FileMaker Pro 可以从您的电子软件下载 (ESD) 页面或 Claris Customer Console下载新安装和主要版本升级。次要版本更新可在 FileMaker Pro（帮助>检查更新）或更新页面中获得。有关更多信息，请参阅 FileMaker Pro安装指南

版本 21.0.1 – 2024 年 6 月

新增功能和技术改进

人工智能脚本步骤和函数

新的 AI 脚本步骤和函数可帮助您更轻松地使用具有大型语言模型 (LLM) 的FileMaker Pro应用程序中的数据。除了从数据中获取嵌入向量的脚本步骤和各种实用函数外，“执行语义查找”脚本步骤还有助于使查找操作变得更加智能，而不仅仅是简单地查找关键词。

新的 AI 脚本步骤：

• 配置 AI 账户：根据给定模型提供商（或端点）和 API 密钥，按名称设置要使用的 AI 账户。

• 插入嵌入：将指定输入文本的向量表示输入到字段或变量中。

• 在搜索结果中插入嵌入：在搜索结果中每个记录的字段中插入一个值，该值具有指定字段内容的向量表示形式。

• 执行语义查找：在指定字段中执行语义查找，并对要使用的给定搜索文本和模型或对给定嵌入向量约束指定的记录集。

• 设置 AI 呼叫日志记录：控制 AI 呼叫的详细信息是否保存到日志文件中。

新的 AI 函数：

• CosineSimilarity：将两个嵌入向量之间的相似性返回为 -1（相反）与 1（相似）之间的数字。

• GetEmbedding：使用嵌入模型返回向量表示形式作为输入文本的容器数据。

• GetEmbeddingAsFile：将嵌入向量从文本格式转换为二进制容器数据。

• GetEmbeddingAsText：将嵌入向量从二进制容器数据转换为文本格式。

• GetTableDDL：以数据定义语言 (DDL) 格式返回指定为 JSON 数组的表摹本列表的表信息。

• GetTokenCount：返回指定文本的标记数。仅用于指导；模型使用的实际数可能会有所不同。

• Get(上一个使用的步骤标记)：返回最后一个 AI 脚本步骤中使用的标记。

除了这些新的脚本步骤和函数外，现有的机器学习脚本步骤和函数现在位于脚本工作区和指定计算对话框中新的“人工智能”类别中。

快速打开

• 为了更轻松地在 FileMaker Pro 中打开您的创作，现在“快速打开”框可以：

  • 打开最近和个人收藏的 FileMaker Pro 文件。

  • 在所有打开的文件中搜索布局和脚本。

  • 在任何模式下以及脚本编辑器菜单处于活动状态时都可以访问。

  • 如果您按住 Alt 键 (Windows) 或 Option 键 (macOS)，则在新窗口中打开选定的布局。

  • 对所选脚本运行脚本（默认），或者，如果权限允许，打开脚本进行编辑。

• 为了更方便地打开“快速打开”框，其键盘快捷键已与布局模式下“字段”选项卡的快捷键互换：

  • 快速打开框：Ctrl+K (Windows)，Command-K (macOS)

  • 字段选项卡：Ctrl+Alt+K (Windows)，Command-Option-K (macOS)

请参阅使用“快速打开”框。

脚本步骤增强

• “使用回调在服务器上执行脚本”脚本步骤现在包括：

  • “状态”选项，用于指定回调脚本是否应暂停、恢复、退出或停止当前运行的脚本。这提供了与通过其他方法启动的脚本相同的选项。

  • “按名称”选项通过计算指定回调脚本名称，以便更轻松地自定义脚本流。

  请参阅“使用回调在服务器上执行脚本”。

• “执行 FileMaker Data API”脚本步骤现在支持：

  • 写入操作以修改记录数据。在请求中，将 action 键设置为 create、update、delete 或 duplicate 值。

  • 像其他脚本步骤一样，通过 Get(上一个错误)、Get(上一个错误详情)、Get(上一个错误位置) 函数返回适当的错误信息。

  • 覆盖“允许用户在数据输入期间覆盖”验证选项。在请求中，将新的 options.entrymode 键设置为 user（遵循验证规则）或 script（覆盖验证规则）。

  请参阅“执行 FileMaker Data API”。

• “配置本地通知”脚本步骤现在支持：

  • 在 FileMaker Pro 中运行（以前仅在 FileMaker Go 中支持）。

  • 当 FileMaker Go 在前台时显示通知（仅在 FileMaker Go 中支持）。使用新的“当 App 在前台时显示”选项。

  请参阅配置本地通知。

• 现在，FileMaker WebDirect 和 FileMaker Data API 运行的脚本支持“设置错误日志记录”脚本步骤，以帮助您快速识别和解决问题。请参阅设置错误日志记录。

• 子脚本现在支持“恢复事务处理”脚本步骤，以帮助您简化使用事务处理的脚本。有关对嵌套事务处理的改进支持的更多信息，请参阅打开事务。

• “从 URL 插入”现在支持 --aws-sigv4 cURL 选项。当文件由 Ubuntu 20 上的 FileMaker Server 托管时，不支持此选项。请参阅支持的 cURL 选项。

• “将副本另存为附加组件包”脚本步骤不再预览，并已添加到 FileMaker Pro 帮助中。请参阅将副本另存为附加组件包。

函数

新函数：

• 新的 JSONMakeArray 函数将一系列值转换为 JSON 数组，同时指定行分隔符和要使用的 JSON 数据类型。请参阅 JSONMakeArray。

• 在 macOS、iOS 和 iPadOS 中，新的 GetLiveTextAsJSON 函数返回容器字段中提供的图像中找到的文本，类似于 GetLiveText 函数。然而，此函数返回每行单独的文本及其在图像中位置的 JSON 数据。请参阅 GetLiveTextAsJSON。

函数增强：

• JSON 函数的语法改进：

  • 要使用 JSONSetElement 函数轻松地将元素附加到数组中，您现在可以在 keyOrIndexOrPath 参数中使用 "[+]" 来表示当前数组末尾的下一个元素。例如，这在 $$jsonArray 中现有数组的末尾添加了两个元素：

    复制

    JSONSetElement ( $$jsonArray ;
        [ "[+]" ; "Claris" ; JSONString ] ;
        [ "[+]" ; "FileMaker" ; JSONString ]
    )
    

  • 为了轻松引用当前 JSON 数组中的最后一个元素，您现在可以在任何 JSON 函数的 keyOrIndexOrPath 参数中使用 "[:]"。例如：

    • JSONGetElement ( "[1, 2, 3, 5]"; "[:]" ) 返回 5。

    • 这使用 "[+]" 语法创建一个包含一个元素的数组，然后通过引用 "[:]" 语法向该元素添加另一个键值对：

      复制

      JSONSetElement( "[]"; 
          ["[+].a", 5, JSONNumber] ; 
          ["[:].b", 6, JSONNumber]
      )

      返回：

      [ { "a":5, "b":6 } ]

    请参阅使用 JSON 函数、JSONSetElement 和 JSONGetElement。

• 随着 iOS 17、iPadOS 17 和 macOS Sonoma 中添加了对泰语和越南语实时文本的支持，GetLiveText 和 GetLiveTextAsJSON 函数现在也支持这些语言。请参阅 GetLiveText。

布局

• Web 查看器现在支持 FileMaker Pro 中的 Web 实时通信 (WebRTC)（在 FileMaker Go 中不支持）。要使 Web 查看器使用 WebRTC，当 FileMaker Pro 首次启动时，用户需要授予对相机和麦克风的访问权限。

应用程序

• macOS：窗口菜单现在显示最小化的 FileMaker Pro 窗口的图标。

• Windows：在“管理布局”对话框、布局模式下的“字段”选项卡和“脚本工作区”等区域使用搜索框时，性能得到了改进。

• Windows：所有对 Microsoft Edge WebView2 运行时的引用都已更新到同一版本，以获得更一致的体验。

• 文件路径中现在支持变量中的重复。例如，$path[2] 可以设置为文件路径，并在如“导出字段内容”等脚本步骤中使用它，这些步骤需要路径信息：

  复制

  设置变量 [ $path[2]; 值: Get ( 桌面路径 ) & "test.pdf" ]
  导出字段内容 [ Table::Container ; "$path[2]" ; 自动打开 ; 创建文件夹: 是 ]

• import.log 文件现在包括在复制或导入值列表和主题时出现问题时的错误信息。

• 在“管理数据库”对话框中，关系图现在支持深色模式。

• 在脚本以完全访问权限运行时，从脚本中删除间接更改数据库架构的功能。

• 所有 Claris FileMaker 2024 产品都有一个新的图标。在应用程序、安装程序、.fmp12 文件图标等中查找它。

  

安装程序 (Windows)

• Windows：FileMaker Pro 安装程序附带的 Microsoft Edge WebView2 Runtime 安装程序已更新到版本 118.0.2088.76。如果已经安装了更高版本，则此版本的 WebView2 安装程序无法运行。

• Windows：FileMaker Pro 安装程序目前在现有的 Bonjour 安装上安装了更新的 Bonjour。

另存为 XML

当使用“将副本保存为 XML”保存 FileMaker Pro 文件时：

• 自定义图标的每个实例的图像数据都单独保存在 XML 文件中。现在，图像只存储一次，并由每个实例引用，这可以减少文件大小和复杂性。

• 布局对象、脚本步骤和自定义菜单项现在包含了哈希值，这使得检测它们何时发生变化变得更加容易。

更新的库和软件包

• Xerces XML 解析器库已替换为 libxml2，Xalan XSLT 处理器库则替换为 libxslt。请参阅XML 格式。

  • 作为 libxml2 和 libxslt 替换的一部分，还支持 EXSLT 的扩展。请参阅 exslt.github.io。

• OpenSSL 已升级至版本 3.0.11。

• OmniOrb 已更新到 4.3.2 版。

问题修复

脚本步骤

• Windows：当“从 URL 插入”脚本步骤与以 file:// 开头并包含任何 Unicode 字符的有效 URL 一起使用时，脚本步骤返回了“连接失败”错误。

• 将“从 URL 插入”脚本步骤与 --proxy cURL 选项及 HTTPS 代理服务器一起使用时，返回一个错误，提示代理的 SSL 证书名称与最终目的地不匹配。

• 在 action 键设置为 create 或 update 后使用“执行 FileMaker Data API”脚本步骤时，为 dateformats 键指定值返回了错误。

• 当运行引用以冒号结尾的字段的“执行 FileMaker Data API”脚本步骤时，FileMaker Pro 意外退出。

• 附加组件中的“发送事件”脚本步骤导致在导出并重新导入附加组件后返回错误 100。

• 当系统通知被禁用时，“配置本地通知”脚本步骤无法运行，并且无法在脚本参数中发送 "NotificationNotAllowed" 值。

• 在运行将“刷新”选项设置为“延迟”并执行循环脚本步骤的脚本后，相关字段并不总是按预期显示或刷新数据。

函数和计算

• 删除记录时，Get(修改的字段) 不一定返回非空字段列表。

• 高精度比较数字有时会错误地导致等效数字被求值为不同的数字。

• 在某些情况下，在包含 9 个或更多零的索引中引用重复字段会导致操作无提示地失败。

性能

• 文本缩短函数，如 Left 和 GetValue，比以前的版本慢。函数的内存减少更改现已调整，以提高性能。

• 当自定义函数以递归运行时，JavaScript 在 Web 查看器对象中运行缓慢。

布局

• macOS：在 Web 查看器中打开 Dropbox 时，会显示一个错误，指示您“更新浏览器以使用 Dropbox”。

• Windows：FileMaker Pro 中的 Web 查看器始终使用英语作为用户界面显示语言。现在，Web 查看器使用 Windows 设置应用程序中选择的 Windows 显示语言。

• macOS：当数千个重复字段可见时，FileMaker Pro 停止响应。

• macOS：幻灯片控件中的条件格式不一定被评估。

• Windows：使用旧 enlightened_print 主题的布局打印速度很慢。

• 悬停状态样式通常不能正确应用于配置了占位符文本的字段。

• 当您单击包含对象（如控件或入口面板）中的布局计算时，单击布局计算外部会导致它向下和向右移动。

• 按字段名称而不是完全限定名称更新字段数据时，布局计算没有更新。

• 在设置为显示为隐藏编辑框的字段中，在计算中使用文本格式化函数的占位符文本在正常和悬停状态下没有正确格式化。

• 创建一个新的文本对象，然后单击拖动对象导致对象宽度更改为 0。

• 当“入口设置”对话框打开时，单行的入口大小增加了 1 个像素。

• 在信息亭模式下，布局的显示在某些情况下是垂直偏移的，以至于按钮的活动区域略高于按钮的可见区域。此外，在列表视图中，第一条记录最初在一定程度上向上滚动，掩盖了第一条记录。

安全

• 如果使用对某些表没有记录访问权限的账户登录 FileMaker Pro 文件，则当启用了授予完全访问权限的脚本运行时，数据查看器将处于活动状态。如果之前设置为监视依赖于受限表中数据的值，则数据查看器的“监视”选项卡会在脚本运行时显示受限制的数据。

应用程序

• 在某些版本的 FileMaker Server 或 FileMaker Cloud 托管的文件中，FileMaker Pro 阻止用户在“文件选项”对话框中进行更改。

• macOS：在“主机”对话框中，编辑最喜欢的主机并按下 Escape 键后，FileMaker Pro 会意外退出。

• macOS Sonoma：当 Stage Manager 打开时，在某些情况下，FileMaker Pro 窗口在您移动它们后会恢复到原始位置。

• 在“文件选项”对话框中选择以下任何选项后，数据库设计报告将它们列为“关闭”：

  • 允许存储的凭据用于身份验证

  • 需要 iOS 或 iPadOS 密码

  • 即使在 OAuth 或 AD FS 启用时也显示登录字段

  • 隐藏全部工具栏

• OnWindowTransaction 脚本触发器没有出现在数据库设计报告中。

• macOS：当六个以上的 OAuth 提供程序设置为登录托管的 FileMaker Pro 文件时，登录对话框中仅显示六个提供程序的按钮。

• macOS：当计算机设置为使用具有用户名和密码的代理服务器访问互联网时，如果打开了 HTTPS 隧道模式，则 FileMaker Pro 无法连接到互联网上的 FileMaker Server 主机。

• macOS：使用“帮助”>“检查更新”后，当没有可用的更新时，版本对话框错误地显示标题“更新错误！”以及“取消更新”按钮。

• macOS：退出具有多个窗口的 FileMaker Pro，布局模式下的两个窗格、管理布局对话框和检查器窗口全部打开，导致 FileMaker Pro 报告错误。

• macOS：以前，在“自定义函数”对话框中编辑函数后，使用“撤销”会撤销所有更改。现在，每次使用撤销只会撤销上一个更改，就像在其他计算对话框中一样。

• macOS：在“幻灯片控制设置”对话框中，当面板数量大时，面板计数被切断。

• macOS：如果脚本打开了“管理数据库”对话框，则在关系图中使用 Command-U 键盘快捷键时，FileMaker Pro 会意外退出。此外，关系图的键盘命令和加速器现在将发挥作用，而不是被忽略。

• macOS：当插件通过 FM_Text_Assign() API 传递无效的 UTF-8 数据时，FileMaker Pro 会意外退出。

• macOS Sonoma：在“布局”模式下对图片使用剪切命令 (Command+X) 时，FileMaker Pro 意外退出。

• macOS Sonoma：更改模式或重新打开文件导致自定义工具栏重置为默认值。

• macOS Sonoma：在状态工具栏中添加或删除项目后，在当前窗口中隐藏状态工具栏，然后打开另一个文件或创建文件，状态工具栏已重置为默认项。

• Windows：当窗口为默认大小时，OAuth 2.0 的“发送邮件”脚本步骤对话框隐藏了服务账户电子邮件选项的上边框。

• 当编辑“导入记录”脚本步骤导入顺序并选择文件类型但没有提供文件时，FileMaker Pro 显示错误，不允许您修改导入顺序。

• Windows：在检查器中粘贴多行计算会导致只粘贴第一行，其余行被截断。

• Windows：在“管理布局”对话框中调整列大小时，FileMaker Pro 会意外退出。

• 当使用具有“无访问”布局权限的账户登录时，如果您进入布局模式并将附加组件拖到布局，FileMaker Pro 会意外退出。

• 编辑字段时，即使字段没有因验证错误而修改，也会报告更改。

• 在保存布局之前，对象不会出现条件格式图标。

• 离开查找模式时，OnWindowTransaction 脚本触发器被错误地触发。

• 对于在“打开事务处理”和对应的“提交事务处理”或“恢复事务处理”脚本步骤之间提交的记录数据，错误地触发了 OnRecordCommit 和 OnRecordRevert 脚本触发器。

• 当多个文件引用一个外部数据源时，从索引插入对话框是空白的。

• 在脚本工作区中，某些脚本步骤末尾的齿轮图标有时被部分隐藏。

• macOS：在脚本工作区中快速重命名脚本或文件夹有时会导致 FileMaker Pro 意外退出。

• 如果用户在托管文件中编辑账户，则尝试同时编辑同一帐户的脚本步骤（例如，重置账户密码）失败，但 Get(上一个错误) 没有返回错误。现在，Get(上一个错误) 返回新的错误代码 310，以指示一个项无法修改，因为另一个用户正在修改它。

• 如果文件已经添加了 FileMaker 或 ODBC 外部数据源，则无法在关系图中从 Claris Studio 数据源添加表。

• 打开“修改表视图”对话框后，FileMaker Pro 意外退出，从那里打开关系图并单击相关表，然后在“修改表视图”对话框中添加相关字段。

• FileMaker Pro 无法通过导入文本文件文件夹来导入 XML 文件。带有 csv、tab、tsv、mer、htm、html、xml、svg、json、log、txt 扩展名的文件现在可以识别为文本文件类型。

• HEIF/HEIC 格式的图像作为文件而不是图像插入容器字段。

• 输入升级许可证后，您可以指定许可证密钥，但不能指定早期限定版本的许可证文件。现在可以指定您收到的早期限定版本。

• 如果事件跨越多个月，则日历附加组件无法在结束月份显示事件。

• 克隆使用简单图表附加组件的文件后，在某些情况下，附加组件的设置对话框是空白的。也就是说，如果附加组件添加到十进制分隔符是句号的系统上的原始文件中，但克隆的文件是在十进制分隔符是逗号的系统上打开的。

• 在将具有指定自定义菜单集布局的附加组件添加到包含相同名称的自定义菜单集的 FileMaker Pro 文件后，该附加组件的自定义菜单集名称在“管理自定义菜单”对话框中按预期更改，以使用不同的名称。但在“管理布局”对话框中，附加组件布局的“菜单集”列显示文件而不是附加组件的菜单集名称。

另存为 XML

使用“将副本另存为 XML”保存 FileMaker Pro 文件时：

• 没有开始序列的 "]]>" 的 XML CDATA 终止序列导致 FileMaker Pro 意外退出。

• Field 元素在 XML 文件中包含不必要的 DefaultStyle 属性。

• 一个设置为验证值作为值列表成员的字段，但没有指定值列表，缺少 XML 文件中的 ValueListReference 元素。

• 在某些情况下，执行脚本的自定义菜单项被错误地保存在 XML 文件中。

• 将操作设置为“不执行任何操作”的按钮为 XML 文件中的按钮产生了不必要的操作元素。

• 位于另一个对象（例如，弹出窗口或面板控件）中的按钮栏中的按钮在 XML 文件中多次出现。现在，该按钮只出现一次，这可以减少文件大小和复杂性。

• 与自定义菜单集关联的布局不包含对自定义菜单集的引用。

• 外部数据源中相关表中字段的合并字段生成了 XML 文件中属性无效或为空的 TableOccurrenceReference 元素。

• 工具提示元素缺少子计算元素。

• ScriptTrigger 元素引用了不正确的脚本触发脚本。

• 布局上合并字段的 FieldReference 元素没有名称和 UUID 属性的值。

• 可用菜单命令设置为仅编辑的特权集被错误地表示为设置为所有。

• 为任何新表设置自定义权限时，使用与现有表设置的 XML 结构不同的 XML 结构。现在，任何新表的 XML 结构都与现有表相同。

• 当值列表来自缺失的文件时，需要对值列表进行验证的字段元素中没有 ValueListReference 元素。现在，在这种情况下，字段元素包括 ValueListReference 元素。ValueListCatalog 元素中的相应值列表现在只包含 id、名称、UUID 和源类型。有关值列表的详细信息现在存储在新的 OptionsForValueLists 元素中。

删除的功能

• macOS：由于 macOS Sonoma 已经删除了对 Encapsulated Postscript (.eps) 图像的支持，FileMaker Pro 不再支持从该版本的 macOS 开始的EPS图像。Windows 中仍然支持 EPS 映像。

已知问题

• 在“指定计算”对话框中编辑布局计算并单击“确定”时，混合或大写函数名称不会按标题大小写重新格式化。

版本 20

不推荐使用的 API、技术或功能

随着 FileMaker Pro 的发展，一系列支持的技术、API 和功能将会随之改变。从发展的一方面而言，某些操作系统版本，硬件和功能可能会不受支持，推荐使用较新的操作系统版本，硬件和功能。不推荐使用并非意味着立即删除，而应当在解决方案中减少使用，因为在未来的产品版本中这些技术可能会被移除。

有关不推荐使用的 API、技术和功能的最新信息，请查看知识库。

法律信息

© 2024 Claris International Inc. 保留一切权利。

Claris 法律信息文档

有关更多信息，请参阅 FileMaker Pro 帮助、其他文档和支持资源。