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
3-2
Developer’s Guide
General steps for preparing your
solution files
Here are some general steps for preparing your database files before
you customize them with the Developer Tool and distribute them to
your users:
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.
3. If you’re creating a cross-platform solution for Windows and
Mac OS machines, design and test each database file on both
platforms.
4. If necessary, convert files from earlier versions of FileMaker Pro
to FileMaker Pro 5.
5. Decide which database will be the primary file that users open
first.
6. Create scripts and/or buttons for users to navigate from the
primary file to all auxiliary files and layouts in the solution.
7. 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.
8. Make backup copies of your original files and store them in a safe
place.
9. Use the FileMaker Developer Tool to customize the database files.
(See chapter 2, “Customizing your database solution” for
information.)
10. 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.
11. 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 4, “Distributing
FileMaker Pro runtime database solutions” for information.
Issues to consider before creating 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.
1 Do you want users to open and close auxiliary files?
In the runtime application, several FileMaker Pro menu options have
been eliminated, 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.
The Interface Elements and Artwork Sampler databases included on
the Developer CD contain sample buttons you can use to make
opening and closing files easier for users. See “Using button image
samples” on page 3-5 for information.
1 Will the runtime application operate in Kiosk mode?
If your runtime database solution will display in Kiosk mode, the
entire interface must be accessible via buttons on the layouts. See
“Design tips for navigating in Kiosk mode” next.