使用 URL 打开文件

通过 URL,您可以启动客户端以及打开共享或本地文件或运行文件中的脚本。安装客户端软件时,URL 架构将向操作系统注册,以便使用这些架构的 URL 被客户端处理。

URL 的完整格式如下所示。可选参数以花括号 ({ }) 指示。添加换行符和缩进以保持合格。

架构://{{帐户:密码@}地址/}文件名
  {?script=脚本名称
    {&param=脚本参数}
    {&option=选项值}
    {&$变量名称{[重复项编号]}=}
  }
  • 架构是其中一个支持的 URL 架构:

    • Claris 客户端:claris

    • FileMaker 客户端:

      • fmp - 处理此架构 URL 最近安装的应用程序版本。

      • fmpXX,其中 XX 是应用程序的主要版本号 - 只有指定版本的应用程序才能使用此架构处理 URL。

  • 帐户:密码是打开文件时使用的帐户名和密码。这些值仅适用于 FileMaker 客户端。对于 Claris 客户端应在 URL 中省略它们,Claris 客户端使用当前用户的 Claris ID。

  • 地址

    • 主机的 DNS 名称或 IP 地址

    • ~指定用户的 Documents 文件夹

    • $指定某个已打开的文件

  • filename是 Claris Pro 或 FileMaker Pro 文件的名称。对于 Claris Go 和 FileMaker Go,文件名区分大小写,对于 Claris Pro 和 FileMaker Pro 则不区分。不需要文件名扩展名。

  • 脚本名称指定要运行的脚本的名称。脚本名称不区分大小写。

  • 脚本参数传递脚本参数到脚本名称。请参阅 Get (脚本参数)函数

  • 选项值指定脚本名称运行时如何处理运行的脚本。请参阅新建脚本情况下处理当前脚本的选项

  • 变量名称重复项编号指在“脚本名称”运行时,指定的本地变量,重复编号和值。您可以使用 & 符号将多个本地变量添加到 URL。请参阅使用变量

要使用 URL 打开文件:

  1. 在要使用的客户端机器上,启动 Web 浏览器。

  2. 按照上述第一部分 URL 格式,将文件的 URL 输入到浏览器地址栏中。

    • Claris 客户端:claris://{地址/}文件名

    • FileMaker 客户端:fmpXX://{{帐户:密码@}地址/}文件

要使用 URL 运行文件中的脚本:

  1. 按照上述步骤操作。

  2. ?script=脚本名称追加至 URL。

    您也可以如上所示添加其他 URL 参数。

注释 

  • 要允许 URL 运行脚本,用户帐户必须启用 fmurlscript 扩展权限。请参阅为权限集编辑扩展权限

  • 要允许使用 claris 或 fmp URL 打开托管的 App,用户必须在收到提示时单击打开。请参阅设置信任的主机和插件首选项

  • 如果 URL 中需要空格、斜杠 (/) 或任何其他特殊字符,请确保使用有效 URL 所需的适当百分比编码值替换这些字符。例如,将空格替换为 %20,或将斜杠替换为 %2F,或者使用 GetAsURLEncoded 函数

示例

  • 打开名为 My Addresses 的托管文件:

    claris://sales.example.com/My%20Addresses.claris
    fmp://sales.example.com/My%20Addresses.fmp12
  • 打开用户的 Documents 文件夹中名为 Clients 的本地文件,并运行名为 ListClients 的脚本:

    claris://~/Clients?script=ListClients
    fmp://~/Clients?script=ListClients
  • 使用 FileMaker Pro 19 打开名为 My Addresses 的托管文件,并指定帐户名称和密码:

    fmp19://MyAccount:MyPassword@sales.example.com/My%20Addresses
  • 在主机上打开名为 Clients 的文件,在恢复暂停的脚本(选项 3)后运行名为 ListClients 的脚本,指定 TopClients 的脚本参数和值为 10 的局部变量 $NumberToList:

    claris://sales.example.com/Clients?script=ListClients&param=TopClients&option=3&$NumberToList=10
    fmp://sales.example.com/Clients?script=ListClients&param=TopClients&option=3&$NumberToList=10
  • 从打开的名为 Clients 的文件中运行脚本 ListClients:

    claris://$/Clients?script=ListClients
    fmp://$/Clients?script=ListClients
  • 在计算中,创建 URL 以在主机上打开名为 Clients 的文件,并运行名为 ListClients 的脚本,指定脚本参数 percent-encoded:

    "claris://sales.example.com/Clients?script=ListClients&param=" & GetAsURLEncoded ( "a/b" )
    "fmp://sales.example.com/Clients?script=ListClients&param=" & GetAsURLEncoded ( "a/b" )