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-4 Developer’s Guide
2. In the Web Companion Configuration dialog box, choose an
HTML file from the Home Page list so the Web Companion will
automatically display it when web users enter the IP address.
The [Built-in] option displays the “FileMaker Pro Instant Web
Publishing” home page by default. All other HTML files that are
located in the root level of the Web folder appear in this list.
See “Creating a custom home page” on page 6-5 for more
information.
3. For custom web publishing, deselect Enable Instant Web Publishing.
4. If desired, choose a language from the Language pop-up menu for
using localized texts in Instant Web Publishing navigation.
This choice will not affect the language of your data.
Note The Language setting can also be used with the [FMP-
CurrentAction], [FMP-FindOpItem], or [FMP-SortOrderItem]
CDML replacement tags in your custom web pages. See “Using an
encoding parameter with a CDML replacement tag” on page 8-14 for
information.
5. If you want, select one or more Logging options: Access Log File,
Error Log File, and Information Log File.
For information, see “Monitoring your site” on page 6-13.
6. Select a Remote Administration option.
If you want to remotely access the Web folder from a different
computer, for example, to upload or download files using HTTP Put
and Get commands or to change settings in the Web Security
Database, select Requires Password and enter a password in the box.
(If it doesn’t matter who has access to the Web folder and everything
inside it, select Requires no password.)
For more information, see “Opening password-protected
databases remotely” on page 6-18.
7. Select a Security option.
FileMaker Pro Access Privileges is selected by default. For general
information about setting access privileges in FileMaker Pro, see
chapter 9, “Protecting databases with passwords and groups,” in the
FileMaker Pro User’s Guide.
In FileMaker Pro 5.5, you can now secure data on a record-by-record
basis using access privileges. For more information, see the Web
Security.pdf file in the FileMaker Pro 5.5 Web Security folder or see
FileMaker Pro Help.
The Web Security Database option is not available when the
Web Security.fp5 database is not open. For information on the Web
Security database, see the Web Security.pdf file.
8. If desired, select Restrict access to IP address(es) and type the IP
addresses of the computers that are allowed to access the Web folder,
the web pages served by the Web Companion, and your databases.
You can enter multiple IP addresses separated by commas and use an
asterisk as a wildcard for all addresses beginning with the specified
numbers. For example, 1.2.3.4, 5.6.7.8, 3.5.* indicates two IP addresses
and all addresses that begin with “3.5.”
A computer’s IP address is determined by the network administrator
(for an intranet) or an Internet service provider (ISP) account.
9. Specify a TCP/IP port number.
By default, web browsers use the TCP/IP port number 80 to
communicate with the web server. If that port is in use, you can use
any number between 1024 and 65535 or the port number 591, which
is registered by FileMaker, Inc. with the Internet Assigned Numbers
Authority (IANA) for use with the FileMaker Pro Web Companion.
Mac OS X To use port numbers below 1024 on Mac OS X machines,
you’ll need your Mac OS X administrator name and password. See
the FileMaker Pro 5.5 and Mac OS X booklet, or view the FMP 5.5
and Mac OSX.PDF file in the Electronic Documentation folder on
the FileMaker Developer 5.5 CD.
10. Click OK to close the Web Companion Configuration dialog box.
11. Click OK again to close the Application Preferences dialog box.