Inhaltsverzeichnis

Search

  1. Vorwort
  2. Einführung in die Datenumwandlung
  3. Datenprozessor-Umwandlung
  4. Assistent für Eingabe- und Ausgabeformate
  5. Relationale Eingabe und Ausgabe
  6. Verwenden des IntelliScript-Editors
  7. XMap
  8. Bibliotheken
  9. Schema-Objekt
  10. Eingabeaufforderung
  11. Skripte
  12. Parser
  13. Skriptports
  14. Dokumentprozessoren
  15. Formate
  16. Datenbehälter
  17. Anker
  18. Transformer
  19. Aktionen
  20. Serializer
  21. Mapper
  22. Lokatoren, Schlüssel und Indexierung
  23. Streamer
  24. Validatoren, Benachrichtigungen und Fehlerbehandlung
  25. Validierungsregeln
  26. Benutzerdefinierte Skriptkomponenten

Benutzerhandbuch

Benutzerhandbuch

RepeatingGroupSerializer

RepeatingGroupSerializer

Dieser Serialisierungsanker
RepeatingGroupSerializer
schreibt eine wiederholte Struktur in das Ausgabedokument.
Verwenden Sie einen
RepeatingGroupSerializer
, wenn die XML-Daten einen Datenbehälter mit mehreren Instanzen enthält. Er iteriert über die einzelnen Instanzen des Datenbehälters und gibt die Daten aus. Weitere Informationen hierzu finden Sie unter Mehrfachinstanz-Datenbehälter.
Unter dem
RepeatingGroupSerializer
schachteln Sie Serialisierungsanker, die die einzelnen Instanzen des Datenbehälters verarbeiten und ausgeben. Sie können auch ein Trennzeichen definieren, das vom
RepeatingGroupSerializer
in der Ausgabe zwischen die Iterationen geschrieben wird.
Die nachstehende Tabelle beschreibt die Eigenschaften des Serialisierungsankers
RepeatingGroupSerializer
:
Eigenschaft
Beschreibung
count
Definiert die Anzahl der auszuführenden Iterationen. Wenn diese Eigenschaft leer bleibt, werden die Iterationen solange fortgesetzt, bis die Eingabe erschöpft ist.
current_iteration
Ein Datenbehälter, in den der
RepeatingGroupSerializer
die Nummer der aktuellen Iteration ausgibt. Mit einem
ContentSerializer
können Sie die Nummer in die Ausgabe schreiben.
disabled
Legt fest, ob die Komponente und alle zugehörigen untergeordneten Komponenten vom Skript ignoriert werden. Verwenden Sie diese Eigenschaft zum Testen, Debuggen und Ändern eines Skripts. Sie können eine der folgenden Optionen auswählen:
  • Ausgewählt. Das Skript ignoriert die Komponente.
  • Gelöscht. Das Skript wendet die Komponente an.
Standardmäßig ist die Eigenschaft deaktiviert.
name
Eine beschreibende Kennzeichnung für die Komponente. Diese Kennzeichnung wird in der Protokolldatei sowie der
Ereignisansicht
angezeigt. Ermitteln Sie anhand der Eigenschaft
name
, welche Komponente das Ereignis verursacht hat.
Benachrichtigungen
Eine Liste mit
NotificationHandler
-Komponenten, die Benachrichtigungen aus geschachtelten Komponenten verarbeiten. Weitere Informationen hierzu finden Sie unter Benachrichtigungen.
on_fail
Die Aktion, die beim Ausfall der Komponente durchgeführt wird. Sie können eine der folgenden Optionen auswählen:
  • Gelöscht. Es wird keine Aktion ausgeführt.
  • CustomLog. Es wird in das Benutzerprotokoll geschrieben.
  • LogError. Eine Fehlermeldung wird in das Engine-Protokoll geschrieben.
  • LogInfo. Eine Informationsmeldung wird in das Engine-Protokoll geschrieben.
  • LogWarning. Eine Warnmeldung wird in das Engine-Protokoll geschrieben.
  • NotifyFailure. Eine Mitteilung wird gesendet.
Die Standardoption lautet „Gelöscht“. Weitere Informationen über die Behandlung von Komponentenfehlern finden Sie in Fehlerbehandlung.
on_iteration_fail
Legt die Aktion fest, wenn eine Iteration fehlschlägt. Sie können eine der folgenden Optionen auswählen:
  • Gelöscht. Keine Aktion.
  • CustomLog. Schreibt in das Benutzerprotokoll.
  • LogError. Schreibt eine Fehlermeldung in das Engine-Protokoll.
  • LogInfo. Schreibt eine Informationsmeldung in das Engine-Protokoll.
  • LogWarning. Schreibt eine Warnmeldung in das Engine-Protokoll.
  • NotifyFailure. Löst eine Benachrichtigung aus.
Die Eigenschaft
on_iteration_fail
wird zum Schreiben eines Eintrags verwendet, wenn eine einzelne Iteration fehlschlägt. Die Eigenschaft
on_fail
wird zum Schreiben eines Eintrags verwendet, wenn der gesamte
RepeatingGroupSerializer
fehlschlägt. Weitere Informationen hierzu finden Sie unter Fehlerbehandlung.
optional
Legt fest, ob ein Komponentenfehler den Ausfall der übergeordneten Komponente verursacht. Sie können eine der folgenden Optionen auswählen:
  • Ausgewählt. Ein Komponentenfehler führt nicht zum Ausfall der übergeordneten Komponente.
  • Gelöscht. Ein Komponentenfehler verursacht den Ausfall der übergeordneten Komponente.
Standardwert ist "Gelöscht". Weitere Informationen über Komponentenfehler finden Sie in Fehlerbehandlung.
remark
Ein benutzerdefinierter Kommentar, der den Zweck oder die Aktion der Komponente beschreibt.
separator
Definiert einen Serialisierungsanker, der den Trennzeichen-String definiert. Sie können eine der folgenden Optionen auswählen:
  • AlternativeSerializers
  • ContentSerializer
  • EmbeddedSerializer
  • GroupSerializer
  • RepeatingGroupSerializer
  • StringSerializer
  • Benutzerdefinierter Serializer
Standardwert ist "Leer".
separator_position
Definiert die Position des
Trennzeichens
relativ zu den Abschnitten. Sie können eine der folgenden Optionen auswählen:
  • Nachher. Schreibt hinter jeden Abschnitt ein Trennzeichen, auch hinter den letzten Abschnitt. Beispiel:
    1|2|3|4|
  • Um. Schreibt vor und hinter jeden Abschnitt Trennzeichen, auch vor den ersten und hinter den letzten Abschnitt. Beispiel:
    |1|2|3|4|
  • Vorher. Schreibt vor jeden Abschnitt ein Trennzeichen, auch vor den ersten Abschnitt. Beispiel:
    |1|2|3|4
  • Zwischen. Schreibt zwischen aufeinander folgende Abschnitte jeweils ein Trennzeichen, jedoch nicht vor den ersten und hinter den letzten Abschnitt. Beispiel:
    1|2|3|4
Standardwert ist "Vorher".
skip_failed_iterations
Legt fest, ob fehlgeschlagene Iterationen übersprungen werden. Sie können eine der folgenden Optionen auswählen:
  • Ausgewählt.
    RepeatingGroup
    überspringt eine fehlgeschlagene Iteration und fährt mit der nächsten Iteration fort. Wenn eine Iteration erfolgreich ist, ist auch
    RepeatingGroup
    .
  • Gelöscht.
    RepeatingGroup
    schlägt fehl, wenn eine Iteration fehlschlägt.
Die Eigenschaft
skip_failed_iterations
hat nur dann einen Effekt, wenn
separator
definiert ist.
Standardwert ist "Ausgewählt".
source
Definiert einen Datenbehälter, der die Quelle für die Serialisierung enthält. Weitere Informationen hierzu finden Sie unter Überblick über Validatoren, Benachrichtigungen und Fehlerbehandlung.
target
Definiert einen Datenbehälter, der das Ergebnis der Serialisierung enthält. Weitere Informationen hierzu finden Sie unter Überblick über Validatoren, Benachrichtigungen und Fehlerbehandlung.