Geavanceerde tools gebruiken > Bestanden voor Developer-oplossingen instellen > Developer-oplossingen documenteren
 

Developer-oplossingen documenteren

Opmerking  In dit onderdeel worden functies beschreven die beschikbaar zijn als de algemene voorkeur Geavanceerde tools gebruiken is ingeschakeld. Raadpleeg Geavanceerde tools gebruiken.

U moet voor uw databaseoplossing documentatie beschikbaar stellen, ongeacht of het om een database gaat die in FileMaker Pro Advanced moet worden geopend of een autonome runtime-databaseoplossing. U kunt op verschillende manieren documentatie voor uw oplossing aanbieden, waaronder een gedrukte handleiding, een online Help-systeem en een lay-out Over… die in de oplossing vanuit elke lay-out beschikbaar is.

Maak een eigen lay-out van het type Over… en Help waarin is gedocumenteerd wat uw databaseoplossing is, hoe deze moet worden gebruikt en waar gebruikers terechtkunnen voor meer informatie. Gebruik daarna de functie Eigen menu's om scripts toe te voegen aan menuopdrachten die de lay-outs Over… en Help openen.

Opmerking  Het Help-systeem van FileMaker Pro Advanced is niet beschikbaar in runtime-toepassingen. Statusbalk-Help (Windows) en Help-tags (macOS) zijn echter wel beschikbaar.

Een lay-out van het type Over… maken

In de FileMaker Pro Advanced-licentie is vermeld dat u voor runtime-databaseoplossingen een lay-out van het type 'Over' beschikbaar moet stellen, waarin uw gebruikers informatie kunnen vinden over hoe zij met u contact kunnen opnemen voor technische ondersteuning.

Zo maakt u een Over…-lay-out:

1. Klik in de lay-outmodus op de statusbalk op Lay-out/rapport maken.

2. Typ bij Lay-outnaam de tekst Over <uw oplossing>.

Belangrijk  Voor runtime-databaseoplossingen moet u het woord "Over" in de lay-outnaam opnemen. U moet ook bepaalde informatie in de lay-out vermelden. Raadpleeg Uw verantwoordelijkheden als ontwikkelaar.

3. Selecteer de optie Lege lay-out.

4. Klik op de knop Voltooien.

5. Voeg aan de lay-out uw logo, andere afbeeldingen en uw bedrijfsgegevens toe.

6. Vermeld een tekst die gebruikers waarschuwt of de oplossingsbestanden beveiligd zijn met wachtwoorden of dat volledige toegangsprivileges zijn verwijderd.

7. Raadpleeg Uw verantwoordelijkheden als ontwikkelaar voor de exacte juridische formulering.

8. Maak een knop waarmee uw gebruikers naar de hoofdlay-out van het primaire bestand kunnen terugkeren.

9. Kies Scripts > Scriptwerkruimte en maak een script dat overschakelt naar de lay-out Over.

10. Vermeld het woord Over in de naam van het script.

11. Maak een menuopdracht die de lay-out Over weergeeft. Raadpleeg Eigen menu's definiëren.

Zo geeft u de Over…-lay-out weer wanneer de runtime-toepassing wordt gestart:

1. Open het primaire bestand voor de databaseoplossing.

2. Kies Bestand > Bestandsopties.

3. Selecteer op het tabblad Openen van het dialoogvenster Bestandsopties de optie Naar lay-out gaan en selecteer de lay-out Over… in de lijst.

Een eigen lay-out van het type Help maken

Maak een Help-lay-out waarin u het gebruik van uw oplossing toelicht en voeg er gegevens aan toe. Maak daarna in het primaire bestand van uw oplossing een script dat het Help-systeem weergeeft. Gebruik de functie Eigen menu's om het script beschikbaar te stellen als een opdracht in het menu Help.

Als u een webpagina wilt maken om uw oplossing te documenteren, kunt u in uw Help-lay-out een Web Viewer plaatsen waarin die webpagina kan worden geopend.

Raadpleeg Eigen menuonderdelen maken en bewerken.

Gedrukte documentatie meeleveren

U dient aan uw gebruikers instructies over de installatie van uw databaseoplossing beschikbaar te stellen. Deze informatie moet u zeker in uw documentatie vermelden:

Minimumvereisten voor apparatuur en software

Hoe moet uw gebundelde oplossing worden geïnstalleerd?

Hoe moeten eigen bestanden worden geïnstalleerd?

De werking van software die u mogelijk hebt toegevoegd voor:

De installatie van uw gebundelde oplossing

Het decomprimeren van uw oplossingsbestanden

Hoe verlopen upgrades naar nieuwe oplossingsbestanden? (zie Gegevens importeren in geüpgrade runtime-oplossingen)

Hoe werkt uw Help-systeem?

Hoe kan de databaseoplossing worden gestart (zie Runtime-oplossingen starten)?

Wat kan er worden gedaan bij beschadigde bestanden (zie Runtime-bestanden herstellen)?

Hoe kunnen de gebruikers met u contact opnemen voor technische ondersteuning?

Belangrijk  Zorg ervoor dat wanneer de bestanden van uw runtime-databaseoplossing beschadigd zouden raken, uw gebruikers het e-mailadres en telefoonnummer van uw technische ondersteuning kunnen terugvinden in uw gedrukte documentatie of in een tekstbestand. Als een databasebestand beschadigd raakt, is het mogelijk dat ze geen toegang meer hebben tot de Over…-lay-out in uw oplossing waarin uw contactgegevens zijn vermeld.

Het is ook aangewezen om de volgende aanbevelingen te vermelden:

Meld uw gebruikers dat de namen van uw oplossingsbestanden niet mogen worden gewijzigd (met uitzondering van de runtime-toepassing) omdat ze uw oplossing anders mogelijk niet kunnen uitvoeren.

Beveel uw gebruikers aan om regelmatig een reservekopie van hun gegevens te maken. U kunt bijvoorbeeld een deel van dat proces automatiseren door scripts toe te voegen die een kopie van de oplossingsbestanden opslaan. Raadpleeg FileMaker Pro Advanced-databases onderhouden en herstellen.

Verwante onderwerpen 

Runtime-oplossingen maken

Bestanden voorbereiden op een runtime-oplossing

Bestanden binden als een runtime-oplossing

Runtime-oplossingen benoemen