Variantes de variables de remplacement pour les réservations, les billets et les factures
Plusieurs variables de remplacement génèrent déjà des tableaux complets de réservation, de séances ou de factures. Des attributs entre crochets permettent de modifier leur présentation. Utilisez ce guide pour la mise en forme ; la référence consultable indique quelle syntaxe est disponible dans chaque modèle.
Combiner des attributs
##BookingPart[NoTime,NoPrices,DurationWeekDays]##Écrivez les attributs à l’intérieur des mêmes doubles dièses et séparez les options par des virgules. Les options modifient l’affichage ; elles ne changent ni l’éligibilité à un prix, ni la réservation, la facture ou le droit d’accès. Certaines options masquent les mêmes informations que d’autres. Ne combinez donc que les variantes utiles au destinataire.
BookingPart : bloc de réservation
| Attribut | Effet |
|---|---|
AlwaysShowPriceCategories | Affiche les catégories de prix même si seule la catégorie standard est réservée. |
DistinctDays | Compte les différents jours de déroulement. |
DurationDaysHours | Affiche la durée en jours/heures. |
DurationWeekDayRange | Regroupe les jours de la semaine consécutifs sous forme de plage ; sinon, les affiche sous forme de liste. |
DurationWeekDays | Affiche les jours de déroulement sous forme de liste de jours de la semaine. |
Gender | Ajoute la civilité des personnes. |
NetAmountAndVATAdded | Ajoute le montant net et la TVA. |
NoPrices | Masque les prix. |
NoTime | Masque les heures. |
NoUsers | Masque la liste des personnes. |
NoWeekDay | Masque les jours de la semaine ; équivaut à NoWeekDays. |
NoWeekDays | Masque les jours de la semaine ; équivaut à NoWeekDay. |
TicketBookedSchedule : séances réservées
| Attribut | Effet |
|---|---|
EndTime | Affiche également l’heure de fin. |
NoDate | Masque la date. |
NoGrouping | Affiche les séances sans le regroupement habituel. |
NoLocation | Masque le lieu. |
NoName | Masque l’intitulé de la séance. |
NoRoom | Masque la salle. |
NoTime | Masque les heures. |
NoTimeLabel | Masque le libellé de l’heure. |
ShortDate | Utilise une date courte. |
OfferAllBookedOffers : offres réservées
| Attribut | Effet |
|---|---|
NoOfferNumber | Masque les numéros d’offre. |
NoPrice | Masque les prix. |
InvoiceListing : lignes de facture
| Attribut | Effet |
|---|---|
NoDate | Masque les détails supplémentaires des séances et des offres. |
Pricecategory | Ajoute les catégories de prix. |
PricecategoryDetail | Ajoute les noms des offres pour les catégories de prix supplémentaires. |
TaxLabelShort | Utilise le libellé court de la taxe. |
TextInvoiceBalance | Différencie plus clairement les libellés du montant de la facture et du solde de la facture. |
User | Ajoute les noms des participants associés. |
Utiliser le bloc de réservation en pratique
Avec AlwaysShowPriceCategories, même une seule catégorie de prix standard reste visible. Cette option est utile lorsque les confirmations doivent indiquer explicitement le tarif réservé. Un tarif d’abonnement est alors présenté tel qu’il a été réservé ; le droit lié à un abonnement actif se configure dans les catégories de prix.
NoWeekDay et NoWeekDays sont des variantes équivalentes. DurationWeekDayRange ne regroupe en plage que les jours réellement consécutifs. Pour des jours de semaine espacés ou répétés, une liste reste plus pertinente. NoUsers est proposé dans le Booking.pdf ordinaire ; ne reprenez pas cette option dans d’autres documents de réservation sans vérification.
Distinguer la période de l’offre des séances réellement réservées
Une offre peut se dérouler de janvier à juin alors qu’une personne ne réserve que deux leçons en mars. Choisissez les données appropriées à votre message. Une date unique et une liste de séances réservées répondent à des objectifs différents.
| Information souhaitée | Données appropriées |
|---|---|
| Période complète de l’offre | OfferStartendDate décrit la période globale de l’offre. Ne l’utilisez pas comme justificatif complet du choix individuel des séances. |
| Première ou dernière séance dans le contexte des leçons du participant | OfferStartDate/OfferStartTime et OfferEndDate/OfferEndTime peuvent tenir compte de la première ou de la dernière leçon réservée lorsqu’un participant est associé. Sans ce contexte, les données de l’offre s’appliquent. Vérifiez le message réellement généré. |
| Toutes les leçons réservées ou sous-offres sélectionnées | Utilisez un bloc de réservation ou de séances prévu à cet effet, par exemple TicketBookedSchedule[ShortDate,EndTime] dans le contexte de document adapté. Une date de début et une date de fin ne montrent pas les interruptions et ne représentent pas automatiquement chaque ligne de réservation. |
| Confirmation d’une réservation groupée ou de plusieurs offres | Vérifiez BookingPart, OfferAllBookedOffers et les blocs de séances disponibles dans le modèle concerné. Une seule valeur OfferName ou une seule date ne décrit pas automatiquement toutes les personnes et sous-offres. |
Retenez en particulier que OfferStartendDate et les champs de début et de fin séparés ne sont pas individualisés de la même manière dans tous les contextes. Ne les remplacez pas uniquement parce que leurs noms se ressemblent. L’aperçu de l’éditeur avec des données de démonstration ne vérifie pas une sélection réelle de leçons.
- Créez un cas de contrôle interne avec une offre en plusieurs parties, sélectionnez uniquement certaines leçons et notez leur date et leur heure.
- Ouvrez le détail de la réservation et comparez la sélection réelle avec l’e-mail de confirmation, le Booking.pdf et, s’ils sont activés, le billet et le fichier ICS.
- Vérifiez également une réservation de plusieurs offres et une réservation groupée. Contrôlez individuellement l’affectation des personnes et les sous-offres réservées.
- Si un document affiche la période complète au lieu des séances choisies, vérifiez d’abord le bloc utilisé et son contexte de données. Ajoutez un bloc de séances proposé et générez à nouveau le même cas de contrôle.
Pour une attestation individuelle de participation, adaptez également l’affichage des dates aux présences saisies et au modèle de leçons. Une période seule ne certifie pas la présence.
Afficher plusieurs jours réservés et les jours de la semaine
Modifiez l’affichage des séances à l’aide du sélecteur de variables de remplacement du modèle concerné. Un bloc système protégé existant, tel que Booking_part_Please_do_not_change, reste conservé comme affichage complet de la réservation ; n’ouvrez pas et ne décomposez pas son contenu généré en ce qui pourrait sembler être des champs de date individuels.
| Modèle | Méthode de mise en forme documentée |
|---|---|
| E-mail de confirmation | Si nécessaire, ajoutez le bloc proposé OfferAllBookedModulesTableTitle dans un paragraphe distinct, à côté ou sous le bloc système existant. Il fournit un tableau avec la date, l’heure, l’intitulé et le responsable. Lors d’une réservation de leçons, la sélection des leçons réservées est prise en compte. La date suit le format de date du compte ; ce bloc ne propose pas de format propre pour le jour de la semaine à chaque ligne du tableau. |
| Booking.pdf | Utilisez le bloc BookingPart proposé. La liste des leçons peut afficher les différents jours réservés dans la colonne Jour. Pour cela, omettez NoWeekDay/NoWeekDays. DurationWeekDays ajoute à l’aperçu de la durée la liste des jours de la semaine de la sélection concernée. |
| Billet ou document de réservation avec TicketBookedSchedule | La liste des séances réservées peut être adaptée avec ShortDate et EndTime. Un attribut tel que WeekDay n’est pas proposé pour ce bloc ; ne reprenez pas sans vérification les attributs de format d’autres variables de remplacement. |
Exemple pour l’e-mail de confirmation, uniquement si cette variable de remplacement est proposée dans le menu du modèle ouvert :
<h3>Vos dates réservées</h3>
##OfferAllBookedModulesTableTitle##Exemple pour le contexte Booking.pdf ordinaire, lorsque vous mettez en forme son bloc de réservation à l’aide d’une variante proposée :
##BookingPart[NoPrices,DurationWeekDays]##Remplacez délibérément le bloc de réservation modifiable concerné ; n’insérez pas plusieurs blocs complets de réservation les uns à la suite des autres. Sur une offre interne de plusieurs jours, vérifiez le cas d’une personne n’ayant sélectionné que deux leçons et comparez les jours de la semaine, les lignes de dates et les heures avec le détail de la réservation. Les jours de semaine identiques répétés peuvent être regroupés dans l’aperçu de la durée ; celui-ci ne remplace donc pas une liste de toutes les dates précises. Une plage « du lundi au vendredi » serait trompeuse pour une sélection limitée au lundi et au jeudi.
Si vous avez besoin de l’écriture exacte « jour de la semaine, date » à chaque ligne du texte de l’e-mail, les attributs de tableau mentionnés ne permettent pas de la formater librement. Utilisez le tableau proposé, le Booking.pdf avec sa liste de jours ou un contexte de sortie configuré et vérifié séparément. Les indications de format des champs de date personnalisés des participants ne modifient pas ces blocs de séances composés.
Liens Wallet et code-barres
MobileWalletTickets et MobileWalletTicketURL fournissent respectivement le contenu Wallet disponible et le lien général. Il existe également MobileWalletAppleURL, MobileWalletGoogleURL, MobileWalletAndroidURL et MobileWalletSamsungURL. Ces variables sont prévues dans les contextes de confirmation et de billet. L’existence effective d’un billet ou d’un lien propre à une plateforme dépend de la billetterie et de la configuration Wallet.
{IF?MobileWalletTicketURL != }<p><a href="##MobileWalletTicketURL##">Ajouter le billet au portefeuille numérique</a></p>{ENDIF}Un code de billet sous forme d’image peut être inséré, par exemple, avec ##TicketDataMatrix*120px*P##. Les variantes fixes proposées sont 120px et 80px en orientation portrait (P), ainsi que 100px et 50px en orientation paysage (L). Cette variable ne peut pas remplacer un code de billet qui n’a pas été généré. Vérifiez le code dans le billet final et dans le processus de scan prévu.
Trois combinaisons utiles
| Objectif | Exemple |
|---|---|
| Documents de réservation compacts sans prix ni heure | ##BookingPart[NoPrices,NoTime,DurationWeekDays]## |
| Liste des séances avec date courte et heure de fin | ##TicketBookedSchedule[ShortDate,EndTime]## |
| Facture d’entreprise avec participants et catégories de prix | ##InvoiceListing[User,PricecategoryDetail,TextInvoiceBalance]## |
Vérifiez les réservations individuelles et groupées, les séances multiples, les intitulés longs, les paiements partiels et les PDF de plusieurs pages. Les attributs d’un nom de base ne s’appliquent pas automatiquement à un autre. Par exemple, NoPrices pour BookingPart s’appelle NoPrice pour OfferAllBookedOffers.
Écrire les options exactement et les choisir selon l’objectif
Reprenez les noms d’attributs de la référence en respectant leur casse. Écrivez par exemple NoPrices pour BookingPart et NoPrice pour OfferAllBookedOffers. Ces noms ne sont pas des synonymes interchangeables. Un attribut inconnu ne produit pas automatiquement un message d’erreur et peut rester sans l’effet souhaité.
TicketBookedSchedule est destiné aux séances réservées d’un modèle de billet ou de document de réservation. OfferAllBookedModules et ses variantes en tableau sont des blocs de séances composés distincts. Utilisez la variante du contexte de modèle ouvert et comparez une réservation de leçons avec une réservation de l’offre complète.