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
Note No matter what the filename extensions are, runtime database
files can still be opened in the FileMaker Pro application. To prevent
users from modifying your runtime database solutions, create
passwords for specific access privileges or select the Permanently
prevent modification of database structure option in the Developer Tool
before you bind the files into a runtime database solution. (See
“Removing design access to your databases” on page 6-11 and
“Protecting your database solution files” on page 4-7 for
information.)
Binding files for cross-platform solutions
If your solution will be used in Windows, bind it using the Developer
Tool for Windows. If your solution will be used on the Mac OS, bind
it using the Developer Tool for Mac OS. If you’re creating a cross-
platform solution to be used on both Windows and the Mac OS, bind
the solution files twice: first using FileMaker Developer Tool for
Windows, and then using FileMaker Developer Tool for Mac OS.
Use the same binding key on both platforms. Also, remember that
binding keys are case-sensitive.
When you’re binding database files on a Mac OS machine for a
cross-platform runtime database solution, select the Change filenames
for Windows compatibility option. (See step
18 in “Using the
FileMaker Developer Tool” on page 6-5.)
The Developer Tool automatically updates all files to use the three-
character extension that you specify on this screen and appends the
extension to the filenames. Internal file references used in
relationships, scripts, and external value lists are updated to interact
with the new filenames.
See “Design tips for cross-platform solutions” on page 4-11 for
additional cross-platform information.
Using the FileMaker Developer Tool 6-9
Modifying bound runtime files
You can open a bound runtime file in FileMaker Pro to make
modifications to it, for example, to access the Define Value Lists menu
command. However, if you selected the Permanently prevent
modification of database structure option when you bound the files,
then you can’t regain access to these menu commands: Define Fields,
Define Relationships, Access Privileges, Layout Mode, and ScriptMaker.
In this case, you’ll have to open the original database files in order to
make design or structure changes in FileMaker Pro and then rebind
them using the binding key that you assigned to that runtime
database solution.
See “Distributing updates to your runtime database solution” on
page 7-6 for more information.
Creating Kiosk-mode solutions
To display your database files in Kiosk mode, you must either bind
your solution database to a stand-alone runtime application, or assign
a limited access password to your solution database, and choose the
Kiosk option.
To display your solution in Kiosk mode:
1. Close all of your database files that you are going to include in
your Kiosk solution.
2. Start the FileMaker Developer Tool application and click Next.
3. Select Open file in Kiosk mode, select other options as desired, and
click Next.
4. If you have already assigned a limited access password to the
database solution, you can choose any other options. If you have not
assigned a limited access password, you must choose Create a stand-
alone runtime solution, in addition to any other options you want.
See “Protecting your database solution files” on page 4-7 for
information about assigning passwords.