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

Marker

Marker

Ein
Marker
-Anker definiert eine Position in einem Quelldokument. Er dient als Referenzpunkt, von dem aus das Skript die danach folgenden Anker sucht.
Standardmäßig ist die Eigenschaft
phase
eines
Marker
auf
initial
gesetzt. Dies bedeutet, dass das Skript ein Dokument nach
Marker
-Ankern durchsucht, bevor es nach
Content
-Ankern sucht. Weitere Informationen hierzu finden Sie unter So sucht der Parser Anker.
Die nachstehende Tabelle beschreibt die Eigenschaften des
Marker
-Ankers:
Eigenschaft
Beschreibung
absent
Bestimmt, ob der angegebene Text oder das angegebene Muster im Dokument fehlt. Die Eigenschaft
absent
hat folgende Optionen:
  • Ausgewählt. Wenn der angegebene Text im Dokument auftaucht, schlägt die
    Marker
    -Komponente fehl.
  • Gelöscht. Wenn der angegebene Text im Dokument auftaucht, ist die
    Marker
    -Komponente erfolgreich.
Standardwert ist "Gelöscht".
adjacent
Wenn diese Eigenschaft ausgewählt ist, muss der
Marker
an den Anker am Anfang seines Suchbereichs angrenzen. Wenn Eigenschaft
direction
auf
backward
gesetzt ist, muss er an den Anker am Ende seines Suchbereichs angrenzen. Ist die Eigenschaft nicht ausgewählt, kann das Skript Text überspringen, bis es den
Marker
findet.
Die Eigenschaft
adjacent
hat folgende Optionen:
  • Ausgewählt. Der
    Marker
    muss unmittelbar nach dem Anfang des Suchbereichs auftreten, wenn
    direction
    auf
    forward
    gesetzt ist, oder unmittelbar vor dem Ende des Suchbereichs, wenn
    direction
    auf
    backward
    gesetzt ist.
  • Gelöscht. Der
    Marker
    kann sich an beliebiger Stelle innerhalb des Suchbereichs befinden.
Standardwert ist "Gelöscht".
count
Gibt an, die wievielte Instanz gesucht werden soll. Um den
Marker
zum Beispiel auf das zweite Zeilenvorschubzeichen nach dem vorherigen Anker zu setzen, definieren Sie
search
als
NewlineSearch
und
count
als
2
.
direction
Eine Suchrichtung für den Anker innerhalb des Suchbereichs. Sie können eine der folgenden Optionen auswählen:
  • Zurück. Die Suche beginnt am Ende des Suchbereichs und findet die letzte Instanz des Ankers.
  • Vorwärtssuche. Die Suche beginnt am Anfang des Suchbereichs und findet die erste Instanz des Ankers.
Bei einem
Marker
-Anker können Sie dieses Verhalten mithilfe der Eigenschaft
count
ändern. Wenn beispielsweise
direction = backward
und
count = 2
ist, findet das Skript die vorletzte Instanz.
Standardwert ist "Vorwärtssuche". Weitere Informationen hierzu finden Sie unter So sucht der Parser Anker.
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.
marking
Legt fest, ob ein Anker als Anfang des Suchbereichs für den danach folgenden Anker verwendet wird. Sie können eine der folgenden Optionen auswählen:
  • Anfangsposition. Setzt einen Referenzpunkt vor dem aktuellen Anker.
  • Endposition. Setzt einen Referenzpunkt hinter dem aktuellen Anker.
  • Vollständig. Setzt einen Referenzpunkt vor und hinter dem aktuellen Anker.
  • Keine. Es wird kein Referenzpunkt erstellt.
Weitere Informationen hierzu finden Sie unter So sucht der Parser Anker.
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.
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.
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.
phase
Legt den Zeitpunkt fest, an dem das Skript die Komponente verarbeitet. Sie können eine der folgenden Optionen auswählen:
  • Anfangsphase. Das Skript verarbeitet die Komponente während der Anfangsphase.
  • Hauptphase. Das Skript verarbeitet die Komponente während der Hauptphase.
  • Endphase. Das Skript verarbeitet die Komponente während der Endphase.
Weitere Informationen hierzu finden Sie unter So sucht der Parser Anker.
Standardwert ist "Anfangsphase".
remark
Ein benutzerdefinierter Kommentar, der den Zweck oder die Aktion der Komponente beschreibt.
search
Definiert die Suchkriterien für den
Marker
. Die Suchkriterien bestimmen, an welcher Position innerhalb des Suchbereichs sich der
Marker
befindet. Beispielsweise platziert
NewlineSearch
den
Marker
bei einem Zeilenvorschubzeichen.
TextSearch
platziert den
Marker
bei einem angegebenen String. Weitere Informationen hierzu finden Sie unter So sucht der Parser Anker.
Den Wert dieser Eigenschaft bildet eine der folgenden Suchkomponenten.
  • NewlineSearch. Sucht ein Zeilenvorschubzeichen.
  • TextSearch. Sucht nach einem vordefinierten Textstring oder nach einem Textstring, der in einem Datenbehälter gespeichert ist.
  • PatternSearch. Sucht nach einem Textstring, der mit einem angegebenen regulären Ausdruck übereinstimmt.
  • OffsetSearch. Überspringt eine vordefinierte Anzahl von Zeichen nach einem Referenzpunkt oder eine in einem Datenbehälter gespeicherte Anzahl von Zeichen. Der
    Marker
    ist die Stelle, die nach den übersprungenen Zeichen folgt.
  • TypeSearch. Sucht nach einem String, der mit einem angegebenen XSD-Datentyp übereinstimmt.
Weitere Informationen hierzu finden Sie im Abschnitt Suchkomponenten: Referenz.