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

FindReplaceAnchor

FindReplaceAnchor

Der
FindReplaceAnchor
-Anker markiert den Quelltext und gibt Ersatztext für die Umwandlung durch den
TransformByParser
-Transformer an.
Die nachstehende Tabelle beschreibt die Eigenschaften des Ankers
FindReplaceAnchor
:
Eigenschaft
Beschreibung
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.
no_initial_phase
Legt fest, ob das Skript nach geschachtelten Ankern in der Hauptphase sucht. Sie können eine der folgenden Optionen auswählen:
  • Gelöscht. Es erfolgt eine Suche nach geschachtelten Ankern entsprechend ihren individuellen Eigenschaften.
  • Ausgewählt. Es erfolgt eine Suche nach geschachtelten Ankern in der Hauptphase.
Die Standardoption lautet „Gelöscht“.
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_partial_match
Bestimmt das Verhalten, wenn
FindReplaceAnchor
nicht alle geschachtelten nicht-optionalen Anker findet. Sie können eine der folgenden Optionen auswählen:
  • Fehlschlag.
    FindReplaceAnchor
    schlägt fehl. Standard.
  • Überspringen.
    FindReplaceAnchor
    entfernt den von den erfolgreich geschachtelten Ankern abgedeckten Bereich aus dem Suchbereich und versucht erneut, alle geschachtelten Anker zu finden. Der Prozess wird wiederholt, bis der Anker gefunden wird oder ein Fehlschlag eintritt.
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 "Hauptphase".
remark
Ein benutzerdefinierter Kommentar, der den Zweck oder die Aktion der Komponente beschreibt.
replace_with
Definiert einen literalen Ersetzungs-String oder einen Datenbehälter, der den Ersetzungs-String enthält.
source
Definiert eine Sequenz von Datenbehältern zur Eingabe in den
FindReplaceAnchor
. Jeder Datenbehälter wird durch eine der folgenden Eigenschaften ausgewiesen:
  • Locator. Identifiziert einen Einzel- oder Mehrfachinstanz-Datenbehälter. Bei Mehrfachinstanz-Datenbehältern greift jede Iteration auf eine neue Instanz zu.
  • LocatorByKey. Identifiziert einen Einzelinstanz-Datenbehälter nach Schlüssel.
  • LocatorByOccurence. Identifiziert einen Mehrinstanz-Datenbehälter nach Sequenznummer.
Verwenden Sie die Eigenschaft
source
, wenn der
FindReplaceAnchor
von einer anderen Komponente aufgerufen wird. Weitere Informationen hierzu finden Sie unter Eigenschaft „source“.
target
Definiert eine Sequenz von Datenbehältern zur Ausgabe vom
FindReplaceAnchor
. Wenn der Datenbehälter noch nicht existiert, wird er erzeugt. Jeder Datenbehälter wird durch eine der folgenden Eigenschaften ausgewiesen:
  • Locator. Identifiziert einen Einzel- oder Mehrfachinstanz-Datenbehälter. Bei Mehrfachinstanz-Datenbehältern erstellt jede Iteration eine neue Instanz.
  • LocatorByKey. Identifiziert einen Einzelinstanz-Datenbehälter nach Schlüssel.
  • LocatorByOccurence. Identifiziert einen Mehrinstanz-Datenbehälter nach Sequenznummer.
Verwenden Sie die Eigenschaft
target
, wenn die Ausgabe vom
FindReplaceAnchor
von einer anderen Komponente verwendet wird. Weitere Informationen hierzu finden Sie unter Eigenschaft „target“.
Wenn
FindReplaceAnchor
keine geschachtelten Anker enthält, ersetzt er den gesamten Text innerhalb des Suchbereichs. Befindet sich
FindReplaceAnchor
zum Beispiel zwischen zwei
Marker
-Ankern, wird der gesamte Text zwischen diesen Ankern markiert.
Wenn
FindReplaceAnchor
einen
Marker
-Anker enthält, markiert er den
Marker
zum Ersetzen.
Wenn
FindReplaceAnchor
zwei
Marker
-Anker enthält, markiert er die
Marker
-Anker und das Segment zwischen ihnen zum Ersetzen.
Der Ersetzungstext kann einen statischen Ersetzungs-String oder ein String sein, der dynamisch aus dem Quelldokument abgerufen wird.
Weitere Informationen hierzu finden Sie unter TransformByParser.