关于持久化数据存储
持久化数据存储是一组命名值,作为架构的一部分保存在 FileMaker Pro 文件中,而不是作为记录数据保存。与临时存储在内存中且特定于用户的变量不同,持久化数据存储中的条目在明确删除之前在 FileMaker 会话中仍然可用,并且文件的所有用户都可以访问。
持久化数据存储中的每个条目都包含以下内容:
-
名称:条目名称的文本。
-
实例 ID:一个额外的文本标识符,可用作命名空间或所有者标识符,用于对具有共同目的的条目进行分组。例如,您可以使用相同的实例 ID 来识别附加组件的特定实例使用的所有命名条目。
名称和实例 ID 的组合唯一标识了文件持久化数据存储中的条目。
-
数据:任何 FileMaker 数据类型的值,包括文本、数字、日期、时间、时间戳或容器等。
何时使用持久化数据存储
在需要存储以下内容时使用持久化数据存储:
-
有关您文件的版本号或其他元数据
-
在不同会话中持续的附加配置设置
-
用于网页查看器的 JavaScript 库或其他资源
-
在多个脚本之间共享的 AI 模型提示
-
跨脚本共享的脚本数据供所有用户使用,无需使用全局字段
如何访问持久化数据存储
要使用持久化数据存储,请使用:
-
配置持久化数据脚本步骤:在持久化数据存储中设置或删除条目。
-
GetPersistentData函数:返回由名称和实例 ID 指定的持久化数据值。
-
ListPersistentDataIDs函数:返回持久化数据存储中具有指定名称的条目的实例 ID 列表。在检索数据之前需要检查哪些实例存在时使用。
注释
-
持久化数据存储只能在当前文件的上下文中访问。
-
连接到该文件的所有用户共享相同的持久化数据存储。一个用户所做的更改立即可供所有其他用户使用。
-
克隆文件时,克隆中包含持久化数据存储条目。请参阅保存和拷贝文件。
-
使用 FileMaker 数据迁移工具时,持久化数据存储不会复制到目标文件,因为持久化数据存储不是记录数据。请参阅 FileMaker 数据迁移工具指南。
-
处理现有条目时,名称和实例 ID 不区分大小写。