Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Links zu Layouter-Handbuch hinzugefügt
Table of Contents
minLevel1
maxLevel6
outlinetrue
stylenone
typelist
printabletrue

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 Ein FormattedText kann als Textbaustein vom Typ Formatierter Text können keine Tabellen, Bilder oder andere komplexe Word-Inhalte abspeichern abgespeichert werden.
Der Textbaustein kann entweder vom durch den 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:einem Word-Dokument über die Seitenleiste eingefügt oder automatisch über ein FormattedText-Field via snippets-API ausgegeben werden.

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

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

image-20240116-094938.png

Ein Field, das diesen Textbaustein zurückgibt:

Code Block
languagexml
<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).. Dies ist dynamischer

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.

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, die in Globalen Übersetzungen vom Typ FormattedText aufgerufen werden können, dies für Word-Vorlagentypen und PowerPoint-Vorlagentypen:

Word-Vorlagentypen

Elemente:

Code Block
languagehtml
<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:

Code Block
languagehtml
"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:

Code Block
languagehtml
<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:

Code Block
languagehtml
"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 über die translations-API (LINK) ausgegeben werden:

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

image-20240116-095243.png

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

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

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

FormattedText in Outlook-Vorlagen (TODO)

mue/wep/ben?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…