Page is loading ...
© 1998, 2000-2001 FileMaker, Inc. All Rights Reserved.
FileMaker, Inc.
5201 Patrick Henry Drive
Santa Clara, California 95054
www.filemaker.com
FileMaker and ScriptMaker are trademarks of FileMaker, Inc., registered in the U.S. and other countries, and the file folder logo is a
trademark of FileMaker, Inc. All other trademarks are the property of their respective owners. Portions of some screen shots are
reprinted by permission from Microsoft Corporation. Portions of some screen shots are copyright 1996-2000 Netscape
Communications Corp. All rights reserved. These screen shots may not be reprinted or copied without the express written permission
of Netscape.
Portions of this software are ©1990 Access Softek and ©1991-2000 MERANT. All rights reserved. This software is based in part on
the work of the Independent JPEG group.
All persons and companies listed in the examples are purely fictitious and any resemblance to existing persons and companies is
purely coincidental.
Mention of third party companies and products is for informational purposes only and does not constitute an endorsement. FileMaker
assumes no responsibility with regard to the selection, performance, or use of these products. All understandings, agreements or
warranties, if any, take place directly between the vendor and prospective users.
FileMaker
Developer
5.5
Developer’s Guide
For Windows and Mac
®
Contents
Preface
Introducing FileMaker Developer 5.5
Ways to use FileMaker Developer 5.5
ix
Create a custom database solution
ix
Customize FileMaker database solutions
ix
Create custom web sites
ix
Take advantage of FileMaker support for open standards
ix
Expand your FileMaker Pro calculations and scripts
ix
Provide layout themes for your solutions
x
Use design tools and templates for UI design
x
Using FileMaker Developer 5.5 in Mac OS X
x
Deploying your customized database solutions
x
Getting more information
x
About this guide
x
Chapter 1
Installing FileMaker Developer 5.5
What you need to install FileMaker Developer
1-1
Installation code
1-1
System requirements for FileMaker Developer 5.5
1-2
For Windows
1-2
For Mac OS X
1-2
For Mac OS
1-2
For runtime database solutions
1-2
Networking requirements
1-2
Windows
1-2
Mac OS X
1-2
Mac OS
1-2
Web publishing requirements
1-2
Requirements for advanced features (Windows)
1-3
Requirements for advanced features (Mac OS)
1-3
Installing FileMaker Developer 5.5 in Windows
1-4
Registering FileMaker Developer
1-7
Uninstalling FileMaker Developer
1-7
Modifying or repairing FileMaker Developer
1-8
Adjusting the FileMaker Pro cache
1-8
Adjusting the network software
1-8
Installing FileMaker Developer 5.5 in the Mac OS
1-8
Easy installation
1-9
Custom installation
1-10
Adjusting memory
1-11
Choosing a network protocol
1-11
New features in FileMaker Pro
1-11
FileMaker Pro 5.5 and Mac OS X
1-11
Contents of the FileMaker Developer 5.5 folder
1-11
Contents of the Developer Extras folder on the FileMaker
Developer 5.5 CD
1-11
Read Me file
1-12
Electronic documentation
1-12
Abiding by the license agreement
1-12
Registration and customer support
1-13
About the TechInfo database
1-13
Chapter 2
Creating a database solution
Overview of preparing your solution files
2-1
Considerations for a runtime database solution
2-2
Considerations for Kiosk mode
2-3
Displaying a database in Kiosk mode
2-3
Navigating in Kiosk mode
2-3
Closing a Kiosk mode solution
2-4
Example Kiosk solution
2-4
iv
Developer’s Guide
Using scripts to control your solution
2-5
Creating startup scripts
2-5
Centering a database window in the Kiosk screen
2-5
Emulating menu commands and window controls
2-6
Creating dynamic buttons
2-6
Protecting your database solution files
2-6
Providing user documentation
2-7
Creating an About layout
2-8
Creating a custom Help layout or file
2-9
Providing What’s This? Help (Windows)
2-10
Including printed documentation
2-10
Design tips for cross-platform solutions
2-11
Creating a consistent appearance
2-11
Simulating outline and shadow text styles
2-11
Using common character sets
2-12
Designing text layouts for cross-platform solutions
2-12
Using a common color palette
2-13
Using graphics in cross-platform solutions
2-13
Using QuickTime movies in cross-platform solutions
2-13
Showing the status bar in Windows
2-14
Using separate scripts for printing
2-14
Using the Status (CurrentPlatform) function
2-14
Creating platform-specific scripts
2-15
Your responsibilities as a developer
2-15
Testing before and after creating your solution
2-16
Converting and upgrading solution files
2-16
Importing data into an upgraded runtime database
solution
2-17
Chapter 3
Creating custom layout themes
Modifying a FileMaker Pro theme
3-1
Basic requirements for a theme file
3-3
Minimum required XML elements for themes
3-3
Removing elements from a theme file
3-4
XML elements for layout parts
3-4
XML elements for text
3-5
Description of XML elements and their theme attributes
3-5
Table of multi-line elements
3-5
Table of single-line elements
3-6
Valid values for theme attributes
3-7
Specifying default values for themes
3-9
Finding values for patterns and colors
3-9
Adding comments to your document
3-10
Checking your theme document for errors
3-11
Chapter 4
Using the FileMaker Developer Tool
About the solution examples
4-1
Using the FileMaker Developer Tool
4-1
Binding your databases into a runtime database solution
4-6
Procedure for binding files
4-6
Specifying a runtime solution name and binding key
4-7
Assigning a three-character filename extension
4-8
Binding files for cross-platform solutions
4-9
Modifying bound runtime files
4-9
Creating Kiosk-mode solutions
4-9
Renaming your databases
4-10
Procedure for renaming files
4-10
Choosing filenames for your database solution
4-10
Removing design access to your databases
4-10
Steps for preventing database modification
4-11
Customizing the About, Help, and Scripts menus
4-11
Adding a custom script to an About menu command
4-11
Adding a custom Help script command to the
Help menu
4-12
Renaming the Scripts menu
4-13
Adding the FileMaker Pro extension to database filenames
4-14
Contents
v
Saving your settings in the Developer Tool
4-14
Using the Solution Options text file
4-14
Saving a set of options
4-14
Modifying the Solution Options text file
4-14
Chapter 5
Distributing FileMaker Pro runtime database solutions
Organizing your runtime database solution components
5-1
Generated DLL files for Windows runtime database
solutions
5-2
System files for Windows solutions
5-2
Solution Extras files for Mac OS solutions
5-3
FileMaker Extensions files for Mac OS solutions
5-3
Including a license agreement
5-4
Choosing the distribution method
5-4
Requirements for distributing on floppy disks
5-4
Using a custom installation program
5-4
Using a compression utility program
5-5
What your users need
5-5
Minimum requirements for your runtime solution
(Windows)
5-5
Minimum requirements for your runtime solution
(Mac OS)
5-5
Sharing your solution over a network
5-5
Documenting the installation procedures
5-5
Starting your runtime database solution
5-6
Recovering damaged files
5-6
Distributing updates to your runtime database solution 5-7
Chapter 6
Publishing your database on the Web
Types of web publishing 6-1
Custom web publishing with XML 6-1
Custom web publishing with JDBC 6-1
Custom web publishing with CDML 6-2
Instant Web Publishing 6-2
Other ways to create custom web sites for your data 6-2
Static web publishing with HTML 6-2
Using the FileMaker Pro Web Companion 6-2
Requirements for web access 6-2
Enabling the Web Companion 6-3
Setting Web Companion configuration options 6-3
Sharing the database via the Web 6-5
Creating a custom home page 6-5
Specifying a custom home page as the default 6-6
Creating a custom home page for Instant Web Publishing 6-6
About the FileMaker WebPortal object 6-7
Overview of setting up a custom home page for Instant
Web Publishing
6-7
Creating a custom web site using a database layout 6-7
Overview of using a database layout as the Instant Web
Publishing home page
6-8
Using script buttons in Instant Web Publishing 6-8
Suppressing the Instant Web Publishing interface 6-11
Bypassing the Instant Web Publishing home page 6-12
Format filenames for instant web pages 6-13
Web Companion support for Internet media types 6-13
Monitoring your site 6-13
Using the access.log file 6-13
Using the error.log file 6-14
Using the info.log file 6-14
Using the Web Companion external functions 6-14
Exporting data to a static HTML page 6-16
Testing your site without a network connection 6-17
Opening password-protected databases remotely 6-18
Opening and closing databases using XML 6-18
Opening and closing databases using CDML 6-18
vi Developer’s Guide
Chapter 7
Using FileMaker Pro XML to deliver your data
About the XML examples 7-1
General process for custom web publishing using XML 7-2
Generating an XML document 7-2
About XML namespaces 7-3
About FileMaker Pro database error codes 7-3
Using the FMPDSORESULT grammar 7-3
Description of elements in the FMPDSORESULT
grammar
7-3
Example of XML data in the FMPDSORESULT
grammar
7-4
Using the FileMaker Pro Extended XML grammars 7-4
Description of elements in the FMPXMLRESULT
grammar
7-5
Example of XML data in the FMPXMLRESULT
grammar
7-6
Description of elements in the FMPXMLLAYOUT
grammar
7-7
Example of XML data in the FMPXMLLAYOUT
grammar
7-7
About UTF-8 encoded data 7-7
Generating FileMaker Pro CGI requests for an XML document 7-8
Request and parameter names 7-8
Requests for adding records to a portal 7-9
Requests for editing multiple records in a portal 7-9
Using style sheets with your XML document 7-10
Comparing CSS, XSLT, and JavaScript 7-11
Cascading style sheets (CSS) example 7-12
Extensible Stylesheet Language–Transformations
(XSLT) example
7-14
JavaScript scripting language example 7-15
Looking at the XML Inventory example 7-16
Chapter 8
Custom web publishing using CDML
About the CDML examples 8-1
General steps for custom web publishing using CDML 8-2
About CDML format files 8-2
Generating FileMaker Pro CGI requests using CDML 8-3
Request names 8-4
Requests for adding records to a portal 8-4
Requests for editing multiple records in a portal 8-4
Using the CDML Tool and templates 8-5
Using the Templates tab 8-6
Using the Tags tab 8-6
Customizing a format file template 8-7
Categories of CDML tags 8-8
Modified CDML tags 8-9
CDML tags new to FileMaker Pro 5 8-9
Modified CDML tags 8-10
Using an intratag parameter 8-11
About the CDML Reference database 8-11
Creating error messages 8-13
Using an encoding parameter with a CDML replacement tag 8-14
Planning your web site 8-14
Looking at the three CDML examples 8-15
Employee Database example 8-15
Guest Book example 8-16
Shopping Cart example 8-17
Chapter 9
Using Java and JDBC to deliver your data
About the JDBC examples 9-1
About JDBC 9-1
Using the FileMaker JDBC Driver 9-2
About the FileMaker JDBC Driver 9-2
Using a JDBC URL to connect to your database 9-2
Contents vii
Specifying driver properties in the URL subname 9-3
SQL supported by the FileMaker JDBC Driver 9-4
Using DbOpen and DbClose pseudo procedures 9-5
Using the RecordID pseudo column 9-6
Using the ModID pseudo column 9-6
SQL statement examples 9-7
Using a character escape 9-7
FileMaker data type mapping to JDBC SQL and Java
data types
9-7
FileMaker Pro support for Unicode characters 9-7
About the FileMaker JDBC Driver interfaces and extensions 9-8
Example 1: Looking at the FileMaker Pro Explorer application 9-8
Setup requirements 9-8
Install the example and the FileMaker JDBC Driver 9-9
Open and share your databases via the Web 9-9
Run the FileMaker Pro Explorer application 9-9
View the source code of the example 9-10
Example 2: Creating the JBuilder Inventory application 9-11
Install the example and FileMaker JDBC Driver 9-11
Set up JBuilder to use the FileMaker JDBC Driver 9-11
Open and share the Inventory.fp5 database 9-11
Start a new JBuilder project 9-11
Create the data module 9-12
Design the data module 9-12
Test the data module 9-13
Generate the application 9-13
Example 3: Creating the Visual Cafe Inventory application 9-14
Install the example and the FileMaker JDBC Driver 9-15
Set up Visual Cafe to use the FileMaker JDBC Driver 9-15
Open and share the inventory_db database 9-15
Create a new Visual Cafe project 9-15
Using the FileMaker Java classes 9-17
About the FileMaker Java Class Library 9-17
Looking at the Java applet examples 9-18
Chapter 10
Understanding external function plug-ins
About external functions 10-1
About the plug-in example file 10-1
Contents of the FMExample Plugin folder 10-2
Contents of the EFP API folder 10-2
Contents of the Resources folder 10-2
Contents of the Source folder 10-2
Installing, enabling, and configuring the example plug-in 10-3
Description of the FMExample plug-in’s external functions 10-3
Using the example plug-in 10-4
Customizing the plug-in example 10-5
Customizing FMExample.r 10-6
Customizing FMExample.rc 10-6
Customizing FMPrefs.c 10-6
Customizing FMMain.h 10-6
Customizing FMFunct..h 10-6
Customizing FMFunct.c 10-6
Requirements for writing an external function plug-in 10-6
Required code files 10-7
Required resource files 10-7
Feature string syntax 10-8
Requirements for the plug-in’s main entry point 10-9
External function naming conventions 10-10
FileMaker Pro messages sent to the plug-in 10-10
The Initialization message 10-11
The Shutdown message 10-11
The Idle message 10-11
The External Function message 10-12
The Preferences message 10-12
Debugging your plug-in 10-13
Avoiding potential Mac OS resource conflicts 10-13
Providing documentation for your plug-in 10-13
Registering your plug-ins 10-13
viii Developer’s Guide
Steps for registering your external function plug-in 10-13
Revising a registered plug-in 10-14
Appendix A
Feature comparison of the runtime
application and FileMaker Pro
Application and document preferences A-1
Toolbar comparison A-2
Menu command comparison A-3
Ignored script steps A-5
Stored registry settings A-6
Appendix B
Valid names used in CGI requests for
FileMaker Pro XML data
Generating a –find, –findall, or –findany request B-1
Examples of –find, –findall, and –findany requests B-1
Generating a –view request B-2
Examples of –view requests B-2
Generating a –new request B-2
Examples of –new requests B-2
Generating an –edit request B-3
Examples of –edit requests B-3
Generating a –delete request B-3
Examples of –delete requests B-3
Generating a –dbnames request B-3
Examples of –dbnames requests B-4
Generating a –layoutnames request B-4
Examples of –layoutnames requests B-4
Generating a –scriptnames request B-4
Examples of –scriptnames requests B-4
Generating a –dbopen request B-4
Examples of –dbopen requests B-5
Generating a –dbclose request B-5
Examples of –dbclose requests B-5
Generating a -dup request B-5
Examples of -dup requests B-5
Generating an -img request B-6
Examples of -img requests B-6
Specifying parameters for the request B-6
–db (Database) B-6
–lay (Layout) B-6
–format (Format) B-6
–recid (Record ID) B-7
–modid (Modification ID) B-7
–lop (Logical operator) B-7
–op (Comparison operator) B-7
–max (Maximum records) B-8
–skip (Skip records) B-8
–sortfield (Sort field) B-8
–sortorder (Sort order) B-9
–script (Script) B-9
–script.prefind (Script before Find) B-9
–script.presort (Script before Sort) B-9
–styletype (Style type) B-9
–stylehref (Style href) B-10
–password (Database password) B-10
field name (Name of specific field) B-10
Appendix C
FileMaker Pro values for error codes C-1
Index I-1
Preface
Introducing FileMaker Developer 5.5
Welcome to FileMaker
®
Developer 5.5! The FileMaker Developer
5.5 product provides the software, APIs, and tools to create custom
FileMaker Pro database solutions for work groups, web sites, or
stand-alone runtime applications.
Ways to use FileMaker Developer 5.5
Create a custom database solution
Use FileMaker Pro to create your custom solution:
1 create custom relational database solutions
1 create custom layouts and scripts for your solution users
1 take advantage of the new Script Debug and Database Design
Report tools in FileMaker Developer to make your database design
and development effort more efficient
Customize FileMaker database solutions
Use the FileMaker Developer Tool to:
1 convert your custom solution to standalone executable files that do
not require the FileMaker Pro application
1 run your solutions in Kiosk mode, without access to certain menu
commands, or with special menu access to custom Help and About
<your solution> layouts
1 rename FileMaker Pro database files without losing links to related
or external files
Create custom web sites
Use the tools, API documentation, and examples provided on the
FileMaker Developer 5.5 CD to create:
1 custom web sites for publishing FileMaker Pro databases on the
Internet or an intranet using FileMaker XML documents or CDML
1 FileMaker Pro database-aware Java applets for your custom web
sites, developed using the open standard FileMaker Pro JDBC
Driver or the proprietary FileMaker Java Class Library
Take advantage of FileMaker support for open standards
1
Use FileMaker Extended XML documents to exchange
FileMaker Pro data with other XML-compatible applications.
1 Use the FileMaker Pro JDBC Driver with your Rapid Application
Development (RAD) tools to create custom front-ends to your
FileMaker Pro database solutions.
1 Use the FileMaker ODBC driver with other ODBC-compatible
applications to access your FileMaker Pro database solutions from
machines that are not running FileMaker Pro.
Expand your FileMaker Pro calculations and scripts
Use the FileMaker Pro External Function Plug-in API and the C or
C++ programming language to create external function plug-ins that
extend the feature set of your FileMaker Pro database solutions (for
example, by providing calculation formulas that take advantage of
recursion and looping, or that hook into other programming
interfaces).
x Developer’s Guide
Provide layout themes for your solutions
Use custom FileMaker layout themes to create a consistent look for
new layouts in your database solutions.
Use design tools and templates for UI design
Use the sample buttons, interface elements, and database examples
provided by FileMaker Developer 5.5 as you develop the user
interface to your custom database solutions.
Using FileMaker Developer 5.5 in
Mac OS X
There are some differences in the user interface and feature set
between the Mac OS and Mac OS X systems. Refer to the Getting
started with FileMaker Pro in Mac OS X guide included with the
FileMaker Developer documentation.
Deploying your customized database
solutions
For deploying your custom database solutions over a network, the
Internet, or an intranet, the FileMaker, Inc. product line includes
FileMaker Server 5.5 and FileMaker Pro 5.5 Unlimited.
FileMaker Server 5.5 provides multi-protocol support for TCP/IP,
IPX/SPX (Windows) and AppleTalk (Mac OS 9.x and earlier)
networks for serving up to 125 hosted files simultaneously to
FileMaker Pro guests on Windows, Mac OS, and Red Hat Linux
machines.
Note Standalone runtime solutions cannot be served or published on
the Web.
FileMaker Pro 5.5 Unlimited includes all of the features of
FileMaker Pro 5.5 and also allows for an unlimited number of web
guests to access your FileMaker Pro databases. Use the FileMaker
Pro Unlimited Web Server Connector to publish your databases
through these popular web servers: Microsoft Internet Information
Server 4.0 and 5.0, Apache on Mac OS X Server, and Apache on Red
Hat Linux 7.1.
Getting more information
For more information about FileMaker Pro products, and for
technical support, go to the FileMaker, Inc. web site at
www.filemaker.com. There you will find product information and
support, trial software, and helpful links to other resources.
FileMaker Developer includes two shortcuts to the website: double-
click Go_FileMaker.html in the FileMaker Developer 5.5\FMI
folder, or click on FileMaker on the Web in the FileMaker Developer
Help menu.
About this guide
The Developer’s Guide provides instructions and examples for using
FileMaker Developer 5.5.
1 Chapter 1 describes how to install the FileMaker Developer
software on Windows and Mac OS systems and provides tables that
describe the content of what is installed.
1 Chapters 2, 3, and 4 describe how to prepare your files with FileMaker
Pro, create custom layout themes, and use the FileMaker Developer
Tool for creating runtime database solutions and other types of database
solutions such as Kiosk mode.
1 Chapter 5 provides instructions for distributing your database
solutions.
1 Chapters 6, 7, and 8 describe custom web publishing with the
FileMaker Pro Web Companion, and using XML and CDML.
Preface xi
1 Chapter 9 describes how to use the FileMaker JDBC Driver to
create FileMaker Pro database-aware Java applications and applets.
It also includes a section on the proprietary FileMaker Java Class
Library from the previous Developer Edition.
1 Chapter 10 provides guidelines for writing FileMaker Pro external
function plug-ins to use in FileMaker Pro field calculations and
scripts.
1 See Appendix A for a comparison of the features in the runtime
application and in FileMaker Developer.
1 See Appendix B for information on CGI requests.
1 See Appendix C for a list of error codes and their meaning.
1 See the FileMaker web site at www.filemaker.com for a description
of the Database Design Report XML grammar.
In addition, throughout this guide are pointers to web sites for
resources and information on various technologies (such as XML
and Java development tools) that you can use with your
FileMaker Pro databases.
Note For information on programming in C or C++, authoring and
using XML, creating CSS or XSL stylesheets, authoring web pages
in Dynamic HTML (including scripting such as JavaScript), and
developing Java applications and applets, see the documentation that
came with your development or authoring tool. Go to
www.filemaker.com for more information.
Chapter 1
Installing FileMaker Developer 5.5
FileMaker Developer 5.5 enables you to create custom database
solutions and distribute your solutions as standalone, executable
applications, or host your solutions on a web server.
To help you create your custom solution, the FileMaker Developer
5.5 CD includes design tools, sample databases, and examples for
using XML, CDML, Java, and JDBC to deliver your data, and
external APIs to extend your solution functionality through plug-ins.
The FileMaker Developer installer installs FileMaker Pro, for
creating your custom database solution, and FileMaker Developer
Tool for creating a runtime version of your solution. The additional
tools, samples, and examples are not installed to your hard drive by
the installer. You can browse the CD to use these development aids,
or you can copy them to your hard drive.
For a description of what’s installed, see “Contents of the FileMaker
Developer 5.5 folder” on page 1-11.
What you need to install
FileMaker Developer
This guide gives instructions for installing the FileMaker Developer
application and associated files on your Windows or Mac OS
computer. Before you begin installing, you should know how you
plan to use FileMaker Developer.
1 On a stand-alone computer—you want to use
FileMaker Developer on your computer, and you don’t plan to share
files with other users over a network.
1 With networking—you want to use FileMaker Developer on your
computer, and you plan to share FileMaker Developer files with other
computers using either TCP/IP or IPX/SPX networking software
(Windows), or TCP/IP or AppleTalk (Mac OS and Mac OS X).
If you’re on a network
you need to know which type of network you’re
using. If you’re not sure which network option to choose, check with
your network administrator before you begin installation. See
“Networking requirements” on page 1-2 for more information.
Installation code
The installation code is a seventeen-digit number located on a multi-
part sticker on a separate paper sheet within the box. Do not lose this
installation code; it cannot be replaced. We recommend that you
place one of the stickers on the inside front cover of your manual.
The installation code ensures adherence to the single user license
agreement, which allows for use of one (1) copy of the Software on
a single computer at a time (refer to your Software License). If the
code is invalid or if another copy of the application installed with that
same code is running on the network, the FileMaker Developer
application displays this error message: “The maximum number of
licensed users are currently using this copy of FileMaker Pro. Please
refer to the Installation Code section of your Getting Started Guide
for further instructions.”
If you receive this error message, you have entered a duplicate
installation code. To install FileMaker Developer on multiple
computers, you must have a unique installation code for each user,
or obtain a volume license. You must license one copy of FileMaker
Developer for each computer.
1-2 Developer’s Guide
System requirements for FileMaker
Developer 5.5
For Windows
1
an Intel-compatible computer with a 486/33 processor
1 a hard disk
1 at least 32 MB of RAM
1 a CD or DVD drive
1 Windows 95, Windows 98, Windows Me, Windows NT 4.0
(Service Pack 6), or Windows 2000.
Note Windows 98, Windows NT 4.0, or Windows 2000 is required
for Web Companion and ODBC features
For Mac OS X
1
Apple G3 computer or higher (excluding G3 upgrade cards)
1 a hard disk
1 at least 128 MB of RAM
1 a CD or DVD drive
1 Mac OS X 10.0.4
For Mac OS
1
Power Macintosh computer
1 a hard disk
1 at least 32 MB of RAM
1 a CD or DVD drive
1 at least System 8.1
For runtime database solutions
For a list of requirements that your users will need to use your
runtime database solutions on Windows and Mac OS machines, see
“What your users need” on page 5-5.
Networking requirements
We recommend using the TCP/IP protocol for networking the
FileMaker Developer application on both Windows and Mac OS
networks. You must use the TCP/IP protocol to share files on a
mixed Windows and Mac OS network.
Windows
1
a Windows-compatible network card
1 the software driver for your network card
1 the appropriate TCP/IP network protocol or IPX/SPX network
protocol for Windows 95, Windows 98, Windows Me,
Windows NT 4.0, or Windows 2000 Professional
Mac OS X
1
TCP/IP networking software
Mac OS
1
TCP/IP or AppleTalk networking software.
Web publishing requirements
To publish a database on the Web using the FileMaker Pro Web
Companion, you need a host computer with access to the Internet or
an intranet via TCP/IP.
Important Access to the Internet requires an Internet service provider
(ISP). FileMaker Developer does not provide an Internet account for
you.
Installing FileMaker Developer 5.5 1-3
Requirements for advanced features
(Windows)
Some of the advanced features of FileMaker Pro require
additional software.
The DLL and the API files are installed with a Complete installation
of Windows. MDAC is provided by Microsoft Corporation. If you
need to update to MDAC 2.5, use Microsoft Windows Update or see
the Microsoft web site at www.microsoft.com.
Note All ODBC components are automatically installed as part of
the Complete installation.
Note QuickTime is required to import graphic formats not supported
by FileMaker Pro 5.5.
Requirements for advanced features
(Mac OS)
Note All ODBC components are automatically installed as part of
Easy Install.
AppleScript is installed with a normal Mac OS software installation.
The Internet Config application, extension, and the Internet Control
Panel are installed with the System software. If you don’t have this
software, refer to the Apple Computer, Inc. web site at
www.apple.com for further information.
Note QuickTime is required to import graphic formats not supported
by FileMaker Pro 5.5.
FileMaker Pro
advanced feature Software requirement
URL support URL.DLL
Open URL script step URL.DLL
Send Mail script step MAPI (Mail API) enabled email client software
Phone dialing Phone dialer or other TAPI (Telephony API)
compliant software
IntelliMouse support IntelliPoint software (included with the IntelliMouse)
ODBC support Microsoft Data Access Components (MDAC)
version 2.5
FileMaker Pro
advanced feature Minimum software requirement
URL support Either Internet Config 1.1 or, for Mac OS 8.5 or later,
the Internet Control Panel
Perform AppleScript
script step
AppleScript system software
Speak script step Speech Manager extension
Open URL script step Either Internet Config 1.1 or, for Mac OS 8.5 or later,
the Internet Control Panel
Send Mail script step Either Internet Config 1.1 or, for Mac OS 8.5 or later,
the Internet Control Panel and email client software
Send Apple event
script step
AppleScript system software
1-4 Developer’s Guide
Installing FileMaker Developer 5.5 in
Windows
You must use the installation program to install FileMaker
Developer—you can’t install FileMaker Developer by dragging files
to your hard disk.
For late-breaking information about FileMaker Developer, browse the
contents of the CD and view the Readme file or visit
www.filemaker.com.
To install FileMaker Developer on Windows systems:
1. Insert the FileMaker Developer 5.5 CD into your CD or DVD
drive.
2. Click Install FileMaker Developer 5.5.
3. When you see the FileMaker Developer Welcome panel, click
Next.
4. In the License Agreement panel, read the Software License
Agreement. If you accept the terms of the license agreement, click
I accept..., then click Next.
5. In the Customer Information panel, type your name and your
organization’s name.
If you don’t have an organization name, you can put other
information (like your address) in the box or leave it blank.
Windows NT or Windows 2000 Professional Choose whether to allow
all users to access this application or only the named user.
Type your
name here
Type your
company or
organization
name here
Installing FileMaker Developer 5.5 1-5
6. Click Next.
7. In the Destination Folder panel, choose the folder where you want
to install FileMaker Developer 5.5.
By default, FileMaker Developer 5.5 will be installed in the
C:\Program Files\FileMaker\FileMaker Developer 5.5 folder.
If you want to install FileMaker Developer in another folder or on
another drive, click the Change button and navigate to the folder where
you want to install FileMaker Developer 5.5.
Click the Space button to see how much disk space you have
available and how much disk space is required to install FileMaker
Developer. If the selected disk doesn’t have enough space for the files
you select, or is write-protected, you can leave the installer and delete
existing files to make more room on the disk. If the disk is locked, or
isn’t a hard disk, you can choose another drive.
8. Click Next.
9. In the Setup Type panel, choose whether to install all program
features (Complete), or to install only selected portions of the
program (Custom). For example, you may choose not to install the
FileMaker Pro tutorial, in order to save disk space.
10. Click Next.
11. If you chose a Complete installation, go to Step 13.
If you chose a Custom installation, you see the Custom Setup panel.
By default, all of the FileMaker Developer features are selected to be
installed. To change the installation of any feature, click on its icon
and choose an installation option.
1-6 Developer’s Guide
Note The option “This feature will be installed when required” means
that the necessary files are copied to your hard drive, but are not
installed until needed.
12. When you have selected the custom installation options for all the
features you want to install, click Next.
13. If you already have FileMaker Pro 5.0 or 5.5 installed, choose
which version of FileMaker Pro you want to associate with .fp5 files.
14. In the Network Protocol panel, choose the network protocol you
want to use for sharing databases.
The default protocol is TCP/IP. You can change the network
protocol later without reinstalling the program. If you are not certain
which protocol to use, see your network administrator.
15. Click Next.
16. In the Application Shortcuts panel, choose whether or not to place
shortcuts on the Desktop and in the Quick Launch toolbar or Start
Menu.
Shortcuts provide a quick and convenient way to launch the
application. Shortcuts can be added or removed after program
installation.
Installing FileMaker Developer 5.5 1-7
17. Click Next.
18. In the Installation Code panel, type the 17-digit installation code
that came with the product.
Important You must enter the installation code or the software will
not install. See “Installation code” on page 1-1 for more information.
19. Click Next to go to the Installation panel, or click Back to review
or change any of your installation settings, such as the destination
folder, user name, or setup type.
20. Click Install to begin the installation.
21. When the installation is complete, click Finish.
If you chose to add shortcuts, a shortcut icon is placed on your
desktop, in the Start menu, and in the Quick Launch toolbar.
Note For Windows 95, Windows 98, and Windows NT4 platforms,
you may be required to reboot your computer.
Registering FileMaker Developer
When installation completes, you see an online registration panel.
Please take the time to complete the registration information.
Uninstalling FileMaker Developer
1. Click the Start button > Settings > Control Panel.
2. Double-click Add/Remove Programs.
3. Select FileMaker Developer 5.5 from the list of applications.
4. Click Remove or Add/Remove.
You see the FileMaker Developer 5.5 Program Maintenance panel
with Remove selected.
Type the
product
installation
code here
1-8 Developer’s Guide
5. Click Next.
6. In the Remove the Program panel, click Remove.
Note Uninstalling doesn’t delete files that you’ve created, as long as
they are named differently than the sample and template files that are
installed with FileMaker Developer.
Modifying or repairing FileMaker Developer
After installation, you can use the FileMaker Developer installer to
automatically replace missing or corrupt files, or to change which
features are installed.
1. Click the Start button > Settings > Control Panel.
2. Double-click Add/Remove Programs.
3. Windows 95, Windows 98, Windows Me: Double-click
FileMaker Developer 5.5.
Windows NT, Windows 2000 Professional: Select
FileMaker Developer 5.5 from the list of applications, then choose
Change.
4. In the Program Maintenance panel, do one of the following:
1 Select Modify to change the installed features.
1 Select Repair to restore missing or corrupted files, shortcuts, or
registry entries.
5. Click Next to continue.
You may be prompted to enter your installation code.
Adjusting the FileMaker Pro cache
See chapter 2 of the FileMaker Pro 5.5 Getting Started Guide for
details.
Adjusting the network software
See chapter 2 of the FileMaker Pro 5.5 Getting Started Guide for
details.
Installing FileMaker Developer 5.5 in the
Mac OS
You must use the installation program to install FileMaker
Developer—you can’t install the application by dragging files to
your hard disk.
To install FileMaker Developer 5.5 on Mac OS systems:
1. Insert the FileMaker Developer 5.5 CD into your CD or DVD
drive.
You see the disc’s window on your screen. If you see only the disc
icon, double-click the icon to open its window.
2. Double-click the file named Start Here Mac OS Classic.
You see the software license agreement.
3. Click Accept if you accept the terms of the license agreement.
You see the FileMaker Developer Installer panel.
4. Follow the steps described in one of the following sections:
/
