Règles (Association auto des médias)

Cette page aborde la syntaxe et les options à utiliser pour la mise en place d'une règle d'association automatique des médias aux documents lors de l'upload manuel de ceux-ci.
A ce jour, le moteur d'import n'est pas encore compatible avec ces règles, donc il faut passer par un fichier d'import de liaisons si les médias ont été créés de cette manière.

Ecran "Administration" > "Système" > "Règles" pour l'administration de ces règles.
https://[your_domain].quable.com/#automation

Principe :

L'association est faite en se basant sur tout ou partie du nom du média uploadé :

• au moment de l'upload, une partie du nom du média est isolé au moyen d’une expression régulière définie dans la règle

• un document avec un code correspondant est cherché

• si un document est trouvé, le rattachement est fait

Plusieurs règles peuvent donc être créées, et serviront à gérer le rattachement sur différents types de documents/liaisons, en fonction du match ou non du nom du média avec les regex définies.

Ci-dessous les champs à renseigner lors de la création d’une règle :

• Slug = "nom_de_la_règle" > libre

• evenement = "mediaupload"

• Ruleif : toujours sous ce format

{
  "target_document_type": "article",
  "target_value_type": "code",
  "target_value": "",
  "rule": "equal",
  "from_value_regex": "\/(\\d+)(\\w{2})-(\\d{1,2}-?\\d{0,2})\\.\S+\/",
  "from_value_regex_group" : 2,
  "from_value_type": "originalfilename",
  "from_value": ""
}

Détail :
– target_document_type : code du type de document (article, produit, refcol, ref, …) sur lequel chercher le code
– target_value_type = "code". Le rattachement n’est aujourd’hui possible que via le code du document
– target_value = "" laisser un string vide
– rule = "equal". La partie isolée du nom du média doit être identique au code du document
– from_value_regex : regex permettant d’isoler des parties du nom du média (au moyen de parenthèses = groupes de capture). Les caractères à échapper doivent l’être 2 fois (ie. \. pour un point au lieu de .)
– from_value_regex_group : entier permettant d’indiquer la valeur de quelle parenthèse capturante est utilisée pour la recherche du document (dans l’exemple, 2 = "(\w{2})" )
– from_value_type = "originalfilename"
– from_value = "" laisser un string vide 

• Rule then :

{
  "action": "createXObject",
  "document_type": "article_images_media",
  "side_entity": "target"
}

Détail :
– action = "createXObject"
– document_type : code de la liaison doc_type > media sur laquelle lier le média. article_images_media est la liaison par défaut à l’init des données, mais d’autres peuvent avoir été créées via l’écran "Modèle de données" > "Liaisons"
– side_entity = "target" (le média est enfant du document)