Adobe Experience Manager Content and Commerce Authoring-Auswahl

Adobe Experience Manager Content and Commerce Authoring bietet eine Reihe von Authoring-Tools, mit denen AEM-Autoren und Marketing-Experten effizient mit Commerce-Produktdaten und -Katalogen arbeiten können. Die Produktauswahl und die Kategorieauswahl sind Teil des CIF-Add-ons und werden von den CIF-Kernkomponenten verwendet. Bei Projekten können diese Auswahlen in jedem Komponentendialogfeld verwendet werden, um Produkte oder Kategorien auszuwählen.

Produktauswahl

Um die Produktauswahl in einer Projektkomponente zu verwenden, müssen Entwicklungspersonen commerce/gui/components/common/cifproductfield zu einem Komponentendialogfeld hinzufügen. Verwenden Sie beispielsweise Folgendes für cq:dialog:

<product jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifproductfield"
    fieldDescription="The product or product variant displayed by the teaser"
    fieldLabel="Select Product"
    filter="folderOrProductOrVariant"
    name="./selection"
    selectionId="sku"/>

Im Produktfeld können Sie über die verschiedenen Ansichten zu dem Produkt navigieren, das Benutzende auswählen möchten. Standardmäßig gibt das Produktfeld die Kennung des Produkts zurück, kann jedoch mithilfe des Attributs selectionId konfiguriert werden.

Das Produktauswahlfeld unterstützt die folgenden optionalen Eigenschaften:

• „selectionId“ („id“, „uid“, „SKU“, „slug“, „combinedSlug“, „combinedSku“) – ermöglicht die Auswahl des Produktattributs, das von der Auswahl zurückgegeben werden soll (Standard = „id“). Bei Verwendung von „SKU“ wird die SKU des ausgewählten Produkts zurückgegeben. Bei Verwendung von „combinedSku“ wird eine Zeichenfolge wie „base#variant“ mit den SKUs des Basisprodukts und der ausgewählten Variante oder eine einzelne SKU zurückgegeben, wenn ein Basisprodukt ausgewählt wurde.
• „filter“ („folderOrProduct“, „folderOrProductOrVariant“) – filtert die Inhalte, die von der Auswahl während der Navigation in der Produktstruktur gerendert werden sollen. „folderOrProduct“ – rendert Ordner und Produkte. „folderOrProductOrVariant“ – rendert Ordner, Produkte und Produktvarianten. Wenn Produkte oder Produktvarianten gerendert werden, können sie auch in der Auswahl ausgewählt werden. (Standard = „folderOrProduct“)
• „multiple“ („true“, „false“) – zum Aktivieren der Auswahl eines oder mehrerer Produkte (Standard = „false“).
• „emptyText“ – zum Konfigurieren des leeren Textwerts des Auswahlfelds.

Außerdem werden die Standardeigenschaften von Dialogfeldern wie name, fieldLabel oder fieldDescription unterstützt.

Ein umfassendes praktisches Beispiel für cifproductfield finden Sie im Projekt CIF-Kernkomponenten. Siehe auch Anpassen von Dialogen in der Dokumentation zu AEM-Kernkomponenten.

Kategorieauswahl

Die Kategorieauswahl kann auch in einem Komponentendialogfeld auf ähnliche Weise wie die Produktauswahl verwendet werden.

Das folgende Snippet kann in einer cq:dialog-Konfiguration verwendet werden:

<category jcr:primaryType="nt:unstructured"
    sling:resourceType="commerce/gui/components/common/cifcategoryfield"
    fieldLabel="Category"
    name="./categoryId"
    selectionId="uid" />

Das Kategorieauswahlfeld unterstützt die folgenden optionalen Eigenschaften:

• selectionId(id, uid, slug, urlPath, idAndUrlPath (veraltet), uidAndUrlPath (veraltet)) – ermöglicht die Auswahl des Kategorieattributs, das von der Auswahl zurückgegeben wird (Standard = id).
• „multiple“ („true“, „false“) – zum Aktivieren der Auswahl einer oder mehrerer Kategorien (Standard = „false“).

Außerdem werden die Standardeigenschaften von Dialogfeldern wie name, fieldLabel oder fieldDescription unterstützt.

Ein umfassendes praktisches Beispiel für cifcategoryfield finden Sie im Projekt CIF-Kernkomponenten.