Adobe Experience Manager Content and Commerce Authoring-Auswahl cif-pickers

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 product-picker

Um die Produktauswahl in einer Projektkomponente zu verwenden, müssen Entwickelnde 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 Benutzende über die verschiedenen Ansichten 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, wenn „combinedSku“ verwendet wird. Zudem 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 ist.
  • „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.

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

CAUTION
Für die Komponente cifproductfield ist die Client-Bibliothek cif.shell.picker erforderlich. Um einem Dialogfeld eine Client-Bibliothek hinzuzufügen, können Sie die Eigenschaft „extraClientlibs“ verwenden.
CAUTION
Ab Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung für id entfernt und durch uid ersetzt. Adobe empfiehlt sku oder slug als Produktkennung. Adobe unterstützt id weiterhin nur für Projekte, die CIF-Kernkomponenten der Version 1.x verwenden.

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 category-picker

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“, „idAndUrlPath“ (veraltet), „uidAndUrlPath“ (veraltet)): Ermöglicht die Auswahl des Kategorieattributs, das von der Auswahl zurückgegeben werden soll (Standard = „id“).
  • „multiple“ („true“, „false“) – zum Aktivieren der Auswahl einer oder mehrerer Kategorien (Standard = „false“).

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

CAUTION
Wie für die Komponente cifproductfield ist für die Komponente cifcategoryfield ebenfalls die Client-Bibliothek cif.shell.picker erforderlich. Um einem Dialogfeld eine Client-Bibliothek hinzuzufügen, können Sie die Eigenschaft extraClientlibs verwenden. Siehe Anpassen von Dialogen in der Dokumentation zu AEM-Kernkomponenten.
CAUTION
Ab Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung für id entfernt und durch uid ersetzt. Adobe empfiehlt uid oder urlPath als Kategoriekennung. Adobe unterstützt id und idAndUrlPath weiterhin nur für Projekte, die CIF-Kernkomponenten der Version 1.x verwenden.

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2