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
Sharing your solution over a network
Because the runtime application does not support FileMaker Pro file
sharing (peer-to-peer or client/server networking), users cannot
share your runtime database solution over a network unless they
access the files using the FileMaker Pro application on their
machines.
For optimal performance, they can host the solution files using
FileMaker Server.
For information about the FileMaker Server and FileMaker Pro
products, and information about volume license sales, see the
FileMaker, Inc. web site at www.filemaker.com.
Documenting the installation procedures
You’ll need to provide instructions to your users for how to install
your runtime database solution. Here’s a list of things you should
document:
• Provide written instructions for copying or installing your solution
to your user’s hard disk.
• Include software and instructions specifying how your users can
decompress your solution files.
• Include information about the minimum equipment and software
requirements.
For suggestions on other information to include with your runtime
database solution, see
“Including printed documentation” on
page 4-10.
Starting your runtime database solution
The first time users double-click the runtime application icon, the
runtime application will auto-register and move appropriate items
into the System folder on their machines.
Distributing FileMaker Pro runtime database solutions 7-5
Runtime application icon
Double-click
to start
Primary file icon
In Windows, the three-character filename extension associated with
the solution will not be registered by the operating system until the
runtime application has been started. If a primary or auxiliary
solution file is double-clicked before the runtime application has
registered the extension, the runtime application won’t be found.
Important Your users should start your solution by double-clicking
the runtime application icon, not the primary file icon. Double-
clicking the icons for the primary or auxiliary files might result in
errors, depending on whether there are other copies of the runtime
application on the hard disk. If your users have more than one
solution on their computers with the same three-character extension
and they double-click the icon for the primary file, the most recently
installed runtime application is opened, which may not be the correct
application for your solution’s primary file.
Each time the runtime application is opened, it looks for the primary
file that has been bound to it. If the primary file can’t be found, the
user is asked to locate the primary file.
Caution your users that they should not rename the primary or
auxiliary solution files. If they do, relationships and external scripts
may not work properly. They can rename the runtime application
after it has been installed.
Note When you make a change to your solution, you should make
sure that your users can import their data into your updated solution.
Include a script attached to a button to make it easy for your users to
import their data into the new solution files. For more information,
see
“Converting and upgrading solution files” on page 4-16.