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.
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.
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 :
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.
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
Taille conseillée : 180 x 220 (hauteur x largeur)
Image de fond du billet
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.
Titre du champ block contenu dans les champs auxiliaires (en dessous des champs secondaires)
Valeur par défaut : ${phs_block}
Contenu du champ block contenu dans les champs auxiliaires (en dessous des champs secondaires)
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.
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)
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)
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)
Taille conseillée : 240 x 240 (hauteur x largeur)
Version retina du champ précédent
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)
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)
Taille conseillée : 120 x 120 (hauteur x largeur)
Logo affiché en haut à gauche du billet
Taille conseillée : 240 x 240 (hauteur x largeur)
Logo destiné aux écrans retina (double de la taille)
Valeur par défaut : ${prd_externalName}
Texte affiché à droite du logo (nom du produit en tant que valeur par défaut)
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).
Titre du champ owner (bénéficiaire) contenu dans les champs principaux (en dessus des champs secondaires)
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)
Titre du champ prix contenu dans les champs principaux (en dessus des champs secondaires)
Valeur par défaut : ${amt_amount} ${amt_currency}
Contenu du champ prix contenu dans les champs principaux (en dessus des champs secondaires)
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.
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 :
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.
La date et heure sont celles du départ du timeslot.
Si aucune date n’est trouvée, la date du jour est prise en compte.
Titre du champ row (rangée) contenu dans les champs auxiliaires (en dessous des champs secondaires)
Valeur par défaut : ${phs_row}
Contenu du champ row (rangée) contenu dans les champs auxiliaires (en dessous des champs secondaires)
Ce champ vous permet d'assigner des couleurs aux textes des champs du billet (titres: foregroundColor, valeurs: labelColor).
Titre du champ seat (numéro de place) contenu dans les champs auxiliaires (en dessous des champs secondaires)
Valeur par défaut : ${phs_nb}
Contenu du champ seat (numéro de place) contenu dans les champs auxiliaires (en dessous des champs secondaires)
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.
Titre du champ site (lieu) contenu dans les champs secondaires (en dessous des champs principaux)
Valeur par défaut : ${ste_externalName}
Contenu du champ site (lieu) contenu dans les champs secondaires (en dessous des champs principaux)
Titre du champ tarif (catégorie de place) contenu dans les champs secondaires (en dessous des champs principaux)
Valeur par défaut : ${prf_rateType}
Contenu du champ tarif (catégorie de place) contenu dans les champs secondaires (en dessous des champs principaux)
Titre du champ qui sera affiché derrière le billet (généralement destiné aux conditions et informations générales)
Contenu du champ qui sera affiché derrière le billet (généralement destiné aux conditions et informations générales)
Tailler conseillée : 120 x 120 (hauteur x largeur)
Image du produit disposée à droite des champs principaux et secondaires
Taille conseillée : 240 x 240 (hauteur x largeur)
Version retina du champ précédent
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.
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.
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 :
