Sharing files on a network > Opening shared files as a client > Opening files using a URL
 

Opening files using a URL

You can open a shared or local file or run a script in a file using a URL. When FileMaker Pro or FileMaker Go is installed, the following URL schemes are registered with the operating system so that URLs using these schemes are handled by FileMaker Pro or FileMaker Go:

fmp – The last installed version of the application handles URLs with this scheme.

fmpXX, where XX is the major version number of the application – Only the specified version of the application handles URLs with this scheme.

To open a file using a URL:

1. Launch a web browser on the intended client machine.

2. Enter the URL of the file into the browser’s address area using the format:

fmpXX://{{account:password@}address/}filename

For address, you can enter:

the IP address or DNS name of the host

~ to specify the user’s Documents folder

$ to specify that the file is already open

Optional parameters are indicated by braces ({ }).

To run a script in a file using a URL:

1. Follow the steps above.

2. Append ?script=scriptname to the URL.

You can also specify a script parameter and local variables using the format:

fmpXX://{{account:password@}address/}filename{?script=scriptname{&param=scriptparameter}{&$variablename{[repetitionnumber]}=value}}

Notes 

To allow a URL to run a FileMaker script, the user’s account must have the fmurlscript extended privilege enabled. See Editing extended privileges for a privilege set.

Filenames are case sensitive for FileMaker Go but not for FileMaker Pro. Script names are not case sensitive.

The filename extension .fmp12 is not required.

You can define multiple local variables in the URL.

If spaces or any other special characters are needed in a link, be sure to replace them with the appropriate percent-encoded values required for valid URLs. For example, replace a space with %20.

Examples

fmp://My%20Addressesfmp://192.168.10.0/My%20Addresses.fmp12fmp://[2001:0DB8:85A3:08D3:1319:8A2E:0370:7334]/My%20Addresses.fmp12fmp19://MyAccount:MyPassword@sales.example.com/My%20Addresses.fmp12

Open a file named Clients.fmp12 on a host and run the script named ListClients:

fmp://sales.example.com/Clients.fmp12?script=ListClients

Open a file named Clients.fmp12 on a host and run a script named ListClients, specifying a parameter of TopClients and a local variable $NumberToList with a value of 10:

fmp://sales.example.com/Clients.fmp12?script=ListClients&param=TopClients&$NumberToList=10

Open a local file named Clients.fmp12 in the user’s Documents folder with a script named ListClients:

fmp://~/Clients.fmp12?script=ListClients

Run the script ListClients from an open file named Clients.fmp12:

fmp://$/Clients.fmp12?script=ListClients

Related topics 

Opening files as the host