{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"006cb9b0-b2a6-4477-bc24-b81568a0643d"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"05d49dbb-18c6-4158-9143-6bd51ee8f9cc"}},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Namensgebung bei Skripten","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"HINWEIS","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Im Folgenden ist mit \"Name eines Skriptes\" immer die Id gemeint.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Namen von Skripten müssen gut überlegt gesetzt werden, da sie als eindeutiges Identifikationsmerkmal dienen. ","type":"text"},{"text":"Wenn sich ein Skript einmal in einer Vorlage befindet, bewirkt eine Änderung des Namens, dass das Skript neu eingefügt werden muss.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Skript-Namen beschreiben bestenfalls die Ausgabe. So ist \"LocationDate\" sinnvoller als \"LetterStart\".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Skript-Namen sollten aber auch möglichst simpel und allgemein vergeben werden. So ist \"Author\" sinnvoller als \"ReportAuthor\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Oftmals kann die Ausgabe aber nicht beschrieben werden, da sie sich unter Umständen durch spezifische Bedingungen völlig verändert. In diesem Fall darf der Ort des Skripte im Dokument als Name gesetzt werden (z. B. \"Footer1stPage\").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Skript-Namen werden mittels \"","type":"text"},{"text":"Pascal Casing","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.c2.com/?PascalCase"}}]},{"text":"\" formatiert. Das bedeutet, dass der Anfangsbuchstabe und jeder Wort-Anfangsbuchstabe immer gross sind.","type":"text"}]},{"type":"paragraph","content":[{"text":"Beispiele:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ContactInformation","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LocationDate","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Skript-Namen dürfen keine Umlaute (äöü) und keine Sonderzeichen ausser \"_\" (Underline) enthalten. Punkte dienen zur Einteilung in die Ordnerstruktur.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Skript-Namen sind auf 100 Zeichen begrenzt.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Die Entwicklungssprache in primedocs ist grundsätzlich Englisch, sowohl im Source Code als auch in den Skripten. Kommentare bilden eine Ausnahme: dort darf auch auf Deutsch geschrieben werden. Kommentare beginnen mit den Zeichen .","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Globale Konfigurationen","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Möglichst global","type":"text"}]},{"type":"paragraph","content":[{"text":"In den meisten Fällen gilt: je globaler desto besser. Das bedeutet: lieber ein Skript zu viel auslagern als eines zu wenig. Sobald ein Skript mehr als einmal vorkommt, wird es ausgelagert (in die ","type":"text"},{"text":"Globalen Konfigurationen","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/31457334"}}]},{"text":" eingefügt und verknüpft), damit das Skript nur an einem Ort gepflegt werden muss.","type":"text"}]},{"type":"paragraph","content":[{"text":"Wenn man ein neues Skript benötigt, das leicht unterschiedlich zu einem existierenden Skript sein soll, erreicht man das auf drei Arten:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Bestehendes Skript erweitern","type":"text"}]},{"type":"paragraph","content":[{"text":"Das bestehende Skript kann so abgeändert werden, dass der gewünschte Unterschied unter einer Bedingung (Condition) zustande kommt. Die Condition könnte z. B. den Status einer nicht-sichtbaren Dokument-Parameter-Checkbox (z. B. DocParam.EnableDateOfInHeader) abfragen oder sich auf den Inhalt eines bestimmten Skript-Namens stützen (z. B. CustomElements.EnableDateOfInHeader = 'true'). Beispiel:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n {D[Texts.DateOf]} \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Hier wird (neben der Abteilung auf der 1. Zeile) entweder \"vom 1. Januar 2017\" oder \"1. Januar 2017\" ausgegeben, je nach dem, ob ","type":"text"},{"text":"DocParam.EnableDateOfInHeader","type":"text","marks":[{"type":"code"}]},{"text":" in einer Vorlage aktiviert ist oder nicht.","type":"text"}]},{"type":"paragraph","content":[{"text":"✔ Wartbarkeit – Da kein zusätzliches Skript erstellt wurde, ist es später einfacher, den Überblick über die Skripte und deren Funktionalitäten zu haben.","type":"text"}]},{"type":"paragraph","content":[{"text":"❌ Komplexität – Skripte mit Conditions sind anspruchsvoller zu lesen und zu bearbeiten.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Vererbung nutzen","type":"text"}]},{"type":"paragraph","content":[{"text":"Falls ein Skript in der Layoutvorlage entweder geschrieben oder mit den ","type":"text"},{"text":"Globalen Konfigurationen","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/31457334"}}]},{"text":" verknüpft ist, besteht auch die Möglichkeit, dieses Skript in die Inhaltsvorlage zu kopieren und dort den Inhalt zu ändern. Dann wird der Skriptinhalt folglich durch die Hauptvorlage gesteuert. Dabei muss der Name zwingend gleich bleiben. Die Dokument-Pipeline geht dann bei der Generierung durch alle Skripte durch und wird dann die in der Kette unterste Version des Skriptes nehmen (in diesem Fall in der Inhaltsvorlage). Das geht natürlich auch von Layoutvorlage zu Funktionsvorlage oder von Inhaltsvorlage zu Funktionsvorlage.","type":"text"}]},{"type":"paragraph","content":[{"text":"✔ Einfachheit – Das Skript wird lediglich kopiert und in die auf der Layoutvorlage basierende Vorlage in der Vorlagenhierarchie eingefügt und angepasst. Der Vorgang ist sehr simpel und unkompliziert.","type":"text"}]},{"type":"paragraph","content":[{"text":"✔ Wartbarkeit – Soll wieder das globale Skript benutzt werden, wird das überschreibende Skript einfach gelöscht oder auskommentiert.","type":"text"}]},{"type":"paragraph","content":[{"text":"❌ Komplexität – Für andere Vorlagenbearbeiter kann es schwierig sein, das richtige Skript zu finden, das sie in der Word-Vorlage sehen. Grund dafür ist, dass die Id gleich lautet (was wir mit der Vererbung auch ausnutzen). Sie müssen wissen, dass bei der Generierung effektiv nicht auf das globale Skript sondern auf eine überschreibende Version in der Inhalts- bzw. Funktionsvorlage zugegriffen wird.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. Kopie erstellen","type":"text"}]},{"type":"paragraph","content":[{"text":"Im Notfall kann man das Skript kopieren, den Namen des Skripts anpassen und die Änderungen an der Kopie vornehmen. Dieses neue Skript muss dementsprechend in der Vorlage neu eingefügt werden. Der Unterschied zum anderen Skript sollte gut ersichtlich sein (zum Beispiel kann ein Kommentar erfasst werden. Bestenfalls sieht man den Unterschied im Namen).","type":"text"}]},{"type":"paragraph","content":[{"text":"✔ Schneller – Kopien von Skripten zu erstellen, ist einfacher und geht schneller.","type":"text"}]},{"type":"paragraph","content":[{"text":"❌ Wartbarkeit – bei vielen ähnlichen Skripte kann leicht die Übersicht verloren gehen. Das insbesondere dann, wenn die Unterschiede der ähnlichen Skripte nicht ersichtlich sind.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Struktur in den Globalen Konfigurationen","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Gruppen (\"Group\")","type":"text"}]},{"type":"paragraph","content":[{"text":"Neue Skripte werden bei praktisch allen Kundenlösungen in den ","type":"text"},{"text":"Globalen Konfigurationen","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/31457334"}}]},{"text":" in der Gruppe \"Scripts\" abgelegt. Neben Skripten können in den Globalen Konfigurationen auch andere Konfigurationen, die häufig verwendet werden, abgelegt werden, wie z. B. Regex-Validierungen, HTML-Bausteine oder ","type":"text"},{"text":"Formatierung-Dokumentfunktion","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/32309402"}}]},{"text":"-Konfigurationen. Letzteres sollte jedoch wenn möglich immer direkt an die Layout- bzw. Inhaltsvorlage angehängt werden. Solche Skripte gehören dann nicht in die Gruppe \"Scripts\", sondern in dafür neu angelegte Gruppen. Formatierung-Dokumentfunktion-Konfigurationen gehören beispielsweise in die Gruppe \"Formatting\".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Namen von Konfigurationsteilen und Skripten","type":"text"}]},{"type":"paragraph","content":[{"text":"Grundsätzlich haben einzelne Einträge in den ","type":"text"},{"text":"Globalen Konfigurationen","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/31457334"}}]},{"text":" beim Auslagern genau denselben Namen wie die darin enthaltenen CustomDataNodes. Im folgenden Beispiel, ist die Gruppe \"Scripts\" und der Eintrag \"Salutation\" angewählt. Das CustomDataNode hat ebenfalls den Namen \"Salutation\":","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"full-width"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Gruppe Scripts.Salutation: Eintrag","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1377,"id":"aa4c9981-9cdf-423b-aa99-f871584a6a11","collection":"contentId-33095810","type":"file","height":451}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Gruppe Scripts.Salutation: XML","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Oft werden jedoch verschiedene Skripte für eine Vorlagengruppe oder für einen Dokumenttyp (Verträge, Briefe, Arbeitszeugnisse, etc.) benötigt. In dem Fall werden diese Skripte alle in einen Eintrag abgespeichert. Die Namen der einzelnen CustomDataNodes sind dann gemäss dem Schema: ","type":"text"},{"text":"Eintrag.Name","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"http://Eintrag.Name"}}]},{"text":". Im folgenden Fall ist das ","type":"text"},{"text":"Signers.Signer_0","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"full-width"}}],"content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Gruppe Scripts.Signers: Eintrag","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":905,"id":"b2ccb173-a35c-4ce9-b913-0894bd3b388a","collection":"contentId-33095810","type":"file","height":557}}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Gruppe Scripts.Signers: XML","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n\n \n \n \n\n \n \n \n \n \n\n \n \n ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Diese Konfiguration wird folglich in den Vorlagen durch ","type":"text"},{"text":"{[Scripts.Signers]}","type":"text","marks":[{"type":"code"}]},{"text":" integriert. Unter \"Inhalt verknüpfen\" kann man somit den Ordner \"Signers\" aufrufen, der vier Skripte enthält. Die Skripte von den ","type":"text"},{"text":"Globalen Konfigurationen","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/31457334"}}]},{"text":" werden, wenn möglich, in den Layoutvorlagen verknüpft, damit alle anhängenden Inhaltsvorlagen diese Skripte auch zur Verfügung haben. Der Fall, dass nur eine Vorlage eine grosse Anzahl Skripte benötigt, ist relativ selten.","type":"text"}]},{"type":"paragraph","content":[{"text":"Es gibt einen Fall, in dem es sinnvoll ist, Skripte mit Nummern zu versehen, nämlich wenn je nach Bedingung, verschiedene Inhalte in einer Tabelle stehen und verschieden formatiert werden. Wenn ein Skript also auf mehrere Teil-Skripte aufgeteilt werden muss, ist dieses Skript meistens ausschliesslich für diese Verwendung vorgesehen. Unter dieser Ausnahme macht es keinen Sinn, für jedes Teil-Skript einen beschreibenden Namen zu vergeben.","type":"text"}]},{"type":"paragraph","content":[{"text":"Ein Beispiel: Nehmen wir an, es wird eine Tabelle erstellt, die fett oder normal formatiert wird. Die Skripte können dann nach Row (=Zeile) und Column (=Spalte) und danach nach fett und nicht fett eingeteilt werden. So weiss man genau, welches Skript in welche Zelle kommt:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Protocol.Row1.Col1.bold","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Protocol.Row1.Col2.normal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Protocol.Row2.Col1.bold","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Protocol.Row2.Col2.normal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Protocol.Row3.Col1.bold","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Protocol.Row3.Col2.normal","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n Sitzung\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n Ort\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Vorsitz\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Das wäre in Word zum Beispiel so:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":408,"id":"36d74888-838b-49a2-8f4c-8fdc97482f42","collection":"contentId-33095810","type":"file","height":163}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Grundsätzlich sollte der Name gemäss dem Kapitel ","type":"text"},{"text":"Namensgebung bei Skripten","type":"text","marks":[{"type":"link","attrs":{"href":"#Namensgebung-bei-Skripten"}}]},{"text":" möglichst beschreibend sein oder in wenigen Fällen die Position beschreiben.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Rekursion in Skripten","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Einfache Rekursion","type":"text"}]},{"type":"paragraph","content":[{"text":"Manchmal macht es Sinn, in einem Skript auf das Resultat eines anderen Skripts zuzugreifen. Wenn z. B. in fünf verschiedenen Skripten der Lösung ermittelt werden muss, ob sich Profil und Signer_1 entsprechen und ob die aktuelle Organisationseinheit nicht das Finanzdepartement ist, kann das über ein Skript ermittelt werden, auf dessen Resultat wir im Anschluss zugreifen:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Beim Verknüpfen von globalen Skripten, die auf andere Logik-Skripte zugreifen, muss darauf geachtet werden, dass das Logik-Skript ebenfalls verknüpft wird. Beispiel, wobei \"CompanyAddress\" das Resultat des Logik-Skripts benötigt: ","type":"text"},{"text":"{[Scripts.Logic.Signer1EqualsProfileAndOuIsNotFinance]}","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"{[Scripts.CompanyAddress]}","type":"text","marks":[{"type":"code"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Mehrfache Rekursion (Depth)","type":"text"}]},{"type":"paragraph","content":[{"text":"Der Zugriff auf ein Resultat eines simplen Skripts funktioniert immer. Der Zugriff auf ein Resultat eines Skripts, das wiederum auf das Resultat eines weiteren Skripts zugreift, wird mit ","type":"text"},{"text":"Depth","type":"text","marks":[{"type":"code"}]},{"text":" ermöglicht. Das passiert in der ","type":"text"},{"text":"Skripte-Dokumentfunktion","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/32604233"}}]},{"text":". Hier ist die Depth auf 5 gesetzt:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Globale Konfigurationen","type":"text"}]},{"type":"paragraph","content":[{"text":"Schöner Code in den ","type":"text"},{"text":"Globalen Konfigurationen","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PDT/pages/31457334"}}]},{"text":" beinhaltet, dass in einem Eintrag nach jedem \"CustomDataNode\"-Element ein leerer Absatz folgt. Hier ein Beispiel:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n [...]\n \n\n \n [...]\n \n\n \n [...]\n ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Skripte","type":"text"}]},{"type":"paragraph","content":[{"text":"CustomDataNodes sind auch hier durch Leerzeilen voneinander sichtbar getrennt. Komplizierte Skripte sowie Conditions in den Skripten sollten in einem einleitenden Kommentar erklärt werden. Bei Conditions kann der Wert des when/notwhen-Attributs Zeilenumbrüche enthalten. Diese verbessern die Lesbarkeit:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Dokument-Parameter","type":"text"}]},{"type":"paragraph","content":[{"text":"Indem Attribute mit Tabs auf dieselbe Höhe gebracht werden, kann die Übersichtlichkeit erhöht werden:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported