Developer’s Guide
Table Of Contents
- Contents
- Chapter 1 Introducing FileMaker Developer 5
- Chapter 2 Customizing your database solution
- About the custom solution examples
- Using the FileMaker Developer Tool
- Binding your databases into a runtime database solution
- Displaying databases in Kiosk mode
- Renaming your databases
- Removing design access to your databases
- Customizing the About, Help, and Scriptsmenus
- Adding the FileMakerPro extension to database filenames
- Saving your settings in the Developer Tool
- Chapter 3 Preparing files for a custom solution
- About the Relational Example
- General steps for preparing your solutionfiles
- Issues to consider before creating a runtime database solution
- Opening files in Kiosk mode
- Design tips for navigating in Kiosk mode
- Creating startup scripts
- Using button image samples
- Documenting your database solution
- 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
- Protecting your runtime database solutionfiles
- Testing before and after creating yoursolution
- Converting and upgrading solution files
- Chapter 4 Distributing FileMakerPro runtime database solutions
- Chapter 5 Creating custom layout themes
- Chapter 6 Publishing your database on the Web
- Moving forward using open web standards
- Using the FileMakerPro Web Companion
- Displaying a custom home page
- Using a custom home page with Instant Web Publishing
- Monitoring your site
- Exporting data to a static HTML page
- Testing your site without a networkconnection
- Opening password-protected databasesremotely
- Using the Web Security Database
- Chapter 7 Using FileMakerPro XML to deliver your data
- About the XML examples
- General process for custom web publishing using XML
- Generating an XML document
- Using the FMPDSORESULT grammar
- Using the FileMakerPro Extended XMLgrammars
- About UTF-8 encoded data
- Generating FileMakerPro CGI requests for an XML document
- Using style sheets with your XMLdocument
- Comparing CSS, XSLT, and JavaScript
- Looking at the XML Inventory example
- Chapter 8 Using Java and JDBC to deliver your data
- About the JDBC examples
- About JDBC
- Using the FileMaker JDBC Driver
- SQL supported by the FileMaker JDBCDriver
- FileMakerPro support for Unicodecharacters
- About the FileMaker JDBC Driver interfaces and extensions
- Example 1: Looking at the FileMakerPro Explorer application
- Example 2: Creating the JBuilder Inventoryapplication
- Example 3: Creating the Visual Cafe Inventory application
- Using the FileMaker Java classes
- Chapter 9 Custom web publishing using CDML
- About the CDML examples
- General steps for custom web publishing using CDML
- About CDML format files
- Generating FileMakerPro CGI requests using CDML
- Using the CDML Tool and templates
- New and modified CDML tags
- About the CDML Reference database
- Creating error messages
- Using an encoding parameter with a CDML replacement tag
- Planning your web site
- Chapter 10 Writing external function plug-ins
- About the plug-in examples and templates
- Installing, enabling, and configuring FileMakerPro plug-ins
- Using external functions in a calculation
- Requirements for writing an external function plug-in
- FileMakerPro messages sent to theplugin
- Debugging your plug-in
- Avoiding potential MacOS resourceconflicts
- Providing documentation for your plug-in
- Naming and registering your plug-ins
- Appendix A Feature comparison of the runtime application and FileMakerPro
- Appendix B Valid names used in CGI requests for FileMaker 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
- 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
Customizing your database solution
2-7
4. Specify the database files that you want to bind, rename them if
desired, and click Next to go to the next screen in the runtime binding
process.
5. Select a primary file.
All of the settings for binding are stored in the primary file. The
primary file opens automatically when a user double-clicks the
runtime application.
6. Select Use custom About script and choose the script’s name from
the pop-up menu.
FileMaker Pro runtime database solutions are required to have an
About layout that gives information about your company and where
users can go for technical support. See “Customizing the About,
Help, and Scripts menus” on page 2-12 for information.
7. Select other options as desired, and click Next.
8. Specify a unique name and binding key for the solution and click
Next.
Note The binding key must be between 6 and 31 characters, and is
case-sensitive.
For more information, see “Specifying a runtime solution name and
binding key” next.
9. Specify a unique three-character filename extension to associate
all of the database files with the runtime application and click Next.
You must specify an extension. For files that will be used on Mac OS
machines, the Developer Tool inserts the letter “F” after the first
character of the extension to indicate a creator code. You should
register the extension as a creator type with Apple Computer. See
“Assigning a three-character filename extension” on page 2-8.
10. Specify the location for the runtime database solution files,
rename the folder if desired, and click Finish to bind the files.
To quickly repeat the binding process, see “Saving your settings in
the Developer Tool” on page 2-15.
For information on bundling the necessary files and delivering your
new runtime database solution to your users, see chapter 4,
“Distributing FileMaker Pro runtime database solutions.”
Specifying a runtime solution name and binding key
The runtime name that you specify in the Developer Tool is used for
the name of the runtime application and can also be used for the
name of the new solution folder that contains the bound runtime
database solution files.
The binding key is a code that the FileMaker Developer Tool uses
during the binding process to internally link the files with the runtime
application. If you need to add auxiliary files later to the existing
runtime database solution, rebind the files using the same key.
When developing a cross-platform solution, use the same key when
you bind the solution in Windows and in the Mac OS. Also, keep in
mind that the binding key is case-sensitive on both Windows and
Mac OS machines.
Note Use a binding key you’ll remember and record it in a safe
place. (You can do this by saving the Developer Tool Options file—
see “Saving your settings in the Developer Tool” on page 2-15 for
information.) Otherwise, if you forget your binding key and want to
change a runtime database solution, you’ll need to rebind all of the
database files using a new binding key and then redistribute the
entire solution, including a new runtime application.
The runtime name is used for the folder
and application names in this solution