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.
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:
Außerdem werden die Standardeigenschaften von Dialogfeldern wie name
, fieldLabel
oder fieldDescription
unterstützt.
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.
Ab Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung für id
entfernt und durch uid
ersetzt. Adobe empfiehlt die Verwendung von sku
oder slug
als Produktkennung. Adobe unterstützt id
weiterhin nur für Projekte, die CIF-Kernkomponenten 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.
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:
Außerdem werden die Standardeigenschaften von Dialogfeldern wie name
, fieldLabel
oder fieldDescription
unterstützt.
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.
Ab Version 2.0.0 der CIF-Kernkomponenten wurde die Unterstützung für id
entfernt und durch uid
ersetzt. Adobe empfiehlt die Verwendung von uid
oder urlPath
als Kategoriekennung. Adobe unterstützt id
und idAndUrlPath
weiterhin nur für Projekte, die CIF-Kernkomponenten Version 1.x verwenden.
Ein umfassendes praktisches Beispiel für cifcategoryfield
finden Sie im Projekt CIF-Kernkomponenten.