Table of Contents

Über den SnippetResolver können Texte in ein Dokument eingefügt werden. Die Texte können hierfür auf verschiedene Arten spezifiziert werden:

Es können primedocs interne Textbausteine über die "id" festgelegt werden.
Es können primedocs externe Textbausteine in Text oder im HTML-Format übermittelt werden.
Der Inhalt kann im OPC-Flat Format übergeben werden.

Grundsätzlich gehen alle Varianten nach demselben Schema vor: Man übergibt den Inhalt und definiert über ein Bookmark in der Vorlage wo dieser Inhalt eingefügt wird. Die Anzahl der Textbausteine ist dabei beliebig. Inhalte, die während der Vorlagenerstellung in dem Bookmark hinterlegt wurden, werden dabei mit den neuen Inhalten ersetzt.

HINWEIS

Der entsprechenden Vorlage muss die Dokumentfunktion SnippetResolver ("Textbausteine") angehängt sein.

Schnellbausteine

Es gibt zudem noch eine weitere Funktion die der "SnippetResolver" übernimmt. primedocs Textbausteine können als "AutoText" bzw. "Schnellbausteine" in die generierte Vorlage hinterlegt werden. Die so eingebundenen "AutoText" Textbausteine stehen damit als normale Schnellbausteine in Microsoft Word zur Verfügung.

...

Im Standardfall werden automatisch immer alle "AutoText" Textbausteine die dem Benutzer zur Verfügung stehen hinterlegt. Dieses Verhalten kann sowohl über die Konfiguration der Dokumentfunktion bzw. über Connect über dieses "Setting" übersteuert werdenThe SnippetResolver can be used to insert texts into a document. The texts can be specified in different ways:

primedocs internal snippets can be specified via their id.
primedocs external snippets can be transmitted in text or HTML format.
The content can be transferred in OPC flat format.

Basically all variants follow the same scheme: You pass the content and define via a bookmark in the template where this content will be inserted. The number of snippets is unlimited. Content that was stored in the bookmark during template creation is replaced with the new content.

NOTE
The corresponding template must have the SnippetResolver ("Snippets") document function attached.

...

Quick parts

The "SnippetResolver" also undertakes another function. primedocs snippets can be added to the generated template as "AutoText" or "Quick parts". The "AutoText" snippets included this way are then available as normal quick snippets in Microsoft Word.

In the standard case, all "AutoText" snippets available to the user are automatically stored. This behavior can be overridden via the configuration in the document function or in Connect using this setting:

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<OneOffixxConnectBatch xmlns="http://schema.oneoffixx.com/OneOffixxConnectBatch/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Entries>
    <OneOffixxConnect>
      <Arguments>
        ...
      </Arguments>
      <Function name="SnippetsResolver" id="dd752747-733e-4175-9fc7-028ab7472742">
	    <Settings>
			<Value key="AutoTextDisabled">true</Value>
		</Settings>
        <Arguments>
          ...
        </Arguments>
      </Function>
    </OneOffixxConnect>
  </Entries>
</OneOffixxConnectBatch>

...

primedocs

...

snippets

Folgendes Szenario: Es soll ein neues Dokument erstellt und mit Textbausteinen (Snippets) befüllt werden. Die Id des Textbausteins kann mit Hilfe des Textbausteineditors ausgelesen werden. Jede Id ist eindeutig und ändert sich nach dem Anlegen nicht mehr. Die Sprache wird über die Dokumentsprache festgelegtA scenario: A new document is to be created and filled with snippets. The id of the snippet can be read out with the help of the snippet editor. Each id is unique and does not change after creation. The language is defined via the document language.

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<OneOffixxConnectBatch xmlns="http://schema.oneoffixx.com/OneOffixxConnectBatch/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Entries>
    <OneOffixxConnect>
      <Arguments>
        <TemplateId>6bb49520-1ebd-4f68-bb5f-02f46a9e1ec8</TemplateId>
        <LanguageLcid>2055</LanguageLcid>
      </Arguments>
      <Function name="SnippetsResolver" id="dd752747-733e-4175-9fc7-028ab7472742">
        <Arguments>
          <Snippet id="A7835D23-E945-4A39-81B9-3CEC067E26C0" bookmark="Bookmark1" />
          <Snippet id="B8235D23-D945-5A39-31B9-23EC067E2120" bookmark="Bookmark1" />
          <Snippet id="43535D23-45D5-6A39-81B9-DE1C067E2112" bookmark="Bookmark2" />
          <Snippet id="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" bookmark="Bookmark3" />
        </Arguments>
      </Function>
    </OneOffixxConnect>
  </Entries>
</OneOffixxConnectBatch>

Mehrere Textbausteine können in einer Textmarke (z. BSeveral snippets can be grouped in one bookmark (e.g. "Bookmark1") gruppiert werden, indem im Attribut by using the same name in the "Bookmark" der gleiche Name steht. Die Textbausteine werden in der gleichen Reihenfolge eingebaut wie sie im XML stehen. Es ist auch möglich, den attribute. The snippets are inserted in the same order as they appear in the XML. It is also possible to use the "_OneOffixxOpenAt" -Bookmark zu verwenden. Dadurch wird der Text an der Cursor-Position, die in der primedocs Vorlage definiert ist, eingefügt.

Externe "Text"-Textbausteine

Möchte man aus einer Fachapplikation unformatierten Textinhalt übergeben, kann man dies so erreichenbookmark. This will insert the text at the cursor's position defined in the primedocs template.

...

External "Text" snippets

If you want to pass unformatted text content from a specialist application, you can do it like that:

Code Block

language	xml

<?xml version="1.0" encoding="UTF-8"?>
<OneOffixxConnectBatch xmlns="http://schema.oneoffixx.com/OneOffixxConnectBatch/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Entries>
    <OneOffixxConnect>
      <Arguments>
        <TemplateId>6bb49520-1ebd-4f68-bb5f-02f46a9e1ec8</TemplateId>
        <LanguageLcid>2055</LanguageLcid>
      </Arguments>
      <Function name="SnippetsResolver" id="dd752747-733e-4175-9fc7-028ab7472742">
        <Arguments>
          <Snippet bookmark="Bookmark3">
            Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Maecenas porttitor congue massa. Fusce posuere, magna sed pulvinar ultricies, purus lectus malesuada libero, sit amet commodo magna eros quis urna.
            Nunc viverra imperdiet enim. Fusce est. Vivamus a tellus.
            Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Proin pharetra nonummy pede. Mauris et orci.
            Aenean nec lorem. In porttitor. Donec laoreet nonummy augue.
            Suspendisse dui purus, scelerisque at, vulputate vitae, pretium mattis, nunc. Mauris eget neque at sem venenatis eleifend. Ut nonummy.
          </Snippet>
        </Arguments>
      </Function>
    </OneOffixxConnect>
  </Entries>
</OneOffixxConnectBatch>

...

External "HTML"

...

Um formatierten Inhalt in das Dokument einzufügen empfiehlt es sich den Inhalt als "HTML"-Snippet zu übergeben. primedocs bietet einen eigenen HTML-Parser und erkennt zudem primedocs eigene Attribute um Style- und Formatierungsoptionen direkt in OpenXML Eigenschaften zu übersetzen.

Grundaufbau

...

snippets

To insert formatted content into the document it is recommended to pass the content as "HTML" snippet. primedocs provides its own HTML parser and also recognizes primedocs custom attributes to translate style and formatting options directly into OpenXML properties.

Basic structure

The structure is almost identical, but an additional parameter "parser" has been added to the snippet. In the "parser" "primedocs" must be specified.

Code Block

language	xml

          <Snippet bookmark="_OneOffixxOpenAt" type="Html" parser="primedocs">
          	<![CDATA[
         
  		<p>HTML Fragmente...</p>
          Fragments...</p>
	]]>
          </Snippet>

...

primedocs

...

attributes

To pass style or "rendering" information, the following attributes can be used:

data-oo-style: Der angegebene Style wird dem entsprechenden The specified style will be applied to the corresponding Open-XML Element zugewiesenelement.
- Styles können auf can be applied to <p>, <ul> / <ol> oder <table> -Elemente angewendet werdenelements.
data-oo-align: Definiert die Ausrichtungdefines the alignment.
- Mögliche WertePossible values: left, right, center
- Das Attribut kann auf The attribute can be applied to <p>, <td> oder <th> -Elemente angewendet werdenelements.
data-oo-table-...: Definierte Angaben für <table>-Elementedefined specifications for <table> elements.
data-oo-image-...: Definierte Angaben für <img>-Elementedefined specifications for <img> elements.
data-oo-background: Definiert eine HintergrundfarbeDefines a background color.
- Mögliche WertePossible values: HEX -Farbcodescolor codes, ze. Bg. E2001A
- Das Attribut kann auf Absatz The attribute can be applied to paragraph (<p>, <h1>, etc.), <td> oder or <th>, oder Text or text (<span>, <strong>, etc.) -Elemente angewendet werdenelements.
data-oo-foreground: Definiert eine Schriftfarbedefines a font color.
- Mögliche WertePossible values: HEX -Farbcodescolor codes, ze. Bg. E2001A
- Das Attribut kann auf Absatz Text The attribute can be applied to paragraph text (<span>, <strong>, etc.) -Elemente angewendet werdenelements.

Note

WICHTIG

Es können nur bestehende Styles verwendet werden, d.h. diese müssen im Wordprocessing-Dokument bzw. in der Style-Vorlage existieren. Zudem wird die 'StyleId' genutzt, welche von dem angezeigten Name in Microsoft Word abweichen kann. (z. B. aus 'Überschrift 1' kann Office eine Style mit der Id 'berschrift1' erstellen).
Falls ein Style bei einer Liste verwendet wird, wird dieser nur angewandt, wenn an diesem Style 'Auflistungsformatierungen' definiert sind.

Hinweis zu CSS und anderen Attributen:

CSS Angaben oder Attribute werden (bis auf die Ausnahmen "colspan" bei der Tabelle und "src" bei Bildern) ignoriert.

Hinweis zu Textangaben:

Der Parser kann sowohl UTF8 als auch HTML kodierte (z. B. ü) Texte direkt ins Open XML wandeln.

Ausgenommen davon sind folgende Zeichen, die zwingend in HTML encodiert werden müssen:

code

IMPORTANT
Only existing styles can be used, i.e. these must exist in the Wordprocessing document respectively in the style template. In addition, the 'StyleId' is used, which may differ from the displayed name in Microsoft Word. (e.g. from 'Heading 1' Office can create a style with the Id 'Heading1').
If a style is used with a list, this is only applied if 'listing formatting' is defined at this style.

Info

NOTE

About CSS and other attributes:
CSS specifications or attributes are ignored (except for "colspan" for table and "src" for images).

About text specifications:
The parser can convert both UTF8 and HTML encoded (e.g. ü) texts directly into Open XML. Exceptions to this are the following characters, which must be encoded in HTML:

Code Block

language	none

" als &quot;
' als &apos;
> als &gt;
< als &lt;
& als &amp;

Typographie-Elemente

Diese Elemente werden in die entsprechenden OpenXML Elemente umgewandelt. Dabei wird versucht, den jeweiligen Stil einzuhalten, sodass ein <b> entsprechend "fett" formatiert wird.

...

Typography elements

These elements are converted to the corresponding OpenXML elements. An attempt is made to adhere to the respective style, so that a <b> is formatted "bold" accordingly.

Elements for OpenXML paragraphs:

<p>
<h1>, <h2>, <h3>, <h4>, <h5>, <h6>
<pre>,<blockquote>,<address>

Elemente für Elements for OpenXML Texttext:

<span>
<u>
<s>
<sub>
<sup>
<i>
<em>
<b>
<strong>
<code>,<time>,<label>
<a> (nur der Link-Text wird übernommen)

...

only the link text is applied)

Elements for OpenXML lines:

<hr>
- Optionale AttributeOptional attributes:
  - data-oo-hr-type="---": Erzeugt eine Linie ähnlich wie beim Creates a line similar to AutoFormat "---"
  - data-oo-hr-type="___": Erzeugt eine Linie ähnlich wie beim Creates a line similar to AutoFormat "___"
  - data-oo-hr-type="###": Erzeugt eine Linie ähnlich wie beim Creates a line similar to AutoFormat "###"
  - data-oo-hr-type="~~~": Erzeugt eine Linie ähnlich wie beim Creates a line similar to AutoFormat "~~~"
  - data-oo-hr-type="***": Erzeugt eine Linie ähnlich wie beim Creates a line similar to AutoFormat "***"
  - data-oo-hr-type="===": Erzeugt eine Linie ähnlich wie beim Creates a line similar to AutoFormat "==="
- Ohne Attributangabe wird ein Linienelement erzeugt.

...

- Without attribute specification a line element is created.

Elements for OpenXML line, column or page breaks:

<br>
- Optionale AttributeOptional attributes:
  - data-oo-br-type="textWrapping": Erzeugt einen ZeilenumbruchCreates a line break.
  - data-oo-br-type="page": Erzeugt einen SeitenumbruchCreates a page break.
  - data-oo-br-type="column": Erzeugt einen Spaltenumbruch, falls der Abschnitt mehrere Spalten enthält.
- Ohne Attributangabe wird ein normaler Zeilenumbruch erzeugt.

...

- - Creates a column break if the section contains multiple columns.
- Without attribute specification a normal line break is generated.

Elements in which known child elements are searched:

<html>,<body>,<form>,<div>

Verschachtelte Nested <p> - oder or <h1> - (etc.) Elemente werden nicht unterstützt. Diese Elemente sind auch laut HTML-Spezifikation nicht dafür ausgelegtelements are not supported. These elements are also not designed for this according to the HTML specification.

Warning
WARNUNGWARNING <h1>-<h6> -Elemente werden behandelt wie <p>-Elemente, jedoch wird automatisch kein Word-Style angewandt. Styles müssen immer explizit angegeben werden.

Bild-Elemente

Bilder können als Data-URL übermittelt werden.

Elemente:

<img>

...

elements are treated like <p> elements, but no Word style is automatically applied. Styles must always be specified explicitly.

...

Image elements

Images can be transmitted as Data URI scheme.

Elements:

<img>

Supported image formats (specified by the MIME type in the data URL) are:

image/bmp
image/png
image/gif
image/jpeg
image/tiff

primedocs -Attributeattributes:

data-oo-image-title: definiert den defines the (optionalen) Titel eines Bildes.
Das Attribut kann auf <img>-Elemente angewendet werden
optional) title of an image.
- The attribute can be applied to <img> elements.
data-oo-image-desc: definiert die defines the (optionale) Beschreibung eines Bildes.
Das Attribut kann auf <img>-Elemente angewendet werden
optional) description of an image.
- The attribute can be applied to <img> elements.
data-oo-image-width: definiert die Breite des Bildes im Dokument.
Das Attribut kann auf <img>-Elemente angewendet werden.

Es wird eine Zahl ohne Komma erwartet

defines the width of the image in the document.

The attribute can be applied to <img> elements.
A number without a comma is expected.

data-oo-image-height: definiert die Höhe des Bildes im Dokument.
Das Attribut kann auf <img>-Elemente angewendet werden.

Es wird eine Zahl ohne Komma erwartet

defines the height of the image in the document.

The attribute can be applied to <img> elements.
A number without a comma is expected.

data-oo-image-sizeunit: definiert die Einheit. Standardmässig wird Pixel (px) gewählt.
Falls keine expliziten Höhen-
- Mögliche Werte: px, cm, mm
- Es wird eine Zahl ohne Komma erwartet.
- Weitere Informationen im Abschnitt Bilder.

Bilder können im Fliesstext, als einzelner Paragraph, in Listen oder Tabellen eingesetzt werden.

Für die Berechnung der Bildgrösse gibt es verschiedene Varianten:

- A number without a comma is expected.
- More information in the pictures section.

Images can be used in continuous text, as a single paragraph, in lists or tables.

There are different options for the calculation of the image size:

If no explicit height ("data-oo-image-height") oder Breiten-or width ("data-oo-image-width") Angaben vorhanden sind, wird die Pixel-Grösse des Bildes genutzt.
Falls eine Höhen- oder Breiten-Angabe vorhanden ist, wird das Seitenverhältnis des Ursprungsbild beibehalten und entsprechend die Grösse berechnet.
Falls sowohl Höhen- als auch Breiten-Angaben vorhanden sind, werden diese als Grösse genutzt – egal welches Seitenverhältnis das Bild hat.

...

specifications are available, the pixel size of the image is used.
If a height or width specification is present, the aspect ratio of the original image is kept and the size is calculated accordingly.
If both height and width specifications exist, they will be used as size – no matter what aspect ratio the image has.

Optionally, the "data-oo-image-title" und and "data-oo-image-desc" Beschreibungen im OpenXML hinterlegt werden.

Tabellen-Elemente

HTML Tabellen können ebenfalls umgewandelt werden, jedoch werden ohne Style-Angabe, die später thematisiert wird, keine Tabellenränder oder ähnliches dargestellt.

Elementecan be used to store descriptions in OpenXML.

...

Table elements

HTML tables can also be converted, but without style specification, which will be discussed later, no table borders or similar are displayed.

Elements:

<table>
<thead> - innerhalb der within <table>
<tbody> - innerhalb der within <table>
<tfoot> - innerhalb der within <table>
<tr> - innerhalb von within <thead>, <tbody> oder or <tfoot>
<td> - innerhalb von within <tr>
<th> - innerhalb von within <tr>
Alle Typographie-Elemente, Bilder und Input-Controls innerhalb eines <td>
Listen innerhalb eines <td>
Tabellen innerhalb eines <td>

Das "colspan"-Attribut gilt für <td>-Elemente.

...

All typography elements, images and input controls within a <td>.
Lists within a <td>.
Tables within a <td>

The "colspan" attribute applies to <td> elements.

primedocs attributes:

data-oo-table-width: definiert die Breite der Tabelle in Prozent oder "Twipdefines the width of the table in percent or "twip" (1cm = 567). Ist Is optional wenn if data-oo-table-columns -Werte als cm Angabe gemacht werden.
Das Attribut kann auf <table>-Elemente angewendet werden
values are specified as cm.
- The attribute can be applied to <table> elements.
data-oo-table-width-unit: Pct/Dxa/Nil/Auto. Standardmässig wird Pct genommen. Dxa steht für die Twip-Angabe.
Das Attribut kann auf <table>-Elemente angewendet werden
Pct is selected by default. Dxa stands for the twip specification.
- The attribute can be applied to <table> elements.
data-oo-table-layout: Fixed/AutoFit. Standardmässig wird Fixed genommen. Bei AutoFit wird bei überlangen Spalten die jeweilige Spalte vergrössert.
Das Attribut kann auf <table>-Elemente angewendet werden
Fixed is selected by default. With AutoFit, the respective column is enlarged in the case of overlong columns.
- The attribute can be applied to <table> elements.
data-oo-table-columns: definiert die Breite der jeweiligen Spalten innerhalb einer Tabelle in Prozent oder als cm-Angaben.
Das Attribut kann auf <table>-Elemente angewendet werden.

Die Werte sind kommasepariert, jeweils pro Spalte, anzugeben

defines the width of the respective columns within a table in percent or as cm values.

The attribute can be applied to <table> elements.
The values are to be specified comma-separated, in each case per column.

data-oo-table-look-*: Durch diese Attribut kann die Word-Tabelle genauer spezifiziert werden, z. B. ob eine Ergebniszeile sichtbar ist oder nicht. Die Eigenschaften decken sich mit den TableLook-Properties vom Through this attribute the Word table can be specified more precisely, e. g. whether a result row is visible or not. The properties are the same as the TableLook-Properties from the OpenXML SDK.
data-oo-table-look-firstRow: True/False - Überschrift: Besondere Formatierung für die erste Zeile anzeigenHeadline: Show special formatting for the first line.
data-oo-table-look-lastRow: True/False - Ergebniszeile: Besondere Formatierung für die letzte Zeile anzeigenResults row: Show special formatting for the last line.
data-oo-table-look-firstColumn: True/False - Erste Spalte: Besondere Formatierung für die erste Spalte anzeigenFirst column: Show special formatting for the first column.
data-oo-table-look-lastColumn: True/False - Letzte Spalte: Besondere Formatierung für die letzte Spalte anzeigenLast column: Show special formatting for the last column.
data-oo-table-look-noHBand: True/False - Gebänderte Zeilen: Besondere Formatierung für gerade bzw. ungerade Zeilen anzeigen.Banded lines: Show special formatting for even or odd rows.
data-oo-table-look-noVBand: True/False - Gebänderte Spalten: Besondere Formatierung für gerade bzw. ungerade Spalten anzeigen.Banded columns: Show special formatting for even or odd columns.

Info
HINWEIS Prozent-Angaben oder NOTE Percentages or absolute cm oder or dxa (Twipstwips) -Angabenvalues: Prozentangaben können in Zusammenhang mit dem ConvertToPdf-Befehl zu inkorrekt dargestellten Dokumenten führen. Werden absolute Angaben verwendet, steht AutoFit nicht zur Verfügung.

Input-Control-Elemente

Bestimmte HTML-Input Controls können auch in das jeweilige Open XML "Custom-Control" umgewandelt werden.

...

Percentages can lead to incorrectly displayed documents in connection with the ConvertToPdf command. If absolute specifications are used, AutoFit is not available.

...

Input control elements

Certain HTML input controls can also be converted to the respective Open XML "custom control".

Elements:

<input type="checkbox" >
- Das The "checked" Attribut wird ausgewertetattribute is evaluated.
<input type="datetime" >
- Das The "value" Attribut wird ausgewertetattribute is evaluated.
<input type="text" >
- Das The "value" Attribut wird ausgewertetattribute is evaluated.
<textarea >
- Der Textinhalt wird ausgewertet.

Diese Controls können sowohl einzeln auch auch im normalen Textfluss stehen.

Listen-Elemente

HTML Listen können ebenfalls umgewandelt werden, jedoch werden diese nur mit minimalen Style-Angaben versehen, falls man keinen expliziten Style angibt.

Elemente:

<ul> - ohne Style-Angabe als Bullet-List dargestellt.
<ol> - ohne Style-Angabe als Numeric-List dargestellt.
<li> - innerhalb von <ul> oder <ol>
Alle Typographie-Elemente, Bilder und Input-Controls innerhalb eines <li>
Verschachtelte Listen, wobei der 'Numbering'-Style der Hauptliste beibehalten wird, innerhalb eines <li>

Hinweis zu Word-Listen und Absatz-Styles:

Listen werden im Word über zwei verschiedene Arten von "Word-Formatvorlagen", also von Styles, gesteuert. Es gibt "Listentypen", welche die Einrückung, Zeichen und Nummerierung steuern (z. B. die Zahlen 1. und 1.1 und 1.1.1). Diesem Listentyp kann ein anderer Style angehängt werden, der sich auf den eigentlichen Text neben der Nummerierungsangabe auswirkt. Damit primedocs die HTML-Liste entsprechend richtig konvertieren kann, sollte folgendes Vorgehen eingehalten werden:

Pro "Haupt"-'<ul>' bzw. '<ol>' sollte ein Listentyp definiert werden. Dieser Listentyp sollte mit einem Style (z. . "ListText") verbunden werden. Im Connect gibt man immer nur den Namen des eigentlichen Style (z. B. wie oben "ListText") an – der Listentyp ist indirekt verknüpft. Aktuell ist es erforderlich auf jeder neuen "<ul>" bzw. "<ol>" Ebene den Style anzugeben. Man kann auch verschiedene Styles verwenden. Ohne Angabe nutzt Word den Standardabsatz-Style.

Zusammenfassung:

Man kann beliebig viele Styles erstellen um den Text in einer Liste zu formatieren. Das muss jeweils auf jeder Ebene angegeben werden. Man muss einen Listentyp erstellen, welcher mit dem "primären" Style verbunden ist. Dieser Listentyp steuert die Nummerierung, Einrückungen etc.

...

- The text content is evaluated.

These controls can be placed individually as well as in the normal text flow.

...

List elements

HTML lists can also be converted, but they will only be provided with minimal style specifications if no explicit style is specified.

Elements:

<ul> - displayed as a bullet list without style specification.
<ol> - without style specification displayed as numeric list
<li> - within <ul> or <ol>
All typography elements, images and input controls inside a <li>.
Nested lists, keeping the 'numbering' style of the main list, within a <li>

Note on Word lists and paragraph styles:

Lists are controlled in Word by two different types of "Word styles", i.e. styles. There are "list types" which control indentation, characters and numbering (e.g. the numbers 1. and 1.1 and 1.1.1). This list type can have a different style attached to it, which affects the actual text next to the numbering specification. In order for primedocs to convert the HTML list correctly, the following procedure should be followed:

For each "main" '<ul>' resp. '<ol>' one list type should be defined. This list type should be connected with a style (e.g. "ListText"). In the connect only the name of the actual style (e.g. as above "ListText") is specified – the list type is indirectly linked. Currently it is necessary to specify the style on each new "<ul>" resp. "<ol>" layer. It is also possible to use different styles. Without specification Word uses the default paragraph style.

Summary:

You can create any number of styles to format the text in a list. This must be specified at each level. A list type which is associated with the "primary" style must be created. This list type controls the numbering, indentations, etc.

...

Example

Code Block

language	xml

<Snippet bookmark="_OneOffixxOpenAt" type="Html" parser="primedocs">
<![CDATA[
  <p>HTML FragmenteFragments...</p>
  <p></p>
  <ul data-oo-style="CorpList">
    <li>Element eins<one</li>
    <li>
      <ul data-oo-style="CorpList">
        <li>Unter<li>Below Element<element</li>
      </ul>
    </li>
  </ul>
  <p data-oo-style="Highlight">Text</p>
  <p>
    <u>
      <em>
        <strong>fett<strong>bold, kursivitalic and unterstrichen <underlined</strong>
      </em>
    </u> oderor ohne<without</p>
  <p>Table with cm-Values:</p>
  <table data-oo-style="ListTable3Accent5" data-oo-table-columns="2cm,10cm" width="100%">
    <tr>
      <td>erste<td>first Spalte<column</td>
      <td>zweite<td>second Spalte<column</td>
    </tr>
    <tr>
      <td>foo</td>
      <td>bar</td>
    </tr>
    <tr>
      <td>foo</td>
      <td>bar</td>
    </tr>
  </table>
  <p>Table with Pct:</p>
  <table data-oo-style="ListTable3Accent5" data-oo-table-width="70" data-oo-table-columns="20,80" width="100%">
    <tr>
      <td>erste<td>first Spalte<column</td>
      <td>zweite<td>second Spalte<column</td>
    </tr>
    <tr>
      <td>foo</td>
      <td>bar</td>
    </tr>
    <tr>
      <td>foo</td>
      <td>bar</td>
    </tr>
  </table>
  <img data-oo-image-title="Test-TitelTitle" data-oo-image-desc="Test-Beschreibung description" data-oo-image-width="50" data-oo-image-sizeunit="px" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAYdEVYdFNvZnR3YXJlAHBhaW50Lm5ldCA0LjAuOWwzfk4AAAAWSURBVBhXY/gvwFD734Lhv9r//491ASz+Bve3zck6AAAAAElFTkSuQmCC" />
  <p>
    <span>Letzer<span>Last...</span>
  </p>
]]>
</Snippet>

...

External "Office HTML"

...

snippets

When submitting HTML content, the "type" Html anzugeben. Es können generell alle von Microsoft Office zugelassenen HTML Inhalte übermittelt werdenmust be specified. In general, all HTML content permitted by Microsoft Office can be submitted.

Warning
ACHTUNGCAUTION Microsoft Office selbst erkennt im begrenzten Umfang selbst HTML-Elemente und kann diese mit der passenden Formatierung in Word integrieren. Es wird allerdings empfohlen auf den primedocs HTML Parser zu verwenden, um Styling-Informationen zu erhalten.

...

recognizes HTML elements to a limited extent and can integrate them into Word with the appropriate formatting. However, it is recommended to use the primedocs HTML Parser to get styling information.

Simple texts:

Code Block

language	xml

    <Snippet bookmark="_OneOffixxOpenAt" type="Html">
       <![CDATA[
               <p>Demo</p>
  
    ]]>

   </Snippet>

Texte Texts in definiertem defined Word -Stylestyle:

Überschriften wie Headings like H1-H4 sowie die normalen Formatierungen (bspw. fett as well as the normal formatting (e.g. bold resp. <strong>) werden automatisch in den entsprechenden Überschriftenstyle (bspware automatically displayed in the corresponding heading style (e.g. <h1> = Überschrift1Heading1) dargestellt.

Code Block

language	xml

    <Snippet bookmark="_OneOffixxOpenAt" type="Html">
      <![CDATA[
      <h1>Grosser Titel<<h1>Large title</h1>
      <strong>fetter Text<<strong>bold text</strong>
      ]]>
    </Snippet>

Texte können durch die Angabe von Texts can be assigned to a specific Word style by specifying "mso-style-name:" einem bestimmten Word-Style zugeordnet werden.

Code Block

language	xml

    <Snippet bookmark="_OneOffixxOpenAt" type="Html">
      <![CDATA[
  [
     <p style="mso-style-name:oneoffixxStyleName">Demo</p>
   
  ]]>
    </Snippet>

TabellenTables:Als

HTML können auch Tabellen übermittelt werdenTables can also be transmitted as HTML.

Code Block

language	xml

    <Snippet bookmark="_OneOffixxOpenAt" type="Html">
      <![CDATA[
          <table width="100%">
              <tr>
                <td>erste Spalte</td>
 
              <td>zweite Spalte</td>
              </tr>
  
       </table>
      ]]>
   
</Snippet>

BilderImages:

Bilder können als Data-URI übermittelt werdenImages can be transmitted as Data URI.

Code Block

language	xml

    <Snippet bookmark="_OneOffixxOpenAt" type="Html">
      <![CDATA[
          <img src="data:image/png;base64,..."

     ]]>
    </Snippet>

...

External "FlatOPC"

...

snippets

Snippets in Flat OPC format can also be accepted. However, no styles or numberings are accepted, but only the body part. This option should only be used in exceptional cases, since the primedocs HTML Parser can handle style information and is therefore the better choice.

Code Block

language	xml

    <Snippet bookmark="_OneOffixxOpenAt" type="OpenXml">
 
    <![CDATA[
        <?mso-application progid="Word.Document"?>
  
     <pkg:package xmlns:pkg="http://schemas.microsoft.com/office/2006/xmlPackage">
        ...
   
    </pkg:package>
      ]]>
   
</Snippet>

Versions Compared

Old Version 1

New Version Current

Key

Schnellbausteine

Quick parts

primedocs

snippets

Externe "Text"-Textbausteine

External "Text" snippets

External "HTML"

Grundaufbau

snippets

Basic structure

primedocs

attributes

Typographie-Elemente

Typography elements

Bild-Elemente

Image elements

Tabellen-Elemente

Table elements

Input-Control-Elemente

Input control elements

Listen-Elemente

List elements

Example

External "Office HTML"

snippets

External "FlatOPC"

snippets

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Schnellbausteine

Quick parts

primedocs

snippets

Externe "Text"-Textbausteine

External "Text" snippets

External "HTML"

Grundaufbau

snippets

Basic structure

primedocs

attributes

Typographie-Elemente

Typography elements

Bild-Elemente

Image elements

Tabellen-Elemente

Table elements

Input-Control-Elemente

Input control elements

Listen-Elemente

List elements

Example

External "Office HTML"

snippets

External "FlatOPC"

snippets