デフォルトのメタモデルの拡張
自動フォーム変換サービス（AFCS）では、ソースフォームからフォームオブジェクトを識別して抽出します。自動フォーム変換サービスでセマンティックマッパーを使用すると、抽出したオブジェクトがアダプティブフォーム内でどのように表示されるのかを確認することができます。例えば、ソースフォームには、表示形式の異なる様々な日付オブジェクトが含まれている場合があります。こうした場合にセマンティックマッパーを使用すると、ソースフォーム内の日付オブジェクトのすべての表示形式を、アダプティブフォームの日付コンポーネントにマップすることができます。また、変換処理の実行中にセマンティックマッパーを使用して、検証設定、ルール、データパターン、ヘルプテキスト、アクセシビリティのプロパティをアダプティブフォームコンポーネントに対して事前に設定して適用することもできます。
メタモデルとは、JSON スキーマのことです。メタモデルを使用するには、JSON について理解する必要があります。具体的には、JSON 形式で保存されたデータの作成、編集、読み取りに関する知識と経験が必要になります。
デフォルトのメタモデル
自動フォーム変換サービス（AFCS）には、デフォルトのメタモデルがあります。これは JSON スキーマで、自動フォーム変換サービス（AFCS）の他のコンポーネントと共に Adobe Cloud 上に存在します。メタモデルのコピーは、ローカル 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"
}
}
}
デフォルトメタモデルのダウンロード
デフォルトのメタモデルをローカルファイルシステムにダウンロードするには、以下の手順を実行します。
- AEM Forms インスタンスにログインします。
- フォーム／フォームとドキュメント**／**メタモデル フォルダーに移動します。
- global.schema.json ファイルを選択して「ダウンロード」をタップします。ダウンロード用のダイアログボックスが表示されます。「アセットをバイナリファイルとしてダウンロード」オプションを選択します。「ダウンロード」をタップします。アーカイブファイルがダウンロードされます。
メタモデルについて
メタモデルとは、各種エンティティが保管された 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
- location
メタモデル内の allOf コンストラクターにより、エンティティ間での継承が可能になります。
各プロパティには、さらに以下のものを含めることができます。
変換サービスは、aem:affKeyword を使用して参照されるキーワードに基づいて、ソースフォームフィールドに対して検索操作を実行します。変換サービスにより、JSON スキーマのプロパティと追加のプロパティが、検索条件に一致するフィールドに適用されます。
上記のサンプルコードでは、変換サービスを使用して、ソースフォーム内のキーワード（phone、telephone、mobile phone、work phone、home phone、telephone number、telephone no、phone number）を検索しています。変換サービスは、これらのキーワードが含まれているフィールドに基づき、変換処理の完了後に、各種プロパティ（type、pattern、aem:afProperties）をアダプティブフォームのフィールドに適用します。
