XML-Transformationsjobs konfigurieren

Sie können einen XML-Transformationsjob erstellen, um eine XML-Datei in eine gewünschte Ausgabe zu transformieren, und Erfassungsmetadatenfeldern Werte aus der XML zuweisen. Hierzu konfigurieren Sie die unterstützten Kombinationen von XSLT-Prozessordefinitionen und stellen die benutzerdefinierte XSLT-Datei bereit. Darüber hinaus können Sie den Erfassungsmetadatenfeldern einen XPath-Ausdruck zuordnen. Die konvertierte XML-Datei kann in Drittanbieteranwendungen zur Anpassung an die Geschäftsanforderungen der anderen Partei verwendet werden.

Hinweis:

In der Oracle Content Management-Starter-Edition können Sie keine XML-Transformationsjobs erstellen. Wenn Sie dieses Feature verwenden möchten, müssen Sie ein Upgrade auf die Oracle Content Management-Premium-Edition durchführen. Weitere Informationen finden Sie unter Starter- und Premium-Edition im Vergleich.

  1. Wählen Sie im Bereich "Prozeduren" links die Prozedur aus.

    Die Konfigurationsseiten für die ausgewählte Prozedur werden rechts angezeigt.

  2. Öffnen Sie die Registerkarte Verarbeitung.

  3. Klicken Sie in der Tabelle XML-Transformationsjobs auf XML-Transformationsjob hinzufügen. Sie können auch auf XML-Transformationsjob bearbeiten klicken, um einen vorhandenen Job zu bearbeiten.

    Sie können einen XML-Transformationsjob auch kopieren, indem Sie ihn auswählen, auf Transformationsjob kopieren klicken und auf Aufforderung einen neuen Namen eingeben. Durch Kopieren eines Jobs können Sie diesen schnell duplizieren und ändern.

  4. Führen Sie auf der Seite Dokumentauswahl folgende Aktionen aus:

    1. Führen Sie im Abschnitt Dokumentauswahl folgende Schritte aus:

      • Geben Sie einen Namen und eine Beschreibung für den Job ein.

      • Um den XML-Transformationsjob für bestimmte Dokumentprofile zu verarbeiten, wählen Sie mindestens ein Dokumentprofil im Feld Auf Dokumentprofile beschränken aus. Sie können auch Alle auswählen, um Dokumente für alle definierten Dokumentprofile zu verarbeiten.

    2. Wählen Sie in der Dropdown-Liste Transformationsausgabeziel eine geeignete Option aus:
      • Dokument: Ersetzt das Originaldokument durch die Ergebnisse der Transformation. Sie können das Dokumentprofil auch ändern, falls gewünscht.
      • Dokument, Kopie beibehalten: Behält die Originalkopie bei. Sie können bei Verwendung dieser Option auch ein Dokumentprofil auswählen. Dann müssen Sie allerdings einen Anhangstyp in der Dropdown-Liste Anhangstyp beibehalten auswählen.
      • Anhang: Speichert die Ergebnisse der Transformation als Anhang. Sie müssen einen Anhangstyp in der Dropdown-Liste Neuer Anhangstyp auswählen.
      • Capture-Feld: Speichert die Ergebnisse der Transformation in einem Capture-Feld. Sie müssen in der Dropdown-Liste Capture-Feld die Option Textfeld auswählen.
    3. Führen Sie im Abschnitt Anhangsauswahl folgende Schritte aus:
      1. Aktivieren Sie das Kontrollkästchen Anhänge verarbeiten:, falls diese Option auf die im vorherigen Schritt getroffene Auswahl zutrifft.
      2. Beschränken Sie die Ergebnisse auf die erforderlichen Anhangstypen, indem Sie die Kontrollkästchen neben den verfügbaren Anhangstypen aktivieren. Sie können auch alle Typen auswählen.
      3. Wählen Sie das Transformationsausgabeziel aus:
        • Anhang: Sie können den Anhangstyp ändern.
        • Anhang, Kopie beibehalten: Sie können den Anhangstyp auswählen. Sie müssen allerdings einen Anhangstyp in der Dropdown-Liste Anhangstyp beibehalten auswählen.
        • Capture-Feld: Sie müssen Textfeld oder XML-Feld auswählen.
  5. Auf der Seite Transformation unter Transformationsdefinition führen Sie folgende Schritte aus:
    1. Wenn das Kontrollkästchen XML-Transformation ausführen noch nicht aktiviert ist, wählen Sie es aus, um die Bearbeitung der Feldwerte auf dieser Seite zu aktivieren. Wenn Sie dieses Kontrollkästchen deaktivieren, ist keine Bearbeitung möglich, und die letzten gespeicherten Werte werden in den Feldern beibehalten. Sie können dieses Kontrollkästchen deaktivieren, wenn keine XML-Transformation erforderlich ist.
    2. Führen Sie im Abschnitt Transformations-Engine folgende Schritte aus:
      • Wählen Sie kompatible Werte für XSLT-Version, Prozessor und Prozessorversion aus. Sie können entweder die Systemstandards oder eine der verfügbaren XSLT-Versionen auswählen, die mit Xalan- und Saxon-HE-Prozessoren und deren Versionen kompatibel sind.
      • Geben Sie eine Ausgabedateierweiterung an, wie XML, HTML, JSON, Text.

        Hinweis:

        Wenn die Ausgabedateierweiterung nicht XML entspricht, ist die Seite "Feldzuordnung" deaktiviert.
    3. Um eine Transformation auszuführen, müssen Sie die XSLT in den Abschnitt XML-Stylesheet hochladen oder dort eingeben.
    4. Die in der XSLT enthaltenen Parameter müssen in der Tabelle "Parameter" definiert sein. Gehen Sie dazu wie folgt vor:
      1. Klicken Sie in der Tabelle Parameter auf Parameter hinzufügen.
      2. Fügen Sie im Dialogfeld XSLT-Parameter hinzufügen den Namen des Parameters hinzu, und weisen Sie ihm einen Wert zu. Sie können für Ihre Parameter einen Textwert hinzufügen oder einen Metadatenwert assemblieren.
      3. Wiederholen Sie die Schritte i und ii, um die erforderlichen Parameter zu definieren.

        Hinweis:

        Wenn Sie Parametern, die in der XSLT definiert sind, keine Werte zuweisen, oder wenn Sie Werte zuweisen, die nicht in der XSLT vorhanden sind, können Sie den XML-Transformationsjob nicht speichern und erhalten beim Speichern des Transformationsjobs eine entsprechende Benachrichtigung.
    5. Im Abschnitt Transformationstests können Sie die transformierte XML hochladen und testen, um zu prüfen, ob sie korrekt generiert wurde. Klicken Sie anschließend auf Weiter. Sie können auch eine Vorschau des Inhalts in diesem Abschnitt anzeigen, indem Sie rechts oben auf Vorschau klicken.
  6. Auf der Seite Feldzuordnung definieren Sie die Navigation zu bestimmten Elementen oder Attributen, damit Benutzer ihre Werte aus dem XML-Dokument extrahieren können:
    1. Wählen Sie das Kontrollkästchen XPath-Feldzuordnung ausführen aus, um die Bearbeitung der Tabelle "XPath-Feldzuordnung" zu aktivieren. Wenn Sie dieses Kontrollkästchen nicht aktivieren, können Sie die Tabelle nicht bearbeiten. Allerdings werden die letzten gespeicherten Werte beibehalten.
    2. Aktivieren Sie das Kontrollkästchen Batch bei Parsingfehlern nicht erfolgreich, wenn das Parsingformat, das Sie im nächsten Schritt auswählen, streng eingehalten werden muss.
    3. Klicken Sie rechts oben in der Tabelle XPath-Feldzuordnung auf XPath-Feldzuordnung bearbeiten.
    4. Führen Sie im Dialogfeld XPath-Feldzuordnung bearbeiten folgende Schritte aus:
      1. Geben Sie im Feld XPath-Ausdruck den XPath-Ausdruck für das ausgewählte Metadatenfeld ein, und wählen Sie das Parsingformat aus.

        Der XPath-Ausdruck wird anhand der Ausgabe der Transformation ausgewertet, falls vorhanden. Wird keine Transformation ausgeführt, wird der XPath-Ausdruck anhand des Dokuments oder Anhangs ausgewertet.

      2. Wählen Sie in der Dropdown-Liste Parsingformat für Datum das Parsingformat aus. Wenn das Capture-Feld eine Zahl enthält, wird stattdessen die Dropdown-Liste Parsingformat für Zahl angezeigt. Falls erforderlich, können Sie ein benutzerdefiniertes Parsingformat in der Dropdown-Liste auswählen.
      3. Klicken Sie auf OK.

        Der Wert, den Sie in der Tabelle XPath-Feldzuordnung zur Spalte XPath-Ausdruck hinzufügen, wird zu einem Datum im ausgewählten Format geparst.

    5. Klicken Sie auf OK.
  7. Geben Sie auf der Seite Nachverarbeitung basierend auf folgenden Informationen an, was nach dem Abschluss eines XML-Transformationsjobs geschieht:
    • Situationen ohne Systemfehler sind Fälle, bei denen alle Kriterien auf der vorherigen Seite erfüllt wurden. Eine erfolgreiche Transformation kann zum Commit übergehen.
    • Systemfehler sind Fälle, bei denen die Transformation nicht erfolgreich verläuft: keine Datensätze gefunden, zu viele Datensätze gefunden usw. Bei nicht erfolgreichen Transformationen kehrt der Batch zur Reparatur zum Content Capture-Client zurück.
    Siehe Nachverarbeitung und Überwachung eines XML-Transformationsjobs konfigurieren.

  8. Prüfen Sie die Einstellungen auf der Seite Zusammenfassung, und klicken Sie auf Weiterleiten, um den Job zu speichern.

  9. Konfigurieren Sie den Batchfluss zu XML-Transformationsjobs. Siehe Batchfluss für einen XML-Transformationsjob konfigurieren.

  10. Testen Sie den erstellten XML-Transformationsjob.

Nachverarbeitung und Überwachung eines XML-Transformationsjobs konfigurieren

Über die Nachverarbeitungsoptionen eines XML-Transformationsjobs können Sie angeben, was nach der Verarbeitung geschieht.

So konfigurieren Sie die Nachverarbeitung und Überwachung eines XML-Transformationsjobs:
  1. Wählen Sie im Bereich "Prozeduren" links die Prozedur aus.
    Die Konfigurationsseiten für die ausgewählte Prozedur werden rechts angezeigt.
  2. Öffnen Sie die Registerkarte Prozessor.
  3. In der Tabelle XML-Transformationsjobs können Sie einen XML-Transformationsjob hinzufügen oder bearbeiten.
  4. Klicken Sie auf die Seite Nachverarbeitung, um die Verarbeitungsoptionen für die erfolgreiche Verarbeitung (ohne Systemfehler) und die nicht erfolgreiche Verarbeitung (mindestens ein Systemfehler) anzuzeigen. Die nächsten Schritte gelten für beide Abschnitte: Wenn kein Systemfehler vorliegt und Wenn Systemfehler vorliegen.
  5. Geben Sie in den Feldern Batchprozessor und Batchprozessorjob gegebenenfalls Verarbeitungsschritte an, die nach Abschluss des XML-Transformationsjobs ausgeführt werden. Mögliche Optionen: Keine, Commit-Prozessor, Erkennungsprozessor, Konvertierungsjobs zu TIFF, Konvertierungsjobs zu PDF, Asset-Lookup-Prozessor oder XML-Transformationsprozessor.
  6. Geben Sie im E-Mail-Adressfeld optional eine Adresse ein, an die eine E-Mail gesendet wird, wenn die Verarbeitung erfolgreich oder mit Fehlern abgeschlossen wurde. Beim Konfigurieren und Testen eines XML-Transformationsjobs können Sie sich selbst als Empfänger für E-Mail-Benachrichtigungen bei Systemfehlern angeben und später automatisch einen Administrator über Verarbeitungsfehler benachrichtigen.
  7. Geben Sie in den restlichen Feldern an, wie verarbeitete Batches geändert werden sollen.

    • Benennen Sie Batches um, indem Sie ein Präfix hinzufügen. Beispiel: Benennen Sie nicht erfolgreiche Batches mit dem Präfix ERR zur Nachverfolgung um.

    • Ändern Sie den Batchstatus oder die Priorität. Beispiel: Sie können den Status von Batches mit Systemfehlern ändern und ein Clientprofil erstellen, mit dem Batches nach diesem Status gefiltert werden. Dann können qualifizierte Benutzer Batches mit Fehlern manuell bearbeiten und abschließen.

  8. Klicken Sie auf Weiterleiten, um den Job zu speichern.

Batchfluss für einen XML-Transformationsjob konfigurieren

Um einen XML-Transformationsjob auszuführen, müssen Sie dem Job Batches zur Verarbeitung zuführen. Dazu legen Sie den XML-Transformationsjob als Nachverarbeitungsschritt in einem Clientprofil fest.

Sie können Batchflüsse von den folgenden Elementen konfigurieren:

XML-Transformationsjob deaktivieren oder löschen

Wenn Sie einen XML-Transformationsjob löschen, ist er nicht mehr für Batches verfügbar, für die er als Nachverarbeitungsschritt festgelegt wurde. Wenn ein für die Nachverarbeitung festgelegter Job nicht verfügbar ist, wird für den Batch ein Fehler angezeigt. Möglicherweise empfiehlt es sich, einen Job vor dem Löschen eine Weile offline zu setzen, damit Sie unerwartete Probleme im Zusammenhang mit dessen Löschung beheben können. XML-Transformationsonlinejobs werden ausgeführt, wenn sie in einem Clientprofil oder auf der Seite "Nachverarbeitung" eines Prozessorjobs ausgewählt wurden. Sie können einen Job vorübergehend anhalten (offline setzen) oder einen deaktivierten Job wieder für die Ausführung aktivieren.

So deaktivieren oder löschen Sie einen XML-Transformationsjob:
  1. Wählen Sie im Bereich "Prozeduren" links die Prozedur aus.
    Die Konfigurationsseiten für die ausgewählte Prozedur werden rechts angezeigt.
  2. Öffnen Sie die Registerkarte Verarbeitung.
  3. Um einen Job zu deaktivieren, wählen Sie ihn in der Tabelle XML-Transformationsjobs aus, und klicken Sie auf XML-Transformationsjob deaktivieren oder aktivieren.

    Sie können einen XML-Transformationsjob auch deaktivieren oder aktivieren, indem Sie auf der Seite "Dokumentauswahl" das Feld Online auswählen oder seine Auswahl aufheben.

  4. Wählen Sie den deaktivierten Job in der Tabelle XML-Transformationsjobs aus, und klicken Sie auf XML-Transformationsjob löschen.
  5. Wenn Sie dazu aufgefordert werden, bestätigen Sie das Löschen dieses Jobs durch Klicken auf Ja.