ドキュメントAEM 6.4Forms ガイド

Correspondence Management アセットへのカスタムプロパティの追加 add-custom-properties-to-correspondence-management-assets

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • User
CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

概要 overview

Correspondence Management のユーザーインターフェイスをカスタマイズし、ユーザーに独自のプロパティとタブのセットを表示できます。 このカスタマイズには、特定のアセットタイプとレター、またはすべてのアセットタイプとレターへのカスタムフィールド／プロパティおよびタブの追加が含まれます。

Correspondence Management アセットへのカスタムプロパティの追加 adding-custom-properties-to-correspondence-management-assets

次のシナリオでは、Correspondence Management のアセットおよびレターにプロパティやタブを追加する方法を示します。

  • すべてのアセットタイプに共通のプロパティを追加する
  • すべてのアセットタイプへの共通タブの追加
  • 特定のアセットタイプへのカスタムプロパティの追加

これらのシナリオでプロパティ、パスおよび値を調整することで、必要に応じて、カスタムのプロパティとタブを様々なアセットセットに追加できます。

シナリオ：すべてのアセットタイプへの共通フィールド（プロパティ）の追加 scenario-adding-a-common-field-property-to-all-the-asset-types

このシナリオでは、すべてのアセットタイプ（テキスト、リスト、条件、レイアウトフラグメント）とレターにカスタムプロパティを追加する方法を示します。 このシナリオを使用して、すべてのアセットおよびレターにプロパティ「受信者の場所」を追加できます。「受診者の場所」プロパティにより、アセットまたはレターが関連する配信地域を特定できます。

NOTE
カスタムプロパティを既に追加している場合は、そのプロパティがアセット作成ページに表示され始めます。 このようなプロパティを非表示にするには、アセット作成ページとプロパティページでのカスタムプロパティの表示/非表示を参照してください。

すべてのアセットタイプに追加されたカスタムプロパティ

すべてのアセットタイプおよびレターにカスタムプロパティを追加するには、次の手順を実行します。

  1. https://[server]:[port]/[ContextPath]/crx/de に移動して、管理者でログインします。

  2. apps フォルダー内で、次の手順で css フォルダー（ccrui フォルダーに存在）に類似したパス／構造で、css という名前のフォルダーを作成します。

    1. 以下のパスにある items フォルダーを右クリックし、ノードをオーバーレイ ​を選択します。

      /libs/fd/cm/ma/gui/content/cmmetadataproperties/commonproperties/col1/items

      ノードをオーバーレイ

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス：/libs/fd/cm/ma/gui/content/cmmetadataproperties/commonproperties/col1/items

      場所：  /apps/

      ノードタイプを一致させる： ​選択済み

      ノードをオーバーレイ

    3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

    4. 「すべて保存」をクリックします。

  3. 次の手順を使用し、新規作成した items フォルダーにすべてのアセットのカスタムプロパティ用のノードを追加します（例：GeoLocation）。

    1. items フォルダーを右クリックして、「作成／ノードを作成」を選択します。

      CRX でのノードの作成

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： GeoLocation（または、このプロパティに与える任意の名前）

      型： nt:unstructured

      ノードを作成：GeoLocation

    3. 作成した新しいノード（ここでは「GeoLocation」）をクリックします。 CRX にノードのプロパティが表示されます。

    4. このノード（ここでは「GeoLocation」）に次のプロパティを追加します。

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      名前 種類 値
      fieldLabel 文字列 フィールド/プロパティに与える名前。 ( ここでは（受信者の場所）
      name 文字列 ./extendedproperties/GeoLocation（値は items ノードで作成したフィールド名と同じにします）
      renderReadOnly ブール値 true
      sling:resourceType 文字列 granite/ui/components/coral/foundation/form/textfield

    5. 「すべて保存」をクリックします。

  4. カスタマイズ内容を表示するには、アセット（テキスト、リスト、条件、レイアウトフラグメント）またはレターの上にマウスポインターを置いて、 プロパティを表示 ​をクリックし、 編集. 新しいフィールド（受信者の場所）が、アセット/レタープロパティの「基本」タブに表示されます。

    note note
    NOTE
    カスタマイズを UI に表示する前に、ブラウザーのキャッシュをクリアする必要が生じる場合があります。

    すべてのアセットに追加されたカスタムプロパティ

    note note
    NOTE
    追加するすべてのアセットの共通プロパティは、アセットプロパティの「基本」タブに表示されます。 デフォルトでは、すべてのアセットに追加された共通のプロパティは、プロパティページおよびアセット作成ページに表示されます。 共通のプロパティを非表示にするには、[link to show / hide properties] を実行する必要があります。

シナリオ：カスタムプロパティ/フィールドにカスタムドロップダウンと値を追加する scenario-add-custom-drop-down-and-values-to-a-custom-property-field

このシナリオでは、すべてのアセットタイプにカスタムプロパティを追加し、それにドロップダウン値を追加する方法を示します。

  1. 次のパスにある items フォルダーを右クリックし、「ノードをオーバーレイ」を選択します。

    /libs/fd/cm/ma/gui/content/cmmetadataproperties/commonproperties/col1/items

  2. 新しく作成されたオーバーレイノード (https://experienceleague.adobe.com/apps/fd/cm/ma/gui/content/cmmetadataproperties/commonproperties/col1/items?lang=ja) の下

    各プロパティ（フィールド）に対して、ドロップダウン ( ここでは geographicallocation) タイプ nt:unstructured。

  3. 次のプロパティをノード（ここでは「geographicallocation」）に追加し、「すべて保存」をクリックします。

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    名前 タイプ 値
    fieldLabel 文字列 フィールド/プロパティに与える名前。 ( ここではgeographicallocation)
    name 文字列 ./extendedproperties/geographicallocation（値は items ノードで作成したフィールド名と同じにします）
    renderReadOnly ブール値 true
    sling:resourceType 文字列 granite/ui/components/coral/foundation/form/select

  4. プロパティノード（ここでは「geographicallocation」）に、items という名前の新しいノードを追加します。items ノードの下に、ドロップダウンの値ごとにノードを追加します。 最初のノードを空白にしてドロップダウンのデフォルト値にし、ユーザーがフィールドに値を指定しないようにするオプションを追加することをお勧めします。 複数のオプション/ドロップダウン値を追加するには、次の手順を繰り返します。

    1. プロパティノード（ここでは geographicalLocation）を右クリックし、作成／ノードを作成 ​を選択します。

    2. フィールド名に item1, を入力し、タイプは nt:unstructured のままにして、「OK」をクリックします。

    3. 次のプロパティを新しく作成したノード（ここでは「item1」）に追加し、「すべて保存」をクリックします。

      table 0-row-3 1-row-3 2-row-3
      名前 タイプ 値
      text 文字列 これは、ユーザーに表示されるドロップダウンオプションの値です。 空白（デフォルト）の値の場合は空白のままにするか、次のような値を入力します。 国際 または 米国内.
      value 文字列 テキストに対して CRXDE に保存される値。一意のキーワードを入力します。

      customizationdropdownvaluescrxde

カスタムドロップダウンは、アセットプロパティで次のように表示されます。

drop-down_customization

シナリオ：すべてのアセットタイプの「共通」タブ scenario-common-tab-for-all-asset-types

このシナリオでは、すべてのアセットタイプ（テキスト、リスト、条件、レイアウトフラグメント）とレターにカスタムタブ「受信者」を追加する方法を示します。 「受信者」タブでは、受信者に関連するすべてのカスタムプロパティを配置する計画を立てることができます。

すべてのアセットタイプに追加されたカスタムタブ

次の手順を使用して、すべてのアセットにフィールド付きのタブを追加できます。

  1. https://[server]:[port]/[ContextPath]/crx/de にアクセスし、管理者としてログインします。

  2. apps フォルダーに、（content フォルダー内の）cmmetadataproperties フォルダーに類似したパス／構造で cmmetadataproperties という名前のフォルダーを作成します。手順は次のとおりです。

    1. 次のパスにある cmmetadataproperties フォルダーを右クリックし、「ノードをオーバーレイ」を選択します。

      /libs/fd/cm/ma/gui/content/cmmetadataproperties

      ノードをオーバーレイ

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス：  /libs/fd/cm/ma/gui/content/cmmetadataproperties

      場所：  /apps/

      ノードタイプを一致させる： ​選択済み

    3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

      CRX で作成されたオーバーレイフォルダー構造

      「すべて保存」をクリックします。

  3. cmmetadataproperties フォルダーに、すべてのアセット用のカスタムタブを作成するためのノードを追加します（例：commontab）。手順は次のとおりです。

    1. cmmetadataproperties フォルダーを右クリックして、「作成／ノードを作成」を選択します。

      ノードを作成

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： commontab（または、このプロパティに与える任意の名前）

      タイプ： nt:unstructured

    3. 作成した新しいノード（ここでは「commontab」）をクリックします。 CRX にノードのプロパティが表示されます。

    4. このノード（ここでは「commontab」）に次のプロパティを追加します。

      table 0-row-3 1-row-3 2-row-3
      名前 タイプ 値
      jcr:title 文字列 列に付ける名前。 ( ここでは受信者 )
      sling:resourceType 文字列 granite/ui/components/coral/foundation/container

    5. 「すべて保存」をクリックします。

  4. 最後の手順（ここでは commontab）で作成したタブノードに対して、次の手順を使用して item というノードを作成します。

    1. 関連するノード（ここでは「commontab」）を右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： 項目

      タイプ： nt:unstructured

    3. 「すべて保存」をクリックします。

  5. 前の手順で作成した items ノード（commontab の下）で、カスタムタブ（commontab）内の列（ここでは「Column1」）を作成するためのノードを追加します。手順は次のとおりです（さらに列を追加するには、この手順を繰り返します）。

    1. items ノードを右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： Column1（または、このノードに与える任意の名前。この名前はユーザーインターフェイスには表示されません。）

      タイプ： nt:unstructured

    3. 次のプロパティをノード（ここでは「Column1」）に追加し、「すべて保存」をクリックします。

      table 0-row-3 1-row-3
      名前 タイプ 値
      sling:resourceType 文字列 granite/ui/components/coral/foundation/container

  6. 前の手順で作成したノード（ここでは「Column1」）に、item という名前のノードを作成します。手順は次のとおりです。

    1. ノード（ここでは「Column1」）を右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： 項目

      タイプ： nt:unstructured

    3. 「すべて保存」をクリックします。

  7. カスタムタブ（ここでは「受信者」）でフィールドを作成するには、ノード（ここでは「GeographicalLocation」）を追加します。 このプロパティは、作成した列に対応します。 次の手順を実行して、フィールドを作成します（さらにフィールドやノードを作成するには、これらの手順を繰り返します）。：

    1. items ノードを右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： GeographicalLocation （またはフィールドプロパティの別の名前）

      タイプ： nt:unstructured

    3. 次のプロパティをフィールドノード（ここでは「GeographicalLocation」）に追加し、 すべて保存.

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      名前 種類 値
      fieldLabel 文字列 受信者の場所（または、フィールドに与える任意の名前）。
      name 文字列 。/extendedproperties/GeographicalLocation
      renderReadOnly ブール値 true
      sling:resourceType 文字列 /libs/granite/ui/components/coral/foundation/form/textfield

  8. レターにこのタブを追加するには、次のパスにある以下の items フォルダーに類似したパス／構造でオーバーレイフォルダーを作成します。

    /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/letter/items/tabs/items

    レターまたは異なるアセットに対してオーバーレイを作成するには、[assettype] を text、condition、list、datadictionary または fragment に置き換えて、次のパスを使用します。

    /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[assettype]/items/tabs/items

    1. 次のパスにある items フォルダーを右クリックし、「ノードをオーバーレイ」を選択します。

      /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/letter/items/tabs/items

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス：  /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/letter/items/tabs/items

      場所：  /apps/

      ノードタイプを一致させる： ​選択済み

    3. 「OK」をクリックします。フォルダーが作成されます。 「すべて保存」をクリックします。

  9. 新規作成した items フォルダーに、アセットのカスタムタブ用のノードを追加します（ここでは「mytab」とします。この名前はユーザーインターフェイスには表示されません）。手順は次のとおりです。

    1. items フォルダーを右クリックして、「作成／ノードを作成」を選択します。

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： mytab（またはこのプロパティに与える任意の名前）

      タイプ： nt:unstructured

    3. 作成した新しいノード（ここでは mytab）をクリックします。 CRX にノードのプロパティが表示されます。

    4. このノード（ここでは「customtab」）に次の 2 つのプロパティを追加します。

      table 0-row-3 1-row-3 2-row-3
      名前 タイプ 値
      path 文字列 fd/cm/ma/gui/content/cmmetadataproperties/commontab
      sling:resourceType 文字列 granite/ui/components/coral/foundation/include

    5. 「すべて保存」をクリックします。

  10. カスタマイズ内容を表示するには、関連するアセット（ここではレター）の上にマウスポインターを置き、「プロパティを表示」をクリックし、 編集. 新しいタブ（受信者）とフィールド（受信者の場所）がユーザーインターフェイスに表示されます。

    note note
    NOTE
    カスタマイズを UI に表示する前に、ブラウザーのキャッシュをクリアする必要が生じる場合があります。

    レターに追加されたカスタムタブ

シナリオ：特定のアセットタイプのカスタムプロパティの追加 scenario-adding-custom-properties-for-specific-asset-types

このシナリオでは、すべてのテキストアセットにフィールドなどのプロパティを特定のアセットタイプに追加する方法を示します。 このプロセスを使用して、次のいずれかにプロパティを追加できます。

  • テキスト
  • 条件
  • リスト
  • レイアウトフラグメント
  • データディクショナリ
  • レター

例えば、テキストアセットにのみ、プロパティ「受信者の場所」を追加して、アセットが関連する地域を特定することができます。 アセットに追加されたカスタムプロパティ

アセットタイプにプロパティを追加するには、次の手順を実行します。

  1. https://[server]:[port]/[ContextPath]/crx/de に移動して、管理者としてログインします。

  2. アセットタイプ（テキストなど）でタブを作成するには、apps フォルダーに以下のフォルダー構造を作成します。

    /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[AssetType]/items/tabs/items

    [AssetType] = text、condition、list、letter、datadictionary または fragment

    次の手順に従って、このフォルダー構造を作成します。

    1. 以下のパスにある items フォルダーを右クリックし、「ノードをオーバーレイ」を選択します。

      /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[AssetType]/items/tabs/items

      例えば、テキストアセットのプロパティを作成する場合は、次のフォルダーを選択します。

      /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/text/items/tabs/items

      ノードをオーバーレイ

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス： /libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[AssetType]/items/tabs/items

      場所：/apps/

      ノードタイプを一致させる： ​選択済み

    3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

      「すべて保存」をクリックします。

  3. 次の手順を使用し、新規作成した items フォルダーにアセットのカスタムタブ用のノードを追加します（例：customtab）。

    1. items フォルダーを右クリックして、「作成／ノードを作成」を選択します。

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： customtab（または、このプロパティに与える任意の名前）

      タイプ： nt:unstructured

    3. 作成した新しいノード（ここでは「customtab」）をクリックします。 CRX にノードのプロパティが表示されます。

    4. このノード（ここでは「customtab」）に次の 2 つのプロパティを追加します。

      table 0-row-3 1-row-3 2-row-3
      名前 種類 値
      sling:resourceType 文字列 granite/ui/components/coral/foundation/container
      jcr:title 文字列 ユーザーインターフェイス上のフィールドの名前（ここでは「My」タブ）

    5. 「すべて保存」をクリックします。

  4. 次の手順を使用し、前の手順で作成したノード（ここでは customtab）に item という名前のノードを作成します。

    1. ノード（ここでは「customtab」）を右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： 項目

      タイプ： nt:unstructured

    3. 「すべて保存」をクリックします。

  5. 次の手順を使用し、前の手順で作成した items ノード（customtab の下）で、カスタムタブ内の列（ここでは Column1）を作成するためのノードを追加します（さらに列を追加するには、この手順を繰り返します）。

    1. items ノードを右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： Column1（または、このノードに与える任意の名前）

      タイプ： nt:unstructured

    3. 次のプロパティをノード（ここでは Column1）に追加してから、「すべて保存」をクリックしてください。

      table 0-row-3 1-row-3
      名前 タイプ 値
      sling:resourceType 文字列 granite/ui/components/coral/foundation/container

  6. 次の手順を使用し、作成する各列（前の手順で作成した列、ここでは Column1）に item という名前のノードを作成します。

    1. 該当する列ノード（ここでは「Column1」）を右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： 項目

      タイプ： nt:unstructured

    3. 「すべて保存」をクリックします。

  7. 作成した各列に対して、items ノードの下に、ユーザーインターフェイスの新しいタブでフィールドを作成するためのノードを作成します。 この手順を繰り返して、列にさらにフィールドを作成します。

    1. 関連するノード（ここでは「列 1」の下の項目）を右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： ​任意の名前（ここでは GeoLocation）

      タイプ： nt:unstructured

    3. 次のプロパティをノードに追加して、「すべて保存」をクリックします。

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      名前 種類 値
      fieldLabel 文字列 受信者の場所（または、フィールドに与える任意の名前）。
      name 文字列 。/extendedproperties/GeoLocation
      renderReadOnly ブール値 true
      sling:resourceType 文字列 granite/ui/components/coral/foundation/form/textfield

  8. カスタマイズ内容を表示するには、関連するアセット（ここではテキスト）の上にマウスポインターを置き、「プロパティを表示」をクリックして、 編集. 新しいタブとフィールド（受信者の場所）がユーザーインターフェイスに表示されます。

    note note
    NOTE
    カスタマイズを UI に表示する前に、ブラウザーのキャッシュをクリアする必要が生じる場合があります。

    特定のアセットに追加されたカスタムプロパティ

アセット作成ページでのカスタムプロパティの表示 display-custom-properties-on-the-asset-creation-page

アセット作成ページにはタブレイアウトがないので、デフォルトでは、新しいタブに追加されたカスタムプロパティはプロパティページにのみ表示され、アセット作成ページには表示されません。アセット作成ページに他のプロパティと共にカスタムプロパティを表示するには、次の手順を実行する必要があります。

  1. 以下のパスにある items フォルダーを右クリックしてから、「ノードをオーバーレイ」を選択してください。

    /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items

  2. レターのノードをオーバーレイダイアログに次の値が含まれていることを確認します。 その他のアセットタイプの場合、パスは次の表に示されます。

    パス： /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items

    場所：/apps/

    ノードタイプを一致させる： ​選択済み

    アセットのタイプに応じて、次のパスにする必要があります。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    アセット/ドキュメントタイプ 追加するパス
    テキスト /libs/fd/cm/ma/gui/content/createasset/createtext/jcr:content/body/items/form/items/textwizard/items/editproperties/items/properties/items/tabs/items/tab1/items
    リスト /libs/fd/cm/ma/gui/content/createasset/createlist/jcr:content/body/items/form/items/listwizard/items/editproperties/items/properties/items/tabs/items/tab1/items
    条件 /libs/fd/cm/ma/gui/content/createasset/createcondition/jcr:content/body/items/form/items/conditionwizard/items/editproperties/items/properties/items/tabs/items/tab1/items
    ぶれ /libs/fd/cm/ma/gui/content/createasset/createfragment/jcr:content/body/items/form/items/fragmentwizard/items/properties/items/properties/items/properties/items/tabs2/items/tab1/items
    レター /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items

  3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

  4. 作成したオーバーレイ items ノードに、名前が col4（またはその他の任意の名前）のノードを作成し、「すべて保存」をクリックします。

    例えば、以下は、レターに対して作成されたオーバーレイノードです。

    /apps/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items

  5. 次のプロパティを新しく作成したノード（ここでは「col4」）に追加し、「すべて保存」をクリックします。

    table 0-row-3 1-row-3 2-row-3 html-authored no-header
    名前 タイプ 値
    path 文字列

    このパスは、次の場所で作成された列へのポインターです。

    • すべてのアセットタイプ用の共通タブの場合：/apps/fd/cm/ma/gui/content/cmmetadataproperties/commontab/items/col1
    • 様々なアセットタイプ用の様々なプロパティの場合：/apps/fd/cm/ma/gui/content/cmmetadataproperties/properties//items/tabs/items/customtab/items/col1
    sling:resourceType 文字列 granite/ui/components/coral/foundation/include

    customfieldappearinginmainproperties

    レターを作成するための UI に表示されるカスタムプロパティ（言語）

リスト表示をカスタマイズしてカスタムプロパティを表示 customize-the-list-view-to-show-custom-properties

Correspondence Management アセットにカスタムプロパティを追加した後、CRX/DE をさらに変更して、カスタムプロパティが Correspondence Management UI に表示されるようにする必要があります。

Correspondence Management のアセットリスト UI にカスタムプロパティを表示するには、次の手順を実行します。

  1. https://[server]:[port]/[ContextPath]/crx/deに移動して、管理者としてログインしてください。

  2. apps フォルダーに以下のフォルダー構造を作成します。

    /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/lists/columns

    次の手順に従って、このフォルダー構造を作成します。

    1. 次のパスにある columns フォルダーを右クリックしてから、「ノードをオーバーレイ」を選択してください。

      /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/lists/columns

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス：/libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/lists/columns

      場所：/apps/

      ノードタイプを一致させる： ​選択済み

    3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

      「すべて保存」をクリックします。

  3. 作成した各プロパティに対して、「columns」ノードの下に、ユーザーインターフェイスで列を作成するためのノードを作成します。 この手順を繰り返して、UI にさらに列を作成します。

    1. 関連するノード（列）を右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： ​任意の名前（ここでは GeographicalLocation）

      タイプ： nt:unstructured

    3. 次のプロパティをノードに追加して、「すべて保存」をクリックします。

      table 0-row-3 1-row-3 2-row-3 3-row-3
      名前 タイプ 値
      jcr:primaryType 名前 nt:unstructured
      jcr:title 文字列 GeographicalLocation この値は、UI の列ヘッダーとして表示されます。
      並べ替え可能な ブール値 true 値が true の場合、ユーザーはこの列の値を並べ替えることができます。

  4. apps フォルダーに以下のフォルダー構造を作成します。

    /libs/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage

    次の手順に従って、このフォルダー構造を作成します。

    1. 次のパスにある columns フォルダーを右クリックしてから、「ノードをオーバーレイ」を選択してください。

      /libs/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス：/libs/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage

      場所：/apps/

      ノードタイプを一致させる： ​選択済み

    3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

      「すべて保存」をクリックします。

  5. 以下の場所から childlistpage.jsp ファイルをコピーします。

    /libs/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/childlistpage.jsp

    ファイルを次の場所に貼り付けます。

    /apps//fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/

  6. childlistpage.jsp ファイル (https://experienceleague.adobe.com/apps/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/childlistpage.jsp?lang=ja) を開き、次の変更を行います。

    1. ファイルの 19 行目に以下の内容を追加します（著作権表記の後に記述）。

      code language-none 
      <%@page import="java.util.Map"%>

    2. 各カスタムプロパティの値を取得する関数の次のコードを、ファイルの最後に追加します。

      code language-none 
      <%!
    private String getCustomPropertyValue(Map<String, Object> extendedProperties, String propertyName) {

        String propertyValue = "";
        if (extendedProperties.containsKey(propertyName)) {
            propertyValue = (String) extendedProperties.get(propertyName);
        }

        return propertyValue;
    }
%>

    3. <tr> タグ (<tr <%= attrs.build() %>>): の前に以下を追加します。

      code language-none 
      <%
    String GeoLocation = "";
    if (asset != null) {
            Map<String, Object> extendedProperties = asset.getExtendedProperties();
            if (extendedProperties != null) {
                GeoLocation = getCustomPropertyValue(extendedProperties,"GeoLocation");
            }
    }
%>

      GeoLocation は、カスタムのノードまたはフィールドの作成時に name プロパティで設定した値です。 カスタムのノードまたはフィールドを作成する際に、プロパティの名前をで指定しました。/extendedproperties/ prefix: ./extendedproperties/GeoLocation に設定します。 コードでは、プレフィックスは不要です。

    4. UI に新しいプロパティを表示するには、終了 tr (</tr>) タグの前に TD タグを以下のように追加します。

      code language-none 
      <td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(geographicalLocation) %>"><%= xssAPI.encodeForHTML(geographicalLocation) %></td>

      列をさらに追加するには、手順 6.3 と 6.4 を繰り返します。

    5. 「すべて保存」をクリックします。

  7. カスタマイズ内容を表示するには、カスタムプロパティを追加したドキュメントフラグメントまたはレターのリスト表示を開きます。

    この手順で追加された UI 列とプロパティは、すべてのアセットタイプに対して表示されます。 ただし、これらのプロパティの値は、最初にカスタムプロパティを追加したアセットタイプに対してのみ、入力および表示できます。

    例えば、「シナリオ：特定のアセットタイプのカスタムプロパティの追加」を使用してテキストアセットにカスタムプロパティを追加した場合、テキストアセットにのみカスタムプロパティを入力できます。ただし、そのカスタムプロパティを UI に表示する場合、列はすべてのアセットタイプで表示されます。

    custompropertyinlistview

  8. （オプション）デフォルトでは、新しい列は UI の最後の列として表示されます。 列を特定の位置に表示するには、次のプロパティを列ノードに追加します。

    table 0-row-3 1-row-3
    名前 タイプ 値
    sling:orderBefore 文字列 パス「 」の列ノードの名前/libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns」をクリックします。 ここで、「地理的な場所」列を「バージョン」列の前（左）に表示する場合は、プロパティを追加します。 sling:orderBefore パス「 」の GeoLocation ノードに/apps/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns/GeoLocation」と入力し、プロパティの値を version に設定します。

    sling:orderBefore プロパティを追加して列の位置を指定する場合は、対応する <td> タグは、この手順の手順 6.4 で指定します。 例えば、この場合、 <td> 地理的位置のタグが次の前に配置されています： <td> タグのバージョン列：

    code language-xml 
    <td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(geographicalLocation) %>"><%= xssAPI.encodeForHTML(geographicalLocation) %></td>
<td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(version) %>"><%= xssAPI.encodeForHTML(version) %></td>

カスタムプロパティの検索を有効にする enable-search-for-custom-properties

デフォルトでは、フルテキスト検索には、CRX/DE を使用して UI に追加するカスタムプロパティは含まれません。

カスタムプロパティを検索に含めるには、カスタムプロパティのインデックス作成を許可する必要があります。

カスタムプロパティのインデックス作成を可能にするには、次の手順を実行します。

  1. https://[server]:[port]/[ContextPath]/crx/deに移動して、管理者としてログインしてください。

  2. /oak:index/cmLuceneに移動して、その下に​ aggregates ​という名前のノードを追加してください。

    1. cmLucene フォルダーを右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： 集計

      タイプ： nt:unstructured

    3. 「すべて保存」をクリックします。

  3. 新規作成した aggregates フォルダーに、ノード cm:resource を追加します。cm:resource の下に、include0 という名前のノードを追加します。

    1. aggregates フォルダーを右クリックして、「作成／ノードを作成」を選択します。ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： cm:resource

      タイプ： nt:unstructured

    2. cm:resource フォルダーを右クリックして、「作成／ノードを作成」を選択します。ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： include0

      型： nt:unstructured

    3. 作成した新しいノード（ここでは include0）をクリックします。 CRX にノードのプロパティが表示されます。

    4. このノード（ここでは「include0」）に次のプロパティを追加します。

      table 0-row-3 1-row-3
      名前 タイプ 値
      path 文字列 extendedProperties

    5. 「すべて保存」をクリックします。

  4. 次の場所にあるプロパティに移動し、その下にノードを追加します。/oak:index/cmLucene/indexRules/cm:resource/properties

    検索に追加する各カスタムプロパティに対して、この手順を繰り返します。

    1. properties フォルダーを右クリックし、「 」を選択します。 作成 > ノードを作成.

    2. ノードを作成ダイアログに次の値が表示されていることを確認し、「OK」をクリックします。

      名前： location（または、検索に追加するカスタムプロパティの名前）

      型： nt:unstructured

    3. 作成した新しいノード（ここでは場所）をクリックします。 CRX にノードのプロパティが表示されます。

    4. このノード（ここでは「location」）に次のプロパティを追加します。

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      名前 種類 値
      分析済み 文字列 true
      name 文字列 extendedProperties/location（または検索に追加するプロパティの名前）
      propertyIndex ブール値 true
      useInSuggest ブール値 true

    5. 「すべて保存」をクリックします。

  5. フルテキスト検索でカスタムプロパティ値を使用して、関連するアセットを検索できるようになりました。

NOTE
それでも検索できない場合は、インデックスの問題が原因の可能性があります。 インデックスを再作成するには、次のノードに移動し、プロパティ「re-index」の値を true に変更します。
/oak:index/cmLucene"とプロパティの値を変更します。

検索ページのデフォルトの表示を変更 change-default-view-of-the-search-page

  1. https://[server]:[port]/[ContextPath]/crx/de にアクセスし、管理者としてログインします。

  2. apps フォルダーで、/libs/granite/ui/content/shell/omnisearch/searchresults/singleresults/views にある list フォルダーと類似したパス／構造で list という名前のフォルダーを作成します。

    1. 以下のパスにある items フォルダーを右クリックし、「ノードをオーバーレイ」を選択します。

      /libs/granite/ui/content/shell/omnisearch/searchresults/singleresults/views/list

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス：/libs/granite/ui/content/shell/omnisearch/searchresults/singleresults/views/list

      場所：/apps/

      ノードタイプを一致させる： ​選択済み

    3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

    4. 「すべて保存」をクリックします。

  3. 新しく作成したノードのリストで、次のプロパティを追加し、 すべて保存:

    table 0-row-3 1-row-3
    名前 タイプ 値
    sling:orderBefore 文字列 card

  4. カスタマイズでは、Formsとドキュメント、アセット、サイトを含むすべてのコンソールの検索結果がリスト表示で表示されます。

アセットページのデフォルト表示の変更 change-default-view-of-the-assets-page

NOTE
これらの手順では、Forms、ドキュメント、アセット、サイトなど、すべてのコンソールのデフォルト表示を変更します。

  1. https://[server]:[port]/[ContextPath]/crx/de にアクセスし、管理者としてログインします。

  2. apps フォルダーで、以下のパスにある list フォルダーと類似したパス／構造で list という名前のフォルダーを作成します。

    /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/

    1. 次のパスにある items フォルダーを右クリックし、「ノードをオーバーレイ」を選択します。

      /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/list

    2. ノードをオーバーレイダイアログに次の値が表示されていることを確認します。

      パス：  /libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/list

      場所：  /apps/

      ノードタイプを一致させる： ​選択済み

    3. 「OK」をクリックします。apps フォルダーにフォルダー構造が作成されます。

    4. 「すべて保存」をクリックします。

  3. 新しく作成したノードのリストで、次のプロパティを追加し、 すべて保存:

    table 0-row-3 1-row-3
    名前 タイプ 値
    sling:orderBefore 文字列 card

  4. ブラウザーの Cookie をクリアするか、ブラウザーの匿名モードを使用してアセットを表示します。 アセットページは、デフォルトでカードレイアウトに表示されます。

アセット作成ページとプロパティページでカスタムプロパティを表示/非表示 show-hide-custom-properties-on-asset-creation-and-properties-pages

カスタムプロパティの表示/非表示を切り替えるには、次の手順を実行します。

  1. geographicallocation などのカスタムプロパティノードに、タイプが「nt:unstructured」の「granite:rendercondition」という名前の新しいノードを作成します。

  2. 次のプロパティをノードに追加し、「すべて保存」をクリックします。

    table 0-row-3 1-row-3
    名前 タイプ 値
    sling:resourceType 文字列 fd/cm/ma/gui/components/admin/assetsproperties/custompropertyconfig

  3. アセット作成ページでこのプロパティを非表示にするには、次のプロパティを追加し、「すべて保存」をクリックします。

    table 0-row-3 1-row-3
    名前 タイプ 値
    hideOnCreate ブール値 true

  4. アセットのプロパティページでカスタムプロパティを非表示にするには、カスタムプロパティに次のプロパティを追加して、 すべて保存:

    table 0-row-3 1-row-3
    名前 タイプ 値
    hideOnEdit ブール値 true

    値を再び表示するには、プロパティの値を false に再設定するか、プロパティエントリを削除します。

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da