Textsuche in Adobe Acrobat Sign

• Übersicht
• Funktionsweise der Textsuche
  • DAS FELD „VEREINBARUNGSTITEL“
• Suche mit spezieller Abfragesyntax
  • RESERVIERTE ZEICHEN UND WÖRTER
  • AUSDRUCKSÜBEREINSTIMMUNG
  • FELDNAMENPRÄFIX
  • PLATZHALTER
  • BOOLESCHE AUSDRÜCKE

Übersicht

Acrobat Sign ermöglicht eine komplexe Suche nach Inhalten in den Vereinbarungen des Benutzers. Die Suchleiste gibt alle auf der Seite Verwalten gefundenen Transaktionen zurück, die mit der für die ausgewählte Inhaltsquelle angegebenen Zeichenfolge übereinstimmen.

• Unter „Ihre Vereinbarungen“ suchen Sie nach Ihren Inhalten. In einem freigegebenen Konto suchen Sie nach dem Inhalt dieses freigegebenen Kontos.

Der Inhalt in den folgenden Feldern wird indiziert, wenn eine Transaktion erstellt/aktualisiert wird:

• Titel: Vereinbarungstitel.
• Anmerkung: Eine private Anmerkung zur Vereinbarung des Teilnehmers, die für andere nicht sichtbar ist.
• Nachricht: Eine Liste der Nachrichten, die für diesen Teilnehmer sichtbar sind (umfasst öffentliche und private Nachrichten).
• Ursprünglicher Dateiname: Ursprünglicher Name einer hochgeladenen Datei, der mit der Vereinbarung verknüpft ist.
• E-Mail: Empfänger (einschließlich CCs) oder E-Mail-Adresse des Absenders.
• Vollständiger Name: Vor- und Nachname des Empfängers (einschließlich CCs) oder Absenders.
• Stellenbezeichnung: Stellenbezeichnung des Empfängers (einschließlich CCs) oder Absenders innerhalb des Unternehmens.
• Firmenname: Firmenname des Empfängers (einschließlich CCs) oder Absenders.
• Name der Empfängergruppe: Name der Ad-hoc-Vereinbarungsgruppe, zu der Empfänger gehören können.
• Inhalt des Textfeldes: Von einem Benutzer bereitgestellter Inhalt des Textfeldes im Formular.
• Vollständiger Name des freigebenden Benutzers: Vollständiger Name des freigebenden Benutzers der Vereinbarung. Bei Nicht-Freigabe ist dies der Name des Benutzers.
• Name der Empfängergruppe des freigebenden Benutzers: Name der Empfängergruppe des freigebenden Benutzers der Vereinbarung. Bei Nicht-Freigabe ist dies der Name der Empfängergruppe des Benutzers.
• Externe ID: Der Absender hat der Vereinbarung eine ID zugewiesen, die in einer beliebigen Form vorliegen kann, in der Regel jedoch als „<groupID>:<ID>“. Externe ID wird im Aufruf an die API zur Vereinbarungserstellung übergeben.
• Externe Gruppen-ID: Der Absender weist der Vereinbarung eine Gruppen-ID zu, die in einer beliebigen Form vorliegen kann und normalerweise als Präfix für die externe ID verwendet wird. Die externe Gruppen-ID wird im Aufruf an die API zur Vereinbarungserstellung übergeben. Sie müssen eine externe ID angeben, wenn Sie den Parameter „Externe Gruppen-ID“ festlegen.
• Transaktions-ID : ID, die dem Vertrag bei der Erstellung von Acrobat Sign zugewiesen wurde.

Funktionsweise der Textsuche

Wenn Sie zum Beispiel nach der Zeichenfolge: „Ein einfacher Fisch“ suchen,

• übersetzt Acrobat Sign die Zeichenfolge in Tokens, wobei Leerzeichen als Trennzeichen verwendet werden. Die obige Beispielzeichenfolge wird in drei Token unterteilt: Ein, einfacher und Fisch
  • Zeichen in Abfragezeichenfolgen gehören zu einer von drei verschiedenen Arten: Buchstabe, Zahl oder Trennzeichen.
  • Zeichen, die als Trennzeichen behandelt werden (außer Leerzeichen), sind: ~ ' ! @ # $ % ^ & * ( ) - = { } [ ] | \. ,: ; " " < >? /
    • Punkte, Unterstriche und Apostrophe bleiben als Teil eines Tokens erhalten, wenn die Zeichen vor und nach diesem Symbol zur gleichen Art gehören.
    • Anführungszeichen, die die gesamte Abfragezeichenfolge umschließen, sind keine Trennzeichen und geben einen literalen Zeichenfolgenwert (Ausdruck) an
    • Anführungszeichen innerhalb einer Abfragezeichenfolge sind Trennzeichen und geben keinen literalen Zeichenfolgenwert an..
• Die Unterscheidung zwischen Groß- und Kleinschreibung wird aufgehoben. Beispiel: ein, einfacher und fisch
• Die Suche versucht dann, den gesamten Text jedes Tokens einem indexierten Wert zuzuordnen
  • Eine komplexere Tokenisierung erfolgt für den Vereinbarungstitel  (siehe unten).
• Es wird eine umfassende Suche verwendet, d. h., jede Vereinbarung, die mindestens einem Token aus mindestens einem durchsuchbaren Feld entspricht, wird in den zurückgegebenen Datensatz aufgenommen
  • Der zurückgegebene Datensatz wird nach einem Relevanzwert  sortiert. Die wichtigsten Suchergebnisse werden zuerst zurückgegeben.

DAS FELD „VEREINBARUNGSTITEL“

Wie bereits erwähnt, weist das Feld Vereinbarungstitel aufgrund eines zusätzlichen „angepassten“ Tokenizers, der in erster Linie Kontext-Trennzeichen (im Vergleich zu expliziten Zeichen) tokenisiert, eine ausgefeiltere Tokenisierung auf. Dieser benutzerdefinierte Tokenizer unterscheidet sich von dem Standard wie folgt:

• Präfixtoken (bis zu zehn Zeichen) werden generiert. Ein Präfixtoken ist die inkrementelle Zeichenfolge eines beliebigen Standardtokens. Beispiel: Wenn das Standardtoken welt ist, lauten die inkrementellen Token: w, we, wel und welt.
  • Dies ermöglicht die Suche nach Teilzeichenfolgen, wenn Sie mit dem ersten Zeichen des Tokens beginnen.
  • Übereinstimmungen in der Mitte der Zeichenfolge werden ignoriert. Beispiel: Bei der Suche nach sicht gibt es beim Wort offensichtlich keine Übereinstimmung.
• Token bei nicht alphanumerischen Zeichen teilen. Beispiel: Die Zeichenfolge Super_Duper ergibt die Token Super und Duper.
  • Unterstriche sind keine Trennzeichen im Standard-Tokenizer
• Token bei Übergängen zwischen Klein- und Großbuchstaben teilen. Beispiel: Die Zeichenfolge PowerShot ergibt die Token Power und Shot.
• Token bei Übergängen zwischen Buchstaben und Zahlen teilen. Beispiel: Die Zeichenfolge XL500 ergibt die Token XL und 500.
• Führende oder nachfolgende Trennzeichen aus jedem Token entfernen. Beispiel: Die Zeichenfolge XL---42+'Autocoder' ergibt die Token XL, 42 und Autocoder.
• Die englische Possessivendung ('s) vom Ende jedes Tokens entfernen. Beispiel: Die Zeichenfolge Dave's ergibt das Token Dave.

Beachten Sie, dass Sie mit der Kombination aus Standard- und benutzerdefinierten Tokenizern nach der vollständigen Zeichenfolge des Tokens (dank des Standard-Tokenizers) und den Präfixtoken (dank des benutzerdefinierten Tokenizers) suchen können. Es wird jedoch kein Präfixtoken angezeigt, das ein Trennzeichen umfasst.

Beispiel: Sie haben eine Vereinbarung mit dem Namen My_NDA

• Der Standard-Tokenizer würde ein Token erzeugen, das wie folgt aussieht my_nda.
• Der benutzerdefinierte Tokenizer würde eine Reihe von Token erzeugen: m, my, n, nd, nda, my_, my_n, my_nd, my_nda.

Beispiel 2: Sie haben eine Vereinbarung mit dem Namen XL500

• Der Standard-Tokenizer würde ein Token erzeugen, das wie folgt aussieht xl500.
• Der benutzerdefinierte Tokenizer würde eine Reihe von Präfixtoken erzeugen: xl500, x, xl, 5, 50, 500, xl5, xl50.

Suche mit spezieller Abfragesyntax

Wie im obigen Abschnitt beschrieben, führt die Vereinbarungssuche einen ungefähren Abgleich aller durchsuchbaren Felder einer Vereinbarung durch. Der Inhalt von durchsuchbaren Feldern wird mit einem Token versehen und diese Token werden dann bei der Abfrage mit der Abfragezeichenfolge verglichen. Die Vereinbarungssuche führt auch einen Präfixabgleich mit bis zu zehn Zeichen für diese Token durch. Wenn in einer Vereinbarung mindestens eine Tokenübereinstimmung gefunden wird, wird diese Vereinbarung in den Suchergebnissen angezeigt.  Die Suchergebnisse werden nach einem Relevanzwert sortiert, wobei die wichtigsten Suchergebnisse zuerst zurückgegeben werden.

Übereinstimmungen mit einem gesamten Feldwert, Übereinstimmungen mit einem Ausdruck aus einem Feldwert, Suchvorgänge nach Vereinbarungen, die kein bestimmtes Token enthalten, Suchvorgänge nach Vereinbarungen, die mehrere Token gleichzeitig enthalten (keinen Ausdruck), können jedoch nur mit einer speziellen Syntax erreicht werden. Die allgemeine Sign-Abfragesprache (Sign Generic Query Language, SGQL) wurde entwickelt, um die Anforderungen der Kunden an Funktionen zu erfüllen, die eine spezielle Syntax erfordern.

RESERVIERTE ZEICHEN UND WÖRTER

SGQL hat sieben reservierte Zeichen:

Diese reservierten Zeichen werden als Operatoren verwendet und definieren Sprachfunktionen in einer Suchabfrage. Wenn ein reserviertes Zeichen falsch verwendet wird, wird ein Syntaxfehler zurückgegeben.  

Um reservierte Zeichen als reguläre Zeichen in einer Suchabfrage zu verwenden, müssen sie escaped werden. In der Suchabfrage

wurden zum Beispiel alle reservierten Zeichen escaped und werden als reguläre Zeichen behandelt.

SGQL verfügt außerdem über drei reservierte Wörter für Operatoren:

Die Operatoren müssen groß geschrieben werden. Um Operatoren als reguläre Token in einer Suchabfrage zu verwenden, müssen sie in doppelte Anführungszeichen eingeschlossen werden. Beispiel:

AUSDRUCKSÜBEREINSTIMMUNG

Eine reguläre Abfrage für eine ungefähre Übereinstimmung stimmt überein, wenn EINES der Token in einem Feld angezeigt wird (aber nicht unbedingt alle). Die Tokenreihenfolge ist dabei irrelevant, da Token nicht zusammen angezeigt werden müssen.

Wenn eine groß-/kleinschreibungsunabhängige exakte Ausdruckssuche in einem oder mehreren durchsuchbaren Feldern erforderlich ist, sollte eine Abfrage zur Ausdrucksübereinstimmung verwendet werden. So kann abgeglichen werden, wo mehrere Token im selben Feld angezeigt werden. Diese Token werden in der innerhalb der Anführungszeichen angezeigten Reihenfolge nacheinander angegeben.

Syntaxformat der Ausdrucksübereinstimmungsabfrage:

  oder 

Wenn die Abfragesyntax nicht den Regeln für die Abfragesyntax einer Ausdrucksübereinstimmung entspricht, führt die Suche eine normale Abfrage für eine ungefähre Übereinstimmung unter allen durchsuchbaren Feldern durch.

Beispiel: Die Abfrage

stimmt mit Vereinbarungen überein, die den Begriff Untersuchungsgruppe in einem der durchsuchbaren Felder enthalten. Beachten Sie, dass für den Ausdruck Untersuchung – Gruppe bei dieser Abfrage keine Übereinstimmung angezeigt wird, da es sich im Gegensatz zu Untersuchungsgruppe nicht um einen groß-/kleinschreibungsunabhängigen exakten Ausdruck handelt.

Eine Ausdrucksübereinstimmung kann an jeder Stelle innerhalb einer Suchabfrage auftreten. Beispiel:

entspricht dem Titel „Kursmaterialien für die Studiengruppe MATHEMATIK 101“, da dieser Titel das Stichwort „MATHEMATIK“ und die Wörter „Kursmaterialien“ und „Studiengruppe“ enthält.

FELDNAMENPRÄFIX

Eine Feldnamenpräfixabfrage sollte verwendet werden, wenn nur nach einem bestimmten Feld in einer Benutzervereinbarung gesucht wird.

Die Feldnamenpräfixabfrage muss ein Präfix für den Feldnamen enthalten, gefolgt von einer Suchabfrage. Syntaxformat der Feldnamenpräfixabfrage:

Das Präfix für den Feldnamen kann vor einem Token oder vor einem in Klammern gesetzten Teil einer Abfrage stehen. In der Suchabfrage

werden zum Beispiel alle Token mit dem Vereinbarungstitelfeld abgeglichen.

In der Suchabfrage unten

hat nur das Wort „Hello“ ein Feldnamenpräfix und dieses Wort wird nur mit dem Vereinbarungstitelfeld abgeglichen. Die restlichen Wörter und Ausdrücke werden mit allen durchsuchbaren Feldern abgeglichen.

Wenn <Feldname> nicht angegeben ist, werden alle Felder abgefragt, die für die Ausdrucksübereinstimmung unterstützt werden. Andernfalls wird nur das Feld <Feldname> abgefragt. 

Wenn die Abfragesyntax nicht den Regeln für die Syntax einer Feldnamenpräfixabfrage entspricht, verwendet die Vereinbarungssuche die gesamte Abfrage als Suchabfrage und führt eine Suche unter allen durchsuchbaren Feldern durch. 

Beispiel: Die Feldnamenpräfixabfrage

führt eine Suche nur in dem Feld durch, das den Titel der Vereinbarung enthält.

Nachfolgend finden Sie eine Liste der Präfixe, die für die Feldnamenpräfixabfrage unterstützt werden. Feldnamenpräfixe sind groß-/kleinschreibungsunabhängig. 

Zur Abwärtskompatibilität verfügen einige Feldnamenpräfixe über Aliase, die in der Funktionalität den ursprünglichen Feldnamenpräfixen entsprechen. Diese Aliase sind veraltet und werden am Ende entfernt:

  *  Das Feldnamenpräfix „name“ kann anstelle von „title“ verwendet werden.

 ** Das Feldnamenpräfix „participantEmail“ kann anstelle von „email“ verwendet werden.  

*** Das Feldnamenpräfix „participantName“ kann anstelle von „fullName“ verwendet werden.

PLATZHALTER

Ein Platzhalter (Sternchen *) kann verwendet werden, um einen Präfixabgleich gefolgt von einer unbegrenzten Anzahl von Zeichen in einem Token durchzuführen. Die Platzhaltererweiterung ist ein aufwändiger Vorgang, der zur Laufzeit ausgeführt wird. Daher müssen die folgenden Syntaxregeln befolgt werden, um dieses Feature verwenden zu können:

• Führende Platzhalter sind nicht zulässig.
• Platzhalter in der Mitte eines Tokens sind nicht zulässig.
• Ein Feldnamenpräfix ist für ein Token erforderlich, das einen Operator für die Platzhaltererweiterung hat.
• Ein Platzhalteroperator kann nicht mehrmals in einer Abfrage verwendet werden.
• Abfragen, die eine Platzhaltererweiterung enthalten, geben einen Zeitüberschreitungsfehler aus, wenn die Ausführungszeit fünf Sekunden überschreitet.

Beispiel: Die Abfrage

stimmt mit den folgenden Titelfeldtoken überein:

und

Die Platzhaltererweiterung ist ein aufwändiger Vorgang. Bei unbedachtem Einsatz verbraucht dieser Vorgang viele Systemressourcen und Sie warten möglicherweise lange auf Ihre Suchergebnisse. Um dieses Problem zu vermeiden, implementiert SGQL Einschränkungen bei der Verwendung von Platzhaltern, wodurch die aufwändigsten und ressourcenintensiven Anwendungsfälle entfallen. Je spezifischer Ihre Token sind, desto effizienter ist die Suche. Die Suche nach einem bestimmten Wort oder Ausdruck ist immer effizienter als die Suche mit einem Platzhalter.

BOOLESCHE AUSDRÜCKE

SGQL unterstützt die booleschen Operatoren AND, OR und NOT sowie die Gruppierung dieser Operatoren mithilfe von Klammern. Die Operatoren müssen groß geschrieben werden.

Der Operator OR wird immer zwischen Token verwendet. Beispiel:

ist identisch mit

Sofern Sie dies nicht aus Gründen der Übersichtlichkeit wünschen, besteht keine Notwendigkeit, den Operator OR anzugeben.

Der NOT-Operator gilt nur für das Token unmittelbar nach dem NOT. Um den Operator NOT auf mehrere Token anzuwenden, müssen Sie die betreffenden Token in Klammern setzen.

Die folgende Tabelle beschreibt die Reihenfolge, in der boolesche Ausdrücke ausgewertet werden.

In der folgenden Tabelle finden Sie Beispiele für semantisch äquivalente Abfragen, die die Operatorpriorität erklären, wenn keine Gruppierungsoperatoren (Klammern) angegeben werden.