Moser FAQ - Arbeiten mit Platzhaltern

MOSER Gesamtdokumentation - 2.12. Arbeiten mit Platzhaltern

2.12. Arbeiten mit Platzhaltern

Versionsgeschichte
	14.6.2022	MZ
Hinweis zu {Ref} für Checklisten (TFS-38303,TFS-35546)
	23.8.2019	MZ
Platzhalter nur im Textformat (PG, 22.8.2019)
Version 3.33.000	27.10.2014	MZ
erweitert (DB3069)
	24.10.2014	MZ
siehe DB3069 (Word-Dokument von Entwicklung)
	17.2.2014	MZ
neu

Platzhalter oder auch variable Stellen, wie z.B. {Ref.Address.Opening} (für den Zugriff auf das Feld Anrede der Adresse), können z.B. sinnvoll in vorbereiteten Texten eingesetzt werden und werden dann beim Einfügen des Textes (nicht im RTF-Format) in ein Projekt durch die Inhalte aus dem gewählten Objekt ersetzt.

Platzhalter stehen Ihnen im Wesentlichen an folgenden Stellen zur Verfügung:

Vor- und Schlussbemerkungen (Vorgangseigenschaften)
Buchungstexte
Zahlungstext der Zahlungsarten (in diesem Fall erfolgt die Auswertung der Platzhalter erst beim Druck und nicht schon beim Einfügen)
E-Mail Benachrichtigungen (siehe auch Handbuch Projektverwaltung - Notizen und Termine)

Beispiel 2.1.

Um in den Vor- oder Schlussbemerkungen eines Vorgangs einen vorgefertigten Text einzufügen, erzeugen Sie diesen zunächst unter Stammdaten | Texte | Alle Texte mit der Funktion Neu F8.

Fügen Sie als Beschreibung Ihr Anschreiben ein und verwenden Sie dazu Platzhalter:

Sehr geehrte{Ref.Address.Opening}
gerne übersenden wir Ihnen unser Angebot zu nachfolgenden Konditionen.

Abbildung 2.23. Text mit Platzhalter

Speichern Sie den Text F7 und öffnen Sie die Registerkarte Vorbemerkungen der Vorgangseigenschaften Ihres Vorgangs. Fügen Sie Ihren vorgefertigten Text mithilfe der Schaltfläche Text nachschlagen ... ein. Der Platzhalter wird mit den Informationen aus der aktuellen Vorgangsadresse ausgefüllt:

Abbildung 2.24. Vorgangsvorbemerkung

Platzhalter haben grundsätzlich die Form {Ref.xxx} und stehen in geschwungenen Klammern. Mit Ref.xxx spricht man also z.B. die Eigenschaften eines aktiven Vorgangzweiges (Objekt der Klasse Branch) an. Um auf Felder des Vorgangsprojektes (Objekt der Klasse Project) zuzugreifen, verwenden Sie Ref.Project.xxx. Ergänzt wird jeder Platzhalter immer noch durch die genaue Eigenschaft (xxx), die entweder direkt verfügbar ist (z.B. {Ref.Title}) oder über weitere Objektreferenzen adressiert werden muss (z.B. {Ref.Project.Address.Bankname}).

Grundsätzliche steht {Ref} also für das Datenobjekt zum aktuellen Kontext. In vielen Fällen ist dies der aktuelle Vorgang, jedoch kann es sich z.B. dabei auch um eine Gliederungszeile des Vorgangs oder eine Adresse handeln.

Wenn Sie Platzhalter in Checklisten verwenden, bezieht sich {Ref} auf die Gliederungszeile der Checkliste im Vorgang. Um in einer Checkliste auf Vorganginformationen zugreifen zu können, müssen Sie in diesem Fall {Ref.Branch} verwenden (also z.B. {Ref.Branch.Title}. Fehlerhafte Ausdrücke in Platzhaltern werden bei der Anzeige des PDF mit (!) gekennzeichnet.

In der nachfolgenden Tabelle finden Sie weitere Beispiele für Platzhalter.

Beachten Sie, dass Platzhalter nur im Textformat und beispielsweise nicht im RTF-Format verfügbar sind.

Übersicht einiger gängiger Objekte und Eigenschaften

Objektname	Eigenschaft	Bedeutung	Beispiel
Branch (Zweig/Vorgang)	Title	Name des Projektzweigs	{Ref.Title} = Zweig: 1. Auftrag 17.02.2014 (esser)
	Total	Gesamtbruttosumme des Projektzweigs	{Ref.Total} = 11.9
	Address	Referenz auf die Adresse des Projektzweigs	{Ref.Address.Bankname} = Sparkasse Aachen
	BookingAddress	Kurzname der Vorgangsadresse	{Ref.BookingAddress} = esser
	Caption	Kurztext des Projektzweigs	{Ref.Caption} = Null [Wenn der Wert Null zurückgegeben wird, ist die gewählte Eigenschaft leer!]
Project (Projekt)	Key	Projekttitle / Name der Projektakte	{Ref.Project.Key} = 2013.00001
	BookingAddress	Kurzname der Projektadresse	{Ref.Project.BookingAddress} = esser
	Address	Objektreferenz zur Projektadresse	{Ref.Project.Address.City} = Essen
Address (Adresse)	Bankname	Banknamen der Bankverbindung zur Adresse	{Ref.Address.Bankname} = Sparkasse Aachen
	Bankkonto	Kontonummer	{Ref.Address.BankAccount} = 3454564
	BIC	BIC der Bankverbindung	{Ref.Address.BIC} = AACSDE33XXX
	BillTo	Referenz auf die Rechnungsadresse	{Ref.Address.BillTo.Key} = cordales
	City	Ort einer Adresse	{Ref.Address.City} = Essen
	Country	Land einer Adresse	{Ref.Address.Country} = Deutschland
	DeliverTo	Referenz auf die Lieferadresse	{Ref.Address.DeliverTo.Key} = cordales
	IBAN	IBAN der Bankverbindung	{Ref.Address.IBAN} = DE86390500000003454564
	Key	Kurznamen einer Adresse	{Ref.Address.Key} = esser
Representative (Personal/Mitarbeiter)	Name1	Herr/Frau/Firma	{Ref.Representative.Name1} = Herr
	Name2	Vor- und Nachname	{Ref.Representative.Name2} = Carlo Cellini

Weitere nützliche Eigenschaften

Eigenschaft	Bedeutung	Beispiel
Today	Aktuelles Systemdatum	{Today} = 21.06.2022
Now	Aktuelles Systemdatum mit aktueller Uhrzeit	{Now} = 21.06.2022 11:22:30

Eine Beschreibung zu Platzhaltern in Zahlungsarten finden Sie unter Zahlungsdatenaustausch - SEPA Zahlungsarten.