Rapprochement par source
Quand votre ERP, votre PLM ou votre fiche technique disent des choses différentes d’une même donnée : ce que chaque système a rapporté, où ils divergent et comment décider lequel l’emporte.
Ce que c’est
En plus de la valeur de chaque attribut d’un produit (la valeur maître, celle qui sort dans vos téléchargements et vos canaux), Bruxel conserve ce que dit chacun de vos systèmes connectés. Vous voyez ainsi où ils divergent et décidez lequel l’emporte, sans qu’un système écrase l’autre.
- Ce que rapporte un système ne change ni la valeur maître, ni l’historique, ni la complétude.
- La comparaison est exacte, après conversion des unités : 285 et 285,4 ne concordent pas.
- Elle s’applique aux attributs texte, nombre, mesure, date, oui/non et sélection ; pas aux sélections multiples.
Comment un système rapporte
Par l’API publique, avec `PUT /v1/products/:id/attributes/:code/source` et une clé ayant la permission `attributes:write`. Chaque système utilise sa propre clé : la source est le système auquel la clé est liée dans « Systèmes connectés » ou, à défaut, le nom de la clé.
La valeur est validée comme la valeur maître (une mesure est convertie dans l’unité de l’attribut), et l’envoyer vide efface ce que ce système disait. Le détail se trouve dans le portail développeurs.
Sur la fiche
Sous chaque attribut qu’un système a rapporté, la fiche indique combien de sources il y a et si elles concordent avec la valeur maître (« 2 sources · ne concordent pas »), avec la valeur de chaque système et quand il l’a vue. « Utiliser celle-ci » passe cette valeur à la valeur maître et figure dans l’historique comme « Rapprochement ».
L’utiliser demande le rôle Éditeur ou plus et respecte les mêmes verrous qu’une modification à la main : les attributs protégés, l’accès limité par groupe et ce qu’une règle fixe.
La file des divergences
Dans Catalogue → « Rapprochement par source » se trouvent tous les produits dont les systèmes divergent, avec des filtres par famille, attribut et source. Pour régler en lot, cochez les lignes (« Tout sélectionner » coche celles de la page), choisissez « Utiliser la valeur de » un système et cliquez sur « Passer à la valeur maître ». Ce qui n’a pas pu se faire indique pourquoi : cette source n’a pas rapporté l’attribut, l’attribut est protégé, il est hors de votre accès ou une règle le fixe.
Les personnes sans accès limité à une partie du catalogue voient la file ; régler demande le rôle Éditeur ou plus.
Qu’un système l’emporte
Avec les règles de priorité actives, choisir un attribut dans le filtre affiche « Priorité des sources » : les systèmes, de celui qui l’emporte le plus à celui qui l’emporte le moins. Une fois enregistrée avec « Enregistrer l’ordre », chaque fois qu’un système rapporte, le plus haut de la liste ayant rapporté écrit la valeur maître tout seul (dans l’historique : « Règle de priorité »). « Appliquer à l’existant » fait de même avec ce qui avait déjà été rapporté.
- Enregistrer l’ordre ne change rien à lui seul.
- Elle n’écrit jamais un attribut protégé ni un attribut fixé par une autre règle.
- Sans ordre, tout reste une divergence.
Dans les rapports
Dans les Rapports, « Divergences entre sources » télécharge la liste complète, et le rapport de qualité en PDF indique combien il en reste à régler.