Configuration avancée

Gérez la limitation du débit Cegid Retail Y2, la mise en cache, les mises à jour d’installation et les paramètres du connecteur basés sur des fichiers.

La limitation de débit et la mise en cache protègent l’environnement Cegid du volume généré par un programme de portefeuille. Un petit nombre de paramètres supplémentaires ne sont disponibles qu’en tant qu’entrées du fichier de configuration. Cette page couvre les deux, ainsi que la manière dont les deux voies de modification sont liées.

Limitation de débit

Cegid impose un plafond de requêtes sur une fenêtre glissante pour l’ensemble de l’environnement. Le dépasser entraîne des requêtes rejetées, qui affectent toutes les applications partageant cet environnement, y compris les caisses du point de vente. Le connecteur applique donc d’abord sa propre limite, délibérément inférieure à celle de Cegid, afin que l’excès de trafic soit retardé côté Wallet Crew plutôt que refusé côté Cegid.

La limitation de débit est activée par défaut. La limite à configurer correspond à la part de la capacité Cegid allouée à The Wallet Crew, et non au plafond complet du plan, sauf si aucune autre application n’utilise l’environnement.

Paramètre	Par défaut	Signification
Activé	Activé	Indique si le limiteur s’applique.
Limite de requêtes autorisées	4980	Requêtes autorisées par fenêtre.
Fenêtre (fichier uniquement)	300 s	La fenêtre glissante, conforme à celle de Cegid.
Réessayer après (fichier uniquement)	60 s	Combien de temps le travail différé attend avant une nouvelle tentative, lorsque Cegid ne fournit pas de consigne propre.
Délai d’attente de la file (fichier uniquement)	0 s	Combien de temps une requête attend une autorisation. Zéro signifie qu’elle est différée immédiatement plutôt que mise en attente.
Délai de nouvelle tentative dans la file (fichier uniquement)	1 s	Intervalle entre les tentatives d’obtention d’une autorisation pendant la mise en file d’attente.

La limite est par hôte Cegid, et non par tenant. Le limiteur comptabilise les requêtes sur l’hôte Cegid appelé. Lorsque plusieurs tenants Wallet Crew pointent vers le même environnement Cegid, par exemple un groupe exploitant plusieurs marques à partir d’une seule instance Y2, ils partagent un même budget. La limite configurée de chaque tenant doit refléter sa part de l’environnement, et non l’ensemble, sinon le groupe dépassera collectivement ce que Cegid autorise.

Lorsque la limite est atteinte, le travail qui peut être différé est replanifié plutôt que mis en échec, puis retenté après l’intervalle indiqué par Cegid lorsqu’il en fournit un. Les modifications de la limite s’appliquent dès l’appel suivant ; aucun redéploiement n’est nécessaire.

Dimensionnement de la limite

Le trafic de rafraîchissement de Carte est facile à sous-estimer. Chaque rafraîchissement peut appeler plusieurs services Cegid. Planifiez les gros rafraîchissements en fonction du même budget de requêtes que celui utilisé par les applications de magasin et tierces.

Mise en cache

La mise en cache conserve les réponses Cegid pendant une courte période afin que les lectures identiques répétées, le plus souvent causées par des plateformes de wallet interrogeant la même Carte, ne deviennent pas chacune un appel à Cegid.

Quatre durées indépendantes sont disponibles pour les profils clients, les données de fidélité, les documents de vente et les opérations de caisse. Toutes sont exprimées en secondes, et toutes sont désactivées par défaut: la mise en cache est facultative, et non quelque chose que l’on réduit à partir d’un réglage par défaut.

Cache	Conservation	Point à considérer
Client	Profils clients	De courtes durées suffisent généralement, car le trafic supprimé correspond à des lectures répétées à quelques secondes d’intervalle.
Fidélité	Cartes, programmes, soldes de points	Le plus visible pour les utilisateurs finaux : un solde qui tarde à se mettre à jour après un achat se remarque.
Documents de vente	Reçus et listes de documents	Des données historiques, donc tolèrent des durées plus longues.
Opérations de caisse	Bons, cartes-cadeaux, valeur stockée	Les soldes changent en caisse ; confirmez les exigences de fraîcheur avant d’allonger.

Les écritures invalident ce qu’elles affectent : la mise à jour d’un client efface le profil mis en cache de ce client, et la création d’une carte de fidélité efface la liste de cartes mise en cache. Des durées de quelques secondes suffisent déjà à éliminer la majeure partie du trafic en double, car le schéma supprimé correspond à des rafales plutôt qu’à des lectures continues.

Mise à jour du client lors de l’installation de la Carte

Lorsqu’elle est activée, ce qui est le cas par défaut, l’installation ou la suppression d’une carte réécrit la fiche client dans Cegid. C’est ce qui permet à une marque de voir l’adoption du wallet dans son propre CRM, à condition que le mapping écrive un état d’installation dans un champ Cegid. La procédure pour le faire se trouve dans Personnaliser le mappage.

Lorsque la marque n’enregistre pas l’état d’installation dans Cegid, le paramètre peut être désactivé pour supprimer le trafic correspondant.

Modification directe du fichier de configuration

Les paramètres du connecteur sont stockés sous forme de fichier YAML dans le magasin de configuration du tenant, et ce fichier peut être modifié directement dans l’espace de travail de configuration, qui offre une arborescence de fichiers, une validation de schéma, un panneau des problèmes, l’historique des versions et la comparaison entre versions.

Cela vaut la peine pour les paramètres que la page du connecteur n’expose pas : la fenêtre de limitation de débit et les intervalles de nouvelle tentative ci-dessus, les durées de cache supérieures à un jour, ainsi que l’association d’un magasin à une connexion nommée, qui n’a pas d’équivalent dans le formulaire.

Mélanger les deux voies est sans danger. L’enregistrement depuis la page de configuration conserve les paramètres qu’elle n’affiche pas elle-même, donc une valeur définie à la main dans le fichier n’est pas perdue lorsqu’une modification ultérieure est effectuée via le formulaire.

Les valeurs ne sont pas converties de force. Une valeur qui ne correspond pas au type attendu n’est pas appliquée, et l’intention se perd silencieusement — un booléen écrit avec une capitalisation inattendue, par exemple, est lu comme du texte plutôt que comme un booléen. Lorsqu’une modification de fichier semble n’avoir aucun effet, la forme de la valeur est la première chose à vérifier.

FAQ

Quelle durée de cache faut-il utiliser ?

Commencez avec quelques secondes pour les données clients et de fidélité, ce qui élimine la majeure partie du trafic de sondage en double sans délai visible, et allongez seulement si la consommation Cegid reste élevée. Des durées plus longues échangent la fraîcheur contre le volume, et ce sont les soldes de fidélité que les utilisateurs finaux remarquent.

Une modification de la limitation de débit nécessite-t-elle un redéploiement ?

Non. La nouvelle valeur s’applique dès l’appel suivant à Cegid.

Où la configuration actuelle peut-elle être consultée dans son ensemble ?

L’espace de configuration affiche le fichier dans son intégralité, avec son historique des modifications, ce qui constitue aussi le moyen le plus rapide de voir ce qui a changé et quand à la suite d’un changement de comportement inattendu.