对于每个文档或活页夹,字段包含额外的详细信息和元数据,有助于对文档进行分类和管理。一些字段适用于所有文档(通过基础文档),而其他字段则适用于特定文档类型、子类型或类别。

访问文档配置

管理 > 配置 > 文档字段可访问字段配置选项。必须拥有管理员:文档字段权限才能编辑字段和创建新字段(称为自定义字段)。默认提供标准字段,且只允许细微修改。

创建文档字段

要创建新的文档字段:

  1. 字段位置列表显示文档类型层次结构。选择字段适用的文档类型、子类型和类别。
  2. 单击添加,然后选择新字段
  3. 选择字段类型,然后输入标签。面向最终用户,标签显示为字段名称。
  4. 设置字段选项。属性因字段类型而异。
  5. 单击保存

编辑文档字段

要编辑现有字段:

  1. 从字段列表中,单击字段标签。
  2. 单击编辑
  3. 进行必要更改,然后单击保存字段类型定义类型字段不可编辑。

文档字段属性

文档字段本身具有决定它们在应用程序中如何工作的字段(或属性)。一些属性仅适用于特定字段类型。

字段类型属性描述
全部标签整个 UI 中用来标识字段的标签,无需具有唯一性;限制为 40 个字符
全部名称公共 API 中使用的字段名称,当构建消息或公式时用作令牌;必须具有唯一性
全部状态决定字段是否可用于新文档
全部字段类型决定字段中数据的类型(文本、选项列表等)
全部帮助内容当用户将鼠标悬停在“文档信息”页面的字段名称上方时出现的有用文本。您可以利用它来定义字段类型或为用户输入的值提供指南。在多语言 Vault 中,您可以定义本地化帮助内容。此字段允许最多 255 个字符。
全部用户必须总是输入一个值(必需)决定在创建新文档时,Vault 是否要求用户为字段输入值
全部显示节段决定该字段出现在“文档信息”页面右侧面板中的具体节段
文本在进行复制的过程中不要复制此字段决定 Vault 在创建副本和创建演示文稿的文档操作过程中是否复制此字段的值;如果启用此设置,则 Vault 会应用字段的默认值(如已配置)。
文本最大长度允许的最大字符数;Vault 不允许超过 1500 个字符。
文本默认值Vault 自动填充的默认值
数字在进行复制的过程中不要复制此字段决定 Vault 在创建副本和创建演示文稿的文档操作过程中是否复制此字段的值;如果启用此设置,则 Vault 会应用字段的默认值(如已配置)。
数字最小值允许的最小值
数字最大值允许的最大值;此字段类型不支持大于 2,147,483,647 的值。如果对象引用类型字段的值大于 500,且允许用户选择多个值设置为 true,则 VQL 查询将返回无序列表。
数字小数位允许的小数位数。这也决定了 VQL 和格式化输出中的小数位截断。
数字默认值Vault 自动填充的默认值
选项列表在进行复制的过程中不要复制此字段决定 Vault 在创建副本创建演示文稿的文档操作过程中是否复制此字段的值;如果启用此设置,则 Vault 会应用字段的默认值(如已配置)。
选项列表使用现有的选项列表允许字段使用现有的选项列表,而非创建新的选项列表
选项列表允许用户选择多个值决定用户是否能从选项列表中选择多个值;一旦将字段设置为多选,就不能将其改回单选。Vault 支持每个高容量对象最多两 (2) 个多值选项列表。
选项列表选项列表值定义用户可以从选项列表中选择的选项;管理员也可以从选项列表页面修改可用选项。
选项列表默认值Vault 自动选择的默认选项列表选项
对象在进行复制的过程中不要复制此字段决定 Vault 在创建副本创建演示文稿的文档操作过程中是否复制此字段的值。
对象允许用户选择多个值决定用户是否能从对象选项列表中选择多个值;一旦将字段设置为多选,就不能将其改回单选。
对象对象定义用户可以从选项列表选择的对象产品等);不同于选项列表类型,对象类型字段允许 Vault 根据用户的选择自动填充其他字段。
对象可搜索字段定义搜索文档时,引用对象应包含的字段。例如,用户搜索文档时,可能希望搜索内容包含产品缩写字段,但不包含产品批准日期。大多数 Vault 都有 50 个可搜索对象字段的默认限制。
公式小数位定义公式字段中的小数位数。
公式公式定义公式字段中用于计算自定义指标的公式。
是/否在进行复制的过程中不要复制此字段决定 Vault 在创建副本创建演示文稿的文档操作过程中是否复制此字段的值;如果启用此设置,则 Vault 会应用字段的默认值(如已配置)。
是/否默认值Vault 自动选择的默认选项
URL在进行复制的过程中不要复制此字段决定 Vault 在创建副本创建演示文稿的文档操作过程中是否复制此字段的值;如果启用此设置,则 Vault 会应用字段的默认值(如已配置)。
URL默认值Vault 自动填充的默认值
查找查找对象字段查找字段的出站关系。这些字段通常以它们引用的对象命名。
查找查找源字段引用对象的一个字段(查找对象字段),Vault 在查找字段中显示该字段。

删除文档字段

要删除字段:

  1. 从字段列表中,单击字段标签。
  2. 单击删除。只有自定义字段会显示此按钮。不能删除标准字段,因为 Vault 需要它们才能正常工作。
  3. 单击确认对话框中的继续,以永久删除该字段。

禁用、删除和移除字段

禁用某个字段将使其无法在新文档中使用,但您可以在需要时再次激活它。它不会影响在字段被禁用之前创建的文档中的字段值,即使编辑文档的其他部分,该值也会保持不变。

删除字段意味着从配置中永久将其删除。Vault 会阻止您删除满足以下条件之一的字段:

  • 至少一个文档在该字段有相应的值。
  • Vault 配置中的其他部分(生命周期规则、工作流步骤、关系类型等)使用该字段。

当选择停止使用共享字段操作时,将从特定文档类型中移除共享字段(也叫作取消关联)。从文档类型中移除某个字段将使其无法在该类型的新文档中使用,还将在该字段有相应值的任何文档上隐藏该字段。当您编辑具有取消关联字段值的文档时,Vault 会清除该值,审计历史记录将显示,取消关联的字段值已从之前的值变为“”。

字段的自定义帮助

当使用字段的帮助内容字段定义自定义帮助文本时,用户可以在创建文档并与其交互时,将光标悬停在字段名称上方,以查看帮助文本。

默认值

您可以使用默认值属性或(对于选项列表)默认值复选框为文档字段定义默认值。此选项仅适用于文本数字URL是/否以及选项列表字段类型。设置默认值不适用于标准文本数字URL是/否字段;但适用于大多数标准选项列表字段。

当您定义默认值时,Vault 会在对文档进行分类时自动填充该值。这通常发生在文档创建过程中,但也可能发生在用户为未分类文档选择文档类型时。当用户使用重新分类操作时,Vault 不会填充默认值。

拥有编辑文档字段的正确权限才能修改默认值。

多选字段的排序顺序

在多选选项列表和对象引用字段中,Vault 按字母顺序对值进行排序。对于选项列表类型字段,Vault 根据用户添加选项列表值的 Vault 语言,按字母顺序对值进行排序。请注意,当您从管理 > 业务管理员 > 选项列表更改选项列表标签时,Vault 不会更新现有文档的字段排序顺序。

引用限制

对象引用字段的引用限制会限制用户可以选择的有效记录列表。您可以使用 标准 VQL 表达式配置对象引用字段的静态或动态引用限制。了解有关使用标准 VQL 设置引用约束的更多信息,请参阅开发人员门户

配置引用限制

要设置引用限制:

  1. 从字段列表中,单击对象引用字段的标签。
  2. 单击编辑
  3. 向下滚动到引用限制节段,然后在文本框中输入标准 VQL 表达式来定义条件。您可以使用令牌帮助程序图标来搜索要添加到表达式中的关系和字段键。
  4. 单击保存

移除引用限制

要移除引用限制:

  1. 从字段列表中,单击文档对象引用字段的字段标签。
  2. 单击编辑
  3. 筛选器表达式文本框中删除表达式。
  4. 单击保存

将标准 VQL 表达式用于引用限制

您可以使用标准 VQL 表达式设置引用限制。但是,文档字段的引用限制不支持完整的 VQL 功能。

在定义静态引用限制时,可以使用以下标准 VQL 运算符:=! =><>=<=。请注意,以下运算符的字符之间不能有空格:!=>=<=

要在文档字段的静态引用限制中使用 AND 子句,必须使用逗号(,)。例如:id IN (SELECT id FROM countryproduct__cr WHERE country__c CONTAINS {{this.country__v}}), state__v = ‘approved_state__c’

静态引用限制

静态引用限制根据定义的静态值限制可用记录列表。此选项仅适用于对象引用字段。您可以根据以下条件使用静态引用限制来筛选可用对象记录:

  • 对象类型
  • 对象记录生命周期状态
  • 对象记录字段的特定值

对象引用限制不能使用以下字段类型:

  • 公式
  • 查找
  • 日期时间
  • 父对象

动态引用限制

动态引用限制根据控制字段的选定值限制有效记录列表。此选项仅适用于对象引用字段,不会在任何其他字段类型中显示。

示例:对象引用字段的静态引用限制

如果地区是文档中的一个字段,则可以对适应症对象引用字段应用静态引用限制,以仅显示与北美有关的适应症。为此,请将以下 VQL 表达式应用到适应症对象引用字段:

region__cr.name__v = ‘North America’

示例:引用对象控制字段的动态引用限制

如果“国家/地区”是引用国家/地区对象的文档的一个字段,“地区”也是国家/地区对象的一个字段,则可以对应用程序对象引用字段应用动态引用约束,以仅显示与指定国家/地区的地区相关的应用程序。为此,请将以下 VQL 表达式应用到应用程序对象引用字段:

region_v CONTAINS {{this.document_country__vr.countries__vr.region__v}}

示例:动静态结合的引用限制

如果国家/地区产品对象之间存在连接,且您希望仅显示与选定国家/地区有关,并处于已批准对象生命周期状态的产品,则可以应用以下 VQL 表达式作为引用限制:

id IN (SELECT id FROM countryproduct__cr WHERE country__c CONTAINS {{this.country__v}} ), state__v = ‘approved_state__c’

静态引用限制的已知问题

以下已知问题影响文档字段的静态引用限制:

  • 目前,无法应用直接引用对象字段的静态引用限制。例如,表达式 region__c = 'North America' 将不起作用。要引用对象字段,必须按如下方式更改您的表达式:region__cr.name__v = 'North America'
  • 当是/否字段的引用约束在筛选器表达式中使用“是”和“否”值时,它们将无法正常运行。对此,您可以在表达式中使用“true”/”yes”或“false”/”no”。