Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Eingabeformat "Xml"

Dieses Eingabeformat ermöglicht die Auftrennung einer XML-Datei, die einen Dokumentenstapel repräsentiert, in die Einzeldokumente. Außerdem ermöglicht dieses Eingabeformat das Extrahieren oder Hinzufügen von zugehörigen Dateianlagen zur XML-Datei.

Eigenschaft

Beschreibung

InputFormat[].DocNode

optionale Definition des Knotens in einer XML-Datei, anhand dessen die Datei in separate dokumentspezifische Teile zertrennt wird

Standardmäßig wird davon ausgegangen, dass eine XML-Datei nur ein Dokument enthält.

Bei der Aufteilung wird das Ursprungsdokument verworfen und stattdessen für jedes neue Teildokument eine Kopie des Ursprungsdokuments generiert. Der Kopie wird der dokumentspezifische Teil der ursprünglichen XML-Datei als weitere Anlage hinzugefügt.

Das Dokument und die Anlage erhalten den Namenszusatz .splitN, wobei N eine laufende Nummer darstellt.

Als Syntax für die Angabe der Eigenschaft ist XPath zu verwenden. Dies ist die gleiche Syntax, die auch für die Extraktion von Indexdaten verwendet wird (siehe XML-Indexdatenleser). Wenn die XML-Datei beispielsweise mehrere Document-Knoten mit den einzelnen Dokumenten enthält, kann der Eigenschaftswert /Root/Document lauten.

<Root> <Document>…</Document> <Document>…</Document> </Root>

InputFormat[].AttachFileMode

Modus, wie zusätzliche Dateianlagen aus der XML-Datei extrahiert oder zu dieser hinzugefügt werden:

  • None: kein Extrahieren/Hinzufügen (Standardwert)

  • Name: anhand des Namens der XML-Datei

  • Reference: anhand Referenz in der XML-Datei

  • Embedded: Binärdaten eingebettet in die XML-Datei

Die Modi Name und Reference erfordern eine dateisystembasierte Eingabe der XML-Datei, da auch die zusätzlichen Dateianlagen nur im Dateisystem gesucht werden.

InputFormat[].AttachFileNode(*)

Diese Eigenschaft ist für die Modi Reference und Embedded relevant.

Teilparameter in XPath-Syntax für die Definition der XML-Knoten, die Daten zu den Dateianlagen enthalten:

  1. File*: relativer/absoluter Dateipfad bzw. Base64-kodierte Binärdaten der Dateianlage

  2. Name: Name der Dateianlage

  3. Type: Typ oder MIME-Typ der Dateianlage

Die Parameter 2 und 3 sind nur für den Modus Embedded relevant und relativ zu dem in Parameter 1 definierten Knoten anzugeben.

Weitere Teilparameter frei wählbaren Namens sind zulässig. Diese Parameter werden den Dateianlagen als Metadaten hinzugefügt.

InputFormat[].AttachFileRefMacro(*)

Feldmakroausdruck, der im Modus Name einen Dateinamen oder ein Namensmuster, optional auch mit relativem/absolutem Ordnerpfad, zurückliefern muss, um die Dateianlagen zu finden

Dieser Ausdruck kann optional auch im Modus Reference genutzt werden, um den extrahierten Wert inhaltlich aufzubereiten.

In dem Makroausdruck sind Dateivariablen wie FilePath, FileName und FileBaseName nutzbar, die sich auf die XML-Datei beziehen. Mit @FileBaseName + ".pdf" kann beispielsweise eine PDF-Datei referenziert werden, die den gleichen Basisnamen hat wie die XML-Datei.

InputFormat[].RemoveXmlNs

Wahrheitswert, ob vor dem Parsen der XML-Dateien enthaltene Namensraumangaben aus diesen entfernt werden, um damit verbundene Probleme beim Parsen zu umgehen

XPath-Ausdrücke zum Referenzieren von Knoten sind dann ggf. auch ohne Namensraumpräfix anzugeben.

Standardwert: FALSE

Achtung

Bei Beibehaltung der Namensräume sind XML-Dokumente nicht lesbar, wenn diese einen Standardnamensraum (ohne Präfix) verwenden, z. B. bei dem Wurzelknoten.

In diesem Abschnitt: