AEM Content & Commerce Authoring-Auswahl

AEM Content & 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. Projekte können diese Auswahl in jedem Komponentendialogfeld verwenden, um Produkte oder Kategorien auszuwählen.

Produktauswahl

Um die Produktauswahl in einer Projektkomponente zu verwenden, muss ein Entwickler 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"/>

Das Produktfeld ermöglicht die Navigation zu dem Produkt, das ein Benutzer über die verschiedenen Ansichten auswählen möchte. 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 vom Picker zurückgegeben werden soll (Standard = id). Bei Verwendung der SKU wird die SKU des ausgewählten Produkts zurückgegeben, während die kombinierte SKU verwendet wird, und es wird eine Zeichenfolge wie base#variant mit der SKU des Basisprodukts und der ausgewählten Variante oder eine einzelne SKU zurückgegeben, wenn ein Basisprodukt ausgewählt ist.
  • filter (folderOrProduct, folderOrProductOrVariant) - filtert den Inhalt, der vom Picker während der Navigation in der Produktstruktur gerendert werden soll. folderOrProduct - rendert Ordner und Produkte. folderOrProductOrVariant - rendert Ordner, Produkt- und Produktvarianten. Wenn ein Produkt oder eine Produktvariante gerendert wird, kann sie auch in der Auswahl ausgewählt werden. (default = folderOrProduct)
  • multiple (true, false) - Aktivieren der Auswahl eines oder mehrerer Produkte (Standard = false)
  • emptyText - zum Konfigurieren des leeren Textwerts des Picker-Felds

Darüber hinaus werden auch standardmäßige Eigenschaften von Dialogfeldfeldern wie name, fieldLabel oder fieldDescription unterstützt.

VORSICHT

Für die Komponente cifproductfield ist die clientlib cif.shell.picker erforderlich. Um einem Dialogfeld eine clientlib hinzuzufügen, können Sie die Eigenschaft extraClientlibs verwenden.

VORSICHT

Ab Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung für id entfernt und durch uid ersetzt. Es wird dringend empfohlen, sku oder slug als Produktkennung zu verwenden. id wird weiterhin nur für Projekte unterstützt, die CIF-Kernkomponenten Version 1.x verwenden.

Ein vollständiges Arbeitsbeispiel für cifproductfield finden Sie im Projekt CIF-Kernkomponenten . Siehe auch Anpassen von Dialogfeldern 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 (deprecated), uidAndUrlPath (deprecated)) - ermöglicht die Auswahl des Kategorieattributs, das vom Picker zurückgegeben werden soll (Standard = id).
  • multiple (true, false) - Aktivieren der Auswahl einer oder mehrerer Kategorien (Standard = false)

Darüber hinaus werden auch standardmäßige Eigenschaften von Dialogfeldfeldern wie name, fieldLabel oder fieldDescription unterstützt.

VORSICHT

Wie die Komponente cifproductfield erfordert auch die Komponente cifcategoryfield die clientlib cif.shell.picker . Um eine clientlib zu einem Dialogfeld hinzuzufügen, können Sie die Eigenschaft extraClientlibs verwenden. Siehe Anpassen von Dialogfeldern in der Dokumentation zu AEM Kernkomponenten .

VORSICHT

Ab Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung für id entfernt und durch uid ersetzt. Es wird dringend empfohlen, uid oder urlPath als Kategoriekennung zu verwenden. id und idAndUrlPath werden weiterhin nur für Projekte unterstützt, die CIF-Kernkomponenten Version 1.x verwenden.

Ein vollständiges Arbeitsbeispiel für cifcategoryfield finden Sie im Projekt CIF-Kernkomponenten .

Auf dieser Seite