Page tree
Skip to end of metadata
Go to start of metadata

Introduction

PASSBOOK a été ajouté à la liste des supports de billets. Il fait partie des modes d’envoi suivants : billet électronique et billet mobile. SecuTix conseille d’activer le mode d’envoi électronique en lieu et place des modes print@home (eticket) ou mobile. En effet, le mode électronique permet une grande flexibilité concernant l’activation des différents supports de billets (un ou plusieurs de ces supports peuvent être activés à tout moment : print@home (eticket), mobile pdf, PASSBOOK). Il est néanmoins conseillé d’activer les trois supports en créant des maquettes adéquates pour que les utilisateurs puissent profiter du meilleur service possible.

Il est à noter que le format PASSBOOK n’est supporté nativement que par les iPhones et iPod touch (iOS >= 6). Les tablettes iPad, ainsi que les appareils Android ne supportent pas nativement ce format.

Les billets PASSBOOK seront automatiquement accessibles depuis les Apple Watch à partir du moment où ils sont ajoutés au WALLET de l’utilisateur.

Ajout d'une maquette

Premièrement il faut ajouter une maquette PASSBOOK dans le contexte Institution à Outils à Maquettes. Vous pouvez importer une maquette existante ou directement créer une nouvelle maquette en appuyant sur le bouton « nouveau » :

Veuillez sélectionner la maquette de base « passbook » et lui donner un nom.

Pas de passbook dans la liste?

Si la maquette de base « passbook » n’apparait pas dans la liste, veuillez contacter votre chef de projet SecuTix ou le support SecuTix. En effet, le support en question n’est tout simplement pas encore activé pour votre institution (ELCADMIN).

Une fois la maquette créée, ouvrez-là et essayez de générer un billet de test PASSBOOK en appuyant sur l’icône d’impression :

En cas de problème

Veuillez contacter le support SecuTix si le billet ne se génère pas correctement.

Pour tester un billet PASSBOOK (extension .pkpass), il faut l'envoyer par email sur un iPhone ou iPod et ouvrir le fichier attaché. Le billet s'affiche sur l'écran après un clic sur l'icône du fichier attaché et si le billet est valide.

Paramétrage de la maquette

Restrictions sur les champs dans l'éditeur

Ne pas déplacer, effacer, renommer ou ajouter un champ dans la maquette. Les champs sont prédéfinis et ne doivent en aucun cas être modifiés (sauf leur valeur bien entendu). Si vous ne voulez pas qu'un champ apparaisse, veuillez tout simplement le rendre invisible --> VALABLE SEULEMENT POUR LES CHAMPS TEXTE SUIVANTS : block_label, block_value, header_label, header_value, owner_label, owner_value, price_label, price_value, row_label, row_value, seat_label, seat_value, site_label, site_value

Les éléments de la maquette ne sont pas disposés tels que dans le résultat final du billet PASSBOOK. Cela est dû à certaines limitations de notre éditeur de maquette. Si vous voulez voir le résultat d’un paramétrage, veuillez directement générer le billet depuis l’éditeur et ouvrir le fichier pkpass sur votre mobile. Veuillez ne pas ajouter de formatage dans les valeurs des champs. Exemple : ne pas entrer dans un champ la valeur suivante : <i style="color:green">Pass</i>.

Les noms des champs correspondent à la signification qu'Apple a voulu leur donner, exemple : price_value. Cependant, vous avez la possibilité de mettre n'importe quelle valeur dans ces champs, libre à vous de composer votre billet comme vous le désirez. Veuillez ne pas renommer un champ même si vous ne lui donner pas la même signification que celle d'Apple.

Pour paramétrer la couleur des champs, veuillez utiliser la champ "settings" et non les valeurs de style.

Voici la liste des champs à disposition et leur signification :


Note : la référence doit toujours se faire par rapport à la documentation officielle Apple, notamment sur les dimensions. Elle est disponible à ce lien

  • background.png

Taille conseillée : 180 x 220 (hauteur x largeur)
Image de fond du billet

  • barcode_message

Valeur par défaut : ${tkt_barcode;min=14}
Code du billet qui sera généré dans le code barre (format : PKBarcodeFormatQR, encoding : iso-8859-1). Veuillez laisser la valeur par défaut dans ce champ.

  • block_label

Titre du champ block contenu dans les champs auxiliaires (en dessous des champs secondaires)

  • block_value

Valeur par défaut : ${phs_block}
Contenu du champ block contenu dans les champs auxiliaires (en dessous des champs secondaires)

  • description

Valeur par défaut : ${prd_publicDescription}
Description du billet qui doit dans la mesure du possible commencer par le type de billet (bon cadeau, entrée, visite) suivi par quelques brèves informations complémentaires. Cette description est utilisée par la fonction VoiceOver qui permet aux personnes activant les fonctionnalités d’accessibilité (exemple : problème de vision) de comprendre le billet.

  • header_label

Valeur par défaut : ${prf_startDate;format=dd.MM.yy}
Titre du champ d’entête (à droite du texte du logo ; typiquement utilisé pour afficher la date)

  • header_value

Valeur par défaut : ${prf_startTime;format=HH:mm}
Contenu du champ d’entête (à droite du texte du logo ; typiquement utilisé pour afficher l’heure)

  • icon.png

Taille conseillée : 120 x 120 (hauteur x largeur)
Icône affichée dans l’écran de verrouillage et dans une application tierce qui récupère le billet (exemple : email)

  • icon@2x.png

Taille conseillée : 240 x 240 (hauteur x largeur)
Version retina du champ précédent

  • locationLatitude

Valeur par défaut : 0 (laisser 0 si vous ne voulez pas activer la fonctionnalité)
Coordonnée en latitude du lieu vers lequel le billet va être automatiquement proposé à l’utilisateur (exemple : 37.3229)

  • locationLongitude

Valeur par défaut : 0 (laisser 0 si vous ne voulez pas activer la fonctionnalité)
Coordonnée en longitude du lieu vers lequel le billet va être automatiquement proposé à l’utilisateur (exemple : -122.0323)

  • logo.png

Taille conseillée : 120 x 120 (hauteur x largeur)
Logo affiché en haut à gauche du billet

  • logo@2x.png

Taille conseillée : 240 x 240 (hauteur x largeur)
Logo destiné aux écrans retina (double de la taille)

  • logoText

Valeur par défaut : ${prd_externalName}
Texte affiché à droite du logo (nom du produit en tant que valeur par défaut)

  • organizationName

Valeur par défaut : ${org_code}
Le nom de l’organisation est affiché dans l’écran de verrouillage du téléphone quand le billet est notifié à l’utilisateur (date ou proximité via latitude/longitude/iBeacon). Il sera aussi montré à l’utilisateur dans les applications d’ouverture tierces (e-mail).

  • owner_label

Titre du champ owner (bénéficiaire) contenu dans les champs principaux (en dessus des champs secondaires)

  • owner_value

Valeur par défaut : ${mvt_beneficiaryFirstName} ${mvt_beneficiaryName}
Contenu du champ owner (bénéficiaire) contenu dans les champs principaux (en dessus des champs secondaires)

  • price_label

Titre du champ prix contenu dans les champs principaux (en dessus des champs secondaires)

  • price_value

Valeur par défaut : ${amt_amount} ${amt_currency}
Contenu du champ prix contenu dans les champs principaux (en dessus des champs secondaires)

  • proximityUUID

Valeur par défaut : f5614bd4-e2d0-4862-abbd-bde5ee635701
Identifiant unique intégré à un iBeacon pour que le billet soit proposé automatiquement à l’utilisateur dès qu’il s’approche de votre contrôle d’accès.

  • relevantDate (JIRA : TNPR-141)

Valeur par défaut : ${relevantDate;format=yyyy-MM-dd'T'HH:mm}+01:00
Format : W3C timestamp
Date et heure à laquelle il devient pertinent de proposer automatiquement le billet à l’utilisateur (exemple : 2014-12-05T09:00-08:00).
Depuis Dufour V3, tous les types de produits sont supportés. La date sélectionnée (relevantDate) sera la suivante :

    • Passes non datés:

La date de départ est prise en compte sauf si elle se trouve dans le passé. Dans ce cas, la date du jour est appliquée. L’heure est fixée à 10:00.

    • Passes horodatés:

La date et heure sont celles du départ du timeslot.

    • Services, autres produits:

Si aucune date n’est trouvée, la date du jour est prise en compte.

  • row_label

Titre du champ row (rangée) contenu dans les champs auxiliaires (en dessous des champs secondaires)

  • row_value

Valeur par défaut : ${phs_row}
Contenu du champ row (rangée) contenu dans les champs auxiliaires (en dessous des champs secondaires)

  • settings

Ce champ vous permet d'assigner des couleurs aux textes des champs du billet (titres: foregroundColor, valeurs: labelColor).

  • seat_label

Titre du champ seat (numéro de place) contenu dans les champs auxiliaires (en dessous des champs secondaires)

  • seat_value

Valeur par défaut : ${phs_nb}
Contenu du champ seat (numéro de place) contenu dans les champs auxiliaires (en dessous des champs secondaires)

  • serialNumber

Valeur par défaut : ${xrf_ticketId}
Identifiant unique du billet qui prend la valeur du ticket ID dans le cas de la valeur par défaut. Il est important que ce numéro soit unique pour chaque billet.

  • site_label

Titre du champ site (lieu) contenu dans les champs secondaires (en dessous des champs principaux)

  • site_value

Valeur par défaut : ${ste_externalName}
Contenu du champ site (lieu) contenu dans les champs secondaires (en dessous des champs principaux)

  • tarif_label

Titre du champ tarif (catégorie de place) contenu dans les champs secondaires (en dessous des champs principaux)

  • tarif_value

Valeur par défaut : ${prf_rateType}
Contenu du champ tarif (catégorie de place) contenu dans les champs secondaires (en dessous des champs principaux)

  • terms_label

Titre du champ qui sera affiché derrière le billet (généralement destiné aux conditions et informations générales)

  • terms_value

Contenu du champ qui sera affiché derrière le billet (généralement destiné aux conditions et informations générales)

  • thumbnail.png

Tailler conseillée : 120 x 120 (hauteur x largeur)
Image du produit disposée à droite des champs principaux et secondaires

  • thumbnail@2x.png

Taille conseillée : 240 x 240 (hauteur x largeur)
Version retina du champ précédent

Lien avec les produits

Une fois la maquette PASSBOOK prête, veuillez lier votre maquette à des produits au travers du paramétrage des maquettes de billets présent dans le contexte organisme à Outils à Maquettes de billets.

Résultat dans le ticketshop

Si l’utilisateur accède au ticketshop depuis son iPhone, le support de billet PASSBOOK sera automatiquement proposé et mis en avant. Dans le cas d’un autre appareil (smartphone Android, tablette Android ou iOS, Desktop), l’utilisateur se verra proposer le billet mobile pdf qui est compatible avec toutes les autres plateformes.

Bien entendu, dans tous les cas, le billet imprimable pdf reste disponible via un bouton secondaire.

Résultat dans l'application mobile SecuTix

L’application mobile iOS détecte automatiquement si un billet PASSBOOK est disponible en supplément au billet mobile pdf classique. L’application proposera à l’utilisateur d’ajouter le billet PASSBOOK à son WALLET directement via un bouton en haut du billet :