Correspondence Management ユーザーインターフェイスをカスタマイズし、調整したプロパティとタブのセットをユーザーに提示できます。このカスタマイズには、特定のアセットタイプ/レターまたはすべてのアセットタイプおよびレターへのカスタムフィールド/プロパティおよびタブの追加が含まれます。
以下のシナリオで、Correspondence Management アセットおよびレターにプロパティ/タブを追加する方法について説明します。
- すべてのアセットタイプへの共通プロパティの追加
- すべてのアセットタイプへの共通タブの追加
- 特定のアセットタイプへのカスタムプロパティの追加
これらのシナリオでプロパティ、パスおよび値を調整することにより、要件に従い、様々なアセットのセットにカスタムプロパティおよびタブを追加できます。
このシナリオでは、すべてのアセットタイプ(テキスト、リスト、条件およびレイアウトフラグメント)およびレターにカスタムプロパティを追加する方法について説明します。このシナリオを使用して、すべてのアセットおよびレターにプロパティ Location of recipients を追加できます。Location of recipients プロパティにより、アセットまたはレターが関連する配信地域を特定できます。
注意:
カスタムプロパティを追加すると、プロパティはアセット作成ページに表示されるようになります。このようなプロパティを非表示にする方法については、「アセット作成ページとプロパティページでのカスタムプロパティの表示/非表示」を参照してください。

-
-
-
カスタマイズ内容を表示するには、アセット(テキスト、リスト、条件またはレイアウトフラグメント)またはレターの上にカーソルを置き、「プロパティを表示」をクリックし、「編集」をクリックします。新しいフィールド(Location of recipients)がアセット/レタープロパティの「基本」タブに表示されます。
注意:
カスタマイズ内容を UI に表示するには、ブラウザーのキャッシュをクリアする必要が生じる場合があります。
注意:
すべてのアセットに追加する共通プロパティは、アセットプロパティの「基本」タブに表示されます。デフォルトでは、すべてのアセットに追加する共通プロパティは、プロパティページおよびアセット作成ページに表示されます。共通プロパティを非表示にする方法については、「[プロパティの表示/非表示へのリンク]」を参照してください。

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

-
-
レターにこのタブを追加するには、次のパスにある以下の 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
-
このシナリオでは、すべてのテキストアセットに対するフィールドなど、特定のアセットタイプにプロパティを追加する方法について説明します。このプロセスを使用して、次のいずれかにプロパティを追加できます。
- テキスト
- 条件
- リスト
- レイアウトフラグメント
- データディクショナリ
- レター

アセット作成ページにはタブレイアウトがないので、デフォルトでは、新しいタブに追加されたカスタムプロパティはプロパティページにのみ表示され、アセット作成ページには表示されません。アセット作成ページに他のプロパティと共にカスタムプロパティを表示するには、次の手順を実行する必要があります。
-
ノードをオーバーレイダイアログで、レターに次の値が表示されていることを確認します。他のアセットタイプのパスは以下の表に示されています。
パス: /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 -
名前 タイプ 値 パス 文字列 このパスは、以下の場所で作成された列へのポインターです。
- すべてのアセットタイプ用の共通タブの場合: /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 String granite/ui/components/coral/foundation/include レターを作成するための UI に表示される、カスタムプロパティ、言語
Correspondence Management アセットにカスタムプロパティを追加した後、CRX/DE でさらに変更を行って、カスタムプロパティが Correspondence Management UI に表示されるようにする必要があります。
Correspondence Management のアセットリスト UI にカスタムプロパティを表示するには、次の手順を実行します。
-
-
childlistpage.jsp ファイル(/apps/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/childlistpage.jsp)を開き、次のように変更します。
-
<%! private String getCustomPropertyValue(Map<String, Object> extendedProperties, String propertyName) { String propertyValue = ""; if (extendedProperties.containsKey(propertyName)) { propertyValue = (String) extendedProperties.get(propertyName); } return propertyValue; } %>
-
<% String GeoLocation = ""; if (asset != null) { Map<String, Object> extendedProperties = asset.getExtendedProperties(); if (extendedProperties != null) { GeoLocation = getCustomPropertyValue(extendedProperties,"GeoLocation"); } } %>
-
-
カスタマイズ内容を表示するには、カスタムプロパティを追加したドキュメントフラグメント(レター)の一覧表示を開きます。
この手順で追加した UI 列およびプロパティは、すべてのアセットタイプで表示されます。ただし、これらのプロパティの値は、最初にカスタムプロパティを追加したアセットタイプに対してのみ入力および表示できます。
例えば、「シナリオ:特定のアセットタイプのカスタムプロパティの追加」を使用してテキストアセットにカスタムプロパティを追加した場合、テキストアセットにのみカスタムプロパティを入力できます。ただし、そのカスタムプロパティを UI に表示する場合、列はすべてのアセットタイプで表示されます。
-
名前 タイプ 値 sling:orderBefore 文字列 パス「/libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns」にある列ノードの名前。カスタム列は UI でこのノードの前に表示されます。
ここで、Geographical Location 列を Version 列の前(左側)に表示する場合は、プロパティ sling:orderBefore をパス「/apps/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns/GeoLocation」にある GeoLocation ノードに追加し、プロパティの値を version に設定します。
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 に追加するカスタムプロパティは含まれません。
カスタムプロパティを検索に含めるには、カスタムプロパティのインデックス作成を可能にする必要があります。
カスタムプロパティのインデックス作成を可能にするには、次の手順を実行します。
注意:
まだ検索できない場合は、インデックス作成の問題が原因の可能性があります。インデックス作成をやり直すには、次のノードに移動し、プロパティ「re-index」の値を true に変更します。
/oak:index/cmLucene およびプロパティの値の変更
注意:
以下の手順は、フォームとドキュメント、アセット、サイトなどのすべてのコンソールのデフォルト表示を変更します。