属性の作成および許容値の定義

カタログ・マネージャーは、属性を作成し、それらに値を定義することができます。

例えば、あるカタログ・マネージャーが、フラット・パネル・テレビのラインをセットアップしているとします。テレビは、ストアの Web サイトに表示できるように、 DisplayType によって分類されます。表示タイプには、LED、QLED、ミニ LED、および OLED が含まれます。 DisplayType はアプリケーション提供のアイテム定義ではないため、カタログ・マネージャーは属性 API を使用して新規属性を作成できます。

項目属性名 = 'DisplayType
アイテム属性グループ・パス = /TV/DisplayDefinition
許容値 = LED、QLED、MiniLed,OLED

注: 属性は、属性名とグループ・パスを使用して一意的に定義されます。

以下の例は、属性 API を示しています。

POST https://api.watsoncommerce.ibm.com/catalog/{tenantid}/v1/attributes
{
  "attributes": [
    {
      "itemAttributeName": "DisplayType",
      "itemAttributeGroupPath": "/TV/DisplayDefinition",
      "dataType": "String",
      "multipleValuesAllowed": false,
      "isValueMandatory": true,
      "allowedValues": ["QLED","LED", "MiniLed", "OLED"],
      "description": "QLED Television Display Type"
    }
  ]
}

ここで、属性の定義に適用されるルールは、そのルールがアイテムに割り当てられるときに検証されます。例:

multipleValuesAllowed -アイテム属性が複数の値をサポートできるかどうかを定義します。
isValueMandatory -属性値をブランクのままにできるかどうかを決定します。

フラット・パネル・テレビの例では、TV は 1 つの表示タイプにしかできないため、 multipleValueAllowed は false に設定されます。ストアの Web サイトが常に表示タイプの値を持つようにするには、この値が必須です。許可された値が指定されると、カタログ・サービスは、アイテム属性値が allowedValuesの少なくとも 1 つと一致することを検証します。ユーザーが QLED01の値を設定した場合、属性定義ではオプションとして QLED のみが許可されるため、アプリケーションは失敗します。

最後に、 itemAttributeGroupPath は注目すべき言及ですが、テキストはありません。ディレクトリー構造では、スラッシュ (/) 表記を使用することをお勧めします。例 /TV/DisplayDefinitionでは、 DisplayType が親 TV に属し、サブタイプが DisplayDefinition であることを示しています。このパラダイムを使用して、戦略的な方法で属性を編成できます。 Sterling Order Management System Softwareがある場合は、統合の複雑さを最小限に抑えるためにスラッシュ (/) 表記を使用してください。