Diese Dokumentfunktion wird benötigt, um den Umgang mit Adressdeckblättern (in der Regel Adressdeckblätter und Briefumschläge) zu konfigurieren.

Dabei hat die Dokumentfunktion zwei Funktionen:

Konfiguration von Vorlagen des Typs "Adressdeckblatt".
Konfiguration der Möglichkeiten, wie aus dem generierten Dokument im Word über den Briefumschlag-Button im Ribbon ein Adressdeckblatt erstellt werden kann.

Konfiguration

Bei Vorlagen des Typs "Adressdeckblatt" ist das Anhängen dieser Dokumentfunktion Pflicht. Zusätzlich muss vor dieser Dokumentfunktion unbedingt die Dokumentfunktion Empfängeradresse angehängt sein.

<?xml version="1.0"?>
<AddressCoverConfiguration>

  <!-- Beispielkonfiguration Adressdeckblattvorlage -->
  <AddressCoverTemplate>

    <!-- Konfiguration für Vorschau -->
    <RecipientPreview>
      <DataNode id="CustomElements.Recipient.AddressCover" />
    </RecipientPreview>

    <!-- Scripts für Data Binding -->
    <Script>
      <CustomDataNode id="Recipient.AddressCover" type="Text">
        <Line>
          <Element id="Recipient.Selected.Transmission" />
        </Line>
        <Line>
          <Element id="Person.Anschrift" />
        </Line>
      </CustomDataNode>
    </Script>
    
  </AddressCoverTemplate>


  <!-- Beispielkonfiguration Adressdeckblattdialog -->
  <AddressCoverDialog>

    <!-- Erlaubte Vorlagen -->
    <LabelTemplates>
      <Template id="18e4a599-3d93-41a3-a289-39fe5263eab5" /> <!-- Briefumschlag  C5 rechts (Standard) -->
      <Template id="4049d9de-ac64-4441-bec9-f342b3dc15b6" /> <!-- Briefumschlag  C5 links -->
      <Template id="84f1d9e1-e6dd-4c2a-864b-67bda8216e2e" /> <!-- Briefumschlag  C4 -->
      <Template id="1948dcff-288d-466a-9598-9a33c16f87de" /> <!-- Briefumschlag  C6 -->
      <Template id="bc498318-387a-4792-aa76-d50331a70c74" /> <!-- Briefumschlag  C65 -->
      <Template id="5aadd902-d86d-4e4c-b6ab-b944190309e7" /> <!-- Briefumschlag  B4 -->
      <Template id="89cd2dce-1fb2-4631-8135-338db1497a22" /> <!-- Briefumschlag  B5 -->
      <Template id="0bcb7ff8-4d54-425e-a48d-2edc9aea3fb3" /> <!-- Briefumschlag  B6 -->
      <Template id="24886fd2-01a9-49a2-80e9-2a920e6392d3" /> <!-- Adressdeckblatt A4 -->
    </LabelTemplates>

    <!-- Salutation configuration -->
    {[Recipients.SalutationConfiguration]}

    <!-- Shipping method configuration -->
    {[Recipients.ShippingMethodConfiguration]}

  </AddressCoverDialog>

</AddressCoverConfiguration>

In diesem Fall ist nur der Teil zwischen <AddressCoverTemplate> und </AddressCoverTemplate> relevant.

Empfänger-Vorschau

Zwischen <RecipientPreview> und </RecipientPreview> kann der anzuzeigende Text für die Vorschau konfiguriert werden:

<RecipientPreview>
  <DataNode id="CustomElements.Recipient.AddressCover" />
</RecipientPreview>

Dabei muss die Id des Textes angegeben werden. In der Regel bleibt diese so wie oben.

Skripte

Zwischen <Script> und </Script> können Skripte definiert werden, die schlussendlich pro Empfänger generiert werden. Wenn also z. B. mit <Element id="Contact.Recipient.Selected.Person.FirstName" /> auf den Vornamen verwiesen wird, wird beim ersten Adressdeckblatt der Vorname des ersten Empfängers und beim zweiten Adressdeckblatt der Vorname des zweiten Empfängers verwendet. Dieses Muster zieht sich durch alle gewählten Empfänger durch.

Standardmässig sieht das Skript folgendermassen aus:

<Script>
  <CustomDataNode id="Recipient.AddressCover" type="Text">
    <Line>
      <Element id="Recipient.Selected.Transmission" />
    </Line>
    <Line>
      <Element id="Person.Anschrift" />
    </Line>
  </CustomDataNode>
</Script>

Verknüpfung

Wird die Dokumentfunktion an eine Word-Vorlage angehängt, bewirkt die Dokumentfunktion, dass ein Adressdeckblatt oder Briefumschlag mit dem aktuell gewählten Empfänger mittels Briefumschlag-Button im primedocs-Ribbon ausgegeben wird:

Der Dialog, der beim Klick auf den Briefumschlag-Button im Ribbon erscheint, sieht so aus:

Verfügbare Adressdeckblatt-Vorlagen:

Diese werden zwischen <LabelTemplates> und </LabelTemplates> definiert. Hier eine Beispielkonfiguration:

<LabelTemplates>
  <Template id="18e4a599-3d93-41a3-a289-39fe5263eab5" /> <!-- Briefumschlag C5 rechts (Standard) -->
  <Template id="4049d9de-ac64-4441-bec9-f342b3dc15b6" /> <!-- Briefumschlag C5 links -->
  <Template id="1948dcff-288d-466a-9598-9a33c16f87de" /> <!-- Briefumschlag C6 -->
  <Template id="24886fd2-01a9-49a2-80e9-2a920e6392d3" /> <!-- Adressdeckblatt A4 -->
</LabelTemplates>

Das bedeutet nun, dass beim Aufruf des Briefumschlag-Dialoges zwischen diesen vier Vorlagen ausgewählt werden kann. Bei der Id handelt es sich um die Vorlagen-Id, nicht um die Versions-Id der Vorlage. Im Dialog sieht das dann unten rechts so aus:

Anrede und Versandart:

Zusätzlich müssen Anrede und Versandart konfiguriert sein. Diese Konfiguration sollte analog derjenigen in der Dokumentfunktion "Empfängeradresse" aussehen. In der Regel werden hier mit den folgenden zwei Zeilen die Anrede- und Versandart-Konfiguration mit den Globalen Konfigurationen verknüpft:

<!-- Anrede-Konfigurationen -->
{[Recipients.SalutationConfiguration]}

<!-- Versandart-Konfigurationen -->
{[Recipients.ShippingMethodConfiguration]}

Mehr Informationen zu den Anrede- und Versandart-Konfigurationen finden Sie unter der Dokumentfunktion Empfängeradresse.