PrintPostExecutor
Der PrintPostExecutor ermöglicht den Zugriff auf in Lobster Data Platform / Orchestration angelegte Druckdokumente per Profil. Diese werden mit den zur "Nachbehandlung" anliegenden Daten interpretiert, um ein bestimmtes Ausgabeformat zu erzeugen.
Typischerweise liegen die zu interpretierenden Daten als Druck-XML vor, repräsentieren also ein Print-Objekt, in dem u. a. die Daten einer oder mehrere Entitäten enthalten sind. Druckdokumente erwarten in der Regel auf Inhalte in diesem Format, die über XPath-Ausdrücke "ausgelesen" werden. Das Prinzip entspricht insofern dem interaktiven "Drucken" für Übersichten und Erfassungsmasken ausgewählte Entitäten über die Ribbon-Makros der Hauptkategorie "Export" (s. a. Verfügbare Befehle, "Druck").
Im interaktiven Prozess werden je Drucktyp anwendbare Druckdokumente abhängig von Zuordnungskriterien und nach dem all-matching-Prinzip ermittelt und entweder automatisch zugeordnet oder zur interaktiven Auswahl angeboten. Im Unterschied dazu erwartet der PrintPostExecutor, dass das zu verwendende Druckdokument anhand seiner ID (id) eindeutig identifiziert wird. Als weitere Parameter werden der Drucktyp und Anmeldedaten für Lobster Data Platform / Orchestration (als Integration Login) erwartet (Details s. u.).
Der PrintPostExecutor kann innerhalb eines Profils in Phase 5 (für die Ausgabedaten einer "Integration Unit") und Phase 6 (für die Ausgabedaten eines Antwortwegs) konfiguriert werden.
Geeignete Parameter müsse jeweils entweder direkt als Parameterliste oder in einer per Dateipfad identifizierten Properties-Datei im Feld Konfigurationsdatei bereitgestellt werden (s. Beispiele).
Parameter
Property |
Parameter |
Beschreibung |
Hinweis |
Print Document ID |
1 |
interne ID des Druckdokuments in Lobster Data Platform / Orchestration |
|
Print Type |
2 |
interner Name für den Drucktyp (PDF, RTF, DOCX, XLSX, TXT, HTML, ZPL) |
Der gewählte Drucktyp muss zum Druckdokumenttyp des per Parameter 1 spezifizierten Druckdokuments passen. |
Scm Login |
3 |
Integration Login im XML-Format (LobsterDataLoginRequest-Objekt) Die Funktion Create Login Request (Integration-Funktion) kann verwendet werden, um eine geeignete Struktur zu erzeugen. |
►HINWEIS◄ Die interaktive Verfügbarkeit von Druckdokumenten (aufgrund von Zuordnungskriterien) ist für den direkten Zugriff per PrintPostExecutor nicht ausschlaggebend. Die Auswahl einer Rolle ohne Beachtung von Besitzereinschränkungen ("Super user") gewährleistet den Zugriff auf sämtliche Druckdokumente, ohne dass Firmenfreigaben oder Besitzer-Zuordnungen angepasst werden müssten. |
Beispiel: < base :LobsterDataLoginRequest xmlns:base = "SCM.BASE" userName = "admin" selectedRole = "1" selectedCompany = "1" /> |
Beispiele
Die folgenden Beispiele zeigen Beispiele für die Übergabe derselben Parameter als Parameterliste und als Properties-Datei:
Beispiel 1: Parameterliste in Phase 5 (z. B. für eine XMLNoTemplateUnit):
Beispiel 2: Pfad zu einer Properties-Datei (mit denselben Parameterwerten, s. u.) in Phase 6:
./conf/demo/postPrint_101_TXT_varLOGIN.properties# PARAMETERS 'Print Document ID', 'Print Type', 'Scm Login'
# ==========================================================
# Blanks in parameter names MUST be escaped by backslash '\'
# ==========================================================
#
Print\ Document\ ID=101
Print\ Type=TXT
Scm\ Login=@var__LOGIN_REQUEST@
Wie die Beispiele verdeutlichen, können für die Parametrierung in beiden Fällen Verweise auf Profil-Variablen (im Format @VARIABLENNAME@) eingesetzt werden.