Auf den Erhalt von XML vorbereiten

Der Empfang und die Verarbeitung der XML-Dateien hängt von den Informationen in den JSON-Dateien ab und davon, wie Sie die Informationen verwenden möchten.

Bevor Sie diese Aufgaben ausführen, lesen Sie das Einsatzszenario und die Beispiele für die Verarbeitung von Aufträgen in einer XML-Datei. Diese Themen liefern Beispiele für die Schritte in diesem Thema.

So bereiten Sie den Erhalt von XML vor:
  1. Werten Sie die XML-Dateien aus, die eine Eingabe für den Prozess bereitstellen. Stellen Sie sicher, dass Sie den Inhalt der Datei sowie die Organisationsweise der Informationen verstehen.

    Sofern möglich, bitten Sie den Bereitsteller der XML-Datei um die XML-Schemadefinition (XSD).

  2. Entscheiden Sie, wie Sie die XML-Dateien in RICOH ProcessDirector verarbeiten möchten. Diese Schrittschablonen bearbeiten XML:

    • Ein auf der CreateJobsFromXML-Schrittschablone basierender Schritt erstellt Jobs aus Elementen in einer XML-Datei, die mit einem XPath-Ausdruck übereinstimmen. Der Schritt übermittelt die Jobs an einen Workflow.
    • Ein auf der ApplyXSLTransform-Schrittschablone basierender Schritt wandelt XML in eine Datei um, die die Werte des RICOH ProcessDirector-Jobs oder der Dokumenteigenschaften festlegt. Der Schritt wandelt auch XML in ein anderes XML-Format um.

    Sie können auf anderen Schrittschablonen basierende Schritte wie z. B. RunExternalProgram zum Bearbeiten von XML-Dateien verwenden.

  3. Um Werte für RICOH ProcessDirector-Job und -Dokumentmerkmale zu extrahieren, ermitteln Sie die XML-Elemente und -Attribute, die Werte für die Merkmale bereitstellen.
      Hinweis:
    • Die Funktion "PDF-Dokumentenunterstützung" oder die Funktion "AFP-Unterstützung" ist erforderlich, um Dokumentmerkmale zu verwenden.
  4. Entscheiden Sie, wie viele CreateJobsFromXML-Schritte erforderlich sind, um die XML zu verarbeiten.

    Beim Erstellen der Workflows, die XML-Dateien verarbeiten, können Sie sich entscheiden, welcher Workflow die Ausgabe der neuen Jobs von den einzelnen CreateJobsFromXML Schritten empfängt. Sie entscheiden auch, ob die neuen Jobs untergeordnete Jobs sind.

    Beispiel:

    • Ihre XML-Datei enthält mehrere Aufträge, und jeder Auftrag enthält mehrere Elemente. Eine Eingabeeinheit des Typs "Ordner für Sofortdruck" empfängt und verarbeitet die XML-Dateien mit dem ersten Workflow.

      Ein CreateJobsFromXML-Schritt im ersten Workflow erstellt für jeden Auftrag einen Job und übergibt die Jobs an einen zweiten Workflow. Dieser Workflow extrahiert Informationen zum Auftrag.

      Ein CreateJobsFromXML-Schritt im zweiten Workflow erstellt für jedes Element im Auftrag einen Job und übergibt die Jobs als untergeordnete Jobs an einen dritten Workflow. Der dritte Workflow verarbeitet die Element-Jobs.

    • Ihre JSON-Datei enthält eine Liste mit Buchtiteln und die PDF-Dateien, die zum Drucken der einzelnen Bücher erforderlich sind. Eine Eingabeeinheit empfängt Anforderungen zum Druck eines oder mehrerer Exemplare eines Buchs auf der Liste und ordnet den Job einem Workflow zu.

      Anhand des Buchtitels in der Anforderung erstellt ein CreateJobsFromXML-Schritt im Workflow einen XML-Job mit den PDF-Dateien, die für den Druck des Buchs erforderlich sind. Der Schritt übermittelt den Job an einen zweiten Workflow.

      Ein CreateJobsFromXML-Schritt im zweiten Workflow erstellt einen XML-Job für jede PDF-Datei (einen für das Cover und einen weiteren für den Text). Der Schritt übermittelt die Jobs als untergeordnete Jobs an einen dritten Workflow. Der dritte Workflow druckt die Cover- und Text-Jobs.

    • Ihre XML-Datei enthält eine Liste von Dokumenteigenschaften, die der Dokumentmerkmaldatei für einen Job hinzuzufügen sind.

      Ein ApplyXSLTransform-Schritt wandelt die XML-Datei in eine Datei mit durch Komma getrennten Werten um, die der Workflow als Merkmalbedingungsdatei verwendet. Der Workflow umfasst keinen CreateJobsFromXML-Schritt.

      Ein SetDocPropsFromConditions-Schritt liest die Merkmalbedingungsdatei aus und legt die Dokumentmerkmale auf der Basis der Werte in der XML-Datei fest.

  5. Definieren Sie für jeden CreateJobsFromXML-Schritt den erforderlichen XPath-Ausdruck, um Jobs von Elementen in der XML-Eingabedatei zu erstellen.
    In der Regel umfasst der Workflow, der Jobs von einem CreateJobsFromXML-Schritt empfängt, einen ApplyXSLTransform-Schritt, um Elemente in der XML-Datei in RICOH ProcessDirector-Job- oder -Dokumentmerkmale umzuwandeln.
  6. Verwenden Sie für jeden ApplyXSLTransform-Schritt ein Drittanbieter-XSLT-Tool (z. B. Altova MapForce) zum Erstellen eines XSLT-Stylesheets.
    • Bezüglich der Umwandlung von XML-Elementen in RICOH ProcessDirector-Jobmerkmale in einer Überschreibungsdatei beachten Sie die Informationen in der XSLT-Stylesheet-Musterdatei für die Verarbeitung von Aufträgen in einer XML-Datei.

      Erstellen Sie die Ausgabedatei für den ApplyXSLTransform-Schritt ${getFileName(overrides,text,write)}.

    • Nach der Installation eines Features für die Dokumentverarbeitung finden Sie im Information Center Details zum Hinzufügen eines Schritt für die Umwandlung von XML-Elementen in RICOH ProcessDirector-Dokumentmerkmale.
  7. Legen Sie fest, wie Sie XML-Dateien für die Verarbeitung empfangen möchten.
    Sie können XML-Dateien an eine Eingabeeinheit des Typs "Ordner für Sofortdruck" übermitteln oder eine XML-Datei an einem Ort platzieren, wo sie der RICOH ProcessDirector-Server abruft.

    Beispiel:

    • Wenn Ihre XML-Datei mehrere Aufträge und jeder Auftrag mehrere Elemente enthält, übermitteln Sie die XML-Dateien an eine Eingabeeinheit des Typs "Ordner für Sofortdruck".
    • Wenn Ihre XML-Datei eine Liste mit Buchtiteln und die PDF-Dateien enthält, die zum Drucken der einzelnen Bücher erforderlich sind, platzieren Sie die Datei an einem leicht zugänglichen Ort. Aktualisieren Sie die Datei immer dann, wenn sich die Buchtitel und die Druckdateien ändern.

      Wenn ein CreateJobsFromXML-Schritt ausgeführt wird, verwendet er einen XPath-Ausdruck zum Erstellen eines XML-Jobs anhand von Informationen in der Liste.

  8. Wenn Sie eine XML-Datei an einem Standort platzieren, von dem sie der RICOH ProcessDirector-Server abruft, entscheiden Sie, wie Jobs an den Workflow übergeben werden.

    Eine Möglichkeit besteht darin, eine Überschreibungsdatei an einen Ordner für Sofortdruck zu übergeben. Die Überschreibungsdatei veranlasst den Ordner für Sofortdruck, einen Job zu erstellen und an den Workflow zu übergeben.

    Um eine Überschreibungsdatei als Auslöser zu verwenden, legen Sie diese Merkmale beim Definieren des Ordners für Sofortdruck fest:

    • Setzen Sie das Merkmal Abschlussmethode auf Auslöser.
    • Geben Sie die gleichen Musterwert sowohl für das Merkmal Auslösermuster als auch für das Merkmal Überschreibungsmuster an.

Sie haben jetzt die Informationen, XPath-Ausdrücke und XSLT-Stylesheets, die erforderlich sind, um Workflows für die Verarbeitung von XML zu definieren.

Related information:

Jobs mit XML-Dateien
Einsatzszenario für das Verarbeiten von Aufträgen in einer XML-Datei
Überschreibungsdateien
CreateJobsFromXML
Übergeordnetes Thema: Jobübergabe vorbereiten