Starten Sie Document Services-APIs aus dem AEM-Arbeitsablauf

Letzte Aktualisierung: 2023-05-04
  • Erstellt für:
  • User
VORSICHT

AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Assembler

AEM Forms bietet benutzerdefinierte Workflows, um die folgenden Assembler Service-APIs aufzurufen:

  • invoke: Ruft Vorgänge auf, die in Eingabe-DDX für bereitgestellte Eingaben angegeben sind.
  • toPDFA: Konvertiert das Eingabedokument in PDF/A-PDF.

DDX-Workflow aufrufen

Der Workflow DDX aufrufen ruft die Assembler Service-API Invoke auf, mit der Sie Dokumente zusammenstellen oder aufteilen, ein Wasserzeichen zu einem PDF hinzufügen können usw.

  1. Ziehen Sie die DDX aufrufen Workflow-Schritt auf der Registerkarte "Forms Workflow"im Sidekick.
  2. Doppelklicken Sie auf den hinzugefügten Workflow-Schritt, um die Komponente zu bearbeiten.
  3. Konfigurieren Sie im Dialogfeld "Komponente bearbeiten"Eingabedokumente, Umgebungsoptionen und Ausgabedokumente und klicken Sie auf OK.

Input Documents

Der Workflow "Invoke DDX"erfordert die folgenden Eingabedokumente:

  • DDX: Es handelt sich um eine obligatorische Eingabe für den Workflow-Schritt "DDX aufrufen". Sie können sie angeben, indem Sie eine der folgenden Optionen aus der Dropdown-Liste "DDX-Eingabe"auswählen.

    • Relative To Payload: Die DDX-Eingabedatei ist relativ zum Payload-Ordner für das Arbeitsablaufelement.
    • Nutzlast verwenden: Die Payload für das Workflow-Element wird als DDX-Eingabedokument verwendet.
    • Absoluter Pfad: Der absolute Pfad zum DDX-Dokument im CRX-Repository.
  • Create Map from PayLoad: Ist diese Option ausgewählt, werden alle Dokumente im Payload-Ordner zur Zuordnung des Eingabedokuments für die invoke-API im Assembler hinzugefügt. Der Knotenname für jedes Dokument wird als Schlüssel in der Zuordnung verwendet.

  • Zuordnung des Eingabedokuments: Legt die Zuordnung des Eingabedokuments fest. Sie können beliebig viele Einträge hinzufügen, wobei jeder Eintrag den Schlüssel des Dokuments in der Zuordnung und die Quelle des Dokuments angibt.

Umgebungsoptionen

Auf der Registerkarte "Umgebungsoptionen"können Sie verschiedene Verarbeitungsoptionen für die invoke-API festlegen.

  • Job Log Level: Gibt die Protokollebene für die Verarbeitungsprotokolle an.

  • Validate Only: Prüft die Gültigkeit der Eingabe-DDX.

  • Fehler bei Fehler: Gibt an, ob der Aufruf des Assembler-Dienstes im Falle eines Fehlers fehlschlagen soll. Der Standardwert ist False.

Output Documents

Je nach Eingabe-DDX kann die invoke-API mehrere Ausgabedokumente erstellen. Auf der Registerkarte "Output Documents"können Sie auswählen, wo das Ausgabedokument gespeichert werden soll.

  1. Ausgabe in Payload speichern: Speichert Ausgabedokumente unter dem Payload-Ordner oder überschreibt die Payload, wenn die Payload eine Datei ist.

  2. Output Document's Map: Hiermit können Sie explizit angeben, wo jedes output document gespeichert werden soll, indem ein Eintrag pro output document hinzugefügt wird. Jeder Eintrag gibt das Dokument an und wo es gespeichert werden soll. Ein Output Document kann die Payload überschreiben oder im Payload-Ordner speichern. Dies ist nützlich, wenn es mehrere Output Documents gibt.

  3. Auftragsprotokoll: Gibt an, wo das Auftragsprotokolldokument gespeichert werden soll. Dies ist bei der Fehlerbehebung hilfreich.

In PDF/A-Workflow konvertieren

Die Option „Nach PDF/A konvertieren“ ruft die toPDFA-Assembler-Dienst-API auf. Sie wird zum Konvertieren von PDF-Dokumenten in PDF/A-kompatible Dokumente verwendet.

  1. Ziehen Sie ConvertToPDFA auf der Registerkarte „Forms Workflow“ in den Sidekick.

  2. Doppelklicken Sie auf den hinzugefügten Workflow-Schritt, um die Komponente zu bearbeiten.

  3. Konfigurieren Sie im Dialogfeld "Komponente bearbeiten"Eingabedokumente, Konvertierungsoptionen und Ausgabedokumente und klicken Sie auf OK.

Input Documents

Geben Sie die Quelle des Dokuments, das in ein PDF/A-kompatibles Dokument konvertiert werden soll, auf eine der folgenden Arten an.

  • Relativ zur Nutzlast: Das Eingabedokument ist relativ zum Payload-Ordner für das Workflow-Element.
  • Nutzlast verwenden: Die Payload für das Workflow-Element wird als Eingabedokument verwendet.
  • Absolute Path: Der absolute Pfad des Eingabedokuments im CRX-Repository.

Konvertierungsoptionen

Mit den Konvertierungsoptionen können Sie Optionen angeben, die den PDF/A-Konvertierungsprozess ändern.

  • Compliance : Gibt den PDF/A-Standard an, dem die Ausgabe-PDF/A entsprechen muss.

  • *Result Level *: Gibt die Protokollebene an, die für PDF/A-Konvertierungsprotokolle verwendet werden soll.

  • Signaturen : Gibt an, wie die Signaturen im Eingabedokument während der Konvertierung verarbeitet werden müssen.

  • Farbraum : Gibt den vordefinierten Farbraum an, der für das PDF/A-Ausgabedokument verwendet werden soll.

  • Konvertierung überprüfen: Gibt an, ob das konvertierte PDF/A-Dokument nach der Konvertierung auf PDF/A-Konformität geprüft werden soll.

  • Job Log Level: Gibt die Protokollebene, die für die Verarbeitung von Protokollen verwendet werden soll, an.

  • Metadata Extension Schema: Gibt den Pfad zum Metadaten-Erweiterungsschema, der für XMP-Eigenschaften in den Metadaten des PDF-Dokuments verwendet werden soll, an.

Output Documents

Auf der Registerkarte "Output Documents"können Sie das Ziel für die Ausgabedokumente angeben

  • PDFA-Dokument: Gibt den Speicherort an, an dem das konvertierte PDF/A-Dokument gespeichert wird. Es kann entweder das Payload-Dokument überschreiben oder im Payload-Ordner gespeichert werden.
  • Conversion Log: Gibt den Ort an, an dem die Konvertierungsprotokolle gespeichert werden. Es kann entweder das Payload-Dokument überschreiben oder im Payload-Ordner gespeichert werden.

Formulare

Der Arbeitsablauf zum Rendern von PDF-Formularen ist ein Wrapper um die Formulardienst-API renderPDFForm, um ein PDF-Formular mit einer XDP-Vorlage und Daten-XML zu erstellen.

Render PDF Form-Workflow

  1. Ziehen Sie den Workflow PDF Formular rendern unter der Registerkarte Forms Workflow im Sidekick.
  2. Doppelklicken Sie auf den hinzugefügten Workflow-Schritt, um die Komponente zu bearbeiten.
  3. Konfigurieren Sie im Dialogfeld "Komponente bearbeiten"Eingabedokumente, Ausgabedokumente und zusätzliche Parameter und klicken Sie auf OK.

Input Documents

  • Vorlagendatei: Gibt den Speicherort der XDP-Vorlage an. Dies ist ein Pflichtfeld.

  • Datendokument: Gibt den Speicherort der Daten-XML an, die mit der Vorlage zusammengeführt werden muss.

Output Documents

  • Output Document: - Gibt den Namen des generierten PDF-Formulars an.

Zusätzliche Parameter

  • Inhaltsstamm: Gibt den Pfad zum Ordner im Repository an, in dem in der Eingabe-XDP-Vorlage verwendete Fragmente oder Bilder gespeichert werden.
  • Sende-URL: Gibt die Standard-Sende-URL für das generierte PDF-Formular an.
  • Gebietsschema: Gibt das Standardgebietsschema für das generierte PDF-Formular an.
  • Acrobat-Version: Gibt die Acrobat-Zielversion für das generierte PDF-Formular an.
  • Tagging-PDF: Gibt an, ob die generierte PDF barrierefrei gemacht werden soll.
  • XCI-Dokument: Gibt den Pfad zur XCI-Datei an.

Ausgabe

Der Arbeitsablauf „Nicht-interaktive PDF generieren“ ist ein Wrapper um die Ausgabe-Dienst-API generatePDFOutput. Er wird verwendet, um nicht-interaktive PDF-Dokumente aus der XDP-Vorlage und der Daten-XML zu generieren.

Workflow "Nicht interaktive PDF-Ausgabe generieren"  

  1. Ziehen Sie den Workflow Nicht-interaktive PDF-Ausgabe generieren auf der Registerkarte Forms Workflow im Sidekick.
  2. Doppelklicken Sie auf den hinzugefügten Workflow-Schritt, um die Komponente zu bearbeiten.
  3. Konfigurieren Sie im Dialogfeld "Komponente bearbeiten"Eingabedokumente, Ausgabedokumente und zusätzliche Parameter und klicken Sie auf OK.

Input Documents

  • Vorlagendatei: Gibt den Speicherort der XDP-Vorlage an. Dies ist ein Pflichtfeld.

  • Datendokument: Gibt den Speicherort der Daten-XML an, die mit der Vorlage zusammengeführt werden muss.

Output Document

Output Document: Gibt den Namen des generierten PDF-Formulars an.

Zusätzliche Parameter

  • Inhaltsstamm: Gibt den Pfad zum Ordner im Repository an, in dem in der Eingabe-XDP-Vorlage verwendete Fragmente oder Bilder gespeichert werden.
  • Gebietsschema: Gibt das Standardgebietsschema für das generierte PDF-Formular an.
  • Acrobat-Version: Gibt die Acrobat-Zielversion für das generierte PDF-Formular an.
  • Linearisierte PDF: Gibt an, ob die generierte PDF-Datei für die Ansicht im Web optimiert werden soll.
  • Tagging-PDF: Gibt an, ob die generierte PDF barrierefrei gemacht werden soll.
  • XCI-Dokument: Gibt den Pfad zur XCI-Datei an.

Auf dieser Seite