Versandmanager (Successor Documents)

Diese Dokumentfunktion (intern Dispatch Manager) aktiviert die Versandverwaltung für Folgedokumente, die aus einem primären Dokument abgeleitet werden – beispielsweise Adressetiketten, Beilagen oder Begleitschreiben. Die Folgedokumente werden pro Objekt (z.B. pro Empfänger) erzeugt und über definierte Ziele und Aktionen weiterverarbeitet.

Grundaufbau

<SuccessorDocumentConfiguration>
  <DistributeByObject>
    <Targets>
      <Target Name="Etikett" Label="Adressetikett" Icon="Tag">
        <TagFilter>
          <Tag>label</Tag>
        </TagFilter>
        <Code>
          function main() { return $("RecipientId"); }
        </Code>
      </Target>
    </Targets>
    <Actions>
      <PrintAction Enabled="true">
        <Default TargetName="Etikett" Printer="LabelPrinter" Tray="Tray2" />
      </PrintAction>
      <GenerateAction Enabled="true" />
    </Actions>
  </DistributeByObject>
</SuccessorDocumentConfiguration>

DistributeByObject

Steuert die Verteilung der Folgedokumente pro Objekt und enthält die beiden Bereiche Targets (welche Folgedokumente) und Actions (was damit geschieht).

Targets

Definiert die möglichen Ziele (Folgedokument-Typen).

Element / Attribut	Pflicht	Beschreibung
Target	–	Ein einzelnes Ziel. Mehrere Ziele sind möglich.
Target/@Name	ja	Eindeutiger Bezeichner des Ziels; wird in den Aktionen über TargetName referenziert.
Target/@Label / @translate-Label	optional	Anzeigename bzw. Übersetzungsschlüssel des Ziels.
Target/@Icon	optional	Symbol für die Oberfläche.
Target/TagFilter/Tag	optional	Schränkt das Ziel auf Vorlagen mit den angegebenen Tags ein. Mehrere Tag-Einträge möglich.
Target/Code	ja	JavaScript, das den Wert für die Verteilung pro Objekt liefert.
GlobalTargets/@Key	optional	Referenz auf eine globale Ziel-Definition statt eines inline definierten Target.

Actions

Definiert, was mit den erzeugten Folgedokumenten geschieht.

Element / Attribut	Beschreibung
PrintAction/@Enabled	Aktiviert die Druckaktion (Standard: true).
PrintAction/Default/@TargetName	Referenziert das zu druckende Target über dessen Name.
PrintAction/Default/@Printer / @Tray	Optionaler Drucker bzw. Papierfach.
GenerateAction/@Enabled	Aktiviert die Generierungsaktion (Standard: true).
GlobalActions/@Key	Referenz auf eine globale Aktions-Definition.

hinweis

Ziele und Aktionen lassen sich über GlobalTargets bzw. GlobalActions als Globale Konfiguration zentral pflegen und über mehrere Vorlagen wiederverwenden.