Documenting developer solutions (FileMaker Pro Advanced)You should provide documentation for your database solution, whether it is a database that must be opened in FileMaker Pro, FileMaker Pro Advanced, or a standalone runtime database solution. There are several ways that you can provide documentation for your solution, including a printed manual, an online Help system, and an About layout that is available from any layout in the solution.Create custom About and Help layouts that document what your database solution is, how to use it, and where users can go for more information. Then use the custom menus feature to attach scripts to menu commands that open the About and Help layouts.Note The FileMaker Pro and FileMaker Pro Advanced Help system is not available in runtime applications. However, status bar Help (Windows) and Help tags (Mac OS) are available.For runtime database solutions, the FileMaker Pro Advanced license specifies that you must create an About layout that provides information for your users on how to contact you for technical support. FileMaker uses the About layout to distinguish databases created by developers using FileMaker Pro Advanced rather than users of FileMaker Pro.
1.
2. For Layout Name, type About <your solution>.Important For runtime database solutions, you must include the word “About” in the layout name. You must also include certain specific information in the layout. See Your responsibilities as a developer (FileMaker Pro Advanced).
3. Select Blank Layout.
4. Click Finish.
6. Include text that notifies users if the solution files are protected with passwords or if full access privileges have been removed.
7. See Your responsibilities as a developer (FileMaker Pro Advanced) for the exact legal wording.
9.
10. Include the word About in the script’s name.
11.
2.
3. In the Open tab of the File Options dialog box, select Switch to layout and choose the About layout from the list.Create a Help layout that provides instructions for how to use your solution and add data to it. Then create a script in the primary file of your solution to display the Help system. Use the custom menus feature to make the script available as a command in the Help menu.If you want to create a web page to document your solution, you can put a web viewer in your Help layout that opens the web page.You’ll need to provide instructions to your users on how to install your database solution. Here’s a list of things you should document:
• Important In the event that your runtime database solution files become damaged, make sure users have access to your technical support email address or telephone number in your printed documentation or in a text file. If a database file is damaged, they may not be able to access the About layout in your solution to find out how to contact you.
• Tell your users not to rename any solution files (except the runtime application), or they may be unable to run your solution.
• Recommend that users back up their data regularly. You might want to automate some of the process by including scripts that save copies of the solution files. For more information, see Maintaining and recovering FileMaker Pro databases.