配置持久化数据

在持久化数据存储中设置或删除条目。

另请参阅 

选项 

  • “名称”是指定持久化数据条目名称的文本。名称不能为空。

  • “实例 ID”是一个可选的文本表达式，可用于识别条目的特定实例。多个条目可以具有相同的名称和不同的实例 ID。

  • “值”是存储数据的表达式。存储值时，数据类型会被保留。

  • “删除条目”将删除指定的条目。

兼容性 

产品 是否支持
FileMaker Pro 是
FileMaker Go 是
FileMaker WebDirect 是
FileMaker Server 是
FileMaker Cloud 是
FileMaker Data API 是
自定义 Web 发布 是

原始版本 

26.0

说明 

如果已存在具有指定名称和实例 ID 的条目，则此脚本步骤将更新其值或删除该条目，具体取决选择的是“值”还是“删除条目”。如果条目不存在，指定“值”会创建条目。请参阅关于持久化数据存储。

注释 

  • 要检索条目的值，请使用 GetPersistentData函数。

  • 由于计算公式的大小有限（请参阅 FileMaker Pro 技术限制），您无法在“值”选项中输入超过该限制的文本值。要指定大于此限制的文本值，请引用包含“值”选项数据的字段或变量。要首先将文本输入到字段或变量中，您可以使用脚本步骤，例如插入文本（用于存储在脚本步骤本身中的文本）、从 URL 插入（用于通过 URL 提供的文本）或读取数据文件（用于本地文件中的文本）。

  • 实例 ID 可以是未指定的（空白）或空字符串 ("")。

  • 未指定的（空白）实例 ID被视为空字符串 ("")。

  • 删除不存在的条目将返回错误代码 10 ("缺少所需数据")。

示例 1 

在当前文件的持久化数据存储中，将一个简单的版本号存储到名为 AppVersion（无实例 ID）的条目中。

复制 
配置持久化数据 [ AppVersion ; 值: "2.1.0" ]

要阅读此条目，请参阅 GetPersistentData函数的示例 1。

示例 2 

使用附加组件的实例 ID 存储附加组件的多个配置值。

复制 
设置变量 [ $instanceID ; 值: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
配置持久化数据 [ com.claris.myaddon.theme ; 实例 ID: $instanceID ; 值: "Dark" ]
配置持久化数据 [ com.claris.myaddon.language ; 实例 ID: $instanceID ; 值: "en" ]
配置持久化数据 [ com.claris.myaddon.modificationdate ; 实例 ID: $instanceID ; 值: Get ( CurrentTimestamp ) ]

示例 3 

按名称和实例 ID 删除特定的持久数据条目。

复制 
设置变量 [ $instanceID ; 值: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
配置持久化数据 [ com.claris.myaddon.theme ; 实例 ID: $instanceID ; 删除 ]

相关主题