Einsatz

FormattedText ist ein Datencontainer, der in primedocs an den folgenden Stellen zum Einsatz kommt. Formatted Text …

ist ein Textbaustein-Typ.
ist ein Typ einer Globalen Übersetzung.
ist ein Field-Typ, somit als Code erzeugbar, wobei FormattedText als Textbaustein oder globale Übersetzung geholt wird.
FormattedText kann in webfähigen Outlook-Vorlagen eingesetzt werden.

FormattedText als Textbaustein

Textbausteine vom Typ Formatierter Text können keine Tabellen, Bilder oder andere komplexe Word-Inhalte abspeichern.

Der Textbaustein kann entweder vom Benutzer selbst mittels Doppelklick oder Drag’n’Drop in ein Dokument eingefügt werden.

Weiter kann ein solcher Textbaustein in einem Field via snippet-API (LINK) ausgegeben werden:

Ein Textbaustein vom Typ “Formatierter Text” mit einem Schlüssel FooterFTSnippet.

Ein Field, das diesen Textbaustein zurückgibt:

<FormattedText Name="FooterFTSnippet">
  <Code>$.snippets.getFormattedText("FooterFTSnippet")</Code>
</FormattedText>

FormattedText als Globale Übersetzung

Der Vorteil von FormattedTexts in den Globalen Übersetzungen ist, dass man keinen Textbaustein erstellen muss sondern den Text mit HTML programmatisch erstellen kann (siehe Beispiel unten).

Dabei wird HandleBars.js verwendet. Hier finden Sie die Dokumentation: Expressions | Handlebars (handlebarsjs.com)

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.

Mögliche HTML-Elemente

Die folgende Listen zeigen alle möglichen HTML-Elemente und ihre Attribute, die in Globalen Übersetzungen vom Typ FormattedText aufgerufen werden können, dies für Word-Vorlagentypen und PowerPoint-Vorlagentypen:

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-word-style-id";
"data-word-space-after"
"data-word-space-before"
"data-word-indentation"
"data-word-alignment" (Center, Right, Left)
"data-office-font"
"data-office-font-size"
"data-office-color-hex"
"data-office-color-theme-name"
"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-powerpoint-alignment" (Center, Right, Left)
"data-office-font";
"data-office-font-size";
"data-office-color-hex";
"data-office-color-theme-name";

FormattedText als Field

Wie in den zwei vorangegangenen Kapiteln beschrieben, kann der Field-Typ FormattedText jeweils Textbausteine und globale Übersetzungen vom Typ FormattedText sowie Fixtext ausgeben.

Anwendung in Fields

Ein FormattedText kann in Fields via translations-API (LINK) ausgegeben werden:

Der FormattedText ist als globale Übersetzung vom Typ “FormattedText” angelegt, Id FormattedTexts.FooterBold.

Ein Field, das die globale Übersetzung zurückgibt:

<FormattedText Name="Claim">
  <Code>$.translations.getFormattedText("FormattedTexts.FooterBold")</Code>
</FormattedText>

Zum Einsatz von FormattedText-Fields erfahren Sie hier mehr: [LINK]

FormattedText in Outlook-Vorlagen (TODO)

mue/wep/ben?