Textbausteine – Platzhalter
Die CRB-Option und Textformate verstehen sowie Platzhalter in Textbausteinen korrekt verwenden.
Für Administration und Vorlagenverantwortliche: Textbausteine und Platzhalter können in vielen Dokumenten wiederverwendet werden. Testen Sie Änderungen mit einem fiktiven Dokument, bevor sie produktiv verwendet werden.
In Textbausteinen können definierte Platzhalter verwendet werden. Beim Einfügen des Textbausteins ersetzt Planura die Platzhalter durch die Werte des aktuellen Dokuments, Auftrags oder Kontakts.
Die Platzhalter sind keine frei benannten Variablen. Jeder Name steht für ein bestimmtes Feld oder eine bestimmte Berechnung in Planura. Verwenden Sie deshalb genau die dokumentierte Schreibweise.
Checkbox CRB: unformatierter oder formatierter Textbaustein
Die Checkbox CRB im Textbaustein legt fest, in welchem Textformat der Inhalt bearbeitet und gespeichert wird:
| Einstellung | Wirkung |
|---|---|
| CRB aktiviert | Der Textbaustein verwendet unformatierten Text. Das einfache Textfeld erlaubt Text und Zeilenumbrüche, aber keine Rich-Text-Formatierung. Die Schriftart-Werkzeuge werden ausgeblendet. |
| CRB deaktiviert | Der Textbaustein verwendet formatierten Text (RTF). Der Rich-Text-Editor und die Schriftart-Werkzeuge stehen zur Verfügung. |
Die Option ist keine CRB-Lizenzfreigabe und lädt keine NPK-Katalogdaten. Sie betrifft den Textbaustein selbst. Wird ein CRB-Textbaustein in einen formatierten Dokumenttext eingefügt, bereitet Planura dessen unformatierten Inhalt für das Zielfeld auf. Dadurch entsteht keine zusätzliche Formatierung wie Fettschrift im ursprünglichen Textbaustein.
Sichern Sie vor dem Umschalten eines bestehenden Bausteins den bisherigen Inhalt. Die beiden Eingabearten führen getrennte Textinhalte, das Umschalten allein konvertiert den bestehenden Text nicht automatisch. Prüfen Sie das neu sichtbare Textfeld und setzen Sie den gewünschten Inhalt bei Bedarf erneut ein, bevor Sie Speichern wählen. Testen Sie den Baustein anschliessend in einem Beispieldokument.
Schreibweise
Das Dollarzeichen am Anfang und am Ende sowie die Kennung PH sind zwingend:
$PHPaymentDateShort$Beispiel: $PHPaymentDateShort$ wird durch das berechnete Zahlungsdatum im kurzen Format ersetzt.
Beispiel: Platzhalter und Ergebnis vergleichen
Verfügbare Platzhalter
Dokumentenkennungen
| Platzhalter | Bedeutung | Beispiel |
|---|---|---|
$PHDocumentTypeCode$ | Code des Dokumenttyps. | RE |
$PHDocumentYear$ | Jahr des Dokuments. | 2025 |
$PHDocumentNumber$ | Laufende Dokumentnummer. | 15 |
Zahlungsinformationen
| Platzhalter | Bedeutung | Beispiel |
|---|---|---|
$PHPaymentPeriod$ | Zahlungsfrist in Tagen aus den hinterlegten Zahlungseinstellungen. | 30 |
$PHPaymentDateShort$ | Berechnetes Zahlungsdatum im kurzen Format. | 15.10.2023 |
$PHPaymentDateLong$ | Berechnetes Zahlungsdatum im langen Format. | 15. Oktober 2023 |
$PHZahlbarBis$ | Zahlungsangabe unter Berücksichtigung von Konditionen, Skonto und Nettofrist. | Zahlbar innert 30 Tage netto. |
$PHZahlbarBis$ kann beispielsweise folgende Ergebnisse erzeugen:
- Zahlbar innert 30 Tage netto.
- Zahlbar innert 10 Tage mit 5.00 % Skonto, innert 30 Tage netto.
- Zahlbar innert 10 Tage mit CHF 5000.00 Skonto, innert 30 Tage netto.
Verantwortliche Person und Kontakt
| Platzhalter | Bedeutung | Beispiel |
|---|---|---|
$PHResponsibleFirstName$ | Vorname der im Dokument verantwortlichen Person. | Max |
$PHResponsibleLastName$ | Nachname der im Dokument verantwortlichen Person. | Muster |
$PHKontakt$ | Kontaktinformation aus dem Dokumentkontext, zum Beispiel eine Telefonnummer. | 044 123 45 67 |
Referenzen und Auftrag
| Platzhalter | Bedeutung | Beispiel |
|---|---|---|
$PHIhrZeichen$ | Wert des Feldes «Ihr Zeichen» aus dem Dokument. | AB-123 |
$PHAuftragReferenzNummer$ | Auftrags- bzw. Referenznummer. | A-2025-15 |
$PHAuftragDatumKurz$ | Auftragsdatum im kurzen Format. | 23.05.2025 |
$PHAuftragDatumLang$ | Auftragsdatum im langen Format. | 23. Mai 2025 |
$PHAusfuehrungsort$ | Ort, an dem die Arbeit ausgeführt wird. | Musterstrasse 12, Zürich |
$PHArbeitsbeschreibung$ | Beschreibung der auszuführenden Arbeit aus dem Auftrag oder Dokument. | Wartung der Heizungsanlage |
Ausführungsdaten
| Platzhalter | Bedeutung | Beispiel |
|---|---|---|
$PHAusfuehrungBeginnDatumKurz$ | Startdatum der Ausführung im kurzen Format. | 23.05.2025 |
$PHAusfuehrungBeginnDatumLang$ | Startdatum der Ausführung im langen Format. | 23. Mai 2025 |
$PHAusfuehrungBeginnZeit$ | Startzeit der Ausführung. | 14:30 |
$PHAusfuehrungEndeDatumKurz$ | Enddatum der Ausführung im kurzen Format. | 23.05.2025 |
$PHAusfuehrungEndeDatumLang$ | Enddatum der Ausführung im langen Format. | 23. Mai 2025 |
Fehler vermeiden
- Schreiben Sie Platzhalter exakt, einschliesslich Gross-/Kleinschreibung.
- Verwenden Sie die Dollarzeichen am Anfang und Ende.
- Testen Sie den Textbaustein in einem Dokument, das alle benötigten Werte enthält.
- Prüfen Sie insbesondere Zahlungsdaten, wenn Konditionen oder Skonto verwendet werden.
- Prüfen Sie auch einen Fall, in dem eine optionale Adresse, Kontaktperson oder Ausführungszeit fehlt.
NPK-Dokument
Reportvorlagen für NPK-Dokumente benennen und die wichtigsten Felder verwenden.
Systemeinstellungen
Formatvorlagen und Platzhalter für E-Mail-Betreff, Einzahlungsschein, Exportdateien sowie Personen-, Geräte-, Material- und Spesentexte. Zusätzlich wichtige Druckvorgaben für freie Dokumente.