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
Using the FileMaker Developer Tool 4-9
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 4-10 and
“Protecting your database solution files” on page 2-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 4-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 2-11 for
additional cross-platform information.
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 5-7 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 2-7 for
information about assigning passwords.