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.

Personnalisation avancée

Étendez le mappage des billets Aparté, le routage et le comportement du connecteur lorsque la configuration par défaut ne suffit pas.

Pourquoi la personnalisation avancée est importante

La configuration par défaut couvre la plupart des projets Aparté. Elle fonctionne bien lorsqu'un seul modèle de Carte suffit.

La personnalisation avancée est utile lorsque l'affichage des tickets ou le routage des modèles nécessite davantage de contrôle.

Exemples réels
  • Familles de tickets multiples: utiliser différents modèles de Carte pour différents types de tickets.

  • Règles d'affichage personnalisées: transformer les valeurs sources avant de les afficher sur la Carte.

  • Routage spécifique: appliquer un modèle différent en fonction des métadonnées du ticket.

Commencez d'abord simplement

Un premier déploiement doit rester simple. Commencez avec le type de Carte par défaut, validez le résultat, puis ajoutez des règles personnalisées uniquement lorsque c'est nécessaire.

Lorsque des données supplémentaires sont nécessaires, ouvrez les détails de la Carte, sélectionnez l' Données onglet, puis sélectionnez Données externes. Inspectez la charge utile brute d'Aparté sous debug.aparte.ticket. Cela confirme quels champs sont disponibles avant de modifier la conception de la Carte.

Ce qui peut être personnalisé

Advanced tab of the Aparté connector settings, showing display rules and template routing options
Les règles d'affichage et le routage des modèles sont configurés ici, au-dessus du type de Carte par défaut.

La personnalisation avancée couvre généralement deux domaines.

  • Règles d'affichage: ajuster la façon dont les données Aparté apparaissent sur la Carte.

  • Routage des modèles: envoyer certains tickets vers un autre type de Carte.

Le connecteur Type de Carte par défaut reste la solution de repli lorsqu'aucune règle personnalisée ne sélectionne un autre modèle.

Déploiement recommandé

Utilisez cet ordre pour garder la configuration facile à valider :

  1. Commencez avec un seul type de Carte par défaut.

  2. Vérifiez la charge utile source dans debug.aparte.ticket.

  3. Ajoutez de petites règles d'affichage si nécessaire.

  4. Ajoutez le routage des modèles uniquement lorsqu'un seul type de Carte ne suffit plus.

Obtenir de l'aide pour la personnalisation avancée

La personnalisation avancée peut être examinée avec l'équipe de support The Wallet Crew. C'est utile lorsque la bonne approche de routage ou de mappage n'est pas encore claire.

Le support peut aider à définir l'ensemble de règles le plus simple avant l'implémentation.

FAQ

Tous les projets Aparté doivent-ils utiliser le mappage avancé ?

Non. La plupart des projets fonctionnent bien avec la configuration par défaut et un seul type de Carte.

Où la charge utile brute d'Aparté peut-elle être inspectée ?

La charge utile source complète est disponible sous debug.aparte.ticket.

Quand faut-il ajouter le routage des modèles ?

Ajoutez le routage lorsque le type de Carte par défaut unique ne couvre plus clairement les variantes de tickets.

Mis à jour