Extensibilité

Étendez le mappage client et magasin Comarch avec des hooks de script de connecteur.

Le mappage par défaut couvre les champs de fidélité courants. L’extensibilité est utile lorsqu’un projet nécessite des attributs Comarch supplémentaires ou une structure de charge utile de Carte différente.

Où le mappage personnalisé est configuré

Le mappage personnalisé est configuré dans l’onglet onglet Avancé de l’éditeur de paramètres Comarch.

C’est ici que des scripts de connecteur peuvent être ajoutés pour étendre ou remplacer le mappage client et magasin par défaut.

L’assistance Wallet Crew peut être contactée lorsque le mappage personnalisé doit être configuré ou examiné.

Hooks disponibles

Le connecteur expose deux hooks de script.

Hook	Objectif	Quand il s’exécute
extensions.comarch.customerMapper	Étendre ou remplacer le mappage client	Après la récupération des données client et l’application du mappage standard
extensions.comarch.locationMapper	Étendre ou remplacer le mappage magasin	Après la récupération des données du magasin et l’application du mappage standard

Quand utiliser l’extensibilité

Utilisez un hook personnalisé lorsque la Carte a besoin de données qui ne sont pas mappées par défaut.

Les cas courants incluent des attributs de profil personnalisés, des libellés de fidélité, des métadonnées de localisation supplémentaires ou des noms de champs propres au projet.

Ce que les hooks reçoivent

Chaque hook reçoit la réponse brute de Comarch et l’entité Carte.

Cela permet de réutiliser n’importe quel champ présent dans la charge utile source, pas seulement les champs mappés par défaut.

Les objets bruts sont également exposés pour inspection sous :

• debug.comarch.customer
• debug.comarch.store

Approche recommandée

Commencez d’abord par le mappage par défaut.

Ajoutez ensuite uniquement les champs supplémentaires dont la Carte a vraiment besoin. Cela simplifie les modèles et réduit la maintenance à long terme.

Notes de sécurité

Appliquez d’abord les modifications de mappage dans l’environnement de préproduction.

Un script de mappage peut affecter chaque actualisation de Carte qui utilise le connecteur. La validation doit couvrir à la fois l’exactitude des données et le rendu du modèle.

FAQ

Où le mappage Comarch personnalisé est-il configuré ?

Le mappage personnalisé est configuré dans l’onglet onglet Avancé de l’éditeur de paramètres Comarch.

C’est ici que des scripts de connecteur peuvent être ajoutés pour étendre ou remplacer le mappage par défaut.

Quand faut-il utiliser l’extensibilité ?

L’extensibilité est utile lorsque le mappage par défaut ne couvre pas les besoins du projet.

Les cas courants incluent des attributs Comarch supplémentaires, des champs renommés ou des règles de transformation spécifiques au projet.

L’extensibilité peut-elle modifier à la fois le mappage client et le mappage magasin ?

Oui. Des hooks distincts sont disponibles pour le mappage client et le mappage magasin.

Cela permet d’adapter chaque partie indépendamment.