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.

Der Versandmanager-Dialog: pro Empfänger ein Ziel (z.B. Etiketten), verarbeitet über die Aktionen im unteren Bereich.

Funktionsweise

Die Verteilung iteriert über die vom Benutzer ausgewählten Objekte einer ObjectCollection. Für jedes ausgewählte Objekt wird der Code des zugehörigen Target ausgewertet. Dieser Code liefert die Feld-Mappings (Forms- bzw. Datenfeldwerte) für das jeweilige Folgedokument – also die Werte, mit denen die Ziel-Vorlage befüllt wird. Anschliessend wird pro Objekt ein Folgedokument generiert; die Ergebnisse eines Ziels werden zu einem PDF zusammengeführt.

Ausgelöst wird der Vorgang über die Aktionen (Actions): GenerateAction blendet im Versandmanager-Dialog (WPF) die Schaltfläche «Vorbereiten» ein, PrintAction die Schaltfläche «Drucken».

Über PrintAction lässt sich pro Ziel ein Drucker festlegen — «Drucken» öffnet die Druckerwahl je Versanddokument-Typ.

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 und die Schaltfläche «Drucken» im Versandmanager-Dialog (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 und die Schaltfläche «Vorbereiten» im Versandmanager-Dialog (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.