製品属性の動的な追加

最終更新日： 2026年5月12日

トピック：
{"id":"d1e21356-0064-4f48-9089-16e3f0dbd2a6"},{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

作成対象：

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

データ同期プロセス中に属性を追加するプラグインを作成することで、製品属性をAdobe Commerceに登録せずに拡張できます。

NOTE

製品属性を拡張する最適な方法は、Catalog Service GraphQL スキーマを拡張するために Catalog Service🔗で Adobe Commerce🔗 where you can configure and manage them from the Commerce Admin. Only add them dynamically if you need them solely for Commerce storefront services and do not want to register them in Adobe Commerce. You also have the option to manage custom attributes using API Mesh に追加することです。

製品属性の追加

customer_attributeをMagento\CatalogDataExporter\Model\Provider\Product\Attributes クラスに追加するプラグインを作成します。

依存関係インジェクション設定ファイル（di.xml）を更新して、プラグインを定義します。

code language-xml
`<type name="Magento\CatalogDataExporter\Model\Provider\Product\Attributes"> <plugin name="product_customer_attributes" type="Vendor\CatalogDataExporter\Model\Plugin\AddAttribute"/> </type>`

プラグインの作成。

code language-php

 <?php
 declare(strict_types=1);

 namespace Vendor\CatalogDataExporter\Model\Plugin;

 use Magento\CatalogDataExporter\Model\Provider\Product\Attributes;

 class AddAttribute {

      /**
       * @param Attributes $subject
       * @param array $result
       * @param $arguments
       * @return array
       * @throws \Zend_Db_Statement_Exception
       */
       public function afterGet(Attributes $subject, array $result, $arguments): array
       {
           $additionalAttributes = [];
           $attributeCode = 'customer_attribute';
           foreach ($result as $product) {
               if (!isset($product['productId']) || !isset($product['storeViewCode'])) {
                   continue;
               }
               // HINT: if needed, do filtration by "storeViewCode" and or "productId"

               $productId = $product['productId'];
               $storeViewCode = $product['storeViewCode'];

               $newKey = \implode('-', [$product['storeViewCode'], $product['productId'], $attributeCode]);
               if (isset($additionalAttributes[$newKey])) {
                   continue;
               }
               $additionalAttributes[$newKey] = [
                   'productId' => $productId,
                   'storeViewCode' => $storeViewCode,
                   'attributes' => [
                       'attributeCode' => $attributeCode,
                       // provide single or multiple values for the attribute
                       'value' => [
                           rand(1, 42)
                       ]
                   ]
               ];

           }

           return array_merge($result, $additionalAttributes);
       }
 }

プラグインを追加すると、次にスケジュールされた同期中に、変更が接続されたストアフロントサービスに同期されます。更新をすぐに送信するには、次のCLI コマンドを使用して同期プロセスを手動で開始します。

code language-shell
`bin/magento saas:resync --feed=products`

カスタム製品属性メタデータの宣言

カスタム製品属性を動的に作成し、ストアフロントサービスでの表示、検索、フィルタリングに使用する場合は、製品属性メタデータを追加してストアフロントの動作を設定します。

依存関係インジェクション設定ファイル（di.xml）を更新して、製品属性メタデータのプラグインを定義します。

code language-xml

<type name="Magento\CatalogDataExporter\Model\Provider\ProductMetadata">
  <plugin name="product_customer_attributes_metadata" type="Vendor\CatalogDataExporter\Model\Plugin\AddAttributeMetadata"/>
</type>

次のプロバイダーMagento\CatalogDataExporter\Model\Provider\ProductMetadataのプラグインを作成します。

必須フィールドについては、vendor/magento/module-catalog-data-exporter/etc/et_schema.xmlのProductAttributeMetadataを確認してください。

code language-php

 <?php
 declare(strict_types=1);

 namespace Vendor\CatalogDataExporter\Model\Plugin;

 use Magento\CatalogDataExporter\Model\Provider\ProductMetadata;

 class AddAttributeMetadata {

      /**
       * @param ProductMetadata $subject
       * @param array $result
       * @param $arguments
       * @return array
       * @throws \Zend_Db_Statement_Exception
       */
      public function afterGet(ProductMetadata $subject, array $result, $arguments): array
      {
           $result[] = [
             'id' => '123',
             // provide storeCode, websiteCode and storeViewCode applicable for your AC instance
             'storeCode' => 'default',
             'websiteCode' => 'base',
             'storeViewCode' => 'default',
             // specify the customer attribute code - should be the same as used in the products attributes plugin
             'attributeCode' => 'customer_attribute',
             // only product attributes are supported
             'attributeType' => 'catalog_product',
             // specify the data type
             'dataType' => 'int',
             'multi' => false,
             'label' => 'Customer Attribute',
             'frontendInput' => 'select',
             'required' => false,
             'unique' => false,
             'global' => true,
             'visible' => true,
             'searchable' => true,
             'filterable' => true,
             // This value must be set to true to export it to the storefront services
             'visibleInCompareList' => true,
             'visibleInListing' => true,
             'sortable' => true,
             'visibleInSearch' => true,
             'filterableInSearch' => true,
             'searchWeight' => 1.0,
             'usedForRules' => true,
             'boolean' => false,
             'systemAttribute' => false,
             'numeric' => false,
             // specify the list of attribute options
             'attributeOptions' => [
                 'option1',
                 'option2',
                 'option3'
             ]
          ];

           return $result;
      }
   }

code language-shell
`bin/magento saas:resync --feed=productAttributes`

recommendation-more-help

commerce-help-data-export