Création d'un attribut et définition des valeurs autorisées

En tant que gestionnaire de catalogue, vous pouvez créer des attributs et leur définir des valeurs.

Par exemple, un gestionnaire de catalogue met en place une ligne de télévision à écran plat. La télévision est classée par DisplayType afin de pouvoir être affichée sur le site Web du magasin. Le type d'affichage inclut LED, QLED, Mini LED et OLED. DisplayType n'étant pas une définition d'élément fournie par l'application, le gestionnaire de catalogue peut créer un nouvel attribut à l'aide de l'API Attribute.
  • Nom de l'attribut de l'élément = 'DisplayType
  • Chemin de groupe d'attributs d'article = /TV/DisplayDefinition
  • Valeurs autorisées = LED, QLED, MiniLed, OLED
Remarque: Un attribut est défini de manière unique avec le nom d'attribut et le chemin de groupe.
L'exemple suivant illustre l'API Attribute.
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"
    }
  ]
}
Ici, les règles qui sont appliquées à la définition d'un attribut sont validées lorsque la règle est affectée à un article. Exemple :
  • multipleValuesAllowed -Définit si un attribut d'élément peut prendre en charge plusieurs valeurs.
  • isValueMandatory -Détermine si une valeur d'attribut peut être laissée vide.

Pour l'exemple de télévision à écran plat, multipleValueAllowed est défini sur false car un téléviseur ne peut être que d'un seul type d'affichage, et la valeur est obligatoire pour s'assurer que le site Web d'un magasin a toujours une valeur pour le type d'affichage. Lorsque des valeurs autorisées sont fournies, le service de catalogue valide qu'une valeur d'attribut d'article correspond à au moins l'un des allowedValues. Supposons qu'un utilisateur définisse la valeur de QLED01, l'application entraîne un échec car la définition d'attribut n'autorise que QLED comme option.

Enfin, itemAttributeGroupPath est une mention notable, bien qu'il soit exempt de texte. Pour une structure de répertoire, il est recommandé d'utiliser la notation par barre oblique (/). Dans l'exemple, /TV/DisplayDefinition, indiquez que DisplayType appartient au téléviseur parent et DisplayDefinition en tant que sous-type. En utilisant ce paradigme, vous pouvez organiser un attribut de manière stratégique. Si vous disposez de Sterling Order Management System Software, utilisez la barre oblique (/) pour réduire la complexité de l'intégration.