Sie sehen sich Hilfeinhalte der folgenden Version an:
- 6.4
- 6.3
- 6.2
- Ältere Versionen
Sie können die Correspondence Management-Benutzeroberfläche anpassen und Benutzern ein angepasstes Set an Eigenschaften und Registerkarten bieten. Diese Anpassung beinhaltet das Hinzufügen benutzerdefinierter Felder/Eigenschaften und Registerkarten zu bestimmten Assetstypen/Briefenm oder zu allen Assettypen und Briefen.
Die folgenden Fälle zeigen, wie Sie Eigenschaften/Registerkarten zu Correspondence Management-Assets und Briefen hinzufügen können:
- Hinzufügen einer allgemeinen Eigenschaft zu allen Assettypen
- Hinzufügen einer allgemeinen Registerkarte zu allen Assettypen
- Hinzufügen von benutzerdefinierten Eigenschaften zu bestimmten Assettypen
Durch Anpassen der Eigenschaften, Pfade und Werte in diesen Szenarios können Sie benutzerdefinierte Eigenschaften und Registerkarten zu einem anderen Assetsset gemäß Ihren Anforderungen hinzufügen.
Dieses Beispiel zeigt, wie Sie eine benutzerdefinierte Eigenschaft allen Assettypen (Text, Liste, Bedingung und Layout-Fragmente) und Briefen hinzufügen können. Mithilfe dieses Szenarios können Sie eine Eigenschaft, einen Ort der Empfänger zu allen Assets und Briefen hinzufügen. Die Eigenschaft des Orts des Empfängers dient zur Identifizierung von geografischen Bereichen der Bereitstellung von Assets oder Briefen.
Hinweis:
Wenn Sie bereits eine benutzerdefinierte Eigenschaft hinzugefügt haben, wird die Eigenschaft auf der Seite zur Asset-Erstellung angezeigt. Um eine solche Eigenschaft auszublenden, finden Sie weitere Informationen unter „Benutzerdefinierte Eigenschaften auf Asset-Erstellung und Eigenschaften“.

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Eigenschaft zu allen Assettypen und Briefen hinzuzufügen:
-
Fügen Sie unter dem neu erstellten Ordner „items“ einen Knoten für die benutzerdefinierte Eigenschaft in allen Asset hinzu (Beispiel: GeoLocation), indem Sie folgende Schritte durchführen:
-
Name Typ Wert fieldLabel Zeichenfolge Der Name, den Sie dem Feld/der Eigenschaft geben möchten. (Hier: Ort des Empfängers) name Zeichenfolge ./extendedproperties/GeoLocation (Geben Sie denselben Wert ein wie in Feldname, den Sie mit dem items-Knoten erstellt haben) renderReadOnly Boolesch true sling:resourceType Zeichenfolge granite/ui/components/coral/foundation/form/textfield
-
Um Ihre Anpassungen anzuzeigen, bewegen Sie den Mauszeiger über ein Asset (Text, Liste, Bedingung oder Layout-Fragment) oder einen Brief, klicken Sie auf Eigenschaften anzeigen und klicken Sie auf Bearbeiten. Das neue Feld (Ort der Empfänger) wird auf der Registerkarte „Grundeinstellungen“ in den Asset-/Briefeigenschaften angezeigt.
Hinweis:
Möglicherweise müssen Sie den Cache Ihres Browsers leeren, bevor Ihre Anpassungen in der Benutzeroberfläche angezeigt werden.
Hinweis:
Die gängigsten Eigenschaften für alle Assets, die Sie hinzufügen, werden auf der Registerkarte „Grundeinstellungen“ der Asset-Eigenschaften angezeigt. Standardmäßig werden die allgemeinen Eigenschaften, die für alle Assets hinzugefügt werden, auf der Seite „Eigenschaften“ sowie auf der Seite „Erstellung“ angezeigt. Um die gemeinsamen Eigenschaften auszublenden, müssen Sie [Eigenschaften ein-/ausblenden].
Szenario: Hinzufügen eines benutzerdefinierte Dropdown-Menüs und von Werten zu einer benutzerdefinierten Eigenschaft/einem benutzerdefinierten Feld
Dieses Beispiel zeigt, wie Sie eine benutzerdefinierte Eigenschaft allen Asset-Typen hinzufügen und Dropdown-Menü-Werten der hinzufügen können.
-
Fügen Sie dem Knoten (hier: geographicallocation) die folgenden Eigenschaften hinzu und klicken Sie auf Alle speichern:
Name Typ Wert fieldLabel Zeichenfolge Der Name, den Sie dem Feld/der Eigenschaft geben möchten. (Hier: geographicallocation) name Zeichenfolge ./extendedproperties/geographicallocation (Verwenden Sie denselben Wert wie beim Feldnamen, den Sie unter dem item-Knoten erstellt haben) renderReadOnly Boolesch true sling:resourceType Zeichenfolge granite/ui/components/coral/foundation/form/select -
Fügen Sie unter dem property-Knoten (hier geographicallocation) einen neuen Knoten mit dem Namen items hinzu. Fügen Sie unter dem items-Knoten jeweils einen Knoten für die Werte im Dropdown-Menü hinzu. Als bewährte Methode fügen Sie den ersten Knoten als leer hinzu, um als Standardwert des Dropdown-Menüs zu dienen und eine Option für den Benutzer, damit dieser einen Wert für das Feld angeben kann. Um mehrere Optionen/Drop-Down-Werte hinzuzufügen, wiederholen Sie die folgenden Schritte:
-
Fügen Sie die folgenden Eigenschaften dem neu erstellten Knoten (hier: item1) hinzu und klicken Sie auf Alle speichern:
Name Typ Wert Text Zeichenfolge Dies ist der Wert der Dropdown-Menüoption, die für den Benutzer sichtbar ist. Lassen Sie das Feld leer für den (Standard-)Wert oder geben Sie den Wert ein, z. B. International oder Innerhalb der USA. value Zeichenfolge Wert gespeichert in CRXDE für den Text. Geben Sie einen beliebigen eindeutigen Suchbegriff ein.

Dieses Beispiel zeigt, wie Sie eine benutzerdefinierte Registerkarte, Empfänger, allen Assettypen (Text, Liste, Bedingung und Layout-Fragmente) und Briefen hinzufügen können. Auf der Registerkarte „Empfänger“ können Sie alle benutzerdefinierten Eigenschaften, die für den Empfänger relevant sind, festlegen.

Mithilfe des folgenden Verfahrens können Sie eine Registerkarte mit einem Feld zu allen Assets hinzufügen:
-
Im item-Knoten, den Sie im vorherigen Schritt (unter commontab) erstellt haben, fügen Sie einen Knoten für die Erstellung einer Spalte (hier: Column1) auf der benutzerdefinierten Registerkarte (commontab) mit folgenden Schritten hinzu (um weitere Spalten hinzuzufügen, wiederholen Sie diesen Schritt):
-
Wenn Sie ein Feld in der Registerkarte „Benutzerdefiniert“ (hier: Empfänger) erstellen möchten, fügen Sie einen Knoten (hier: GeographicalLocation) hinzu. Diese Eigenschaft entspricht der Spalte, die Sie erstellt haben. Führen Sie die folgenden Schritte aus, um das Feld zu erstellen (um mehr Felder/Knoten zu erstellen, wiederholen Sie diese Schritte.):
-
Um diese Registerkarte für Briefe hinzuzufügen, erstellen Sie einen Überlagerungsordner mit dem Pfad/der Struktur ähnlich dem folgenden items-Ordner unter folgendem Pfad:
/libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/letter/items/tabs/items
Um Überlagerung für einen Brief oder ein anderes Asset zu erstellen, verwenden Sie den folgenden Pfad, indem Sie [assettype] durch Text, Bedingung, Liste, Datenwörterbuch oder Fragment ersetzen:
/libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[assettype]/items/tabs/items
-
Um Ihre Anpassungen anzuzeigen, bewegen Sie den Mauszeiger über das entsprechende Asset (hier: ein Brief), klicken Sie auf „Eigenschaften anzeigen“ und klicken Sie auf Bearbeiten. Die neue Registerkarte (Empfänger) und das Feld (Ort der Empfänger) werden in der Benutzeroberfläche angezeigt.
Hinweis:
Möglicherweise müssen Sie den Cache Ihres Browsers leeren, bevor Ihre Anpassungen in der Benutzeroberfläche angezeigt werden.
Dieses Beispiel zeigt, wie Sie eine Eigenschaft einem bestimmten Assettyp hinzufügen können, z. B. ein Feld zu allen Textassets. Mithilfe dieses Prozesses können Sie die Eigenschaften zu einer der folgenden Optionen inzufügen:
- Text
- Bedingung
- Liste
- Layout-Fragment
- Datenwörterbuch
- Brief

-
Um eine Registerkarte in einem Assettyp zu erstellen (z. B. Text), erstellen Sie die folgende Ordnerstruktur im Apps-Ordner:
/libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[AssetType]/items/tabs/items
[AssetType] = Text, Bedingung, Liste, Brief, Datenwörterbuch oder Fragment
Führen Sie die folgenden Schritte aus, um diese Ordnerstruktur zu erstellen:
-
Klicken Sie mit der rechten Maustaste auf den Elementordner an folgendem Speicherort und wählen Sie Überlagerungsknoten:
/libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/[AssetType]/items/tabs/items
Wenn Sie beispielsweise eine Eigenschaft für Textassets erstellen möchten, markieren Sie den folgenden Ordner:
/libs/fd/cm/ma/gui/content/cmmetadataproperties/properties/text/items/tabs/items
-
-
Um Ihre Anpassungen anzuzeigen, bewegen Sie den Mauszeiger über das entsprechende Asset (hier: ein Text), klicken Sie auf „Eigenschaften anzeigen“ und klicken Sie auf Bearbeiten. Die neue Registerkarte und das Feld (Ort der Empfänger) werden auf der Benutzeroberfläche angezeigt.
Hinweis:
Möglicherweise müssen Sie den Cache Ihres Browsers leeren, bevor Ihre Anpassungen in der Benutzeroberfläche angezeigt werden.
Standardmäßig sind die benutzerdefinierten Eigenschaften, die neuen Registerkarten hinzugefügt werden, auf der Seite „Asset-Erstellung“ sichtbar, da diese Seite kein Registerkartenlayout hat. Um die benutzerdefinierten Eigenschaften auf der Seite „Asset-Erstellung“ zusammen mit anderen Eigenschaften anzuzeigen, müssen Sie die folgenden Schritte ausführen:
-
Stellen Sie sicher, dass das Dialogfeld „Überlagerungsknoten“ die folgenden Werte für Brief enthält: Bei anderen Assettypen ist der Pfad in der folgenden Tabelle vorgegeben:
Pfad: /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items
Speicherort: /apps/
Knotentypen abgleichen: Ausgewählte
Asset/Dokumenttyp Pfad, der hinzugefügt werden soll Text /libs/fd/cm/ma/gui/content/createasset/createtext/jcr:content/body/items/form/items/textwizard/items/editproperties/items/properties/items/tabs/items/tab1/items Liste /libs/fd/cm/ma/gui/content/createasset/createlist/jcr:content/body/items/form/items/listwizard/items/editproperties/items/properties/items/tabs/items/tab1/items Bedingung /libs/fd/cm/ma/gui/content/createasset/createcondition/jcr:content/body/items/form/items/conditionwizard/items/editproperties/items/properties/items/tabs/items/tab1/items Fragment /libs/fd/cm/ma/gui/content/createasset/createfragment/jcr:content/body/items/form/items/fragmentwizard/items/properties/items/properties/items/tabs2/items/tab1/items Brief /libs/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items -
Mit dem Überlagerungsknoten „items“, den Sie erstellt haben, erstellen Sie einen Knoten mit dem Namen col4 (oder einen anderen Namen) und klicken Sie auf Alle speichern.
Beispielsweise ist Folgendes der Überlagerungsknoten, der für Briefe erstellt wird.
/apps/fd/cm/ma/gui/content/createasset/createletter/jcr:content/body/items/form/items/letterWizard/items/properties/items/properties/items/letterproperties/items
-
Fügen Sie die folgenden Eigenschaften dem neu erstellten Knoten (hier „col4“) hinzu und klicken Sie auf Alle speichern:
Name Typ Wert path Zeichenfolge Dieser Pfad ist der Zeiger auf die Spalte, die erstellt wird in:
- Für die Registerkarte „Allgemein“ für alle Assettypen: /apps/fd/cm/ma/gui/content/cmmetadataproperties/commontab/items/col1
- Für verschiedene Eigenschaften für unterschiedliche Assettypen: /apps/fd/cm/ma/gui/content/cmmetadataproperties/properties//items/tabs/items/customtab/items/col1
sling:resourceType Zeichenfolge granite/ui/components/coral/foundation/include Benutzerdefinierte Eigenschaft, Sprache, die auf der Benutzeroberfläche für die Erstellung eines Briefs angezeigt werden
Nachdem Sie eine benutzerdefinierte Eigenschaft zu Correspondence Management-Assets hinzugefügt haben, müssen Sie weitere Änderungen in CRX/DE vornehmen, um sicherzustellen, dass die benutzerdefinierte Eigenschaft auf der Correspondence Management-Benutzeroberfläche angezeigt wird.
Führen Sie die folgenden Schritte aus, um die benutzerdefinierte Eigenschaft auf der Benutzeroberfläche der Correspondence Management-Assetliste anzuzeigen:
-
Öffnen Sie die childlistpage.jsp-Datei (/apps/fd/cm/ma/gui/components/admin/childpagerenderer/childlistpage/childlistpage.jsp) und nehmen Sie die folgenden Änderungen vor:
-
Fügen Sie am Ende der Datei den folgenden Code der Funktion hinzu, die den Wert für jede benutzerdefinierte Eigenschaft erhält:
<%! 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"); } } %>
Geolocation im Code ist der Wert, den Sie in die name-Eigenschaft beim Erstellen des benutzerdefinierten Knotens/Felds festlegen. Beim Erstellen eines benutzerdefinierten Felds/Knotens haben Sie den Namen der Eigenschaft angegeben.Präfix /extendedproperties/: ./extendedproperties/GeoLocation. Im Code ist das Präfix nicht erforderlich.
-
Um Ihre Anpassungen anzuzeigen, öffnen Sie die Listenansicht der Dokumentfragmente oder Briefe, in denen Sie die benutzerdefinierte Eigenschaft hinzugefügt haben.
Die Spalten „Benutzeroberfläche“ und „Eigenschaft“, die in diesem Verfahren hinzugefügt wurden, werden für alle Asset-Typen angezeigt. Jedoch können die Werte in diesen Eigenschaften nur für die Assettypen implementiert und angezeigt werden, für die Sie die benutzerdefinierte Eigenschaft hinzugefügt haben.
Beispielsweise mithilfe des Szenarios: Zum Hinzufügen von benutzerdefinierten Eigenschaften für bestimmte Arten von Assets, können Sie benutzerdefinierte Eigenschaft zu Text-Assets hinzufügen. Wenn jedoch diese benutzerdefinierte Eigenschaft auf der Benutzeroberfläche angezeigt wird, wird die Spalte für alle Assettypen.
-
(Optional) Standardmäßig wird die neue Spalte als die letzte Spalte auf der Benutzeroberfläche angezeigt. Damit die Spalte an einer bestimmten Position angezeigt wird, fügen Sie die folgende Eigenschaft zum Knoten „Spalte“ hinzu:
Name Typ Wert sling:orderBefore Zeichenfolge Der Name des Spaltenknotens im Pfad „/libs/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns“ vor dem die benutzerdefinierte Spalte auf der Benutzeroberfläche angezeigt werden soll.
Wenn Sie möchten, dass hier die Spalte „Geographischer Standort“ vor (links) der Spalte „Version“ anzeigen wird, fügen Sie die Eigenschaft „sling:orderBefore“ dem Knoten „GeoLocation“ im Pfad „/apps/fd/cm/ma/gui/content/cmassets/jcr:content/views/list/columns/GeoLocation“ hinzu und legen Sie den Wert der Eigenschaft fest.
Wenn Sie die Eigenschaft „sling:orderBefore“ hinzufüge, um die Spalte „Standort“ anzugeben, müssen Sie auch die Reihenfolge des entsprechenden <td>-Tags aktualisieren, was in Schritt 6.4 dieses Verfahrens erklärt wird. Beispiel: In diesem Fall müssen Sie sicherstellen, dass der <td>-Tag des geografischen Standorts vor <td>-Tag der Spalte „Version“ platziert wird:
<td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(geographicalLocation) %>"><%= xssAPI.encodeForHTML(geographicalLocation) %></td> <td is="coral-td" value="<%= xssAPI.encodeForHTMLAttr(version) %>"><%= xssAPI.encodeForHTML(version) %></td>
Standardmäßig enthält die Volltextsuche keine benutzerdefinierten Eigenschaften, die Sie zur Benutzeroberfläche mit CRX/DE hinzufügen.
Um die benutzerdefinierten Eigenschaften in die Suche einzubeziehen, müssen Sie die Indexerstellung von benutzerdefinierten Eigenschaften ermöglichen.
Um die Indexerstellung von benutzerdefinierten Eigenschaften zu ermöglichen, führen Sie die folgenden Schritte aus:
Hinweis:
Wenn Sie immer noch nicht suchen können, gibt es möglicherweise ein Problem bei der Indexerstellung. Für die neue Indexerstellung navigieren Sie zu folgendem Knoten und ändern Sie den Wert der Eigenschaft „re-index“ in „true“:
/oak:index/cmLucene“ und ändern Sie den Wert der Eigenschaft
Hinweis:
Diese Schritte ändern die Standardansicht aller Konsolen wie Formulare und Dokumente, Assets und Websites.
Einblenden/Ausblenden benutzerdefinierter Eigenschaften auf den Seiten „Asseterstellung“ und „Eigenschaften“
Um die benutzerdefinierten Eigenschaften ein- bzw. auszublenden, führen Sie die folgenden Schritte aus: