Quelltext der Seite Platzhalter und Platzhalterprüfung DiPlanCockpit Pro

'''ACHTUNG Diese Seite ist noch ein Entwurf!'''

== Platzhalter ==
Bei der Erstellung von Mustervorlagen kann auf Platzhalter zurückgegriffen werden. Bei diesen Platzhaltern handelt es sich u.a. um Stammdaten aus der K1, vom Nutzer eingetragene Daten im Verfahren, oder hinterlegte Textbausteine zum Rechtsbezug (letzte werden im Reiter "[[Rechtszitate DiPlanCockpit Pro|Rechtszitate]]" gepflegt).

Diese Platzhalter werden bereits in der Datei mit *dotx.-Dateiformat eingesetzt. Die dort verwendeten Platzhalter greifen dann auf Informationen aus z.B. der K1 zurück, sodass im Verfahren geführte Daten automatisch in die Mustervorlage übernommen werden.
[[Datei:ImagePlatzhalter.png|zentriert|mini|437x437px|Beispiel für ein Set an Platzhaltern in einer Mustervorlage]]

== Platzhalterprüfung ==
Mit der Funktion "Platzhalterprüfung" wird geprüft, ob Platzhalter vorhanden sind und ob diese korrekt geschrieben wurden.

Die Platzhalterprüfung kann bei der Erstellung, dem Ersetzen oder bei bereits vorhandenen [[Mustervorlagen DiPlanCockpit Pro|Mustervorlagen]] genutzt werden.

Damit eine Platzhalterprüfung beim Erstellen und Ersetzen ausgeführt wird, muss das entsprechende Häkchen bei "Platzhaltersyntax validieren" aktiviert werden. Bei vorhandenen Mustervorlagen wird dies über das Drei-Punkte-Menü und "validieren" angestoßen.

Bei der Prüfung kann es zwei Ergebnisse geben:

# Die Prüfung ist valide. Es wird ein Hinweisfeld angezeigt, dass die Prüfung erfolgreich war.
# Die Prüfung ist invalide. Es wird ein Modal dargestellt, welches Informationen zu der Anzahl an fehlerhaften Platzhaltern darstellt. Es werden alle Platzhalter aufgelistet, welche invalide sind. Das Dokument kann dann geöffnet und die Platzhalter angepasst werden. Die Ergebnisse des Modals werden nicht als Datei zur Verfügung gestellt. Entweder kann ein Screenshot gemacht werden, oder die Datei, die als Basis für die Mustervorlage dient, wird direkt geöffnet und die fehlerhaften Platzhalter behoben.  Per Button "Schließen" wird das Modal geschlossen und die Mustervorlage wird nicht erstellt. Wenn der Button "zurück" angeklickt wird, kann die Platzhalterprüfung ausgeschaltet werden. Das Dokument enthält dann evtl. Fehler, es kann trotzdem angelegt werden.

== Beispiel ==
Die von oben gezeigte Beispieldatei wurde innerhalb eines Verfahrens (Planname = "Review 22.05.2024") genutzt. Die manuell nachträglich hinzugefügten farbigen Markierungen zeigen, welche Platzhalter aufgelöst (schwarz), nicht aufgelöst (gelb) oder nicht vorhanden (rot) sind.
[[Datei:ImagePlatzhalterBeispielMarkiert.png|zentriert|mini|699x699px]]

* Aufgelöste Platzhalter: sind durch Werte aus dem Planverfahren ersetzt. Das können Werte aus Feldern der Stammdatenseite, Datumswerte aus Zeitplanung/Aufgaben o.ä. sein.
* Nicht aufgelöste Platzhalter: entsprechendes Feld wurde im Planverfahren (noch) nicht befüllt/aktiviert
* Nicht vorhandene Platzhalter: Platzhalter existiert nicht

Die zuvor erläuterte Platzhalterprüfung hilft dabei, nicht vorhandene, oder falsch geschriebene Platzhalter zu identifizieren. Die Datei und die gezeigten Informationen aus der Platzhalterprüfung müssen manuell abgeglichen werden. Fehler in der dotx.-Datei werden nicht wie hier im Beispiel farbig markiert.