Correspondence Management アセットへのカスタムプロパティの追加

概要

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

Correspondence Management アセットへのカスタムプロパティの追加

以下のシナリオで、Correspondence Management アセットおよびレターにプロパティ／タブを追加する方法について説明します。

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

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

シナリオ：すべてのアセットタイプへの共通フィールド（プロパティ）の追加

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

メモ

カスタムプロパティを追加すると、プロパティはアセット作成ページに表示されるようになります。このようなプロパティを非表示にする方法については、「アセット作成ページとプロパティページでのカスタムプロパティの表示／非表示」を参照してください。

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

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

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

  2. 次の手順を使用して、appsフォルダーに、（ccruiフォルダー内の）cssフォルダーに似たパス/構造を持つ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」）に次のプロパティを追加します。

      名前 種類 値
      fieldLabel 文字列 フィールド／プロパティに与える任意の名前。（ここでは「Location of recipients」）
      name 文字列 ./extendedproperties/GeoLocation （値は、itemsノードで作成したフィールド名と同じにします）。
      renderReadOnly ブール値 true
      sling:resourceType 文字列 granite/ui/components/coral/foundation/form/textfield

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

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

    メモ

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

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

    メモ

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

シナリオ：カスタムプロパティ／フィールドへのカスタムドロップダウンおよび値の追加

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

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

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

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

    プロパティ（フィールド）ごとにノードを作成し、そのノードのタイプnt:unstructuredのドロップダウン（ここではgeographicallocation）を作成します。

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

    名前 タイプ 値
    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）に追加し、「すべて保存」をクリックします。

      名前 タイプ 値
      text 文字列 これは、ユーザーに表示されるドロップダウンオプションの値です。空白（デフォルト）値の場合は空白のままにします。または、「海外」、「米国内」などの値を入力します。
      value 文字列 CRXDEにテキスト用に保存される値。 一意のキーワードを入力します。

      customizationdropdownvaluescrxde

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

dropdown_customization

シナリオ：すべてのアセットタイプ用の共通タブ

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

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

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

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

  2. 次の手順を使用して、appsフォルダーに、（コンテンツフォルダー内の）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フォルダーの下に、すべてのアセットのカスタムタブを作成するノードを追加します(例：「共通」タブ)を次の手順で使用します。

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

      ノードを作成

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

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

      タイプ： nt:unstructured

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

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

      名前 タイプ 値
      jcr:title 文字列 列に与える任意の名前。（ここでは「Recipients」）
      sling:resourceType 文字列 granite/ui/components/coral/foundation/container

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

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

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

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

      名前： items

      タイプ： nt:unstructured

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

  5. 前の手順で作成したitemsノード（「commontab」の下）で、次の手順を使用して、カスタムタブ(「commontab」)に列を作成するノード（ここでは「Column1」）を追加します（列を追加するには、この手順を繰り返します）。

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

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

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

      タイプ： nt:unstructured

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

      名前 タイプ 値
      sling:resourceType 文字列 granite/ui/components/coral/foundation/container

  6. 前の手順で作成したノード（ここでは「Column1」）に、次の手順を使用して、「items」というノードを追加します。

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

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

      名前： items

      タイプ： nt:unstructured

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

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

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

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

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

      タイプ： nt:unstructured

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

      名前 種類 値
      fieldLabel 文字列 Location of recipients（または、フィールドに与える任意の名前。）
      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]をテキスト、条件、リスト、データ辞書、フラグメントに置き換えて、次のパスを使用します。

    /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 つのプロパティを追加します。

      名前 タイプ 値
      path 文字列 fd/cm/ma/gui/content/cmmetadataproperties/commontab
      sling:resourceType 文字列 granite/ui/components/coral/foundation/include

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

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

    メモ

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

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

シナリオ：特定のアセットタイプのカスタムプロパティの追加

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

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

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

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

  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 つのプロパティを追加します。

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

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

  4. 前の手順で作成したノード（ここでは「customtab」）で、次の手順を使用して「items」というノードを追加します。

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

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

      名前： items

      タイプ： nt:unstructured

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

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

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

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

      名前： 列1（またはノードに与える任意の名前）

      タイプ： nt:unstructured

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

      名前 タイプ 値
      sling:resourceType 文字列 granite/ui/components/coral/foundation/container

  6. 作成する各列(前の手順（ここでは「Column1」）で指定)に対して、次の手順を使用してitemというノードを作成します。

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

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

      名前： items

      タイプ： nt:unstructured

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

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

    1. 関連ノード（ここでは「Column1」の下の「items」）を右クリックし、「作成／ノードを作成」を選択します。

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

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

      タイプ： nt:unstructured

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

      名前 種類 値
      fieldLabel 文字列 Location of recipients（または、フィールドに与える任意の名前。）
      name 文字列 。/extendedproperties/GeoLocation
      renderReadOnly ブール値 true
      sling:resourceType 文字列 granite/ui/components/coral/foundation/form/textfield

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

    メモ

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

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

アセット作成ページでのカスタムプロパティの表示

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

  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/

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

    アセットの種類に応じたパスを使用する必要があります。

    アセット／ドキュメントタイプ 追加するパス
    テキスト /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/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. 作成したオーバーレイ項目ノードの下に、名前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」）に追加し、「すべて保存」をクリックします。

    名前 タイプ 値
    パス 文字列

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

    • すべてのアセットタイプの共通タブの場合：/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 に表示される、カスタムプロパティ、言語

カスタムプロパティを表示するための一覧表示のカスタマイズ

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. 関連ノード（ここでは「columns」）を右クリックし、「作成／ノードを作成」を選択します。

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

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

      タイプ： nt:unstructured

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

      名前 タイプ 値
      jcr:primaryType 名前 nt:unstructured
      jcr:title 文字列 GeographicalLocationこの値は、UIの列ヘッダーとして表示されます。
      sortable ブール値 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 ファイル（/apps/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/childlistpage.jsp）を開き、次のように変更します。

    1. ファイルの 19 行目に以下を追加します（著作権情報の後）。

      <%@page import="java.util.Map"%>

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

      <%!
    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() %>>)の前に、次を追加します。

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

      コード内の GeoLocation は、カスタムノード／フィールドの作成時に名前プロパティで設定した値です。カスタムノード／フィールドの作成時、プロパティの名前を /extendedproperties/ prefix: ./extendedproperties/GeoLocation で指定しました。コードの prefix は必須ではありません。

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

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

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

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

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

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

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

    custompropertyinlistview

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

    名前 タイプ 値
    sling:orderBefore 文字列 UIにカスタム列を表示する前のパス「/libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns」にある列ノードの名前。 ここで、「バージョン」列の前（左）に「地理的場所」列を表示する場合は、パス「/apps/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns/GeoLocation」のGeoLocationノードにプロパティsling:orderBeforeを追加し、プロパティの値を「バージョン」に設定します。

    sling:orderBefore プロパティを追加して列の位置を指定する場合は、この手順の手順 6.4 で指定した、対応する <td> タグの順序も更新する必要があります。例えば、この場合、Geographical Location の <td> タグを Version 列の <td> タグの前に配置する必要があります。

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

カスタムプロパティの検索の有効化

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

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

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

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

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

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

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

      名前： aggregates

      タイプ： nt:unstructured

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

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

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

      名前： cm:resource

      タイプ： nt:unstructured

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

      名前： include0

      タイプ： nt:unstructured

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

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

      名前 タイプ 値
      パス 文字列 extendedProperties

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

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

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

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

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

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

      タイプ： nt:unstructured

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

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

      名前 種類 値
      analyzed 文字列 true
      name 文字列 extendedProperties/location（または、検索に追加するプロパティの名前）
      propertyIndex ブール値 true
      useInSuggest ブール値 true

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

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

メモ

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

/oak:index/cmLucene およびプロパティの値の変更

検索ページのデフォルト表示の変更

  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. 新しく作成したノード list で、次のプロパティを追加し、「すべて保存」をクリックします。

    名前 タイプ 値
    sling:orderBefore 文字列 card

  4. カスタマイズにより、フォームとドキュメント、アセット、サイトを含むすべてのコンソールで一覧表示に検索結果が表示されるようになりました。

アセットページのデフォルト表示の変更

メモ

以下の手順は、フォームとドキュメント、アセット、サイトなどのすべてのコンソールのデフォルト表示を変更します。

  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. 新しく作成したノード list で、次のプロパティを追加し、「すべて保存」をクリックします。

    名前 タイプ 値
    sling:orderBefore 文字列 カード

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

アセット作成ページとプロパティページでのカスタムプロパティの表示／非表示

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

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

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

    名前 タイプ 値
    sling:resourceType 文字列 fd/cm/ma/gui/components/admin/assetsproperties/custompropertyconfig

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

    名前 タイプ 値
    hideOnCreate ブール値 true

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

    名前 タイプ 値
    hideOnEdit ブール値 true

    値を再度表示するには、プロパティ値をfalseにリセットするか、プロパティエントリを削除します。

このページ