Implémenter la notion de liste d'options conditionnelles

Ce document décrit l'approche recommandée quant à l'implémentation de la notion de limitation des options d'une liste vis-à-vis de contraintes spécifiques. Ces contraintes peuvent être associées à une classification (exemple: "N'autoriser la saisie d'une option que si le produit courant est classé dans la catégorie laptop"), à une liste (exemple: "N'autoriser la saisie de certaines options en fonction du code fournisseur") ou tout autre field associé à un item ("N'autoriser que certains types de palettes en fonction du poids d'un item").

TIP

To limit options on a list SET_SELECTABLE_OPTIONS and at the same time apply a default value SET_TEXT, set first the default value rule (priority 1) and then the reduced list of options (priority 2). Otherwise there will be a warning on the grid. More details here #4616

Exemples d'utilisation

L'outil formula permet de définir une liste de règles, dont on peut contrôler leur exécution en définissant des conditions, et qui peuvent agir de différentes manières sur une cellule donnée (on appelle ici cellule, la valeur d'un field sur un item donné).

Nous nous intéresserons dans ce document à l'action SET_SELECTABLE_OPTIONS permettant de définir les options cohérentes pour une liste d'options, dans un contexte donné.

Limiter une liste d'option vis-à-vis d'une seconde liste d'option

Ci-dessous, nous détaillerons un cas issu d'un exemple présent au sein de la structure de donnée du PIM de Fnac/Darty.

Besoin remonté par les équipes de Fnac/Darty

• Empêcher la saisie de valeur incohérente pour la liste d'option DEEE. En effet certaines options de cette liste ne sont cohérentes que pour certains fournisseurs. Le nom du fournisseur est quant à lui renseigné dans une autre colonne dans notre structure de données.
• Les règles de cohérence peuvent évoluer dans le temps, il est donc nécessaire de pouvoir retrouver les items pour lesquels l'option DEEE serait incohérente.

Limiter la sélection d'option d'un field en utilisant une formula

La formula présenté ci-dessous permet de limiter depuis l'interface les options qu'un utilisateur pourra sélectionner pour le field DEEE_SCALE

Pour le champ DEE ("DEEE_SCALE"), dans le cas où le code fournisseur ("SUPPLIER_CODE") sélectionné est "Apple" ("0646") ou "Samsung" ("0647"), n'autoriser que les options "5240654", "5240655" et "5240656". Cependant, dans le cas où le code fournisseur sélectionné est "Sony" ("0648"), n'autoriser que l'option "5240656".

<Formulas>
    <Field key="DEEE_SCALE">
        <Rule priority="1" >
            <Conditions>
                <Condition-Group>
                    <Condition source="SUPPLIER_CODE" operator="IN"> 
                        <Value>0646</Value>
                        <Value>0647</Value>
                    </Condition>
                </Condition-Group>
            </Conditions>
            <Action type="SET_SELECTABLE_OPTIONS">
                <Value>5240654</Value>
                <Value>5240655</Value>
                <Value>5240656</Value>
            </Action>
        </Rule>
        <Rule priority="2" >
            <Conditions>
                <Condition-Group>
                    <Condition source="SUPPLIER_CODE" operator="IN"> 
                        <Value>0648</Value>
                    </Condition>
                </Condition-Group>
            </Conditions>
            <Action type="SET_SELECTABLE_OPTIONS">
                <Value>5240656</Value>
            </Action>
        </Rule>
    </Identifier>
</Formulas>

• C'est l'action SET_SELECTABLE_OPTIONS qui permet de limiter les options sélectionnables pour une liste donnée.

Remonter un statut particulier sur un champ de formatage conditionnel dans le cas où l'option sélectionnée est invalide

La limitation des options disponibles pour une liste d'option donnée peut être complétée par l'ajout d'une contrainte au sein des règles de formatage conditionnel pour faire remonter les items possédant des valeurs "incohérentes" (c'est-à-dire des valeurs normalement non permises par l'action SET_SELECTABLE_OPTIONS). Ces options incohérentes peuvent apparaitre dans plusieurs cas de figure:

• Mise à jour d'une rule ou ajout d'une rule au sein d'une table possédant déjà des items. Dans ce cas une donnée précédemment autorisée peut ne plus l'être.
• Import d'une option non permise depuis app.product-live.com via Data Factory.

TIP

À noter que même si aucune règle de conformité n'est précisée, l'option 'incoherente' sera remontée comme telle dans l'interface à l'aide d'un pictogramme immédiatement collé à la valeur dans la grille (comme c'est le cas pour une option qui serait archivée).

<?xml version="1.0" encoding="UTF-8"?>
<Table key="PRODUCTS">
    <Conditional-Formattings>
        <Conditional-Formatting key="commonConformity" level="PRODUCT">
            <Title>Conformité interne</Title>
            <Default-Status key="VALID">
                <Title>Valide</Title>
                <Color>GREEN</Color>
            </Default-Status>
            <Statuses>
                <Status key="INVALID">
                    <Title>Invalide</Title>
                    <Color>RED</Color>
                    <Priority>1</Priority>
                    <Rules>
                        <Common>
                            <Field key="DEEE_SCALE">
                                <Rule-Required />
                                <Rule-Must-Be-Selectable />
                            </Field>
                        </Common>
                    </Rules>
                </Status>
            </Statuses>
        </Conditional-Formatting>
    </Conditional-Formattings>
</Table>

Dans l'exemple ci-dessus, <Rule-Must-Be-Selectable /> fait référence à l'action SET_SELECTABLE_OPTIONS définie dans la formula décrite plus haut. Dans le cas ou une rule n'est pas correctement exécuté, l'action définit l'option courante comme étant 'incohérente' et déclenche dans le cas ci-dessus la rule <Rule-Must-Be-Selectable /> qui déclenche le statut INVALID.

Exemples

Si l'on considère la formula suivante:

<Formulas>
    <Field key="DEEE_SCALE">
        <Rule priority="1" >
            <Conditions>
                <Condition-Group>
                    <Condition source="SUPPLIER_CODE" operator="IN"> 
                        <Value>0646</Value>
                        <Value>0647</Value>
                    </Condition>
                </Condition-Group>
            </Conditions>
            <Action type="SET_SELECTABLE_OPTIONS">
                <Value>5240654</Value>
                <Value>5240655</Value>
            </Action>
        </Rule>
        <Rule priority="2" >
            <Conditions>
                <Condition-Group>
                    <Condition source="SUPPLIER_CODE" operator="IN"> 
                        <Value>0648</Value>
                    </Condition>
                </Condition-Group>
            </Conditions>
            <Action type="SET_SELECTABLE_OPTIONS">
                <Value>5240656</Value>
            </Action>
        </Rule>
    </Identifier>
</Formulas>

Ainsi que la règle de formatage conditionnel suivante

<?xml version="1.0" encoding="UTF-8"?>
<Table key="PRODUCTS">
    <Conditional-Formattings>
        <Conditional-Formatting key="commonConformity" level="PRODUCT">
            <Title>Conformité interne</Title>
            <Default-Status key="VALID">
                <Title>Valide</Title>
                <Color>GREEN</Color>
            </Default-Status>
            <Statuses>
                <Status key="INVALID">
                    <Title>Invalide</Title>
                    <Color>RED</Color>
                    <Priority>1</Priority>
                    <Rules>
                        <Common>
                            <Field key="DEEE_SCALE">
                                <Rule-Must-Be-Selectable />
                            </Field>
                        </Common>
                    </Rules>
                </Status>
            </Statuses>
        </Conditional-Formatting>
    </Conditional-Formattings>
</Table>

Premier exemple, l'item ne possède aucune valeur sur le field SUPPLIER_CODE

<Item partition="active">
    <Identifier key="ref">A</Identifier>
</Item>

• Dans ce cas, aucune Rule (ou action SET_SELECTABLE_OPTIONS) n'est venue limiter les options disponibles: toutes les valeurs pour le field DEEE_SCALE sont disponibles"
  • L'ensemble des valeurs pour le field DEEE_SCALE sont sélectionnables depuis l'interface app.product-live.com
  • Le statut remonté pour le champ de formatage conditionnel commonConformity est VALID
  • L'absence d'une valeur sur un field donné est considérée comme valide du point de vue de la règle de conformité Rule-Must-Be-Selectable

Deuxième exemple, l'item possède une valeur valide sur le field DEEE_SCALE

<Item partition="active">
    <Identifier key="ref">A</Identifier>
    <Field key="SUPPLIER_CODE">0646</Field>
    <Field key="DEEE_SCALE">5240654</Field>
</Item>

• Dans ce cas l'option 5240654 est permise pour le fournisseur 0646
• À l'édition, l'utilisateur se verra offrir la possibilité de sélectionner une des deux options permises, 5240654 ou 5240655
• Le statut remonté pour le champ de formatage conditionnel commonConformity est VALID

Troisième exemple, l'item possède une valeur invalide sur le field DEEE_SCALE

<Item partition="active">
    <Identifier key="ref">A</Identifier>
    <Field key="SUPPLIER_CODE">0646</Field>
    <Field key="DEEE_SCALE">00000000</Field>
</Item>

• On suppose quand dans notre exemple 00000000 est une option qui existe bien
• Dans ce cas l'option 00000000 n'est pas permise pour le fournisseur 0646
• Dans app.product-live.com, on constate via une icône sur la cellule que la valeur sélectionnée est non cohérente
• À l'édition, l'utilisateur se verra offrir la possibilité de sélectionner une des deux options permises, 5240654 ou 5240655
• Le statut remonté pour le champ de formatage conditionnel commonConformity est INVALID

Limiter une liste d'option vis-à-vis d'une classification

Ci-dessous nous détaillerons un cas issu d'un exemple présent au sein des structures de données d'Adeo et Kingfisher.

Besoin remonté par les équipes d'Adeo

• Empêcher la saisie d'une valeur incohérente pour la liste d'option Taille. Certaines de ces options ne sont cohérentes que pour un type de produit donné.
  • Exemple Une chaussure ne peut accepter que les valeurs 38, 39, 40, (...), alors qu'un t-shirt accepte les valeurs S, M, L, (...)

Limiter la sélection d'options un field en utilisant une formula

Comme dans l'exemple précédent, la formula présentée ci-dessous permet de limiter depuis l'interface les options qu'un utilisateur pourra sélectionner pour le field SIZE

Pour le field SIZE, dans le cas ou la catégorie shoes est sélectionnée, n'autoriser que les options 38, 39, 40, 41 et 42. Cependant, dans le cas où la catégorie sélectionnée est t-shirt, n'autoriser que les options S, M, L et XL.

<Formulas>
    <Field key="SIZE">
        <Rule priority="1" >
            <Conditions>
                <Condition-Group>
                    <Condition source="TYPOLOGY" operator="IN"> 
                        <Value>shoes</Value>
                    </Condition>
                </Condition-Group>
            </Conditions>
            <Action type="SET_SELECTABLE_OPTIONS">
                <Value>38</Value>
                <Value>39</Value>
                <Value>40</Value>
                <Value>41</Value>
                <Value>42</Value>
            </Action>
        </Rule>
        <Rule priority="2" >
            <Conditions>
                <Condition-Group>
                    <Condition source="TYPOLOGY" operator="IN"> 
                        <Value>t-shirt</Value>
                    </Condition>
                </Condition-Group>
            </Conditions>
            <Action type="SET_SELECTABLE_OPTIONS">
                <Value>S</Value>
                <Value>M</Value>
                <Value>L</Value>
                <Value>XL</Value>
            </Action>
        </Rule>
    </Identifier>
</Formulas>

Remonter un statut particulier sur un champ de formatage conditionnel dans le cas où l'option sélectionnée est invalide

L'exemple ci-dessous est en tout point similaire à l'exemple présenté plus haut.

<?xml version="1.0" encoding="UTF-8"?>
<Table key="PRODUCTS">
    <Conditional-Formattings>
        <Conditional-Formatting key="commonConformity" level="PRODUCT">
            <Title>Conformité interne</Title>
            <Default-Status key="VALID">
                <Title>Valide</Title>
                <Color>GREEN</Color>
            </Default-Status>
            <Statuses>
                <Status key="INVALID">
                    <Title>Invalide</Title>
                    <Color>RED</Color>
                    <Priority>1</Priority>
                    <Rules>
                        <Common>
                            <Field key="SIZE">
                                <Rule-Must-Be-Selectable />
                            </Field>
                        </Common>
                    </Rules>
                </Status>
            </Statuses>
        </Conditional-Formatting>
    </Conditional-Formattings>
</Table>

L'impact des outils utilisés dans l'import et l'export de la table

• Les formules et l'action SET_SELECTABLE_OPTIONS:
  • Plus de détails sur les formulas et l'action SET_SELECTABLE_OPTIONS au sein de la définition de la table dans la documentation de la tâche d'import de table
  • Cette action est également visible dans l'export de la table
• Les champs de formatage conditionnel:
  • La rule Rule-Must-Be-Selectable au sein de l'import de table sur les fields de type liste d'options (simple et multiples)
  • Cette rule est également visible dans l'export de la table

L'impact des outils utilisés dans l'import des items

• Lors de l'import items, les Action de type SET_SELECTABLE_OPTIONS sont exécutées
  • Si on s'apprête à enregistrer une valeur "cohérente", alors la valeur est flaguée comme telle au sein de l'item
  • Dans le cas contraire, la valeur est flaguée comme étant incohérente
  • Plus de détails à ce sujet ici et ici