PrintPostExecutor

Der PrintPostExecutor ermöglicht Lobster_data den Zugriff auf in Lobster Data Platform / Orchestration angelegte Druckdokumente. 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 core: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 Ribbonmakros 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 Lobster_data Login) erwartet (Details s. u.).

Der PrintPostExecutor kann innerhalb eines Lobster_data-Profils in Phase 5 (für die Ausgabedaten einer "Integration Unit") und Phase 6 (für die Ausgabedaten eines Anwortwegs) 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

Lobster_data Login im XML-Format (LobsterDataLoginRequest-Objekt)

Die Funktion Lobster_pro: Create Login Request (_data-Funktion) kann verwendet werden, um eine geeignete Struktur zu erzeugen.

  • Für die in den Anmeldedaten gewählte Firma muss Lesezugriff auf das per Parameter 1 spezifizierte Druckdokument bestehen.

  • Die in den Anmeldedaten gewählte Rolle ist nur hinsichtlich der "Besitzereinschränkungen" relevant.

  • Anderweitige Rollenrechte ("Drucken", "Druckdokumente") sind nicht relevant.

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):

    images/download/attachments/62853220/image2020-11-2_19-17-33-version-1-modificationdate-1604411861342-api-v2.png



  • Beispiel 2: Pfad zu einer Properties-Datei (mit denselben Parameterwerten, s. u.) in Phase 6:

    images/download/attachments/62853220/image2020-11-2_18-6-46-version-1-modificationdate-1604411861370-api-v2.png

    ./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.