Für jedes Suchelement enthält der Code in einer Aktivität Extraction Rules eine Reihe von Regeln, die nacheinander ausgeführt werden. Jede Regel besteht aus zwei Teilen und endet mit einem Semikolon:
Der linke Teil prüft eine Bedingung oder ermittelt Werte, die sie erfüllen. Der rechte Teil erstellt neue Suchelement-Instanzen und weist ihnen diese Werte zu.
Beispiel
Die folgende einfache Regel findet ein Such-Element kw_Contract, das das Schlüsselwort „Contract“ enthält:
Struktur des linken Bereichs
Der linke Bereich besteht aus bis zu drei Komponenten:
Existenzbedingung (optional)
Findet ein Objekt, das die angegebenen Attribute aufweist. Es wird empfohlen, dem Objekt einen Namen zuzuweisen, wenn es existiert, damit Sie es innerhalb derselben Regel erneut verwenden können. Die Bedingung kann auch das Fehlen eines Objekts angeben.
Beispiele
Wenn Sie nur eine Instanz des Suchelements SellerName finden möchten, geben Sie zu Beginn der Regel an, dass noch keine Instanz gefunden wurde:
Sie können bei der Verwendung negativer Bedingungen keinen Variablennamen zuweisen, da eine negative Bedingung bedeutet, dass kein Objekt vorhanden ist.
Diese Bedingung prüft, ob eine benannte Entität „Address“ existiert:
Siehe Existence condition für Details zur in diesem Abschnitt verwendeten Syntax.
Tokenvorlage (erforderlich)
Besteht aus einer Folge von Token. Ein Token ist ein Wort einer natürlichen Sprache oder ein Satzzeichen. Token enthalten in der Regel keine Leerzeichen, abgesehen von einigen seltenen Fällen, in denen das Leerzeichen innerhalb einer Konstruktion steht, die als ein einzelnes Wort verwendet wird: such as, a lot.
Beispiel
Die folgende Token-Vorlage besteht aus einem Token, das dem Schlüsselwort „Grantor“ entspricht, einem Token mit einem Doppelpunkt und einem wiederholten Token mit der benannten Entität Person (als wiederholend angegeben, da der Name einer Person aus mehreren Wörtern bestehen kann, wobei jedes ein eigenes Token ist):
Die Vorlage erkennt eine Textzeichenfolge wie „Grantor: Anne Smith“ und weist der Variablen p den Wert „Anne Smith“ zu.
Siehe Token Template für Details zur in diesem Abschnitt verwendeten Syntax.
Zusätzliche Prüfung (optional)
Prüft zusätzliche Bedingungen für Objekte, die bereits in der Regel erwähnt wurden.
Beispiel
Angenommen, Sie suchen die Parteien eines Vertrags und haben die Felder in zwei separate Gruppeninstanzen aufgeteilt, eine für jede Partei. Nachdem Sie einen Organisationsnamen und eine Adresse gefunden haben, können Sie prüfen, ob diese Suchelemente denselben übergeordneten Eintrag haben. Ist das der Fall, bedeutet dies, dass diese Adresse zu dieser Organisation gehört.
Siehe Additional check für Details zur hier verwendeten Syntax.
Struktur des rechten Teils
Der rechte Teil besteht aus einem oder mehreren durch Kommas getrennten Abschnitten, die neue Instanzen von Gruppen und Suchelementen erstellen und den Suchelementen Werte zuweisen:
Üblicherweise findet der linke Teil der Regel ein Token, eine Tokenfolge oder ein Objekt und weist es einer Variablen zu. Anschließend kann der rechte Teil diese Variable verwenden, um ihren Wert in eines der Suchelemente zu schreiben. Beispielsweise schreibt der folgende Code den Wert von t in das Suchelement Element1:
Beispiel
Siehe rechter Teil für Details zur in diesem Abschnitt verwendeten Syntax.
Code erstellt nur Instanzen von Such-Elementen und Gruppen-Such-Elementen, die in der Aktivität Extraction Rules bereits vorhanden sind. Es können keine neuen Such-Elemente per Code erstellt werden. Um zusätzliche Such-Elemente in der Struktur zu erstellen, verwenden Sie die Registerkarte Search Elements im Activity Editor.
Verweisen auf Suchelemente
Um in Code auf ein Suchelement zuzugreifen, müssen Sie einen Namen verwenden, der dieses Element eindeutig identifiziert. Wenn ein Element einen eindeutigen Namen hat, können Sie einfach über diesen Namen darauf verweisen. Wenn es mehrere Elemente mit demselben Namen gibt, müssen Sie einen ausreichend langen Pfad angeben, um das Element eindeutig zu identifizieren.
Betrachten Sie die folgende verschachtelte Struktur von Suchelementen:
Um im Code auf den Namen des Käufers zu verweisen, können Sie einfach „FullName“ verwenden, da das Element mit diesem Namen eindeutig ist. „Buyer.FullName“ oder „Root.Buyer.FullName“ funktionieren genauso.
Um auf die Adresse des Käufers zu verweisen, müssen Sie mindestens den Namen der übergeordneten Gruppe angeben, da es zwei Elemente namens „Address“ gibt. Verwenden Sie hier „Buyer.Address“ oder „Root.Buyer.Address“.
Sie können die Sprache des Dokuments angeben, für die die Regel ausgeführt werden soll. Dadurch wird die Regel für andere Sprachen übersprungen. Stellen Sie der Regel ein Rautezeichen (#) und den zweistelligen Sprachcode (ISO-639-1) voran.
Codes für die unterstützten Sprachen
Wenn Sie beispielsweise Dokumente in Englisch und Spanisch verarbeiten, möchten Sie möglicherweise sprachspezifische Schlüsselwörter verwenden: