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
6-2 Developer’s Guide
For a list of JDBC resources, see the product support pages on the
FileMaker, Inc. web site at www.filemaker.com.
Custom web publishing with CDML
The FileMaker Pro Web Companion lets you publish your database
with custom web pages using a proprietary markup language called
CDML. Included with FileMaker Developer 5.5 are all the tools,
templates, and examples you need to create your own custom web
pages using CDML. For information, see chapter 8, “Custom web
publishing using CDML.”
Instant Web Publishing
When you use FileMaker Pro Instant Web Publishing, the Web
Companion generates predesigned HTML forms with HREF links to
your database. For general information on web publishing and using
the Instant Web Publishing feature, see “Publishing databases on the
Web,” in the FileMaker Pro User’s Guide or see FileMaker Pro
Help.
Other ways to create custom web sites for your data
If you want, you can create a custom home page to go with your
instant web pages instead of using the built-in FileMaker Pro Instant
Web Publishing home page. See “Creating a custom home page” on
page 6-5, “Creating a custom home page for Instant Web
Publishing” on page 6-6, and “Creating a custom web site using a
database layout” on page 6-7.
Static web publishing with HTML
You can also publish your data on static web pages if you don’t need
dynamic web access to your database. See “Exporting data to a static
HTML page” on page 6-16.
Using the FileMaker Pro Web Companion
The Web Companion is a plug-in that acts as a Common Gateway
Interface (CGI) application for handling interactions between
FileMaker Pro and your web browser. The Web Companion also
functions as a web server by providing static files (such as HTML
pages and images) to the web browser.
Web users access your database either by accessing the IP address of
the computer running FileMaker Pro with their browser (which takes
them to the home page) or by clicking an HREF link that contains a
specific CGI request for FileMaker Pro. The Web Companion then
sends via HTTP (Hypertext Transfer Protocol) either the default
home page or the web page specified in the FileMaker CGI request.
Note The Web Companion in FileMaker Pro can serve to a
maximum of ten IP addresses in a 12-hour period, as indicated by the
IP Guest Limit of 10 in the Web Companion Configuration dialog
box. To serve your datases to more IP addresses at a time, you will
need FileMaker Pro 5.5 Unlimited software.
If desired, you can set up your computer for testing without a
constant connection to the Internet or an intranet. For information,
see “Testing your site without a network connection” on page 6-17.
For general information on the Web Companion and about
connecting to the Internet or an intranet, see chapter 14, “Publishing
databases on the Web” in the FileMaker Pro User’s Guide.
Requirements for web access
The host computer must have a copy of FileMaker Pro serving the
databases on the Web (preferably with a full-time, constant
connection to the Internet or your intranet). The Web Companion
must be enabled in FileMaker Pro.