Spezielle Auszeichnungs-Tags in Html zur Steuerung der Docx-Ausgabe

Soll ein generierter Html-Output in ein Word-Dokument konvertiert werden, dann sind die Möglichkeiten zur Ausgabensteuerung in Docx begrenzt.

Um z.B. Header und Footer im Docx korrekt zu erstellen, haben wir zusätzliche Html-Tags eingeführt. Nachfolgend finden Sie eine Auflistung aller Zusatz-Tags.

documentHeaderFirst

Der Inhalt dieses Tags wird als Html interpretiert und als Header auf der ersten Seite des Docx-Dokumentes ausgegeben.

documentHeaderPrimaryOrOdd

Header für alle außer der ersten Seite

documentHeaderEven

Header für Seiten mit gerader Seitennummer, wenn definiert, ist documentHeaderPrimaryOrOdd nur noch für die ungeraden Seiten zuständig.

documentFooterFirst

Footer für die erste Seite des Docx-Dokumentes

documentFooterPrimaryOrOdd

Footer für alle außer der ersten Seite

documentFooterEven

Footer für gerade Seiten, wenn definiert, ist documentFooterPrimaryOrOdd nur noch für die ungeraden Seiten zuständig.

Beispiel:

    <documentFooterFirst>
        <div class="footer">
            <left>Seite {PAGE} von {NUMPAGES}<left>
        </div>
    </documentFooterFirst>

documentBody

Der Hauptinhalt des Docx-Dokumentes, welcher je nach Länge auf die resultierende Anzahl von Docx-Seiten umgebrochen wird.

documentShape

Kann nur innerhalb eines documentHeader... oder documentFooter... definiert werden! Mit diesem Tag kann man einen Textblock innerhalb der Seite definieren, der absolut positioniert wird aber von der Sichtbarkeit an den Header/Footer gekoppelt ist, in dessen Kontext er definiert ist. Hinweis: Der Textblock muss NICHT im Bereich des Headers/Footers liegen sondern kann überall auf der Seite positioniert werden.

Argumente

x - X-Position in der Seite (Standard: 0) y - Y-Position in der Seite (Standard: 0) width - Breite des Textblocks (Standard: 100) height - Höhe des Textblocks (Standard: 100)

Technisch wird hier ein Textblock als Docx-Shape, erstellt im Kontext des entsprechenden Headers, angelegt.

Der Text des documentBody umfließt diesen Block.

Beispiel:

    <documentHeaderFirst>
        <documentShape x="1850" y="500" width="550" height="3000">
            <p  document_softbreaks="1">
                Bearbeitet von
                <b>{{BO.Me.RealName}}</b>

                Durchwahl (Vorwahl) Amtsnr.
                <b>{{BO.Me.TelephoneNumber}}</b>

                E-Mail
                <b>{{BO.Me.EMailAddress}}</b>

                Ihr Zeichen, Ihre Nachricht vom
                <b>{{BO.Inq.InquiryState?.Eingereicht | date.to_string '%d.%m.%Y' ?? "unbekannt"}}</b>

                Mein Zeichen (Bei Antwort angeben)
                <b>{{BO.Inq.PiBOID}}</b>

                Datum
                <b>{{$BriefkopfDatum | date.to_string '%d.%m.%Y'}}</b>
            </p>
        </documentShape>
    </documentHeaderFirst>

Verwendung findet dies z.B. wenn eine Seitenleiste mit Informationen nicht im Header oder Footer sondern am linken oder rechten Rand der Seite angezeigt werden soll.