Platzhaltervarianten für Buchungen, Tickets und Rechnungen
Mehrere Platzhalter erzeugen bereits vollständige Buchungs-, Termin- oder Rechnungstabellen. Mit Attributen in eckigen Klammern ändern Sie deren Darstellung. Verwenden Sie diese Anleitung zum Gestalten; die durchsuchbare Referenz zeigt, welche Schreibweise in welcher Vorlage verfügbar ist.
Attribute kombinieren
##BookingPart[NoTime,NoPrices,DurationWeekDays]##Schreiben Sie die Attribute innerhalb derselben Doppelrauten und trennen Sie mehrere Optionen mit Kommas. Die Optionen verändern die Ausgabe; sie ändern weder Preisberechtigung noch Buchung, Rechnung oder Zugangsrecht. Manche Optionen blenden dieselben Informationen aus wie andere Optionen. Kombinieren Sie deshalb nur Varianten, die dem Empfänger helfen.
BookingPart: Buchungsblock
| Attribut | Wirkung |
|---|---|
AlwaysShowPriceCategories | Zeigt Preiskategorien auch dann, wenn nur die Standardkategorie gebucht ist. |
DistinctDays | Zählt verschiedene Durchführungstage. |
DurationDaysHours | Zeigt Dauer in Tagen/Stunden. |
DurationWeekDayRange | Fasst aufeinanderfolgende Wochentage als Bereich zusammen; sonst Liste. |
DurationWeekDays | Zeigt die Durchführungstage als Wochentagsliste. |
Gender | Ergänzt die Anrede bei den Personen. |
NetAmountAndVATAdded | Ergänzt Nettobetrag und Mehrwertsteuer. |
NoPrices | Blendet Preise aus. |
NoTime | Blendet Uhrzeiten aus. |
NoUsers | Blendet die Personenliste aus. |
NoWeekDay | Blendet Wochentage aus; gleichbedeutend mit NoWeekDays. |
NoWeekDays | Blendet Wochentage aus; gleichbedeutend mit NoWeekDay. |
TicketBookedSchedule: gebuchte Termine
| Attribut | Wirkung |
|---|---|
EndTime | Zeigt zusätzlich die Endzeit. |
NoDate | Blendet das Datum aus. |
NoGrouping | Gibt Termine ohne die übliche Gruppierung aus. |
NoLocation | Blendet den Durchführungsort aus. |
NoName | Blendet die Terminbezeichnung aus. |
NoRoom | Blendet den Raum aus. |
NoTime | Blendet Uhrzeiten aus. |
NoTimeLabel | Blendet die Beschriftung der Zeit aus. |
ShortDate | Verwendet ein kurzes Datum. |
OfferAllBookedOffers: gebuchte Angebote
| Attribut | Wirkung |
|---|---|
NoOfferNumber | Blendet Angebotsnummern aus. |
NoPrice | Blendet Preise aus. |
InvoiceListing: Rechnungspositionen
| Attribut | Wirkung |
|---|---|
NoDate | Blendet zusätzliche Termin-/Angebotsdetails aus. |
Pricecategory | Ergänzt Preiskategorien. |
PricecategoryDetail | Ergänzt Angebotsnamen bei weiteren Preiskategorien. |
TaxLabelShort | Verwendet die kurze Steuerbezeichnung. |
TextInvoiceBalance | Unterscheidet die Bezeichnungen für Rechnungsbetrag und Rechnungssaldo deutlicher. |
User | Ergänzt die Namen zugeordneter Teilnehmender. |
Buchungsblock praktisch verwenden
Mit AlwaysShowPriceCategories bleibt auch eine einzelne Standardpreiskategorie sichtbar. Das hilft, wenn Bestätigungen den gebuchten Tarif ausdrücklich nennen sollen. Ein Abo-Tarif wird dabei so dargestellt, wie er gebucht wurde; die aktive Abo-Berechtigung wird in den Preiskategorien konfiguriert.
NoWeekDay und NoWeekDays sind gleichwertige Varianten. DurationWeekDayRange fasst nur wirklich aufeinanderfolgende Tage zu einem Bereich zusammen. Bei verteilten oder wiederholten Wochentagen bleibt eine Liste sinnvoller. NoUsers ist im normalen Booking.pdf angeboten; übernehmen Sie diese Option nicht ungeprüft in andere Buchungsdokumente.
Angebotszeitraum und tatsächlich gebuchte Termine unterscheiden
Ein Angebot kann von Januar bis Juni laufen, obwohl eine Person nur zwei Lektionen im März bucht. Wählen Sie für Ihre Aussage den richtigen Datenbezug. Ein einzelnes Datum und eine Liste gebuchter Termine erfüllen unterschiedliche Zwecke.
| Gewünschte Aussage | Geeigneter Bezug |
|---|---|
| Gesamtzeitraum des Angebots | OfferStartendDate beschreibt den zusammengefassten Angebotszeitraum. Verwenden Sie ihn nicht als vollständigen Nachweis der individuellen Terminwahl. |
| Erster oder letzter Termin im Teilnehmer-Lektionskontext | OfferStartDate/OfferStartTime und OfferEndDate/OfferEndTime können bei vorhandener Teilnehmerzuordnung die erste bzw. letzte gebuchte Lektion berücksichtigen. Ohne diesen Kontext gelten Angebotsdaten. Prüfen Sie die tatsächlich erzeugte Nachricht. |
| Alle gebuchten Lektionen oder ausgewählten Unterangebote | Verwenden Sie einen dafür angebotenen Buchungs-/Terminblock, beispielsweise TicketBookedSchedule[ShortDate,EndTime] im passenden Dokumentkontext. Ein Anfangs- und Enddatum zeigt keine Lücken und nicht automatisch jede einzelne Buchungsposition. |
| Bestätigung einer Sammel- oder Multi-Angebotsbuchung | Prüfen Sie BookingPart, OfferAllBookedOffers und die verfügbaren Terminblöcke der konkreten Vorlage. Ein einzelner OfferName oder Datumswert beschreibt nicht automatisch alle Personen und Unterangebote. |
Beachten Sie insbesondere: OfferStartendDate und die getrennten Start-/Endfelder werden nicht in jedem Kontext gleich individualisiert. Ersetzen Sie sie nicht allein aufgrund ähnlich klingender Namen. Die Editorvorschau mit Demodaten prüft keine reale Lektionsauswahl.
- Erstellen Sie einen internen Prüffall mit einem mehrteiligen Angebot, wählen Sie nur einzelne Lektionen und halten Sie deren Datum und Uhrzeit fest.
- Öffnen Sie das Buchungsdetail und vergleichen Sie die tatsächliche Auswahl mit Bestätigungs-Mail, Booking.pdf und, falls aktiv, Ticket und ICS.
- Prüfen Sie zusätzlich eine Multi-Angebots- und eine Sammelbuchung. Kontrollieren Sie Personenzuordnung und gebuchte Unterangebote einzeln.
- Wenn ein Dokument den Gesamtzeitraum statt der gewählten Termine zeigt, prüfen Sie zuerst den verwendeten Block und seinen Datenkontext. Ergänzen Sie einen angebotenen Terminblock und erzeugen Sie denselben Prüffall erneut.
Für einen individuellen Teilnahmenachweis stimmen Sie die Datumsdarstellung zusätzlich mit den erfassten Präsenzen und dem Lektionsmodell ab. Ein Zeitraum allein bescheinigt keine Anwesenheit.
Mehrere gebuchte Tage und Wochentage darstellen
Bearbeiten Sie die Terminanzeige über die Platzhalterauswahl der jeweiligen Vorlage. Ein vorhandener geschützter Systemblock, etwa Booking_part_Please_do_not_change, bleibt als vollständige Buchungsausgabe erhalten; öffnen oder zerlegen Sie seinen erzeugten Inhalt nicht in vermeintlich einzelne Datumsfelder.
| Vorlage | Belegter Gestaltungsweg |
|---|---|
| Bestätigungs-Mail | Fügen Sie den angebotenen Block OfferAllBookedModulesTableTitle bei Bedarf in einen eigenen Absatz neben beziehungsweise unter dem bestehenden Systemblock ein. Er liefert eine Tabelle mit Datum, Zeit, Bezeichnung und Leitung. Bei einer Lektionsbuchung wird die Auswahl der gebuchten Lektionen berücksichtigt. Das Datum folgt dem Kontodatumsformat; dieser Block bietet kein eigenes Wochentagsformat pro Tabellenzeile. |
| Booking.pdf | Verwenden Sie den angebotenen BookingPart-Block. Die Lektionsliste kann die einzelnen gebuchten Tage mit der Spalte Tag ausgeben. Lassen Sie dafür NoWeekDay/NoWeekDays weg. DurationWeekDays ergänzt in der Dauerübersicht die Wochentagsliste der betreffenden Auswahl. |
| Ticket oder Buchungsdokument mit TicketBookedSchedule | Die gebuchte Terminliste kann über ShortDate und EndTime angepasst werden. Ein Attribut wie WeekDay ist für diesen Block nicht angeboten; übernehmen Sie Formatattribute anderer Platzhalter nicht ungeprüft. |
Beispiel für die Bestätigungs-Mail, nur wenn dieser Platzhalter im geöffneten Vorlagenmenü angeboten wird:
<h3>Ihre gebuchten Termine</h3>
##OfferAllBookedModulesTableTitle##Beispiel für den normalen Booking.pdf-Kontext, wenn Sie dessen Buchungsblock über eine angebotene Variante gestalten:
##BookingPart[NoPrices,DurationWeekDays]##Ersetzen Sie dafür den betreffenden bearbeitbaren Buchungsblock bewusst; fügen Sie nicht mehrere vollständige Buchungsblöcke hintereinander ein. Prüfen Sie an einem internen Angebot mit mehreren Tagen eine Person mit nur zwei ausgewählten Lektionen und vergleichen Sie Wochentage, Datumszeilen und Uhrzeiten mit dem Buchungsdetail. Wiederholte gleiche Wochentage können in der Dauerübersicht zusammengefasst sein; sie ersetzt daher keine Liste aller konkreten Daten. Ein Rahmen «Montag bis Freitag» wäre bei nur Montag und Donnerstag irreführend.
Benötigen Sie genau die Schreibweise «Wochentag, Datum» für jede Zeile im Mailtext, ist sie durch die genannten Tabellenattribute nicht frei formatierbar. Verwenden Sie die angebotene Tabelle beziehungsweise das Booking.pdf mit seiner Tagesliste oder einen separat eingerichteten, geprüften Ausgabekontext. Die Formatangaben für eigene Teilnehmer-Datumsfelder ändern diese zusammengesetzten Terminblöcke nicht.
Wallet-Links und Barcode
MobileWalletTickets und MobileWalletTicketURL liefern die verfügbare Wallet-Ausgabe bzw. den allgemeinen Link. Dazu existieren MobileWalletAppleURL, MobileWalletGoogleURL, MobileWalletAndroidURL und MobileWalletSamsungURL. Sie sind im Bestätigungs- und Ticketkontext vorgesehen. Ob tatsächlich ein Ticket oder plattformspezifischer Link existiert, hängt vom Ticketing und der Wallet-Konfiguration ab.
{IF?MobileWalletTicketURL != }<p><a href="##MobileWalletTicketURL##">Ticket zur Wallet hinzufügen</a></p>{ENDIF}Ein Ticketcode als Bild wird beispielsweise mit ##TicketDataMatrix*120px*P## eingefügt. Die festen angebotenen Varianten sind 120px und 80px im Hochformat (P) sowie 100px und 50px im Querformat (L). Ein nicht erzeugter Ticketcode kann dadurch nicht ersetzt werden. Prüfen Sie den Code im fertigen Ticket und im vorgesehenen Scanablauf.
Drei sinnvolle Kombinationen
| Zweck | Beispiel |
|---|---|
| Kompakte Buchungsunterlagen ohne Preis und Uhrzeit | ##BookingPart[NoPrices,NoTime,DurationWeekDays]## |
| Terminliste mit kurzer Datumsanzeige und Endzeit | ##TicketBookedSchedule[ShortDate,EndTime]## |
| Firmenrechnung mit Teilnehmern und Preiskategorien | ##InvoiceListing[User,PricecategoryDetail,TextInvoiceBalance]## |
Prüfen Sie Einzel- und Sammelbuchungen, mehrere Termine, lange Bezeichnungen, Teilzahlungen und mehrseitige PDFs. Die Attribute des einen Grundnamens gelten nicht automatisch für einen anderen Grundnamen. Ein NoPrices bei BookingPart heisst bei OfferAllBookedOffers beispielsweise NoPrice.
Optionen exakt schreiben und zielgerichtet auswählen
Übernehmen Sie Attributnamen mit ihrer Gross-/Kleinschreibung aus der Referenz. Schreiben Sie bei BookingPart beispielsweise NoPrices und bei OfferAllBookedOffers NoPrice. Diese Namen sind keine austauschbaren Synonyme. Ein unbekanntes Attribut erzeugt nicht automatisch einen Fehlerhinweis und kann ohne die gewünschte Wirkung bleiben.
TicketBookedSchedule ist für die gebuchten Termine einer Ticket- oder Buchungsdokumentvorlage bestimmt. OfferAllBookedModules und dessen Tabellenvarianten sind eigene, zusammengesetzte Terminblöcke. Verwenden Sie die Variante des geöffneten Vorlagenkontexts und vergleichen Sie eine Lektionsbuchung mit einer vollständigen Angebotsbuchung.