Liaisons automatiques

La page Liaisons automatiques vous permet d'utiliser le puissant moteur de règles de Quable PIM pour spécifier les conditions de liaison automatique des médias téléchargées à vos documents ou variants existants.

44094409

La page affiche une liste de vos règles de liaison automatique existantes (le cas échéant) et des boutons d'action pour ajouter, modifier ou supprimer des règles.

🚧

Des compétences en programmation peuvent être nécessaires pour créer des règles de liaison automatique, car le processus comprend la création d'une expression régulière (regex) et de deux déclarations JSON (JavaScript Object Notation).

Règles

Les liaisons automatiques sont basées sur des règles qui créent dynamiquement des associations entre vos documents/variants et vos médias en fonction d'une partie du nom du média téléchargée (une expression régulière définie lors de la création de la règle pour la liaison). Tous les médias qui doivent être liés via une règle de liaison automatique spécifique doivent être nommées selon le modèle défini dans la règle.

Lorsqu'un média est téléchargé, Quable PIM interprète l'expression régulière définie dans la règle, et recherche un document ou un variant qui correspond aux conditions de la règle. Si une correspondance est trouvée, l'association est faite.

❗️

Chaque règle de liaison automatique est limitée à un seul type de document. Vous devez créer des règles distinctes pour chaque type de document que vous voulez lier automatiquement avec les médias téléchargés.

Convention de dénomination

Les règles de liaison automatique dépendent des expressions régulières pour interpréter le nom des médias téléchargés et savoir à quel type de document les associer. Cela exige que les noms de vos médias suivent un modèle spécifique.

Il n'y a pas de limites à votre modèle général, mais un identifiant de document doit être inclus dans le nom du média. Un identifiant de document est une chaîne de caractères alphanumériques qui identifie un document (code du document ou valeur de l'attribut). Cela permet à Quable PIM d'identifier le type de document à lier.

👍

Il n'y a pas de format spécifique requis, mais il est fortement recommandé de garder votre convention de dénomination aussi simple que possible. Votre chef de produit Quable PIM peut vous fournir un modèle pour vous aider à créer votre propre convention de dénomination.

Exemple 1

Vous voulez lier automatiquement les médias à votre type de document produit avec le type de liaison produit_main_pictures. Votre administrateur Quable PIM a créé une règle automatique pour rechercher cette convention de dénomination :

chaîne de caractères aléatoire_document code_1.extension de fichier

La règle de recherche :

  • des segments avec des types de données spécifiques,
  • séparés par des traits de soulignement ( _ ), et
  • une extension de fichier.

Le tableau suivant fournit une ventilation des segments dans cet exemple.

Segment

Type de données

Description

chaîne de caractères aléatoire

caractères alphanumériques

Il peut s'agir de n'importe quel texte. La règle vérifie uniquement qu'il s'agit d'un contenu alphanumérique.

document code

caractères alphanumériques

Il s'agit d'identifier le document auquel il faut lier la ressource. Dans ce cas, le document cible doit être du type de document défini dans la déclaration Rule if. ("target_document_type).

1

nombre

(optionnel) Ceci indique la séquence du média.

extension de fichier

caractères alphanumériques

Il peut s'agir de n'importe quelle extension de fichier. La règle vérifie seulement qu'il y a un type d'extension ici (par exemple, .jpg, .png, .svg).

Pour respecter cette règle de liaison automatique, vos médias pourraient être nommés :

picture_bluejean_1.jpg
abc123_bluejean_1.png
random_bluejean_1.svg

Si les noms des médias sont dans le format correct et incluent le code du type de document et le numéro 1, les médias seront automatiquement liés aux bons documents.

Exemple 2

Vous voulez lier automatiquement les médias à votre type de document produit avec le type de liaison product_pictures. Votre administrateur Quable PIM a créé une règle automatique pour rechercher cette convention de dénomination :

(chaîne de caractères aléatoire)document code-8.extension de fichier

La règle recherche :

  • des segments avec des types de données spécifiques,
  • séparés par des parenthèses ( ( ) ) et un trait d'union (- ), et
  • une extension de fichier.

Le tableau suivant fournit une ventilation des segments dans cet exemple.

Segment

Type de données

Description

chaîne de caractères aléatoire

caractères alphanumériques

Il peut s'agir de n'importe quel texte. La règle vérifie uniquement qu'il s'agit d'un contenu alphanumérique.

document code

caractères alphanumériques

Il s'agit d'identifier le document auquel il faut lier la ressource. Dans ce cas, le document cible doit être du type de document défini dans la déclaration Rule if. ("target_document_type).

8

nombre

(optionnel) Ceci indique la séquence du média.

extension de fichier

caractères alphanumériques

Il peut s'agir de n'importe quelle extension de fichier. La règle vérifie seulement qu'il y a une sorte d'extension ici (par exemple, .jpg, .png, .svg).

Pour respecter cette règle de liaison automatique, vos médias pourraient être nommés :

[picture]bluejean-8.jpg
[abc123]bluejean-8.png
[random]bluejean-8.svg

Créer des règles

Pour créer une règle de liaison automatique, cliquez sur le bouton Nouvelle règle. Un formulaire s'affiche pour définir la règle de liaison automatique.

16041604

Le formulaire requiert les informations suivantes :

  • Slug - identifie la règle
  • Event - indique l'action qui déclenche la règle
  • Rule if - définit les conditions à remplir
  • Rule then - définit l'action à effectuer

Ces informations sont combinées pour créer une déclaration JSON que Quable PIM interprète pour établir la liaison automatique. Chaque élément d'information est décrit dans les sections suivantes.

Slug

Le Slug est un identifiant lisible par l'homme pour la règle de liaison automatique. Il s'agit généralement d'un nom qui doit être aussi descriptif que possible.

Information

Description

Slug

Saisissez le texte (caractères alphanumériques) pour identifier votre règle de liaison automatique.

Event

Importer un média dans Quable PIM est un Evénement distinct. C'est ce qui déclenche l'application de la règle de liaison automatique.

Information

Description

Event

Saisissez mediaupload pour indiquer l'événement par lequel la règle est déclenchée.

Note : Ceci doit être saisi exactement comme indiqué.

Rule if

La section Règle if définit une déclaration JSON avec les conditions qui doivent être remplies pour que la règle s'applique :

Information

JSON Code

Description

Rule if

Les conditions qui doivent être remplies pour que la règle soit appliquée. Elle doit être rédigée dans le format indiqué dans l'exemple (ci-dessous).

Ces conditions identifient :

  • le type de document auquel la règle s'applique,
  • comment identifier le bon type de document,
  • comment interpréter le nom du média, et
  • quelle partie du nom du média utiliser.

target_document_type

Le code unique du document qui doit être lié.

target_value_type=”code”

OR

target_value_type=”eav”

  • "code" - indique que la règle utilise un code de document.
  • "eav" - indique que la règle utilise une valeur d'attribut.
  • target_value=””

    Si

    • target_value_type=”code”, il doit s'agir d'une chaîne vide ("").
    • target_value_type=”eav”, il s'agit du code de l'attribut (par exemple, "target_value": "color").

    rule=”equal”

    Cela indique que la partie isolée du nom du média doit correspondre exactement au type de document ou au code d'attribut.

    from_value_regex

    Une expression régulière (regex) permettant d'isoler les segments de noms de média (entre parenthèses, également appelés groupes de capture). Les caractères devant être échappés doivent l'être deux fois avec une barre oblique inverse (par exemple, \\. pour un point au lieu de .).

    Par défaut, le premier groupe de capture est examiné sauf si from_value_regex_group soit utilisé pour spécifier un groupe.

    Si vous êtes novice en matière d'expressions régulières, vous pouvez vous référer à ce site. (en anglais)

    from_value_regex_group

    (optionnel) Un nombre entier (numéro) indiquant le groupe de capture à utiliser pour la recherche de documents (1 = premier groupe, 2 = deuxième groupe, etc.).

    from_value_type="originalfilename”

    Il doit être saisi exactement comme indiqué.

    from_value=””

    Il doit être saisi exactement comme indiqué.

    Rule then

    La section Rule then définit une déclaration JSON avec l'action à entreprendre si les conditions définies dans la déclaration Rule if sont remplies :

    Information

    JSON Code

    Description

    Rule then

    Les actions à entreprendre lorsque les conditions de la règle sont remplies. Elle doit être rédigée dans le format indiqué dans l'exemple ci-dessous.

    action=createXObject

    Ceci doit être utilisé exactement comme écrit. Il indique à Quable de créer une liaison entre le média et le document/variant.

    document_type

    Le code unique de la liaison doc_type > asset à utiliser. Le type de liaison par défaut est article_images_media. Voir Types de liaison pour en savoir plus sur la création de types de liaison supplémentaires.

    sequence_regex

    (optionnel) Une expression régulière (regex) définissant l'ordre des médias.

    Note : le numéro de séquence doit être inclus dans le originalfilename du média.

    target_property="originalfilename"

    (optionnel) Spécifie que sequence_regex est dans le nom du média.

    side_entity=”target”

    Ceci doit être utilisé exactement comme écrit. Elle fait du média une entité enfant du document auquel il est lié.

    Exemple

    Vous avez un type de document produit avec un attribut dont le code est couleur. L'attribut a deux valeurs possibles (rouge, bleu). Pour lier le média bleu.jpg à tous les documents du type de produit dont la valeur de l'attribut couleur est bleu, votre règle serait la suivante :

    15961596

    La déclaration Rule if :

    {
        "target_document_type": "product",
        "target_value_type": "eav",
        "target_value": "color",
        "rule": "equal",
        "from_value_regex": "\/^([a-zA-Z0-9]*)\\.[jpg|png]\/",
        "from_value_type": "originalfilename",
        "from_value": ""
    }
    
    Rule if logique :
    "target_document_type": "product"Les médias doivent être liés à un type de document produit.
    "target_value_type": "eav"La liaison doit être basée sur un attribut.
    "target_value": "color"Utilisez ce code d'attribut spécifique.
    "rule": "equal"Le nom du média doit correspondre exactement à une valeur d'attribut.
    "from_value_regex": "\/^([a-zA-Z0-9]*)\\.[jpg|png]\/"Le nom du média doit être comme ceci :
    • ([a-zA-Z0-9]*) précise que le nom du média doit être une chaîne de caractères alphanumériques.
    • [jpg|png] précise que le bien doit avoir une extension jpg ou png.

    🚧

    "from_value_type": "originalfilename" et "from_value": "" doivent toujours être écrits comme indiqué.

    La déclaration Rule then :

    {
    "action": "createXObject",
    "document_type": "article_images_media",
    "side_entity": "target"
    }
    
    Rule then logique :
    "action": "createXObject"Créer un objet de connexion.
    "document_type": "article_images_media"Utilisez le type de liaison article_images_media.
    "side_entity": "target"Utilisez la "target" dans la déclaration Rule if.

    Modifier les règles

    Vous pouvez modifier une règle de liaison automatique en la sélectionnant dans la liste et en cliquant sur le bouton Editer. Le formulaire d'information s'affiche.

    Lorsque vous avez terminé vos modifications, cliquez sur le bouton Appliquer pour enregistrer vos modifications ou sur le lien Retour pour revenir à la page des liaisons automatiques sans enregistrer les modifications.

    Supprimer des règles

    Pour supprimer une règle de liaison automatique, sélectionnez-en une dans la liste et cliquez sur le bouton Supprimer. Un dialogue s'affiche pour annuler ou confirmer la suppression.

    318318

    Cliquez sur Oui pour supprimer la règle ou sur Non pour annuler la suppression.

    ❗️

    Attention

    Cette action est irréversible. Une fois qu'une règle de liaison automatique a été supprimée, elle ne peut pas être récupérée.


    Did this page help you?