X4 Produktdokumentation

Document Comparison

Dieser Adapter vergleicht eine Repository-Datei mit einer Input-Datei und gibt als Prozess-Ergebnis einen Statuswert aus.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Funktions-Adapter durchführt

Mögliche Werte: Compare: Dateien miteinander vergleichen

Parameter

comparisonMethod

Vergleichsmethode

Mögliche Werte:

  • BYTE: Dateien byte-weise miteinander vergleichen (Standard)

  • ZIP: ZIP-Dateien anhand ihrer Inhalte miteinander vergleichen

  • XML: XML-Dateien anhand ihrer Inhalte miteinander vergleichen

  • TEXT: Text-Dateien anhand ihrer Inhalte miteinander vergleichen

  • EMPTY: Input-Dateien mit leeren Byte-Arrays vergleichen

expectedResult

Pfad zum Dokument das mit dem Adapter-Input verglichen werden soll. Bezieht sich auf die Vergleichsmethoden BYTE, ZIP, XML und TEXT

Mögliche Werte: Repository-Pfad, z. B. X4Experience/BPM/1-Examples/InvoiceReceipt/BPM/Data/Invoice.xml (Pflichtfeld)

ignoreWhitespace

Gibt an, ob Leerzeichen beim Vergleichen ignoriert werden sollen; Bezieht sich auf die Vergleichsmethoden XML und TEXT

Mögliche Werte:

  • ja: Leerzeichen ignorieren

  • nein: Leerzeichen berücksichtigen (Standard)

normalizeWhitespace

Gibt an, ob Leerzeichen am Anfang und Ende einer Zeichenkette entfernt werden sollen; Bezieht sich auf die Vergleichsmethoden XML und TEXT

Mögliche Werte:

  • ja: Leerzeichen wird am Anfang und Ende einer Zeichenkette entfernt (Standard)

  • nein: Leerzeichen am Anfang und Ende einer Zeichenkette bleibt erhalten

ignoreComments

Gibt an, ob Kommentare innerhalb des XML-Dokuments beim Vergleichen ignoriert werden sollen; Bezieht sich auf die Vergleichsmethode XML

Mögliche Werte:

  • ja: Kommentare ignorieren

  • nein: Kommentare berücksichtigen (Standard)

compareSimilar

Gibt an, ob die Reihenfolge der Elemente und Attribute (Tags) innerhalb des XML-Dokuments beim Vergleichen ignoriert werden soll, z. B. wenn die Inhalte innerhalb des XML-Dokuments zwar gleich, aber ihre Reihenfolge unterschiedlich ist; Bezieht sich auf die Vergleichsmethode XML

Mögliche Werte:

  • ja: Reihenfolge ignorieren

  • nein: Reihenfolge berücksichtigen (Standard)

ignoreCDataAndTextDiff

Gibt an, ob der Inhalt innerhalb des Elementes CDATA als Klartext interpretiert werden soll; Bezieht sich auf die Vergleichsmethode XML

Mögliche Werte:

  • ja: Inhalt von CDATA als Klartext interpretieren (Standard)

  • nein: Inhalt von CDATA nicht als Klartext interpretieren

Input

Als Input erwartet der Adapter eine beliebige Datei, die mit einer gegebenen Repository-Datei verglichen wird.

Output

Als Prozess-Ergebnis können verschiedene Statuswerte ausgegeben werden:

1

Die verglichenen Dokumente sind gleich

0

Die verglichenen Dokumente sind nicht gleich

-1

Die Dokumente konnten nicht miteinander verglichen werden, da der Input entweder leer, nicht wohlgeformt oder falsch war.