Claris FileMaker WebDirect 19 指南

本指南提供了关于为 FileMaker WebDirect 设计定制化 App，以及使用 FileMaker Server 或 FileMaker Cloud 托管定制化 App 的信息。

本指南所用术语：

• 在 Web 上发布：用户可以在 Internet 或 Intranet 上使用 Web 浏览器访问的定制化 App
• Web 用户：使用 FileMaker WebDirect 操控在 Web 上发布的 FileMaker Pro 定制化 App 的人员
• 定制化 App、数据库、文件：FileMaker Pro 构建以及 Web 用户通过 FileMaker WebDirect 访问的内容
• Admin Console - 是指 FileMaker Server 和 FileMaker Cloud 的 Admin Console（管理控制台），描述特定产品的情况除外。

如需其他文档，请访问产品文档中心。

Claris FileMaker WebDirect® 将 Web 应用和桌面应用程序相结合，将 FileMaker Pro 的功能引入到 Web 版的定制化 App。使用 FileMaker WebDirect，您可以：

• 无需任何 Web 编写工具或其他技术，轻松快捷地使用兼容的 Web 浏览器，面向任何人员部署定制化 App

• 通过最新的浏览器访问数据

• 导入或导出记录和容器数据

• 通过隐藏和锁定菜单栏和状态工具栏，部署自定义 Web 应用程序

FileMaker WebDirect 基于高级 Web 技术而开发，支持定制化 App 在当代 Web 浏览器的限制下完成大部分 FileMaker Pro 可以执行的操作。

在以下用途中，FileMaker WebDirect 表现堪称完美：

• 部署主要用于 Web 浏览器的 FileMaker 定制化 App

• 扩展现有的定制化 App，将团队或组织外的远程用户纳入其中

  对于特定的组群用户，您可以仅添加或修改用户需要的布局。例如，如果仓库工人仅需要完成订单管理定制化 App 中的订单，则您可能只需要添加在浏览器中正常使用的发票布局。

如果您想要面向 Web 用户扩展现有定制化 App，则应计划对定制化 App 进行调整更改，以尽可能实现最佳用户体验。尽管您可能需要使用 FileMakerPro 对定制化 App 进行一定的更改，但不需要写任何 PHP、HTML、CSS 或 JavaScript 代码。

FileMaker WebDirect 在 Web 浏览器中运行，并使用以下标准的 Web 技术：

• HTML5，用于定义页面结构

• CSS3，用于控制页面外观

• JavaScript，支持交互（例如，点击按钮）

• HTTP/HTTPS 和 WebSocket 协议，用于在 Web 浏览器和 Web 服务器间进行通信

HTML5 和 CSS3 在各 Web 浏览器中实现的效果不尽相同。根据 Web 浏览器遵从这些标准方式的不同、浏览器 JavaScript 引擎的执行方式的不同以及浏览器分析和渲染 CSS 方式的不同，FileMaker WebDirect 定制化 App 的运行方式也会有所不同。

FileMaker WebDirect 结构

FileMaker WebDirect 的结构连接两个不同的环境：Web 浏览器和 FileMaker 定制化 App。在 Web 浏览器中，FileMaker WebDirect 作为客户端运行，与通过 FileMaker Server 或 FileMaker Cloud 托管的定制化 App 进行交互。

FileMaker Server 和 FileMaker Cloud 包括以下组件:

• 数据库服务器：托管与所有 FileMaker 客户端共享的定制化 App（FileMaker Pro、Claris FileMaker Go® 和 FileMaker WebDirect）。该服务器处理布局、数据、脚本、脚本触发器、用户帐户验证、记录锁定以及与所有 FileMaker 客户端的通信。
• Web 发布引擎：将布局、交互以及由定制化 App 定义的数据转换为 HTML5、CSS3、JavaScript 和适用于 Web 浏览器的数据，并处理用户交互。Web 发布引擎(WPE)可以实时在布局中创建用户界面，以便在 Web 浏览器中运作，并处理脚本、脚本触发器、用户单击和按键操作。在 FileMaker Server 多设备部署中，WPE 管理一级服务器与二级服务器之间的通信。
• Web 服务器：使用 HTTP/HTTPS 和 WebSocket 协议与 Web 浏览器通信，从而将定制化 App 作为 Web 应用程序来使用。

FileMaker WebDirect

Web 服务器

Web 发布引擎

FileMaker 数据库服务器

一级服务器

FileMaker Server
单设备部署
或
FileMaker Cloud 部署

FileMaker WebDirect

Web 服务器

Web 发布引擎

FileMaker 数据库服务器

一级服务器

FileMaker Server
多设备部署

Web 服务器

Web 发布引擎

二级服务器

Web 服务器

Web 发布引擎

二级服务器

FileMaker Cloud 可以在 Internet 上托管数据库，而 FileMaker Server 可以在 Internet 或 Intranet 上托管数据库。

此外：

• 在使用 TCP/IP 不间断地连接 Internet 或 Intranet 的电脑上发布数据库。

• 主机应该具有专用的“静态”（永久）Internet 协议 (IP) 地址或域名。

• 当 Web 用户连接到 FileMaker WebDirect 定制化 App 时，应使用具备稳定连接性和 150 毫秒或更少延迟的以太网、Wi-Fi 或移动（4G 或 LTE）网络。失去网络连接（可能是由于间歇信号或切换网络造成的）可能会导致 FileMaker WebDirect 客户端从服务器断开。

• 使用安全套接层(SSL)加密，以保证 FileMaker WebDirect 与 FileMaker Server 或 FileMaker Cloud 之间的通讯安全。

• 要使用 FileMaker WebDirect，必须启用 Cookies 和 JavaScript，并且允许弹出窗口。

尽管 FileMaker WebDirect 与 FileMaker Pro 非常相似，但其并不具有 FileMaker Pro 客户端的所有功能。

• Web 用户可以选择布局和不同的布局视图，但是他们无法添加、删除或修改字段、布局、脚本、关系、值列表或其他数据库架构。

• FileMaker WebDirect 不支持“表视图”。不支持可以将视图更改为“表视图”的脚本步骤或脚本步骤选项。如果布局的默认视图为“表视图”，则会在其他视图中显示布局。如果未启用其他视图，则会在“列表视图”中显示布局。

• FileMaker WebDirect 不允许用户选择位于其他布局对象之后的对象，即使位于最上层的对象透明或用户在对象组中单击空白空间。不堆迭多个对象，您可以：

  • 为选项卡标签使用计算值

  • 将图标添加到按钮，而不是在按钮最上层堆迭图像

  • 将多个对象进行组合并将按钮设置应用到组合

• FileMaker WebDirect 提供有限的文本样式。不支持高亮显示、段落文本样式和制表位。FileMaker WebDirect 仅支持 Web 浏览器支持的富文本。仅限为按钮和布局文本应用富文本。对于字段，FileMaker WebDirect 中仅显示用于对象样式的富文本格式。Web 用户无法输入带有富文本格式的数据。在 FileMaker WebDirect 中编辑字段时，可以删除任何现有的富文本格式。

• FileMaker Pro 自定义菜单不支持 FileMaker WebDirect 定制化 App。

FileMaker WebDirect 的性能受以下因素影响：

• Web 用户设备的处理性能

• 并发访问定制化 App 的 Web 用户数量

• Web 用户网络连接的质量

• FileMaker Server 或 FileMaker Cloud 和 Web 浏览器之间传输数据的数量

• Web 浏览器与 FileMaker Server 或 FileMaker Cloud 通信的频率；每当出现以下情况时，通信就会发生：

  • 记录被创建、打开、提交或删除

  • 当前记录被更改

  • 布局被更改

  • 计算方式被评估

  • 脚本被执行

  • 脚本触发器被激活

提升您的 FileMaker WebDirect 定制化 App 性能：

• 尽量避免在布局上使用以下各项：入口、面板控件、计算字段、合计字段、带有验证选项的字段、带有数据格式选项的字段、脚本触发器、列表视图和工具提示。

• 保持适用于 Web 使用的图像大小。

• 选择或创建简单主题，例如不使用渐变或图像切片的主题。

• 创建自定义主题和自定义样式，而不是覆盖现有主题和样式。

• 减少每个布局对象上使用的对象状态。

• 尽量避免使用条件格式化。

Web 用户会通过具有不同屏幕大小和分辨率的移动设备访问 FileMaker WebDirect 定制化 App。要为手机浏览器提供最佳体验，请确定您的定制化 App 所适用的目标设备，并设计您的定制化 App 以适应每种设备。

• 为一定范围内的设备中的所有最小设备都设计一种布局，并根据 Web 浏览器的高度和宽度配置布局对象的自动调整大小选项，以便进行调整。

  • 在某些移动浏览器中，如果布局大于移动设备的可查看区域，则用户可能无法查看靠近布局底部边缘的对象。
  • 在 iOS 和 iPadOS 设备上，如果用户放大屏幕上的图像，状态工具栏和一些布局元素可能会无法访问。
  • 在 Android 设备上，布局元素的大小始终固定不变。用户无法放大或缩小。

• 如果浏览器尺寸更改为比特定高度或宽度更大或更小（例如当手机浏览器更改方向时），则请使用 OnLayoutSizeChange 脚本触发器更改布局。

• FileMaker WebDirect 不支持保存快照链接、导入记录、导出记录或从手机浏览器中导出容器字段内容等等。

如果您要显示自己的界面来执行任务，可以在文件打开时隐藏菜单栏和状态工具栏。

要禁止显示 FileMaker WebDirect 控件，在 FileMaker Pro“文件选项”对话框中设置菜单栏和状态工具栏在默认情况下隐藏。请参阅 FileMaker Pro 帮助。

对于多文件定制化 App，必须在每个文件中禁止显示 FileMaker WebDirect 控件。

除了输入或修改数据，您的定制化 App 可能会要求 Web 用户执行其他任务。

Web 用户应当通过打开菜单栏然后单击“关闭文件”来正确地关闭其会话，这是很重要的。

• 如果他们在关闭文件之前关闭浏览器窗口或退出浏览器，则他们的会话仍会处于打开状态，这可能会导致：

• 在已达到连接个数限制时阻止其他用户打开定制化 App

• 阻止定制化 App 运行分配给脚本触发器的脚本

• 导致脚本持续运行直到出现指定的超时，可能会导致意外结果

• 使数据易受黑客的攻击，直到连接超时

• 如果 Safari 浏览器中的一个不活动的浏览器选项卡上留有一个闲置的 FileMaker WebDirect 会话，那么会话超时之前该会话可能无响应。

• 如果在关闭文件之前锁定或关闭设备，会话可能会无响应。

• 如果在关闭文件之前关闭浏览器，任何未提交的更改都将被还原。

要避免这种情况，可以设置会话在短时间内超时，或者创建脚本化按钮，以便安全地关闭文件。请参阅使用虚拟窗口。

注释：如果隐藏了菜单栏，请创建脚本化按钮以关闭文件。请参阅隐藏菜单栏和状态工具栏。

一些函数、脚本和脚本触发器在 FileMaker WebDirect 中不受支持或与在 FileMaker Pro 中执行的任务不同。在您的定制化 App 中预览所有计算方式和脚本以确保其正确地执行任务。

有关单个函数、脚本步骤和脚本触发器，请参阅 FileMaker Pro 帮助。

除了 Web 用户输入的数据，FileMaker WebDirect 定制化 App 还可以访问外部 ODBC 和 FileMaker 数据源。

要在 Web 上发布 FileMaker Pro 定制化 App 作为 FileMaker WebDirect 定制化 App，请使用 FileMaker Pro 来确定哪些用户帐户可以通过 Web 浏览器访问定制化 App，以及将定制化 App 上传至 FileMaker Server 或 FileMaker Cloud。

要更改 FileMaker WebDirect 的设置，请在具有托管您的定制化 App 的 FileMaker Server 或 FileMaker Cloud 部署网络访问权限的设备上运行 Admin Console。请参阅 FileMaker Server 帮助和 FileMaker Cloud 帮助。

Web 用户通过 FileMaker WebDirect 启动中心、Claris Customer Console、HTML 网页或自定义主页访问 FileMaker WebDirect 定制化 App。

• FileMaker WebDirect 不支持手势或动作。
• 如果在连接 Web 用户的过程中修改定制化 App，可能会造成意外结果。例如，如果您将更改保存到某布局中，而这时 Web 用户正在“列表视图”中进行显示，则每个 Web 用户的当前记录都会更改为搜索结果中的第一个记录。
• 使用在所有目标操作系统中都有安装的字体。如果某种字体不可用，则 Web 浏览器会使用其默认字体作为替代。
• 对象和组合对象不应存在于多个布局部分中。如果某个对象或对象组存在于多个部分，则它仅在其定位的布局部分中显示。
• 当用户向入口输入字段时，入口中的记录在用户离开该字段后才会更新。
• 为了能够识别“列表视图”中的当前记录，可将活动对象状态样式应用到布局的正文部分。“列表视图”不支持当前记录标记符。
• 不支持高亮显示、上标和下标条件格式化选项。下划线、文本下划线和双下划线都会显示为常规下划线。
• 以下布局对象不支持工具提示：文本、图像、不允许输入的字段、合并字段、合并变量、入口、图表和不允许交互的 Web 查看器。
• FileMaker WebDirect 会根据系统偏好设置显示滚动条。FileMaker WebDirect 不支持“入口设置”对话框中的显示滚动条选项。
• 如果 FileMaker WebDirect 无法检测到或不支持 Web 浏览器语言，FileMaker WebDirect 以英语显示其界面、工具提示和对话框。

每个 FileMaker Server 和 FileMaker Cloud 部署都限定了最大连接数。达到最大连接数时，其他 Web 用户如果尝试打开定制化 App，则会在 Web 浏览器中看到错误信息。

• 如果您认为 FileMaker Server 或 FileMaker Cloud 达到最大连接数的情况出现异常，则可能有 Web 用户没有正常退出定制化 App。您可以等待会话超时，或关闭文件以断开所有用户与定制化 App 的连接，或通过 Admin Console 断开特定用户。请参阅 FileMaker Server 帮助和 FileMaker Cloud 帮助。

• Web 用户应避免从多个浏览器窗口或同一浏览器窗口的多个选项卡打开同一定制化 App。每个浏览器窗口或选项卡都会占用一个 FileMaker Server 或 FileMaker Cloud 连接，这会使服务器很快达到连接数的上限。请参阅使用虚拟窗口。

• 手机浏览器不支持“始终在入口中显示垂直滚动条”的选项。

• 手机浏览器不支持工具提示。

• 仅当用户单击字段时，移动浏览器才会显示屏幕键盘。

• 容器字段中的 PDF 文件不支持交互操作。在 iOS 和 iPadOS 设备上，容器字段仅显示 PDF 的第一页。在 Android 设备上，点按容器字段中的链接即可在新的 Web 浏览器窗口中查看 PDF。要与容器字段中的 PDF 交互，请在 Windows 或 macOS 中打开定制化 App。
• 在 iOS 和 iPadOS 设备上，应禁用“请求桌面网站”浏览器设置。

• 如果某字段使用系统格式来显示数据，则 FileMaker WebDirect 会使用创建定制化 App 时的位置所适用的默认系统格式。默认系统格式影响字段、合并字段和验证消息中的日期、时间和时间戳格式。

• 以下功能在字段中不受支持：自动完成（预键入）、竖式书写文本、由 FileMaker Pro 设置的输入方法和行间距。

• FileMaker WebDirect 只能访问托管在同一服务器上的文件中的字段。

• 所有记录上都会显示字段边框和填充。“布局设置”对话框中的仅为当前记录描绘字段选项不受支持。

• 告知用户避免在文本字段中添加前置或后缀空格，因为在 FileMaker WebDirect 中打开定制化 App 时文本字段中可能无法显示数据。如果附加空格是必要的，请确保文本字段长度足以容纳附加空格，或者可以为文本字段添加一个滚动条。

• 隐藏的编辑框通常显示与字段中实际字符个数相同的隐藏字符，不会将回车符显示为隐藏字符。

• 复选框集和单选按钮集作为标准 HTML 控件来显示；不支持对象样式。如果它们被裁剪，请在 FileMaker Pro 布局上放大这些字段。
• 在弹出菜单和下拉列表中，web 用户无法使用“编辑”项或“其他”项来编辑值或将值添加到值列表。

• Web 用户可以将最大 300 MB 的文件插入到每个容器字段中。要插入大于 300 MB 的文件，请使用 FileMaker Pro。

• Web 用户可以在交互容器字段中使用最大 300 MB 的文件。如果文件大于 300 MB，则 Web 用户必须导出容器字段中的内容才能使用该文件。要在交互容器字段中使用大于 300 MB 的文件，请使用 FileMaker Pro。

• 要允许 Web 用户从容器字段中导出数据，在“编辑权限集”对话框中将“可用菜单命令”设置为“全部”。

• 尽可能避免为面板控件使用自定义样式。为面板控件使用自定义样式时，同一个布局的其他面板控件上也可能会显示该自定义样式（即使这些控件具有不同的样式）。
• 选项卡控件的选项卡标签上放置的对象显示在面板区域。
• 在定制化 App 中设计滑动面板时，请选择“滑动控件设置”对话框中的显示导航点，以允许 Web 用户使用滑动控件圆点在滑动面板之间进行导航。滑动控件不支持在 Web 浏览器中的各面板间轻扫浏览。作为一种选择，您可以定义脚本，以控制导航滑动面板的方式。

• 调整窗口大小时，不会调整弹出框的大小，所以在设计弹出框时，要考虑到 Web 浏览器窗口的大小。为了避免不理想的结果，请勿将浏览器窗口尺寸设置为比某个打开弹出框更小，或者将打开弹出框尺寸设置为比当前窗口更大。

• 用户在“列表视图”中滚动查看记录时，在其进入另一条记录之前弹出框不会关闭。

• 在“列表视图”中，按钮栏可能针对搜索结果中的每条记录提供不同的激活段。

• 调整按钮栏大小时，按钮栏会显示其默认激活段。

• FileMaker WebDirect 使用 iframe 来显示 Web 查看器页面。因此，iframe 的所有限制都适用于 Web 查看器页面。这种限制有时会导致某些网站在 FileMaker WebDirect 中访问的 Web 查看器内显示为空白。排除此问题的两个最常见原因：

  • 验证目标 URL 是否使用了与父页面相同的协议（例如 http 或 https）。例如，如果您的 FileMaker WebDirect 页面通过 https 进行访问，那么您的 Web 查看器页面的 URL 也应该以 https 开头，反之亦然。
  • 确保您的 Web 查看器指向一个允许其内容嵌入到其他网站的网站。例如，如果一个网站的 X-Frame-Options 响应头包含 X-Frame-Options: SAMEORIGIN，那么该网站的内容只能从托管在同一域的另一个网站的 iframe 中使用。
• 即使您清除了“Web 查看器设置”对话框中的“允许与 Web 查看器交互”复选框，Web 用户也可能会以限制的方式与 Web 查看器内容交互。即使将 Web 查看器定义为按钮，也会发生受限制的交互。
• 如果由 Web 查看器计算出的 URL 不包含冒号 (:)，FileMaker WebDirect 会将 http:// 方案添加到 URL 的开头。为了避免发生错误，在设置 Web 查看器时应在网址中包含适当的方案。
• FileMaker WebDirect 不支持“设置 Web 查看器”脚本步骤的“后退”和“前进”选项。要在 FileMaker WebDirect 的 Web 查看器中来回浏览，请在 Web 查看器中右键单击 (Windows) 或按住 Control 键并单击 (macOS)，然后选择“后退”或“前进”。如果布局具有多个 Web 查看器，快捷菜单只会使用最近从一个页面更改到另一个页面的 Web 查看器，而不一定是鼠标指针所在的 Web 查看器。
• FileMaker WebDirect 不支持内容是由 FileMaker WebDirect 自身发布的 Web 查看器。如果 Web 查看器的 URL 包含 /fmi/webd，则 Web 查看器中不显示任何网页。
• Web 查看器中的内容可能会对 FileMaker WebDirect 造成意想不到的影响。例如，URL（从字段数据计算出的 URL，或用户通过单击 Web 查看器中的链接指定的 URL）可以指定具有 target=top 属性的页面。此属性会使该页面替换 Web 浏览器窗口中的 FileMaker WebDirect。
• 随着操作系统厂商对安全问题不断地进行修补，他们可能会禁止某些功能，通常会同时修改用户 Web 浏览器内的安全设置。此类更改可能会禁止或更改 FileMaker WebDirect 中 Web 查看器的行为。告知用户如何更改浏览器中的安全设置，以让 Web 查看器正常工作，或确保 Web 查看器所使用的 URL 仅限于被信任的网页。

• 厚度值不是整数的对象边框向下取整到最接近的整数。厚度如果大于 0 点、但小于 1 点，则取整为 1 点。

• 如果在布局部分或布局背景中应用边框，请勿将对象放置在边框上。否则，重叠在边框上的对象部分将不会显示在 Web 浏览器中。

• 如果在布局部分或布局背景中应用图像扇区填充，请勿将布局对象放置在靠近布局部分或布局背景的图像段之上或附近。否则，布局对象可能会无法按预期显示。

• 要设定所显示对象内容到对象边框的距离，请更改对象的内边距。FileMaker WebDirect 不支持缩进。

• 要在对象组中隐藏某个对象，请对整个对象组应用隐藏条件。用户无法在对象组中单击位于隐藏对象后面的对象，除非整个对象组被隐藏。

• 如果为对象应用按钮设置和隐藏条件，则应最后应用隐藏条件。否则，在对象被隐藏后，用户可能无法单击位于应用了按钮设置的对象后面的对象。

• Tab 键顺序可能与 FileMaker Pro 中的 Tab 键顺序不同。不同浏览器可能以不同方式支持 Tab 键顺序。
• Web 浏览器中的 Tab 键顺序包括编辑框、隐藏的编辑框、下拉列表、弹出菜单、下拉日历、复选框集、单选按钮集和容器字段。
• 在“查找”模式中，Tab 键顺序不包含计算字段。
• iPadOS：如果您搭配 iPad Pro 使用智能键盘，则 Tab 键顺序可能无法正常运作。例如，您可以用 Tab 键切换到不在布局的 Tab 键顺序中的字段。

• 在 FileMaker WebDirect 定制化 App 中的每个文件中创建相同的帐户和密码。用户为第一个文件输入帐户和密码后，这些信息会用来验证相关文件。还必须为所有定制化 App 文件中的所有权限集启用 fmwebdirect 扩展权限。

• Web 浏览器无法在布局上显示另一个文件中的字段，除非 Web 用户也能访问该文件。基于其他文件中字段值的计算字段也同样受到该限定条件的制约。

• 当定制化 App 引用了受保护的未授权访问的相关文件时，Web 用户无法在 FileMaker WebDirect 中对受保护的文件进行访问授权。因此，当 Web 用户打开定制化 App 时，该文件将不包含受保护文件的任何数据。为避免此情况，请使用 FileMaker Pro 为引用受保护文件的所有文件进行授权。请参阅 FileMaker Pro 帮助。

• 当 FileMaker Server 部署重定向 Web 发布引擎 (WPE) 之间的 FileMaker WebDirect 连接时，URL 栏中显示的主机名更改以匹配目标 WPE 的主机名。参考特定 WPE 主机名的功能，例如 Web 查看器，会返回意外的结果。
• 如果 WPE 在部署中的某台设备上被禁用，并且某个用户使用该设备的 URL 访问 FileMaker WebDirect，该用户不会被重定向到可用的 WPE，也无法访问 FileMaker WebDirect。
• 如果二级服务器上启用了 WPE，用户可以通过二级服务器使用 FileMaker WebDirect 定制化 App，即便 FileMaker WebDirect 在一级服务器上被禁用。
• 如果您使用自定义主页或者为您的定制化 App 托管自定义 Web 内容，请确保在 FileMaker Server 部署中的全部 WPE 上托管所有自定义内容。否则，某些 WPE 可能无法访问或显示自定义内容。
• 在单独网页的 <iframe> 标记内显示 FileMaker WebDirect 内容可能会导致意想不到的结果。
• 要在多设备部署中使用 FileMaker WebDirect 的插件，请在一级服务器和所有二级服务器上均安装插件。