Claris Developer 5.5 User guide

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

of Netscape.

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:

Page is loading ...

Claris Developer 5.5, FileMaker Developer 5.5 User guide

Related papers

Other documents