Modèle de carte wallet et mappage des champs

Créez le modèle Billet d’événement et mappez les données de billet Secutix dans Apple Wallet et Google Wallet.

Votre template Wallet définit ce que voient les utilisateurs à la porte. Le mapping des champs définit quelles données Secutix se retrouvent dans chaque champ du Wallet. Commencez simple. Faites en sorte que le code-barres, le nom de l'événement, la date, le lieu et le siège soient corrects. Ajoutez des champs supplémentaires uniquement lorsque vous savez pourquoi ils sont importants.

Créer le modèle de billet d'événement

Un template est le « modèle » de votre billet dans Apple Wallet et Google Wallet. C’est ce qui fait que la Carte ressemble à votre marque et ce qui décide quelles informations sont affichées au participant.

Vous le créez une fois, puis vous le réutilisez pour chaque billet émis. La plupart des équipes commencent avec un seul template de billet d'événement. Même avec de petites variations, vous pouvez souvent conserver un seul template car le moteur de template prend en charge les variables et les conditions dans chaque champ personnalisable, y compris les couleurs et les images.

Vous ne créez davantage de templates que lorsque vous avez besoin d’un aspect complètement différent ou d’un contenu différent pour certains billets. Si vous voulez une explication plus longue, voir Modèle.

Cas d’utilisation réels

Utilisez plusieurs templates lorsque vous avez besoin d’une mise en page ou d’un ensemble de champs clairement différent.

• Différents types de produits : un template pour un pass visite, un autre pour un billet d'événement, et un autre pour un abonnement saisonnier.

• Différentes salles / halls : un template par salle dans un lieu multi-salles, afin que la Carte mette en avant le bon nom de salle et les bonnes informations d’entrée.

• Changements de configuration du lieu : différents templates lorsque le même endroit a des configurations différentes (assis, debout, en arène).

• Placement numéroté vs libre : un template qui affiche section/rang/siège, et un autre qui se concentre sur placement libre.

• Différentes expériences d'accès : différents templates lorsque certains spectacles nécessitent des instructions supplémentaires (entrée VIP, accès anticipé, flux d’entrée spécifique).

1

Créer un nouveau template

Créer un nouveau template

2

Choisissez « Utiliser un pré-construit »

Sélectionner Utiliser un pré-construit pour commencer depuis la bibliothèque.

3

Choisir le template « Billet d'événement »

Choisissez le Billet d’événement template lors de la création de votre Carte.

4

Définir le nom du template

Le nommage des templates est important. Secutix peut cibler des templates par nom lors de la distribution. Si vous prévoyez plusieurs templates, configurez des règles de routage dans Sélection du template (routage).

Mapping des champs

Le connecteur mappe par défaut les champs de billet les plus courants. Dans votre template, ouvrez l’éditeur de configuration avancée pour parcourir les données Secutix disponibles avec autocomplétion. Utilisez la liste des champs ci-dessous pour planifier votre mapping et déboguer les valeurs.

Interface de mapping des champs avec autocomplétion Secutix.

Utilisez cette page lorsque vous devez :

• Confirmer quels champs Secutix sont disponibles.

• Ajouter des champs calculés supplémentaires à la charge utile de votre Carte.

• Déboguer quels champs de billet vous pouvez réutiliser dans votre template.

Pour en savoir plus sur la configuration des templates de billets, voir Billet d’événement.

Champs disponibles

Champs disponibles (liste complète)

Voici le catalogue brut des champs exposé par le connecteur. Considérez-le comme une boîte à outils. Vous avez rarement besoin de tout.

L'équipe Wallet	Secutix	Exemple
firstName	movementData.beneficiaryFirstname	Cyril
lastName	movementData.beneficiaryLastname	DURAND
barCode	movementData.barCode	085035041335220306680099
ticket.zone3	movementData.area	Zone unique
ticket.seatCategory	movementData.seatCategory	Catégorie unique
address.country	operationData.siteAddress.countryCode	FR
address.address	operationData.siteAddress.firstAddressLine	116, Avenue du Président Kennedy
address.city	operationData.siteAddress.locality	PARIS
	operationData.siteAddress.phoneNumber	33-0156401516
	operationData.siteAddress.webSite	http://www.maisondelaradioetdelamusique.fr/
address.zipCode	operationData.siteAddress.zipCode	75016
ticket.zone1	operationData.site	Maison de la Radio et de la Musique
ticket.zone2	operationData.space	Studio 104
ticket.price	operationData.totalAmount	0
ticket.name	operationData.performance	Spectacle Wallet
ticket.subName	operationData.performanceAddOnName	Un spectacle exceptionnel
ticket.startDate	operationData.performanceDate	2024-07-01T20:00:00.000+02:00
	operationData.product	Spectacle Wallet
	operationData.productFamilyType	SINGLE_ENTRY
	operationData.productFamilySubType	SIMPLE_TICKET
ticket.taxNumber	movementData.TaxNumber	12010124729
expirationDate	expirationDate	2024-02-23T00:03:46.627+01:00
ticket.orderId	orderId	2389856
ticket.contactId	contactReference	897501
ticket.fileId	operationData.fileId	2234582
ticket.zone5	movementData.row
ticket.seatNumber	movementData.seatNumber
ticket.zone4	movementData.block
ticket.priceCategory	operation.AudienceSubCategory
ticket.priceCurrency	operation.CatalogCurrency.CurrencyCode
ticket.eventId	operationData.eventId
ticket.entrance	operationData.entrance
ticket.entranceCode	operationData.entranceCode
ticket.floor	operationData.floor
ticket.seatQuality	operationData.seatQuality
ticket.sector	operationData.sector
ticket.canceled	movementTicketData.TicketState is INVALIDATED or CANCELLED
address.longitude	operationData.siteAddress.gpsLongitude or computed from address via Google Maps API
address.latitude	operationData.siteAddress.gpsLatitude or computed from address via Google Maps API

Personnalisation du mapping (avancé)

N'utilisez le scripting que lorsque le catalogue de champs par défaut n’est pas suffisant. Ajoutez un script personnalisé dans le Avancé onglet de la page de configuration Secutix.

Écran de configuration Secutix

Ceci est utile lorsque vous devez :

• Mapper une valeur Secutix qui n’est pas encore exposée.

• Construire un champ calculé (format, concaténation, valeur conditionnelle).

• Normaliser les valeurs pour que les templates restent propres (exemple : toujours produire un seul champ « entranceLabel »).

Enregistrer extensions.secutix.movement.mapper et implémenter MapFromSecutix.

/**
 * Étendre le mapping par défaut de Secutix vers Wallet Crew.
 *
 * Ajouter tous les champs supplémentaires sur `entity`. Ils deviennent disponibles pour le rendu du template.
 *
 * @param {Object} params
 * @param {Object} params.Movement - Informations de Movement depuis le Web Service Secutix.
 * @param {Object} params.Operation- Informations d'opération liées au Movement courant depuis le Web Service Secutix.
 * @param {Object|null|undefined} params.Product - Informations produit annulables liées au Movement courant depuis Secutix.
 * @param {Object} entity - Entité cible du Wallet à enrichir.
 */
function mapFromSecutix(data, entity) {
  // Exemple : exposer un champ Secutix comme champ Wallet supplémentaire
  const stageVisibility = data?.Movement?.StageVisibility;
  if (stageVisibility != null) {
    entity["ticket.stageVisibility"] = stageVisibility;
  }
}

export default function(context) {
  context.register('extensions.secutix.movement.mapper', {
    MapFromSecutix: mapFromSecutix
  });
}

Si vous prévoyez d'exécuter plusieurs templates de billets, configurez des règles de routage dans Sélection du template (routage).