Databaseschema's documenteren

Opmerking  Deze functie is beschikbaar als de algemene instelling Geavanceerde tools gebruiken is ingeschakeld. Raadpleeg Geavanceerde tools gebruiken.

FileMaker Pro biedt twee mogelijkheden om de gegevens van uw app op maat te documenteren, namelijk door het volgende op te slaan:

  • een kopie van het bestand in XML-indeling

  • een Database Design Report

Kopie opslaan als XML

U kunt een kopie van een FileMaker Pro-bestand opslaan in een XML-indeling waarin de tabellen, velden, relaties, lay-outs, scripts en andere onderdelen van het bestand naar voren komen. In deze XML-indeling worden de meeste gegevens van het bestand opgenomen, maar de indeling bevat geen recordgegevens.

Omdat het XML-bestand uit tekst bestaat, kunt u het opslaan in versiebeheersystemen zoals Git en standaard, op tekst gebaseerde tools gebruiken om versies met elkaar te vergelijken.

Zo slaat u een kopie van een bestand op als XML:

  1. Open alle bestanden die u als XML wilt opslaan.

    U moet volledige toegangsrechten hebben voor de bestanden en de bestanden moeten geopend zijn in FileMaker Pro.

  2. Kies Gereedschappen > Kopie opslaan als XML.

  3. Hef in de lijst Beschikbare bestanden de selectie op van de bestanden die u wilt uitsluiten.

  4. Maak de selectie van Op te nemen catalogi ongedaan in de catalogi die u wilt uitsluiten.

    Catalogi zijn verschillende typen elementen (tabellen, velden, relaties, scripts, layouts, enzovoort) die samen het schema van uw aangepaste app definiëren.

  5. Selecteer extra opties.

    Selecteer Om dit te doen

    Details opnemen voor analysetools

    Voeg meer informatie toe aan het XML-bestand.

    Met deze optie wordt het DDR_INFO-element toegevoegd, dat extra informatie biedt die nuttig is voor tools van derden die u kunt gebruiken om uw aangepaste app te analyseren. Afhankelijk van uw app kan deze optie een aanzienlijk groter XML-bestand produceren.
    Sla de binaire gegevens van elk lay-outobject op onder het knooppunt

    Sla de binaire gegevens van elk lay-outobject (bijvoorbeeld een afbeelding) op onder het knooppunt van het lay-outobject in het XML-bestand.Dit kan het gebruik van XML voor sommige tools vergemakkelijken, maar hierdoor kan het XML-bestand groter worden.

    Als deze optie is uitgeschakeld, wordt er alleen een verwijzing opgeslagen onder het knooppunt van elk lay-outobject, dat verwijst naar de bibliotheekgegevenscatalogus waar de binaire gegevens worden opgeslagen. Dit kan helpen de bestandsgrootte te verkleinen wanneer dezelfde binaire gegevens worden gebruikt voor veel lay-outobjecten.

    Wanneer u afzonderlijke XML-bestanden voor catalogi maakt, is deze optie geselecteerd en kan deze niet worden gewijzigd.

    Maak voor elke database een afzonderlijk XML-bestand voor elke catalogus

    Maak een afzonderlijk XML-bestand voor elke geselecteerde catalogus in een database. De XML-bestanden worden voor elke database in een aparte map opgeslagen.

    Als deze optie is uitgeschakeld, wordt voor elke database één XML-bestand gemaakt.

    Samenvatting automatisch openen als u klaar bent

    Open het bestand Summary.xml met de bijbehorende toepassing wanneer u meerdere XML-bestanden maakt.

  6. Klik op Maken.

  7. Wijzig de standaardbestandsnaam en kies indien nodig een andere map.

    Wanneer u meerdere XML-bestanden opslaat, is de bestandsnaam voor het bestand Summary.xml.

  8. Klik op Opslaan.

Opmerkingen

  • Deze XML-indeling kan variëren tussen opeenvolgende versies van FileMaker Pro. Wanneer u de XML gebruikt om twee versies van een FileMaker Pro-bestand te vergelijken, zorg er dan voor dat u dezelfde versie van FileMaker Pro gebruikt om van elk bestand een XML-kopie op te slaan. Als u de XML gebruikt met andere tools, moeten deze tools ondersteuning bieden voor de XML die wordt opgeslagen door uw versie van FileMaker Pro.

  • Uit veiligheidsoverwegingen kan het zinvol zijn om de toegang tot het XML-bestand te beperken om onbevoegde toegang tot vertrouwelijke gegevens in het bestand te voorkomen.

Een Database Design Report maken

Gebruik de functie Database Design Report om het schema van uw database te documenteren en het als een HTML- of XML-bestand op te slaan.

Met Database Design Report kunt u:

  • rapporten maken voor elke database die op dat ogenblik is geopend

  • statistische gegevens verzamelen over de structuur van uw database

  • de informatie in het rapport gebruiken om de structuur van uw database opnieuw te maken als u ooit de originele databasebestanden zou verliezen

  • een tekstuele voorstelling van uw databaseschema onderzoeken

  • een selectie maken van de elementen (velden, relaties, scripts, enz.) en tabellen in de database die u wilt documenteren

  • problemen met ontbrekende verwijzingen, verbroken relaties, berekeningen, en nog veel meer oplossen

Een Database Design Report in HTML-formaat bevat een Rapportoverzicht dat een snapshot bevat van de meeste elementen in elk databasebestand. Het Rapportoverzicht bevat hyperlinks naar details over elementen in elk databasebestand.

Een Database Design Report in XML-indeling bevat informatie over de elementen in elk databasebestand en is klaar om naar de gewenste indeling te worden geconverteerd.

Zo maakt u een Database Design Report:

  1. Open alle databasebestanden waarvoor u een Database Design Report wilt opstellen.

    U moet beschikken over volledige toegangsprivileges voor elk bestand waarvoor u een Database Design Report wilt opstellen en het bestand moet in FileMaker Pro geopend zijn.

  2. Kies Gereedschappen  > Database Design Report.

  3. In de lijst Beschikbare bestanden schakelt u alle bestanden uit die u niet in het rapport wilt opnemen door het overeenkomstige selectievakje uit te schakelen.

  4. Als er bestanden zijn die tabellen bevatten die u niet in het rapport wilt opnemen, selecteert u het bestand naast het selectievakje in de lijst Beschikbare bestanden.

  5. In de lijst Opnemen in rapport schakelt u elementen uit die u uit het rapport wilt uitsluiten.

  6. Als u het rapport niet in het standaard HTML-formaat maar in het XML-formaat wilt publiceren, selecteert u de optie XML in het gebied Rapportformaat.

  7. Klik op Maken en daarna op Opslaan om het Database Design Report op te slaan.

Opmerkingen

  • De informatie in het HTML-rapport is een deel van de informatie die in de XML-versie wordt geleverd.

Verwante onderwerpen