Developer’s Guide
Table Of Contents
- Preface Introducing FileMaker Developer 5.5
- Chapter 1 Installing FileMaker Developer 5.5
- What you need to install FileMakerDeveloper
- System requirements for FileMaker Developer 5.5
- Networking requirements
- Web publishing requirements
- Requirements for advanced features (Windows)
- Requirements for advanced features (MacOS)
- Installing FileMaker Developer 5.5 in Windows
- Installing FileMaker Developer 5.5 in the MacOS
- New features in FileMaker Pro
- FileMaker Pro 5.5 and Mac OS X
- Contents of the FileMaker Developer 5.5 folder
- Contents of the Developer Extras folder on the FileMaker Developer 5.5 CD
- Read Me file
- Electronic documentation
- Abiding by the license agreement
- Registration and customer support
- About the TechInfo database
- Chapter 2 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 yoursolution
- Converting and upgrading solution files
- Chapter 3 Creating custom layout themes
- Chapter 4 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 Scriptsmenus
- Adding the FileMakerPro extension to database filenames
- Saving your settings in the Developer Tool
- Chapter 5 Distributing FileMakerPro runtime database solutions
- Chapter 6 Publishing your database on the Web
- Types of web publishing
- Using the FileMakerPro 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 networkconnection
- Opening password-protected databasesremotely
- 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 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
- 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 9 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 10 Understanding external function plug-ins
- About external functions
- About the plug-in example file
- Installing, enabling, and configuring the exampleplug-in
- Description of the FMExample plug-in’s externalfunctions
- Using the example plug-in
- Customizing the plug-in example
- 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
- Registering your plug-ins
- Appendix A Feature comparison of the runtime application and FileMakerPro
- Appendix B Valid names used in CGI requests for FileMakerProXMLdata
- 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 FileMakerPro values for error codes
- Index
Creating a database solution 2-3
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.
The \Developer Extras\FileMaker, Inc\Examples\Creating Dynamic
Buttons\ folder on the FileMaker Developer 5.5 CD contains information
about buttons you can use to make opening and closing files easier for
users. See “Creating dynamic buttons” on page 2-6 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
“Creating dynamic buttons” on page 2-6.
1 Do you want users to be able to modify the database?
Although many menu commands are unavailable in a runtime
application, users can still access the menu commands by opening
your runtime database solution files in FileMaker Pro. (For a
complete list of available menu commands, see appendix A, “Feature
comparison of the runtime application and FileMaker Pro.”)
If you do not want users to modify your files, you can create
passwords to prevent them from opening the files in FileMaker Pro.
(See “Protecting your database solution files” on page 2-7.)
You can also make your files permanently unmodifiable by selecting
the Permanently prevent modification of database structure option in the
Developer Tool. (See “Removing design access to your databases”
on page 4-10.)
1 Will this be a cross-platform runtime database solution?
For advice on handling fonts, graphics, and general cross-platform
issues, see “Design tips for cross-platform solutions” on page 2-11.
1 How will you provide updates for your users?
Plan ahead for the time you may want to update your runtime
database solution files. You can make the process easier for users by
providing scripts in your primary file to export their data and import
it into the updated solution. See “Importing data into an upgraded
runtime database solution” on page 2-17 for an overview.
1 Will your users be printing reports or other information from your
runtime database solution?
It’s a good idea to set document margins in FileMaker Pro if your
runtime database solution will be printed from a variety of printers.
See “Specifying page margins” in the FileMaker Pro 5 User’s Guide
or see FileMaker Pro Help.
Considerations for Kiosk mode
When you create a solution to run in Kiosk mode, you need to
consider if you want to make your solution a stand-alone application,
how the user will navigate your solution, and how the user will be
able to quit the solution.
Displaying a database in Kiosk mode
To display a solution in Kiosk mode, you must either create a stand-
alone application or assign a limited access password to the primary
file. See “Protecting your database solution files” on page 2-7 for
information about assigning a limited password, and “Creating
Kiosk-mode solutions” on page 4-9 for information about creating a
Kiosk-mode solution.
Navigating in Kiosk mode
The primary file is the main database that users see first in your
Kiosk solution. Because Kiosk mode does not contain any menus or
window controls, the primary file must contain buttons that users can
click to navigate through the solution, close the files, and to quit
FileMaker Pro or the runtime application.