Kurzbeschreibung

Das XML-Element <Signatur> gibt die im System hinterlegte Unterschrift eines Benutzers als Bild aus.

Welche Signatur verwendet wird, richtet sich nach der angegebenen Quelle und der Konfiguration des Empfänger-Mappings im Datacenter.

Einordnung

Bereich: Inhalte

Schwierigkeitsgrad: ⭐⭐⭐☆☆

Vorkenntnisse: Block · Content · Variable

Siehe auch

• Variable
• Block
• Empfänger-Mapping

Zweck

Mit <Signatur> kann eine hinterlegte Unterschrift automatisch in ein Dokument eingefügt werden.

Dadurch lassen sich beispielsweise

• Serienbriefe,
• Bescheide,
• Anschreiben oder
• andere Dokumente

mit der passenden Unterschrift des zuständigen oder des erstellenden Mitarbeiters versehen.

Die Unterschrift wird dabei als Bild in das Dokument eingefügt.

Position innerhalb der Dokumentvorlage

Da <Signatur> einen sichtbaren Inhalt erzeugt, wird das XML-Element innerhalb eines <Content> verwendet.

<Block>

    <Content>

        <Signatur
            Quelle="user"
            Width="1800000"
            Height="700000">
        </Signatur>

    </Content>

</Block>

Attribute

Weitere Attribute können je nach Version des Developers vorhanden sein.

Quelle

Das Attribut Quelle bestimmt, wessen Unterschrift ausgegeben wird.

Hierbei wird nicht direkt auf einen Benutzer, sondern auf den entsprechenden technischen Benutzer verwiesen.

Welcher technische Benutzer verwendet wird, wird über das Empfänger-Mapping im Datacenter festgelegt.

Zur Verfügung stehen derzeit folgende Werte:

Wichtig

Die tatsächliche Zuordnung erfolgt über das Empfänger-Mapping im Datacenter.

<Signatur> verweist nicht direkt auf einen Benutzer, sondern auf den dort konfigurierten technischen Benutzer.

FormattingType

Mit FormattingType wird festgelegt, wie die Signatur innerhalb des Dokumentlayouts dargestellt wird.

In den meisten Dokumenten wird die Standarddarstellung (Normal) verwendet.

Width und Height

Mit Width und Height wird die Größe der ausgegebenen Signatur festgelegt.

Die Werte werden – wie bei anderen Bildelementen – in EMU (English Metric Units) angegeben.

Orientierungshilfe

Die Umrechnung erfolgt nach folgender Formel:

Zentimeter × 360000 = EMU

Hinweis

Die tatsächliche Größe sollte immer anhand der Dokumentvorschau beziehungsweise eines erzeugten Testdokuments geprüft werden.

Qualität der Signatur

Die Qualität der ausgegebenen Signatur hängt unmittelbar von der Qualität der hinterlegten Bilddatei ab.

Bereits bei der Erstellung des Unterschrift-Scans sollte deshalb auf

• eine ausreichende Auflösung,
• eine saubere Freistellung,
• eine passende Bildgröße und
• eine gute Lesbarkeit

geachtet werden.

Als Bildformat wird PNG empfohlen.

PNG unterstützt transparente Hintergründe und eignet sich daher besonders für die Darstellung von Unterschriften.

Verhalten bei fehlender Signatur

Ist für den ausgewählten Benutzer keine Signatur hinterlegt, wird kein Bild ausgegeben.

Der für die Signatur vorgesehene Bereich bleibt in diesem Fall leer.

Es erfolgt keine automatische Ersatzdarstellung.

Developer-Tipp

Prüfen Sie insbesondere bei neuen Benutzern oder Testsystemen, ob eine passende Signatur im System hinterlegt wurde.

Typische Einsatzgebiete

<Signatur> wird häufig verwendet für:

• Anschreiben,
• Bescheide,
• Serienbriefe,
• Genehmigungen,
• Schreiben mit persönlicher Unterschrift.

Best Practices

• Möglichst PNG-Dateien verwenden.
• Auf eine ausreichende Bildqualität achten.
• Die Bildgröße über Width und Height an das Dokumentlayout anpassen.
• Die Dokumentvorschau nach Änderungen an der Signatur prüfen.
• Die Zuordnung der Benutzer über das Empfänger-Mapping dokumentieren.

XML-Wissen

Die Signatur wird während der Dokumenterzeugung anhand des konfigurierten technischen Benutzers ermittelt.

Das XML-Element enthält daher selbst keine Informationen über den eigentlichen Dateinamen oder Speicherort der Bilddatei.

Diese Zuordnung erfolgt vollständig über die Systemkonfiguration.

Typische Fehler

Falsche Quelle gewählt

Wird Quelle="user" verwendet, obwohl die Signatur des erstellenden Mitarbeiters ausgegeben werden soll, erscheint die falsche Unterschrift.

Keine Signatur hinterlegt

Ist für den ausgewählten Benutzer keine Signatur vorhanden, bleibt der vorgesehene Bereich leer.

Zu kleine oder zu große Darstellung

Eine ungeeignete Kombination aus Width, Height und der Größe der hinterlegten Bilddatei kann zu einer unscharfen oder verzerrten Darstellung führen.

Ungeeignetes Bildformat

Bilder mit farbigem Hintergrund oder geringer Auflösung wirken im Dokument häufig unprofessionell.

Für Unterschriften wird deshalb das Bildformat PNG empfohlen.