管理表单元数据 manage-form-metadata

版本
文章链接
AEM as a Cloud Service
单击此处
AEM 6.5
本文

概述  overview-nbsp

元数据允许更轻松地分类和组织资源,并帮助正在查找特定资源的用户。

默认情况下,AEM Forms会为每个资源类型提供一组定义的元数据。 除了默认元数据之外,您还可以将自定义元数据添加到每个资源类型。 AEM Forms还为您提供了合适的方法,来为您的表单高效地创建、管理和交换所有这些元数据。

如果您是开发人员或站点所有者,则可以自定义AEM Forms的最终用户界面Forms Portal,以反映您在组织中使用的元数据。 有关Forms门户的更多信息,请参阅在门户上发布表单简介

AEM Forms中的元数据 metadata-in-aem-forms

在AEM Forms中,与资源关联的元数据属性的列表取决于其类型。 此外,如果添加任何自定义元数据属性,则会将该属性添加到添加了自定义元数据的类型的所有资产中。

资源类型 asset-types

AEM Forms支持以下资源类型:

  • 表单模板(XFA表单)
  • PDF forms
  • 文档(平面PDF)
  • 自适应表单
  • 资源
  • XFS

广泛的元数据列表 extensive-list-of-metadata

以下是AEM Forms中支持的元数据属性的广泛列表:

属性名称
资源类型
描述
标题
除资源以外的所有其他资源
表单的显示名称。
描述
除资源以外的所有其他资源
表单描述。 用户可以指定此值。
类型
所有

指定资源类型的只读值。 它可以具有以下值之一:

  • 表单模板
  • PDF表单、PDF表单(Acroform)或PDF表单(签名)
  • 文档,文档(已签署)
  • 自适应表单
  • 资源
已创建
所有
指定资源创建时间的只读值。
上次修改日期
所有
一个只读值,它指定上次修改资源的时间。
创作
除资源以外的所有其他资源

根据表单类型自动计算的只读值。

  • PDF/表单模板/文档 — 从上传的二进制文件获取。
  • 自适应表单 — 创建表单时登录用户。
状态
除资源以外的所有其他资源

只读值,定义表单的以下状态之一:

  • 无值:表示从未发布过表单。
  • 已发布:发布表单时。
  • 修改时间:表单发布一次后进行修改的时间。
上次发布日期
除资源以外的所有其他资源
一个只读值,指定上次发布表单的时间。
Publish开启/结束时间
除资源以外的所有其他资源

计划自动发布/取消发布表单的时间。 用户在编辑元数据时设置此值。

  • Publish的打开和关闭时间都应晚于当前日期。
  • Publish关闭时间应在发布开启时间之后。
提交URL

表单模板

PDF表单

配置用户指定的URL以将表单数据提交到servlet。

可以使用以下任一方法配置提交URL,并按优先级顺序列出:

  • 在AEM Forms Designer中创建XFA表单时,使用HTTP提交按钮直接在表单模板中指定提交URL。
  • 在AEM Forms UI中,选择表单并在编辑元数据属性时指定提交URL。
  • 在Forms Portal中,编辑Search & Lister组件,然后在“表单链接”选项卡下指定提交URL。
HTML渲染配置文件
表单模板
以HTML格式呈现表单HTML时使用的模板呈现配置文件。
渲染格式

表单模板

自适应表单

此选项允许用户指定发布表单时的表单渲染格式:

  • HTML
  • PDF
  • 双向

此选项用于限制表单仅在Forms Portal上对最终用户可见。

标记
除资源以外的所有其他资源
与表单关联的标签有助于快速轻松搜索。
引用

自适应表单

表单模板

资源

与此表单相关的资产(其他表单或资源)列表。 这些资产可以分为以下两类:

  • 引用:当前表单引用的Assets。
  • 引用者:引用当前资源的Assets。

这些资源显示为链接,通过单击这些链接可以直接访问其元数据。

表单模型(XDP/XSD)选择
自适应表单

指定创作自适应表单时使用的表单模型。 此属性可以具有以下值:

  • 表单模板:从存储库中的现有表单模板中选择表单模板。 此值可更新。
  • XML架构:已上传XSD文件。 此值可更新。

表单模型一旦选定便可以更新,但不能删除。

查看表单元数据 view-form-metadata

Assets具有现有的属性值,可以在只读模式下查看这些值。 此元数据源自表单上传或表单创建时。

  1. 导航到要查看元数据的资源的位置。

  2. 使用以下方式之一打开属性页面:

    1. 单击“快速操作”中的查看属性 e_reviewmode_properties_n 图标。

      note note
      NOTE
      快速操作是在鼠标悬停时显示在缩略图上的操作项。
    2. 选择表单,然后单击工具栏中显示的查看属性 e_reviewmode_properties_n 图标。

    3. 在不处于选择模式时,通过单击表单缩略图导航到表单详细信息页面。 现在,单击右上角的 aem6forms_eye_viewon 眼睛图标,然后单击其下方列表中的“属性”。

  3. 打开的属性页显示的方案仅包含那些保存某些值的元数据属性。

    属性页面有一个包含两个操作图标的工具栏:

    • 编辑: aem6forms_edit 编辑元数据属性值
    • 视图: aem6forms_eye_viewon 导航到表单详细信息页面,该页面将在预览模式下打开表单。

    内容部分分为两部分:

    • 左侧面板包含表单的缩略图
    • 右侧面板包含以只读模式分布的元数据属性,这些属性分布在不同的选项卡中。

添加/更新表单元数据值 add-update-form-metadata-values

您可以编辑现有元数据属性的值或向现有元数据属性字段添加新值(例如,当元数据字段为空时)。

更新元数据属性值 update-metadata-property-values

  1. 按照上一节中提到的步骤打开属性页面,可以在其中查看所选表单的现有元数据。

  2. 在工具栏中,单击编辑图标 aem6forms_edit 以将页面的模式从只读更改为读/写。

  3. 打开的属性页面包含一个混合了可编辑输入字段和静态文本的架构。

  4. 静态文本中显示的属性是无法编辑的属性。

  5. 您可以导航到其他选项卡,以查找位于这些选项卡下方的元数据属性的输入字段。

    此页面有一个工具栏,其中包含两个与视图模式不同的操作图标:

    • 取消: aem6forms_close 取消迄今为止对元数据属性值所做的任何更改
    • 完成: aem6forms_check 保存迄今为止对元数据属性值所做的所有更改

    这两个操作都会将用户引导回包含更新值的属性页的只读模式。

更新表单缩略图 update-the-form-thumbnail

属性页面中的左侧面板显示表单的缩略图。 默认情况下,显示的缩略图是创建表单(自适应表单)时或上传表单时生成的缩略图。

对于所有表单类型,您可以选择通过单击​ 上传图像 ​并从本地目录浏览图像文件来上传图像。 所选图像将用作缩略图,而不是默认图像。

对于自适应表单,还提供了附加功能,允许用户生成缩略图作为当前自适应表单预览的快照。 由于AEM Forms还支持创作自适应表单,因此每次更改自适应表单时,自适应表单的预览都可能会发生更改。 此功能可生成缩略图,从而帮助您根据当前预览状态为自适应表单获取新的缩略图。 单击​ 生成预览 ​以执行此操作。

NOTE
  • 在缩略图中使用正方形图像。 当您使用非正方形图像并在列表视图中查看缩略图时,缩略图显示为已裁剪。
  • 上传或生成新图像后,缩略图将替换为此图像,并且无法重置为上一个图像。

添加自定义元数据 add-custom-metadata

除了开箱即用的元数据之外,AEM Forms还支持新的自定义元数据。

提供了一个工具(元数据架构编辑器)来定义元数据布局的架构;即表单的​ 属性 ​页面中显示的布局。 通过元数据架构编辑器,可为资源添加或修改自定义架构。

AEM Forms在此工具中公开受支持表单类型的元数据架构。 通过这种方式,您可以访问这些架构,并使用元数据架构编辑器中提供的功能来添加自定义属性。

导航到元数据架构编辑器 navigate-the-metadata-schema-editor

  1. 导航到​ 工具> Assets >元数据架构

  2. 从列出的架构表单中单击​ 表单

  3. 在打开的列表中,单击要为其添加自定义元数据的资源类型。

    note note
    NOTE
    这些架构包含现成提供的元数据属性,不得更改/编辑(选中复选框并单击工具栏中的编辑)以避免功能问题。
  4. 单击的任何资产类型都会打开一个包含extendedmetadata选项的列表。 编辑此架构。

  5. 选中extendedmetadata旁边的复选框,然后单击工具栏中显示的编辑 aem6forms_edit 图标。

  6. AEM Forms会打开所选资源类型的元数据架构编辑器/表单生成器(在本例中为“自适应表单”)。

    自适应表单类型的 元数据架构编辑器

    元数据编辑器

    1. 左侧面板包含放置字段的选项卡部分,右侧面板显示所有可用的UI组件以及从左侧面板中选择的字段的属性。

    2. 锁定的部分不可编辑,并包含开箱即用提供的所有元数据属性的字段。

    3. 单击+符号可添加其他选项卡。

    4. 您可以添加所需类型的自定义字段,方法是将​ 构建表单 ​分区中的字段组件拖到架构页面上。

    5. 单击该字段后,可在​ 设置 ​部分下提供该字段的规范。

在架构编辑器中添加自定义元数据属性 add-custom-metadata-property-in-schema-editor

  1. 导航到要添加自定义属性的选项卡(现有或新)。

  2. 将所需类型的组件从​ 构建表单 ​区域拖到左侧面板并放置在方便的位置。

    note note
    NOTE
    不能移动锁定的部分,但可以将组件放在任何空格中。
  3. 单击刚刚拖动的组件。 在右侧面板中打开的设置选项卡中,填写以下字段的信息:

    1. 指定字段标签,该标签用作位于架构中的字段上方的显示名称(例如:Department)

    2. 在映射到属性字段下,您可以看到预填充的值​ 。/jcr:content/metadata/default“”。 将“default”更改为所需的属性名称,该属性名称用于存储crx存储库中的属性(例如:“”。/jcr:content/metadata/department')

      note note
      NOTE
      请勿更改前缀'。/jcr:content/metadata/' ,它定义存储属性的路径。
      此外,属性名称必须是唯一的,以避免在存储库中的同一位置写入两个或更多属性的值。 因此,建议您更改“default”值。
    3. 根据需要填写其他设置。 例如:如果要使字段成为必填字段,请选择必填选项。

    4. 要删除您添加的字段,请选择该字段,然后单击删除 delete-1 图标。

  4. 如有必要,请按照步骤1 - 3添加其他资产。

  5. 完成所有更改后,单击​ 完成

    您已成功添加自定义元数据属性。

AEM Forms中的所有自适应表单现在都包含此额外的元数据属性。 您可以从属性页面对其进行编辑。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2