フォームメタデータの管理

最終更新日: 2023-12-07
  • 作成対象:
  • Admin
バージョン 記事リンク
AEM as a Cloud Service ここをクリックしてください
AEM 6.5 この記事

概要 

メタデータを使用すると、アセットの分類および編成を容易に行うことができ、ユーザーが特定のアセットを検索しやすくなります。

AEM Formsでは、デフォルトで、各アセットタイプに対して定義されたメタデータのセットが提供されます。 デフォルトのメタデータに加え、各アセットタイプにカスタムメタデータを追加することができます。AEM Formsでは、フォーム用にこのメタデータを効率的に作成、管理およびやり取りする適切な方法も提供されています。

開発者またはサイトの所有者は、Forms Portal、AEM Formsのエンドユーザーインターフェイスをカスタマイズして、組織で使用しているメタデータを反映させることができます。 フォームポータルについて詳しくは、ポータルでのフォーム発行の概要を参照してください。

AEM Forms におけるメタデータ

AEM Formsでは、アセットに関連付けられたメタデータプロパティのリストは、アセットのタイプに応じて異なります。 また、任意のカスタムメタデータのプロパティを追加すると、カスタムメタデータが追加されたタイプのすべてのアセットに追加されます。

アセットタイプ

AEM Formsでは、次のアセットタイプがサポートされています。

  • フォームテンプレート(XFA フォーム)
  • PDF のフォーム
  • ドキュメント(フラット PDF)
  • アダプティブフォーム
  • リソース
  • XFS

広範なメタデータのリスト

次のリストは、AEM Forms でサポートされるメタデータのプロパティの広範なリストです。

プロパティ名 アセットタイプ 説明
タイトル リソース以外のすべて フォームの表示名。
説明 リソース以外のすべて フォームの説明。ユーザーはこの値を指定できます。
タイプ すべて

アセットのタイプを指定する読み取り専用の値です。次のいずれかの値になります。

  • フォームテンプレート
  • PDF フォーム、PDF フォーム(Acroform)または PDF フォーム(署名済み)
  • ドキュメント、ドキュメント(署名付き)
  • アダプティブフォーム
  • リソース
作成日 すべて アセット作成の時間を指定する、読み取り専用の値です。
最終変更日 すべて アセットが最後に変更された時間を指定する、読み取り専用の値です。
作成者 リソース以外のすべて

フォームタイプに基づいて自動で算出される、読み取り専用の値です。

  • PDF/フォームテンプレート/ドキュメント - アップロードされたバイナリファイルから取得。
  • アダプティブフォーム - フォーム作成時にログインしているユーザー。
ステータス リソース以外のすべて

次のフォームのいずれかの状態を定義する読み取り専用の値です。

  • 値なし:フォームが一度も公開されていない場合。
  • 公開済み:フォームが公開されたとき。
  • 変更済み:一度公開された後にフォームが変更されたとき。
最終公開日 リソース以外のすべて フォームが最後に公開されたときの時間を指定する読み取り専用の値です。
公開オン/オフ時間 リソース以外のすべて

フォームが自動で公開または未公開になるようにスケジュールされる時間です。ユーザーはこの値をメタデータの編集で設定します。

  • 公開オンおよび公開オフのどちらの時間も、現在の日付よりも後の日付にする必要があります。
  • 「オフタイムに公開」は、「オンタイムに公開」よりも後の時間にする必要があります。
URL を送信

フォームテンプレート

PDF フォーム

フォームデータをサーブレットに送信するためにユーザー指定の URL を設定する方法です。

「URL を送信」は、次の方法(好ましい順)のいずれかを使用して設定できます。

  • AEM Forms Designer で XFA フォームを作成しているときに、「HTTP 送信」ボタンを使用して、「URL を送信」をフォームテンプレートに直接指定します。
  • AEM Forms の UI で、メタデータのプロパティ編集時にフォームを選択し、送信 URL を指定します。
  • Forms Portal で、Search & Lister コンポーネントを編集し、「フォームリンク」タブで送信 URL を指定します。
HTML レンダリングプロファイル フォームテンプレート HTML 形式のフォームテンプレートのレンダリング中に使用される HTML レンダリングプロファイル。
レンダリング形式

フォームテンプレート

アダプティブフォーム

このオプションを使用すると、ユーザーはフォームが公開されるときのフォームのレンダリング形式を指定できます。

  • HTML
  • PDF
  • 両方

このオプションは、エンドユーザーに表示されるフォームポータルでのみフォームのレンダリング形式を制限する場合に使用されます。

タグ リソース以外のすべて 検索をすばやく容易に行うために、フォームに関連付けられたラベルです。
参照

アダプティブフォーム

フォームテンプレート

リソース

このフォームが関連付けられているアセット(その他のフォームまたはリソース)のリストです。これらのアセットは、次の 2 つに分類されます。

  • 参照先:現在のフォームが参照しているアセット。
  • 参照元:現在のアセットを参照しているアセット。

これらのアセットはリンクとして表示され、リンクをクリックすると、そのメタデータに直接アクセスできます。

フォームモデル(XDP/XSD)選択 アダプティブフォーム

アダプティブフォームのオーサリング時に使用するフォームモデルを指定します。 このプロパティは次の値を含めることができます。

  • フォームテンプレート:リポジトリ内に存在するフォームテンプレートから選択されます。 この値は更新できます。
  • XML schema: XSD ファイルがアップロードされます。 この値は更新できます。
  • なし
フォームモデルを選択すると、更新できますが削除できません。

フォームメタデータの表示

アセットには既存のプロパティの値が含まれ、これは読み取り専用モードで表示できます。このメタデータは、フォームのアプロード時またはフォーム作成時に生成されます。

  1. メタデータを表示するアセットの場所に移動します。

  2. 次のいずれかの方法を使用してプロパティページを開きます。

    1. クイックアクションからプロパティ表示の e_reviewmode_properties_n アイコンをクリックします。

      メモ

      クイックアクションは、マウスのカーソルを合わせたときにサムネール上に表示されるアクション項目です。

    2. フォームを選択し、ツールバーに表示されるプロパティ表示の e_reviewmode_properties_n アイコンをクリックします。

    3. 選択モードではない場合にフォームのサムネールをクリックして、フォーム詳細ページに移動します。ここで、右上にある aem6forms_eye_viewon 目のアイコンをクリックして、その下にあるリストで「プロパティ」をクリックします。

  3. プロパティページが開き、いくつかの値を保持するメタデータのプロパティのみを含むスキーマが表示されます。

    プロパティページには、次の 2 つのアクションアイコンを含むツールバーがあります。

    • 編集:aem6forms_edit メタデータプロパティの値の編集
    • 表示:aem6forms_eye_viewon プレビューモードでフォームを開き、フォーム詳細ページに移動します。

    コンテンツ部分は 2 つのパートに分かれています。

    • 左のパネルにはフォームのサムネールが含まれます
    • 右のパネルには、様々なタブに配布されるメタデータのプロパティが読み取り専用モードで含まれます。

フォームメタデータの値の追加および更新

既存のメタデータプロパティの値を編集したり、新しい値を既存のメタデータプロパティのフィールドに追加する(例えば、メタデータフィールドが空白の場合など)ことができます。

メタデータプロパティの値の更新

  1. 前述の節で説明した手順に従って、選択したフォームの既存のメタデータを表示するプロパティページを開きます。

  2. ツールバーで、編集アイコンの aem6forms_edit をクリックし、ページのモードを読み取り専用から読み取り/書き込みに変更します。

  3. 編集可能な入力フィールドと静的テキストの組み合わせを含むスキーマを保持するプロパティページが開きます。

  4. 静的テキストに表示されるプロパティは、編集できないプロパティです。

  5. 別のタブに移動して、メタデータプロパティが格納されている入力フィールドを検索します。

    このページのツールバーには、ビューモードのツールバーとは異なる 2 つのアクションアイコンが含まれています。

    • キャンセル:aem6forms_close これまでにメタデータプロパティの値に加えられた変更をキャンセルします
    • 完了:aem6forms_check これまでにメタデータプロパティの値に加えられたすべての変更を保存します

    どちらのアクションでも、更新済みの値を含むプロパティページを読み取り専用モードに戻すようユーザーは指示されます。

フォームサムネールの更新

プロパティページの左のパネルには、フォームのサムネールが表示されます。デフォルトでは、表示されるサムネールは、フォーム作成時(アダプティブフォーム)またはフォームアップロード時に生成されるサムネールです。

すべてのフォームタイプには、「画像をアップロード」をクリックして画像をアップロードするオプション、およびローカルディレクトリから画像ファイルを参照するオプションがあります。デフォルトのサムネールの代わりに、選択された画像がサムネールとして使用されます。

アダプティブフォームの場合は、現在のアダプティブフォームプレビューのスナップショットとしてサムネールを生成できる追加機能が用意されています。 AEM Formsはアダプティブフォームのオーサリングもサポートしているので、アダプティブフォームを変更するたびに、アダプティブフォームのプレビューが変わる場合があります。 このサムネール生成機能を使用すると、現在のプレビューステータスに基づいてアダプティブフォームの新しいサムネールを取得できます。 「プレビューを生成」をクリックし、このアクションを実行します。

メモ
  • サムネールには四角形の画像を使用します。四角形以外の画像を使用し、サムネールを一覧表示で表示すると、サムネールはクリップされて表示されます。
  • 新しい画像がアップロードまたは生成されると、サムネールはこの画像に置き換えられ、以前の画像にリセットすることはできません。

カスタムメタデータの追加

初期設定の状態で提供されているメタデータとは別に、AEM Forms は新規のカスタムメタデータをサポートします。

メタデータレイアウトのスキーマを定義するためのツール(メタデータスキーマエディター)が提供されます。これは、フォームの「プロパティ」ページにおける表示レイアウトです。メタデータスキーマエディターを使用して、アセットのカスタムスキーマを追加または変更できます。

AEM Formsは、サポートされているフォームタイプのメタデータスキーマをこのツールで公開します。 この方法で、これらのスキーマにアクセスし、メタデータスキーマエディターで提供される機能を使用してカスタムプロパティを追加できます。

  1. ツール/Assets/メタデータスキーマ に移動します。

  2. 一覧表示されたスキーマフォームで​​フォーム」をクリックします。

  3. 開いたリストで、カスタムメタデータを追加するアセットタイプをクリックします。

    メモ

    これらのスキーマには初期設定で提供されるメタデータプロパティが含まれていますが、機能的な問題の発生を防ぐため、変更および編集(チェックボックスの選択およびツールバーで編集をクリック)することはできません。

  4. 任意のアセットタイプをクリックすると、extendedmetadata オプションを含むリストが開きます。このスキーマを編集します。

  5. extendedmetadata の横にあるチェックボックスを選択し、ツールバーに表示される編集の aem6forms_edit アイコンをクリックします。

  6. 選択されたアセットタイプ(この場合はアダプティブフォーム)のメタデータスキーマエディターまたはフォームビルダーが、AEM Forms で開きます。

    アダプティブフォームタイプ用のメタデータスキーマエディター

    メタデータエディター

    1. 左のパネルにはフィールドが配置されるタブ付きセクションが含まれ、左のパネルで選択したフィールドの使用可能なすべての UI コンポーネントとプロパティが右のパネルに表示されます。

    2. ロックされたセクションは編集することができず、初期設定で提供されるすべてのメタデータプロパティのフィールドが含まれます。

    3. 「+」 記号をクリックして、追加のタブを追加できます。

    4. フォームを作成」セクションからスキーマページにフィールドコンポーネントをドラッグして、必要なタイプのカスタムフィールドを追加できます。

    5. このフィールドの仕様は、フィールドをクリックした後に「設定」セクションの下に提供されます。

カスタムメタデータプロパティのスキーマエディターへの追加

  1. カスタムプロパティを追加する既存または新規のタブに移動します。

  2. 必要なタイプのコンポーネントを「フォームをビルド」セクションから左のパネルにドラッグし、適切な場所に配置します。

    メモ

    ロックされたセクションは移動できませんが、空いている場所であればどこでもコンポーネントを配置できます。

  3. ドラッグしたコンポーネントをクリックします。右のパネルに開いた「設定」タブで、次のフィールドに情報を入力します。

    1. スキーマに配置されたフィールドの上に表示される名前として使用するフィールドラベルを指定します(例:部門)。

    2. プロパティにマッピングフィールドの下に、事前入力された値 「./jcr:content/metadata/default」​が表示されます。‘default’ を、必要なプロパティ名に変更します。これは、crx リポジトリーにプロパティを保存するために使用されます(例えば、'./jcr:content/metadata/department')。

      メモ

      プレフィックス「 」は変更しないでください。/jcr:content/metadata/'は、プロパティが保存されるパスを定義します。

      また、リポジトリーの同じ場所に 2 つ以上のプロパティの値が書き込まれるのを防ぐため、プロパティ名は一意にする必要があります。そのため、「default」の値は変更することをお勧めします。

    3. 要件に基づいてその他の設定を入力します。例えば、フィールドを必須フィールドにする場合は、必須オプションを選択します。

    4. 追加したフィールドを削除するには、フィールドを選択して削除の delete-1 アイコンをクリックします。

  4. 必要に応じて、手順 1 ~ 3 に従って、別のプロパティを追加します。

  5. すべての変更を行ったら、「完了」をクリックします。

    カスタムメタデータのプロパティを正常に追加しました。

AEM Forms内のすべてのアダプティブフォームに、この追加のメタデータプロパティが含まれるようになりました。 このプロパティは、プロパティページから編集できます。

このページ