AEM Content & Commerce Authoring ピッカー

AEM Content & Commerce Authoring には、AEM の作成者やマーケターがコマース製品のデータやカタログを効率的に操作するのに役立つ一連のオーサリングツールが用意されています。製品ピッカーとカテゴリピッカーは CIF アドオンの一部で、CIF コアコンポーネントで使用されます。プロジェクトでは、任意のコンポーネントダイアログでこれらのピッカーを使用して、製品やカテゴリを選択できます。

製品ピッカー

プロジェクトコンポーネントで製品ピッカーを使用するには、開発者がコンポーネントダイアログに commerce/gui/components/common/cifproductfield を追加する必要があります。例えば、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"/>

製品フィールドを使用すると、ユーザーが選択したい製品に様々なビューを使用して移動できます。デフォルトでは、製品フィールドは製品の ID を返しますが、selectionId 属性を使用して設定できます。

製品ピッカーフィールドでは、次のオプションプロパティをサポートしています。

  • selectionId(id、uid、sku、slug、combinedSlug、combinedSku)- ピッカーが返す製品属性を選択できます(デフォルトは id)。sku を使用する場合は、選択した製品の sku が返され、combinedSku を使用する場合は、base#variant のような文字列と、基本製品および選択したバリアントの sku が返されます。基本製品が選択されている場合は、単一の sku が返されます。
  • filter(folderOrProduct、folderOrProductOrVariant)- 製品ツリー内を移動する際にピッカーでレンダリングするコンテンツをフィルタリングします。folderOrProduct - フォルダーと製品をレンダリングします。folderOrProductOrVariant - フォルダー、製品および製品バリアントをレンダリングします。製品または製品バリアントがレンダリングされる場合は、ピッカーでも選択できるようになります(デフォルトは folderOrProduct)。
  • multiple(true、false)- 1 つまたは複数の製品の選択を有効にします(デフォルトは false)。
  • emptyText - ピッカーフィールドの空のテキスト値を設定します。

また、namefieldLabelfieldDescription などの標準のダイアグログフィールドプロパティもサポートされています。

注意

cifproductfield コンポーネントには クライアントライブラリが必要です。cif.shell.pickerダイアログにクライアントライブラリを追加するには、extraClientlibs プロパティを使用します。

注意

CIFコアコンポーネントバージョン2.0.0以降、idのサポートは削除され、uidに置き換えられました。 製品IDとしてskuまたはslugを使用することを強くお勧めします。 アドビでは、CIFコアコンポーネントバージョン1.xを使用するプロジェクトに対してのみidを引き続きサポートします。

完全に動作する cifproductfield の例は、CIF コアコンポーネントプロジェクトにあります。AEM コアコンポーネントドキュメントのダイアログのカスタマイズも参照してください。

カテゴリピッカー

カテゴリピッカーは、製品ピッカーと同様の方法で、コンポーネントダイアログでも使用できます。

次のスニペットを cq:dialog 設定で使用できます。

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

カテゴリピッカーフィールドでは、次のオプションプロパティをサポートしています。

  • selectionId(id, uid, slug, urlPath, idAndUrlPath (非推奨), uidAndUrlPath (非推奨)) — ピッカーから返されるカテゴリ属性を選択できます(デフォルト= id)。
  • multiple(true、false)- 1 つまたは複数のカテゴリの選択を有効にします(デフォルトは false)。

また、namefieldLabelfieldDescription などの標準のダイアグログフィールドプロパティもサポートされています。

注意

cifproductfield コンポーネントと同様に、cifcategoryfield コンポーネントにも クライアントライブラリが必要です。cif.shell.pickerダイアログにクライアントライブラリを追加するには、extraClientlibs プロパティを使用します。AEM コアコンポーネントドキュメントのダイアログのカスタマイズを参照してください。

注意

CIFコアコンポーネントバージョン2.0.0以降、idのサポートは削除され、uidに置き換えられました。 カテゴリ識別子としてuidまたはurlPathを使用することを強くお勧めします。 CIFコアコンポーネントバージョン1.xを使用するプロジェクトでのみ、引き続きididAndUrlPathをサポートします。

完全に動作する cifcategoryfield の例は、CIF コアコンポーネントプロジェクトにあります。

このページ