This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Connexions et magasins

Configurez plusieurs connexions Cegid Retail Y2, acheminez chaque magasin vers les bons identifiants et maintenez les intégrations multi-magasins.

Le connecteur peut utiliser une seule connexion Cegid ou des connexions distinctes pour chaque magasin. Cette page explique quand plusieurs connexions sont nécessaires, comment le connecteur en sélectionne une, et ce qui nécessite une maintenance continue.

Quand plusieurs connexions sont nécessaires

Une seule connexion suffit dès lors qu’un seul jeu d’identifiants Cegid peut voir et agir sur chaque client couvert par le programme Wallet. Cela couvre la grande majorité des implémentations, y compris la plupart des déploiements multi-marchés, car les marchés sont généralement séparés par magasin plutôt que par identifiants.

Plusieurs connexions deviennent nécessaires dans deux situations. La première est celle de bases de données Cegid réellement distinctes : une marque exploitant des environnements Cegid séparés pour différentes régions ou enseignes. La seconde, et la plus courante en pratique, est une base de données unique dans laquelle chaque magasin a son propre utilisateur de service web, de sorte que les enregistrements créés par ce magasin portent leur propre préfixe d’identifiant de magasin et consomment le compteur de ce magasin.

Les identifiants par magasin offrent une attribution précise dans Cegid, au prix d’une entrée de configuration par magasin qui doit être créée à chaque ouverture et maintenue à chaque changement de mot de passe. Les marques exploitant des parcs de ce type devraient lire Runbooks d’exploitation en complément de cette page.

Ajouter et supprimer des connexions

Les connexions sont gérées depuis la barre d’outils des connexions en haut de la page de configuration Cegid. Le sélecteur répertorie chaque connexion avec son identifiant de base de données, en marquant la valeur par défaut. À côté se trouvent les actions permettant d’ajouter une connexion, de supprimer celle sélectionnée et de la définir comme connexion par défaut.

Une nouvelle connexion est créée avec, préremplies, l’URL du service et les identifiants de la connexion par défaut, de sorte que dans le cas courant — l’ajout d’un nouveau magasin dans une base existante — seul le nom, ainsi que le nom d’utilisateur et le mot de passe propres au magasin, doivent être modifiés.

Comment une connexion est choisie

Lorsqu’une requête concerne un magasin particulier, le connecteur sélectionne une connexion selon un ordre fixe :

  1. La connexion explicitement liée à ce magasin, si elle est configurée.

  2. Une connexion dont le nom est exactement l’identifiant du magasin.

  3. La connexion par défaut.

La deuxième règle est celle sur laquelle reposent la plupart des parcs, et c’est pourquoi le nommage des connexions n’est pas purement cosmétique : nommer chaque connexion d’après l’identifiant de son magasin est ce qui permet de faire appliquer les identifiants propres au magasin sans aucune configuration supplémentaire.

Lier un magasin à une connexion nommée

Lorsqu’une connexion ne peut pas être nommée d’après le magasin — parce qu’une seule connexion sert plusieurs magasins, par exemple — le magasin peut être lié explicitement à une connexion nommée. Ce lien est défini sur l’enregistrement du magasin dans la configuration du tenant et n’a pas d’équivalent sur la page du connecteur, c’est donc l’un des rares paramètres qui nécessite l’espace de travail de configuration décrit dans Configuration avancée.

Magasin d’attache et magasin de création

Cegid distingue le magasin auquel un client est rattaché du magasin où l’enregistrement a été créé. Le connecteur écrit le magasin d’attache, et le relit en priorité par rapport au magasin de création, ne revenant à la création que lorsque l’attache est vide.

Le magasin de création est défini par Cegid lui-même à partir des identifiants utilisés, ce qui constitue le mécanisme derrière les préfixes d’identifiant. Il ne peut pas être choisi via le service web avec lequel le connecteur écrit, donc un enregistrement créé avec les identifiants d’un magasin porte définitivement le préfixe de ce magasin.

Modèles à éviter

Trois habitudes reviennent dans les configurations multi-connexions de longue durée, et chacune provoque un problème caractéristique.

Commenter et décommenter des connexions comme moyen de désactiver des magasins laisse une configuration dans laquelle les entrées actives et retirées sont entremêlées, et rend facile à manquer une faute de frappe dans une entrée active. La suppression de la connexion est préférable.

Magasins retirés laissés configurés continuent d’être testés à chaque contrôle de configuration, produisant des erreurs persistantes qui apprennent aux opérateurs à ignorer le résultat du test.

Paramètres de reçu appliqués à certaines connexions seulement produisent des reçus qui diffèrent d’un magasin à l’autre sans cause évidente.

FAQ

Pourquoi un client a-t-il obtenu un identifiant avec le mauvais préfixe de magasin ?

L’enregistrement a été créé à l’aide d’identifiants appartenant à un autre magasin. Soit le magasin n’a pas sa propre connexion et la requête est retombée sur la connexion par défaut, soit le nom de la connexion ne correspond pas exactement à l’identifiant du magasin.

Peut-on corriger après coup un préfixe d’identifiant ?

Pas par The Wallet Crew, car l’identifiant est attribué par Cegid. Lorsque Cegid réémet des identifiants, les Cartes peuvent être mises à jour pour pointer vers les nouveaux identifiants, à condition de disposer du mappage entre les anciens et les nouveaux.

Y a-t-il une limite au nombre de connexions ?

Non, aucune limite fixe. Des parcs comptant plusieurs dizaines de connexions sont exploités en production. Au-delà de quelques-unes, c’est la charge de maintenance plutôt que la plateforme qui devient la contrainte.

Mis à jour