Documentazione dello schema del database

Nota  Questa funzione è disponibile se è selezionata l'impostazione generale Utilizza strumenti avanzati. Vedere Utilizzo degli strumenti avanzati.

FileMaker Pro offre due modi per documentare i dettagli dell'app personalizzata salvando:

  • una copia del file in formato XML

  • un Resoconto Definizione Database

Salvataggio di una copia come XML

È possibile salvare una copia di un file FileMaker Pro in un formato XML che rappresenti le tabelle, i campi, le relazioni, i formati, gli script e altre parti del file. Questo formato XML contiene la maggior parte dei dettagli sul file, ma non i dati dei record.

Poiché il file XML è testo, è possibile salvarlo su sistemi di controllo di versione come Git e utilizzare strumenti standard basati su testo per confrontare le versioni.

Per salvare una copia di un file come XML:

  1. Aprire tutti i file che si desidera salvare come XML.

    È necessario disporre di privilegi di accesso completo per i file e i file devono essere aperti in FileMaker Pro.

  2. Selezionare Strumenti > Salva copia come XML.

  3. Nell'elenco File disponibili, deselezionare tutti i file che si desidera escludere.

  4. Da Cataloghi da includere, deselezionare tutti i cataloghi che si desidera escludere.

    I cataloghi sono diversi tipi di elementi (tabelle, campi, relazioni, script, formati e così via) che insieme definiscono lo schema dell'app personalizzata.

  5. Selezionare opzioni aggiuntive.

    Seleziona Per

    Includi dettagli per gli strumenti di analisi

    Aggiungere ulteriori informazioni nel file XML.

    Questa opzione aggiunge l'elemento DDR_INFO, che fornisce informazioni aggiuntive utili agli strumenti di terze parti che si possono utilizzare per analizzare la propria app personalizzata. A seconda dell'app, questa opzione può produrre un file XML notevolmente più grande.
    Salva i dati binari di ogni oggetto del formato sotto il rispettivo nodo

    Memorizzare i dati binari di ogni oggetto del formato (ad esempio, un'immagine) sotto il nodo dell'oggetto del formato nel file XML. Questo può rendere l'XML più facile da usare per alcuni strumenti, ma può aumentare la dimensione del file XML.

    Quando questa opzione è deselezionata, sotto il nodo di ogni oggetto del formato viene memorizzato solo un riferimento, che punta al catalogo dati della libreria in cui sono memorizzati i dati binari. Questo può aiutare a ridurre le dimensioni del file quando gli stessi dati binari vengono utilizzati per molti oggetti del formato.

    Quando si creano file XML separati per i cataloghi, questa opzione è selezionata e non può essere modificata.

    Per ogni database, crea un file XML separato per ogni catalogo

    Creare un file XML separato per ogni catalogo selezionato in un database. I file XML vengono salvati in una cartella separata per ogni database.

    Se deselezionata, questa opzione crea un file XML per ogni database.

    Apri automaticamente il riepilogo al termine

    Aprire il file Summary.xml con l'applicazione associata quando si creano più file XML.

  6. Fare clic su Crea.

  7. Cambiare il nome del file predefinito e selezionare una cartella diversa, se necessario.

    Quando si salvano più file XML, il nome del file è per il file Summary.xml.

  8. Fare clic su Salva.

Note

  • Questo formato XML può cambiare da una versione di FileMaker Pro a quella successiva. Quando si utilizza l'XML per confrontare le due versioni di un file FileMaker Pro, assicurarsi di utilizzare la stessa versione di FileMaker Pro per salvare una copia di ogni file come XML. Se si utilizza l'XML con altri strumenti, assicurarsi che siano progettati per utilizzare l'XML salvato dalla versione di FileMaker Pro in uso.

  • Per sicurezza, considerare di limitare l'accesso al file XML per impedire l'accesso non autorizzato alle informazioni sensibili contenute al suo interno.

Creazione di un Resoconto Definizione Database

Utilizzare la funzione Resoconto Definizione Database per documentare lo schema del database e salvarlo come file HTML o XML.

Con la funzione Resoconto Definizione Database è possibile:

  • creare resoconti per tutti i database attualmente aperti

  • eseguire statistiche sulla struttura del database

  • utilizzare le informazioni del resoconto per ricostruire la struttura del database se si perdono i file di database originali

  • esaminare una rappresentazione testuale dello schema del database

  • scegliere gli elementi (campi, relazioni, script e così via) e le tabelle del database da documentare

  • risoluzione problemi legati a riferimenti mancanti, relazioni interrotte, calcoli, ecc

Il Resoconto Definizione Database in formato HTML comprende una panoramica del resoconto che offre un'istantanea della maggior parte degli elementi contenuti in ogni file di database. La panoramica del resoconto contiene collegamenti ipertestuali ai dettagli relativi agli elementi di ogni file di database.

Un Resoconto Definizione Database in formato XML contiene informazioni sugli elementi presenti in ogni file di database, pronte per essere trasformate nel formato richiesto.

Per creare un Resoconto Definizione Database:

  1. Aprire tutti i file di database di cui si intende creare un Resoconto Definizione Database.

    È necessario disporre di privilegi di accesso completo per qualsiasi file di cui si intende creare un Resoconto Definizione Database e il file deve essere aperto in FileMaker Pro.

  2. Selezionare il menu Strumenti > Resoconto Definizione Database.

  3. Nella lista dei File disponibili, eliminare tutti i file che si intende escludere dal Resoconto annullando la casella di controllo ad essi associata.

  4. Se alcuni di questi file contengono tabelle che si intende escludere dal resoconto, selezionare il nome file oltre alla casella di controllo della lista File disponibili.

  5. In Includi nel report, cancellare gli elementi che si desidera escludere dal resoconto.

  6. Se si desidera pubblicare il resoconto in formato XML invece che nel formato HTML di default, selezionare XML nella sezione Formato resoconto.

  7. Fare clic su Crea, quindi su Salva per salvare il Resoconto Definizione Database.

Note

  • Le informazioni fornite nel resoconto HTML sono un sottogruppo di quelle fornite nella versione XML.

Argomenti correlati