Developer’s Guide
Table Of Contents
- Chapter 1 Welcome to FileMaker Developer
- Chapter 2 Installing FileMaker Developer in Windows
- Chapter 3 Installing FileMaker Developer in the Mac OS
- Chapter 4 Creating a database solution
- Overview of preparing your solutionfiles
- Considerations for a runtime databasesolution
- Considerations for Kiosk mode
- Using scripts to control your solution
- Protecting your database solution files
- Providing user documentation
- Design tips for cross-platform solutions
- Creating a consistent appearance
- Simulating outline and shadow text styles
- Using common character sets
- Designing text layouts for cross-platform solutions
- Using a common color palette
- Using graphics in cross-platform solutions
- Using QuickTime movies in cross-platform solutions
- Showing the status bar in Windows
- Using separate scripts for printing
- Using the Status (CurrentPlatform) function
- Creating platform-specific scripts
- Your responsibilities as a developer
- Testing before and after creating your solution
- Converting and upgrading solution files
- Chapter 5 Creating custom layout themes
- Chapter 6 Using the FileMaker Developer Tool
- About the solution examples
- Using the FileMaker Developer Tool
- Binding your databases into a runtime database solution
- Creating Kiosk-mode solutions
- Renaming your databases
- Removing design access to your databases
- Customizing the About, Help, and Scripts menus
- Adding the FileMaker Pro extension to database filenames
- Saving your settings in the Developer Tool
- Chapter 7 Distributing FileMaker Pro runtime database solutions
- Chapter 8 Publishing your database on the Web
- Types of web publishing
- Using the FileMaker Pro Web Companion
- Creating a custom home page
- Creating a custom home page for Instant Web Publishing
- Creating a custom web site using a database layout
- Web Companion support for Internet mediatypes
- Monitoring your site
- Exporting data to a static HTML page
- Testing your site without a network connection
- Opening password-protected databases remotely
- Chapter 9 Custom web publishing using CDML
- About the CDML examples
- General steps for custom web publishing using CDML
- About CDML format files
- Generating FileMaker Pro CGI requests using CDML
- Using the CDML Tool and templates
- About the CDML Reference database
- Creating error messages
- Using an encoding parameter with a CDML replacement tag
- Planning your web site
- Chapter 10 Using FileMaker Pro XML to deliver your data on the Web
- About the XML examples
- General process for custom web publishing using XML
- Generating an XML document
- Using the FMPDSORESULT grammar
- Using the FileMaker Pro Extended XML grammars
- About UTF-8 encoded data
- Generating FileMaker Pro CGI requests for an XML document
- Using style sheets with your XML document
- Comparing CSS, XSLT, and JavaScript
- Looking at the XML Inventory example
- Chapter 11 Using JDBC to deliver your data
- About the JDBC examples
- About JDBC
- Using the FileMaker JDBC Driver
- SQL supported by the FileMaker JDBC Driver
- FileMaker Pro support for Unicode characters
- About the FileMaker JDBC Driver interfaces and extensions
- Example 1: Looking at the FileMaker Pro Explorer application
- Example 2: Creating the JBuilder Inventory application
- Example 3: Creating the Visual Cafe Inventory application
- Chapter 12 Understanding external function plug-ins
- About external functions
- About the plug-in example file
- Installing, enabling, and configuring the example plug-in
- Description of the FMExample plug-in’s external functions
- Using the example plug-in
- Customizing the plug-in example
- Requirements for writing an external function plug-in
- FileMaker Pro messages sent to the plug-in
- Debugging your plug-in
- Avoiding potential Mac OS resourceconflicts
- Providing documentation for your plug-in
- Registering your plug-ins
- Appendix A Feature comparison of the runtime application and FileMaker Pro
- Appendix B Valid names used in CGI requests for FileMaker Pro XML data
- Generating a –find, –findall, or –findany request
- Generating a –view request
- Generating a –new request
- Generating an –edit request
- Generating a –delete request
- Generating a –dbnames request
- Generating a –layoutnames request
- Generating a –scriptnames request
- Generating a –dbopen request
- Generating a –dbclose request
- Generating a -dup request
- Generating an -img request
- Specifying parameters for the request
- –db (Database)
- –lay (Layout)
- –format (Format)
- –recid (Record ID)
- –modid (Modification ID)
- –lop (Logical operator)
- –op (Comparison operator)
- –max (Maximum records)
- –skip (Skip records)
- –sortfield (Sort field)
- –sortorder (Sort order)
- –script (Script)
- –script.prefind (Script before Find)
- –script.presort (Script before Sort)
- –styletype (Style type)
- –stylehref (Style href)
- –password (Database password)
- field name (Name of specific field)
- Appendix C FileMaker Pro values for error codes
- Index
4-2 Developer’s Guide
Overview of preparing your solution files
As you design, build, and test your database solution, keep in mind
how your users will interact with it. This includes navigational
scripts and buttons, effective use of layouts and themes, and Help for
the user.
Here are some general considerations for preparing solution files:
1. If desired, create a custom theme for all the layouts in your
database solution. (See chapter 5, “Creating custom layout themes”
for information.).
2. In FileMaker Pro, design, create, and test the databases that make
up your solution.
If you’re creating a cross-platform solution for Windows and
Mac OS machines, design and test each database file on both
platforms. See
“Design tips for cross-platform solutions” on
page 4-11.
3. If necessary, convert files from versions of FileMaker Pro earlier
than 5.0.
4. Decide which database will be the primary file that users open
first.
5. Create scripts and/or buttons for users to navigate from the
primary file to all auxiliary files and layouts in the solution. See
“Using scripts to control your solution” on page 4-5 and “Creating
dynamic buttons” on page 4-6.
6. Create documentation about your database solution, such as an
About layout that describes your company and where users can go
for technical support, and a Help layout that describes how to
navigate and use your solution. See
“Providing user documentation”
on page 4-8.
7. Make backup copies of your original files and store them in a safe
place.
Once you have completed the design and development work and you
are satisfied that your database solution is ready for distribution, use
the FileMaker Developer Tool to create Kiosk-mode or custom
stand-alone solutions.
To create a custom solution:
1. Use the FileMaker Developer Tool to bind and customize the
database files. (See chapter 6, “Using the FileMaker Developer
Tool” for information.)
2. Test your custom solution for errors—step through your database
files trying every option, feature, and button. If your solution will be
run in both Windows and the Mac OS, test your solution on both
platforms.
3. Plan how your database solution will be distributed to your users
and, if necessary, create a custom installer.
FileMaker Pro runtime applications don’t have automatic installers,
so you’ll need to create an installation procedure for your runtime
database solution files. You may also need a utility to decompress
and install the files on users’ hard disks. See
chapter 7, “Distributing
FileMaker Pro runtime database solutions” for information.
Considerations for a runtime
database solution
Here’s a list of issues to consider as you prepare your database files
for a stand-alone runtime database solution. It’s best to address these
issues before binding the files to the runtime application.
• Do you want users to open and close auxiliary files?
In the runtime application, several FileMaker Pro menu options are
not available to the user, including File menu > Open and File menu >
Close. If you want users to open and close auxiliary files, you must
provide scripts in your solution to perform these operations. Then,
place a button or startup script in each auxiliary file that returns to the
main layout of the primary file.