Einsatz

FormattedText ist ein Datencontainer, welcher Text mit Formatierungsoptionen (u.A. Fett, Kursiv, Unterstrichen, Umbrüche oder auch Word-Spezifische Formatierungen) enthalten kann.

Dabei handelt es sich bei FormattedText, egal in welchem Kontext, technisch um HTML:

Formen von FormattedText

FormattedText kommt in primedocs vor als

• Typ einer Globalen Übersetzung

• Textbaustein-Typ

• Field-Typ, somit als Code erzeugbar, wobei FormattedText als Textbaustein oder globale Übersetzung geholt werden kann.

• in webfähigen Outlook-Vorlagen.

FormattedText als Globale Übersetzung

Der Vorteil von FormattedTexts in den Globalen Übersetzungen ist, dass man keinen Textbaustein erstellen muss sondern den Text in seinem technischen Format, HTML, erstellen kann.

Dabei wird HandleBars.js verwendet. Hier finden Sie die Dokumentation: Expressions | Handlebars (handlebarsjs.com). Im Gegensatz zu FormattedText-Textbausteinen (weiter unten) kann so in der Übersetzung Kontrollstrukturen und Schlaufen abbilden.

Mithilfe von benannten Parametern können in globalen Übersetzungen Platzhalter erstellt werden, die über die Fields später Absätze (<p></p>) oder Schlaufen mit dynamischen Daten füllen.

Mehr Informationen finden Sie im Layouter-Handbuch: https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/395378689/Word+Eintauchen+in+Fields#FormattedTexts-als-Globale-%C3%9Cbersetzung

Mögliche HTML-Elemente

Die folgende Listen zeigen alle möglichen HTML-Elemente und ihre Attribute, welche in den Vorlagen verwendet werden können (entweder als Textbaustein, als Field-Typ, etc.).

Word-Vorlagentypen

Elemente:

<p>Paragraph</p>
<span>Span</span>
<sup>superscript</sup>
<sub>subscript</sub>
<u>underline</u>
<i>italic</i>
<em>italic</em>
<b>bold</b>
<strong>bold</strong>
<br />

Attribute, auf span und p:

"data-office-font"
"data-office-font-size"
"data-office-color-hex"
"data-office-color-theme-name"
"data-word-style-id";
"data-word-space-after"
"data-word-space-before"
"data-word-indentation"
"data-word-alignment" (Center, Right, Left)

Attribute auf br:

"data-word-break-type" (Page)

PowerPoint-Vorlagentypen

Elemente:

<p>Paragraph</p>
<span>Span</span>
<sup>superscript</sup>
<sub>subscript</sub>
<ul><li>list</li></ul>
<ol><li>list</li></ol>
<u>underline</u>
<i>italic</i>
<em>italic</em>
<b>bold</b>
<strong>bold</strong>
<br />

Attribute, auf span und p:

"data-office-font";
"data-office-font-size";
"data-office-color-hex";
"data-office-color-theme-name";
"data-powerpoint-alignment" (Center, Right, Left)

FormattedText als Textbaustein

Ein FormattedText kann als Textbaustein vom Typ Formatierter Text abgespeichert werden. Textbausteine dieses Typs werden allerdings nur beim Vorlagenbau bzw. Templating eingesetzt und daher von Endbenutzern nicht verwendet.

Ein FormattedText-Textbaustein wird über ein FormattedText-Field via snippets-API beim Erstellen von Dokumenten ausgegeben.

Diese Textbausteine können keine Tabellen, Bilder oder andere komplexe Inhalte abspeichern. Dazu eignen sich jedoch Textbausteine vom Typ WordContent.

FormattedText als Field

Wie in den zwei vorangegangenen Kapiteln beschrieben, kann der Field-Typ FormattedText einen Textbaustein, eine globale Übersetzung vom Typ FormattedText sowie Fixtext ausgeben.

Anwendung in Fields

Eine Übersetzung vom Typ FormattedText kann in Fields über die translations-API ausgegeben werden:

Erfahren Sie im Layouter-Handbuch mehr zum Einsatz von FormattedText-Fields: https://primesoft-group.atlassian.net/wiki/spaces/PD/pages/395378689/Word+Eintauchen+in+Fields#Typ-FormattedText

FormattedText in webfähigen Outlook-Vorlagen (TODO)

Thomas Wepfer , Luc Benninger , Robert Mühsig Hier benötige ich eure Hilfe zum Abschliessen der Seite. Ansonsten veröffentlichen wir sie einmal ohne diesen Abschnitt…

Syntax

[TODO]