扩展默认元模型 extend-the-default-meta-model

automated forms conversion服务(AFCS)标识源表单并从中提取表单对象。 语义映射器可帮助服务确定提取的对象如何以自适应形式表示。 例如,源表单可以有许多不同类型的日期表示形式。 语义映射器有助于将源表单的日期表单对象的所有表示形式映射到自适应表单的日期组件。 语义映射器还允许该服务在转换期间预配置验证、规则、数据模式、帮助文本和可访问性属性并将其应用于自适应表单组件。

元模型是一个JSON架构。 在开始使用元模型之前,请确保您熟悉JSON。 您必须具有创建、编辑和读取以JSON格式保存的数据的经验。

默认元模型 default-meta-model

automated forms conversion服务(AFCS)有一个默认的元模型。 它是一个JSON模式,通过Automated forms conversion服务(AFCS)的其他组件驻留在Adobe云上。 您可以在本地AEM服务器上找到元模型的副本,网址为: http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json。 您也可以单击此处来访问或下载英语架构。 法语德语 西班牙语意大利语葡萄牙语语言的元模型也可供下载。

元模型的模式是从https://schema.org/docs/schemas.html上的模式实体派生出来的。 它具有https://schema.org上定义的Person、PostalAddress、LocalBusiness和其他实体。 元模型的每个实体都遵循JSON模式对象类型。 以下代码表示一个元模型结构示例:

   "Entity": {
      "id": "Entity",
      "properties": {
        "name": {
          "type": "string"
        },

        "description": {
          "type": "string",
          "description": "Description of the item"
        }
      }
    }

下载默认元模型 download-the-default-meta-model

执行以下步骤以将默认元模型下载到本地文件系统:

  1. 登录到您的AEM Forms实例。
  2. 导航到​ Forms > Forms & Documents > Meta Model ​文件夹。
  3. 选择​ global.schema.json ​文件并点按​ Download。 将显示下载对话框。 选择​ Download asset(s) as binary files ​选项。 点击​ Download。存档已下载。

了解元模型 understanding-the-meta-model

元模型是指包含实体的JSON架构文件。 JSON架构文件中的所有实体都包含名称和ID。 每个实体可以包含多个属性。 图元及其属性会因域而异。 您可以使用关键字和字段配置来扩充架构文件,以将架构属性映射到自适应表单组件。

"Event": {
      "id": "Eventid",
      "allOf": [
        {
          "$ref": "#Entity"
        },
        {
          "properties": {
            "startDate": {
              "type": "string",
              "format": "date",
              "description": "Specify the start date and time of the event in ISO 8601 date format."
            },
            "endDate": {
              "type": "string",
              "format": "date",
              "description": "Specify the end date and time of the event in ISO 8601 date format."
            },
            "location": {
              "$ref": "#PostalAddress",
              "description": "Specify the location of the event."
            }
          }
        }
      ]
    }

在此示例中,Event ​表示实体的名称,该实体的值​ id ​为​ Eventid。 Event实体包括多个属性:

  • startDate
  • endDate
  • 位置

元模型中的​ allOf ​构造允许在实体间进行继承。

每个属性还可以包括:

元模型属性

转换服务基于使用​ aem:affKeyword ​引用的关键字,对源表单字段执行搜索操作。 转换服务会将JSON架构属性和其他属性应用于符合搜索条件的字段。

在此示例中,转换服务在源表单中搜索电话、电话、手机、工作电话、家庭电话、电话号码、电话号码和电话号码关键字。 转换服务会根据包含这些关键字的字段,在转换后将类型、模式和aem:afProperties应用于自适应表单字段。

用于生成的自适应表单字段的JSON架构属性 jsonschemaproperties

元模型支持使用Automated forms conversion服务(AFCS)生成的自适应表单字段的以下JSON架构通用属性:

属性名称
描述
标题
元模型中的标题属性中提到的文本用作搜索关键字,以对生成的自适应表单字段执行操作。 例如,修改自适应表单字段的标签。 有关详细信息,请参阅自定义元模型示例中的 修改表单字段的标签
说明
description属性设置所生成的自适应表单字段的帮助文本。 有关详细信息,请参阅自定义元模型示例中的 将帮助文本添加到表单字段
类型

type属性定义生成的自适应表单字段的数据类型。 标题属性的可能值包括:

  • 字符串:生成文本数据类型的自适应表单字段。
  • 数字:生成数值数据类型的自适应表单字段。
  • integer:生成子类型设置为integer的numeric数据类型的自适应表单字段。
  • 布尔值:生成切换自适应表单组件。

有关在元模型中使用类型属性的详细信息,请参阅自定义元模型示例中的 修改表单字段的类型

模式
pattern属性基于正则表达式来限制生成的自适应表单字段的值。 例如,元模型中的以下代码将生成的自适应表单字段的值限制为10位数:
"pattern": "/\\d{10}/"
同样,元模型中的以下代码将字段的值限制为特定的日期格式。
"pattern": "date{DD MMMM, YYYY}",
格式

format属性根据命名模式而不是正则表达式来限制生成的自适应表单字段的值。 format属性的可能值包括:

  • 电子邮件:生成电子邮件自适应表单组件。
  • 主机名:生成文本框自适应表单组件。

有关在元模型中使用format属性的详细信息,请参阅自定义元模型示例中的 修改表单字段的格式

枚举和枚举名称
enum和enumNames属性将下拉列表、复选框或单选按钮字段的值限制为固定集。 enumNames中列出的值将显示在用户界面上。 使用枚举属性列出的值用于计算。
有关详细信息,请参阅 将表单字段转换为自适应表单中的多选复选框将文本字段转换为自适应表单中的下拉列表 以及 自定义元模型示例中将其他选项添加到下拉列表

基于关键字的搜索,用于将属性应用于生成的自适应表单字段 keywordsearch

automated forms conversion服务(AFCS)在转换期间对源表单执行关键字搜索。 筛选符合搜索条件的字段后,转换服务将为元模型中的这些字段定义的属性应用于生成的自适应表单字段。

使用​ aem:affKeyword ​属性引用关键字。

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

在此示例中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 银行帐号 ​文本后,转换服务使用​ 类型 ​属性将该字段转换为​ 数字 ​类型。

生成的自适应表单字段的其他属性 additionalproperties

您可以在元模型中使用​ aem:afProperties ​属性,为使用Automated forms conversion服务(AFCS)生成的自适应表单字段定义以下附加属性:

属性名称
描述
多行
multiLine属性在转换后将源表单字段转换为自适应表单中的多行字段。 有关详细信息,请参阅自定义元模型示例中的 将字符串字段转换为多行字段
必需
必填属性将转换后的自适应表单字段输入设置为必填字段。
有关详细信息,请参阅自定义元模型示例中的 将验证添加到自适应表单字段
jcr:title
使用jcr:title属性和title JSON架构属性,可在转换后修改自适应表单字段的标签。
有关详细信息,请参阅自定义元模型示例中的 修改表单字段的标签
有关可使用JSON架构应用于自适应表单字段的更多属性的信息,请参阅使用JSON架构创建自适应表单
sling:resourceType和guideNodeClass
sling:resourceType和guideNodeClass属性用于将表单字段映射到相应的自适应表单组件。
有关详细信息,请参阅自定义元模型示例中的 将表单字段转换为自适应表单中的多选复选框将文本字段转换为自适应表单中的下拉列表
validatePictureClause

validatePictureClause属性对转换后自适应表单字段中允许的格式设置验证。
有关详细信息,请参阅自定义元模型示例中的 将验证添加到自适应表单字段

用您自己的语言创建自定义元模型 language-specific-meta-model

您可以创建语言特定的元模型。 此类元模型可帮助您以所选语言创建映射规则。 automated forms conversion服务(AFCS)允许您使用以下语言创建元模型:

  • 英语(en)
  • 法语(fr)
  • 德语(de)
  • 西班牙语(es)
  • 意大利语(it)
  • 葡萄牙语(pt-br)

将​ aem:Language ​元标记添加到元模型顶部以指定其语言。 例如,

"metaTags": {
        "aem:Language": "fr"
    }

当未指定语言时,服务会认为元模型是英语的。

创建语言特定元模型的注意事项

  • 确保每个键的名称都使用英语。 例如,emailAddress。

  • 确保所有实体引用和所有ID键的预定义值只包含ASCII字符。 例如,“id”:“ContactPoint”/“$ref”:“#ContactPoint”。

  • 确保与以下键对应的所有值都使用指定的元模型语言:

    • aem:affKeyword
    • 标题
    • 说明
    • enumName
    • shortDescription
    • validatePictureClauseMessage

    例如,当元模型的语言为法语(“aem:Language”:“fr”)时,请确保所有描述和消息都为法语。

  • 请确保所有JSON架构属性都仅使用支持的值。 例如,type属性只能跨越字符串、数字、整数和布尔值的选定值。

下图显示了英语元模型和相应的法语元模型的示例:

使用自定义元模型修改自适应表单字段 modify-adaptive-form-fields-using-custom-meta-model

除了默认元模型中列出的模式和验证之外,您的组织还可以具有这些模式和验证。 您可以扩展默认元模型以添加特定于您的组织的阵列、验证和实体。 automated forms conversion服务(AFCS)在转换期间将自定义元模型应用于表单字段。 当发现特定于您的组织的新模式、验证和图元时,可以不断更新元模型。

automated forms conversion服务(AFCS)使用保存在以下位置的默认元模型,在转换期间将源表单字段映射到自适应表单字段:

http://<服务器>:<端口>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json

但是,您可以将自定义元模型保存在文件夹中,并修改转换服务属性以在转换期间使用自定义元模型。

在转换期间使用自定义元模型 use-custom-meta-model-during-conversion

执行以下步骤以在转换期间使用自定义元模型:

  1. 在​ Forms > Forms & Documents ​中创建文件夹,并将自定义元模型JSON架构文件上传到该文件夹。

  2. 使用以下方式打开转换服务属性:

    Tools > Cloud Services > Automated Forms Conversion Configuration > <所选配置的属性>

  3. 在​ Basic ​选项卡的​ Custom Meta-model ​字段中指定自定义元模型的位置,然后点按​ Save & Close

  4. 运行转换以将自定义元模型应用到转换过程。

自定义元模型示例 custommetamodelexamples

使用自定义元模型修改自适应表单字段属性的常见示例包括:

  • 修改表单字段的标签
  • 修改表单字段的类型
  • 将帮助文本添加到表单字段
  • 将表单字段转换为自适应表单中的多选单选按钮
  • 修改表单字段的格式
  • 向自适应表单字段添加验证
  • 将表单字段转换为自适应表单中的下拉列表选项
  • 向下拉列表添加其他选项
  • 将字符串字段转换为多行字段

修改表单字段的标签 modify-the-label-of-a-form-field

示例: ​转换后,将表单中的银行帐号标签修改为自适应表单中的自定义帐号。

在此自定义元模型中,转换服务使用​ title ​属性作为搜索关键字。 在检索表单中的​ 银行帐号 ​文本后,转换服务将该文本替换为​ aem:afProperties ​部分中引用​ jcr:title ​属性的​ 客户帐号 ​字符串。

{
  "numberfields": {
      "type": "number",
   "title": "Bank account number",
   "aem:afProperties" : {
    "jcr:title" : "Customer account number"
   }
   }
}

修改表单字段的类型 modify-the-type-of-a-form-field

示例:在转换为自适应表单中的数字类型字段之前,修改表单中文本类型的​ 银行帐号 ​字段,在转换之后,修改为数字类型字段。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 银行帐号 ​文本后,转换服务使用​ 类型 ​属性将该字段转换为数字类型。

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

将帮助文本添加到表单字段 add-help-text-to-a-form-field

示例:将帮助文本添加到自适应表单的​ 银行帐号 ​字段。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在表单中检索​ 银行帐号 ​文本后,转换服务使用​ description ​属性将帮助文本添加到自适应表单字段。

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"],
   "description": "Specify your bank account number."
 }
}

将表单字段转换为自适应表单中的多选复选框 convert-a-form-field-to-multiple-choice-check-boxes-in-the-adaptive-form

示例:转换前将表单中字符串类型的​ 国家/地区 ​字段转换为转换后自适应表单中的复选框。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 国家/地区 ​文本后,转换服务使用​ 枚举 ​属性将该字段转换为以下复选框:

  • 印度
  • 英国
  • 澳大利亚
  • 新西兰

sling:resourceType ​和​ guideNodeClass ​属性将表单字段映射到复选框自适应表单组件。

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidecheckbox",
      "guideNodeClass": "guidecheckbox"
    }
  }
}

修改表单字段的格式 modify-the-format-of-a-form-field

示例:将​ 电子邮件地址 ​字段的格式修改为电子邮件格式。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 电子邮件地址 ​文本后,转换服务使用​ 格式 ​属性将该字段转换为电子邮件格式。

{
   "additionalDetails" : {
      "aem:affKeyword": ["E-mail Address"],
       "type" : "string",
       "format" : "email"
  }
}

向自适应表单字段添加验证 add-validations-to-adaptive-form-fields

示例1: ​向自适应表单的​ 邮政编码 ​字段添加验证。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 邮政编码 ​文本后,转换服务使用在​ aem:afProperties ​节中定义的​ validatePictureClause ​属性向字段添加验证。 根据验证,您在转换后为自适应表单中的​ 邮政编码 ​字段指定的输入必须包含六个字符。

{
   "postalCode" : {
      "aem:affKeyword": ["Postal Code"],
      "type" : "string",
      "aem:afProperties" : {
        "validatePictureClause" : "\\d{6}"
      }
   }
}

示例2: ​向自适应表单的​ 银行帐号 ​字段添加验证。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 银行帐号 ​文本后,转换服务使用​ aem:afProperties ​部分中定义的​ 强制 ​属性向字段添加验证。 根据验证,在转换后提交表单之前,您必须为​ 银行帐号 ​字段指定一个值。

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"],
   "aem:afProperties" : {
        "mandatory": "true"
      }
   }
}

将文本字段转换为自适应表单中的下拉列表 convert-a-text-field-to-drop-down-list-in-the-adaptive-form

示例:将转换前表单中字符串类型的​ 国家/地区 ​字段转换为转换后自适应表单中的下拉选项。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 国家/地区 ​文本后,转换服务使用​ 枚举 ​属性将该字段转换为以下下拉列表选项:

  • 印度
  • 英国
  • 澳大利亚
  • 新西兰

sling:resourceType ​和​ guideNodeClass ​属性将表单字段映射到下拉自适应表单组件。

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidedropdownlist",
      "guideNodeClass": "guideDropDownlist"
    }
  }
}

向下拉列表添加其他选项 add-additional-options-to-the-drop-down-list

示例: ​使用自定义元模型将​ SriLanka ​添加为现有下拉列表的额外选项。

要添加额外选项,请使用新选项更新​ 枚举 ​属性。 在此示例中,使用​ Sri Lanka ​作为额外选项更新​ 枚举 ​属性。 枚举 ​属性中列出的值将显示在下拉列表中。

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand",
   "Sri Lanka"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidecheckbox",
      "guideNodeClass": "guidecheckbox"
    }
  }
}

将字符串字段转换为多行字段 convert-a-string-field-to-a-multi-line-field

示例: ​将字符串类型的​ Address ​字段转换为表单中的多行字段。

在此自定义元模型中,转换服务使用​ aem:affKeyword ​中的文本作为搜索关键词。 在检索表单中的​ 地址 ​文本后,服务使用在​ aem:afProperties ​节中定义的​ multiLine ​属性将该文本字段转换为多行字段。

{
 "multiLine" : {
   "aem:affKeyword": [
      "Address"
    ],
    "type" : "string",
    "aem:afProperties": {
      "multiLine": "true"
    }
  }
}
recommendation-more-help
c40c2ccf-3d1b-4b47-b158-c4646051b46c