Wyszukiwanie tekstu w usłudze Adobe Acrobat Sign

• Omówienie
• Jak działa wyszukiwanie tekstu
  • POLE TYTUŁ UMOWY
• Wyszukiwanie ze specjalną składnią kwerendy
  • ZASTRZEŻONE ZNAKI I SŁOWA
  • DOPASOWANIE FRAZ
  • PREFIKS NAZWY POLA
  • SYMBOLE WIELOZNACZNE
  • WYRAŻENIA LOGICZNE

Omówienie

Aplikacja Acrobat Sign umożliwia złożone wyszukiwanie zawartości w umowach użytkownika. Pasek wyszukiwania, znajdujący się na stronie Zarządzaj, zwraca wszystkie transakcje pasujące do ciągu podanego dla wybranego źródła zawartości.

• Jeśli patrzysz na „swoje umowy”, wyszukujesz w swojej zawartości. Jeśli patrzysz na współdzielone konto, wyszukujesz w zawartości kont współdzielonych.

Zawartość poniższych pól indeksuje się podczas tworzenia/aktualizowania transakcji:

• Tytuł — tytuł umowy.
• Uwaga — prywatna notatka uczestnika do umowy; nie jest ona widoczna dla nikogo innego.
• Wiadomość — lista wiadomości widocznych dla tego uczestnika (w tym wiadomości publiczne i prywatne).
• Oryginalna nazwa pliku — oryginalna nazwa przesłanego pliku powiązanego z umową.
• Adres e-mail — adres e-mail odbiorcy (w tym DW) lub nadawcy.
• Imię i nazwisko — imię i nazwisko odbiorcy (w tym DW) lub nadawcy.
• Stanowisko — nazwa stanowiska odbiorcy (w tym DW) lub nadawcy.
• Nazwa firmy — nazwa firmy lub organizacji odbiorcy (w tym DW) lub nadawcy.
• Nazwa grupy odbiorców — nazwa grupy umowy ad hoc, do której mogą należeć odbiorcy.
• Treść pola tekstowego — treść pola tekstowego w formularzu wypełniana przez użytkownika.
• Imię i nazwisko udostępniającego — imię i nazwisko osoby udostępniającej umowę. W przypadku braku udostępniania jest to nazwa użytkownika.
• Nazwa grupy odbiorców udostępniającego — nazwa grupy odbiorców osoby udostępniającej umowę. W przypadku braku udostępniania jest to nazwa grupy odbiorców użytkownika.
• Identyfikator zewnętrzny — identyfikator nadawcy powiązany z umową, który może mieć dowolną postać, ale najczęściej wygląda następująco: „<groupID>:<ID>”. Identyfikator zewnętrzny jest przekazywany w wywołaniu interfejsu API tworzenia umowy.
• Identyfikator grupy zewnętrznej — grupowy identyfikator nadawcy powiązany z umową, który może mieć dowolną postać, ale najczęściej jest używany jako prefiks identyfikatora zewnętrznego. Identyfikator grupy zewnętrznej jest przekazywany w wywołaniu interfejsu API tworzenia umowy. W przypadku ustawienia parametru identyfikatora grupy zewnętrznej należy ustawić identyfikator zewnętrzny.
• Identyfikator transakcji — identyfikator przypisany do umowy przez program Acrobat Sign po jej utworzeniu.

Jak działa wyszukiwanie tekstu

Jeśli szukasz ciągu: „Zwykła ryba morska”:

• Wyszukiwanie Acrobat Sign dzieli ciąg na tokeny, używając spacji jako separatorów. Powyższy przykład ciągu rozbitego na trzy tokeny: Zwykła, ryba, i morska.
  • Znaki w kwerendzie ciągu należą do jednego z trzech typów: litera, cyfra lub separator.
  • Znaki traktowane jako separatory (inne niż spacja): ~ ` ! @ # $ % ^ & * ( ) - + = { } [ ] | \ . , : ; " ' < > ? /
    • Kropki, znaki podkreślenia i apostrofy pozostają częścią tokena, jeśli znaki przed i po tym symbolu są tego samego typu.
    • Cudzysłowy otaczające cały ciąg kwerendy nie są separatorami i określają dosłowną wartość ciągu (frazę).
    • Cudzysłowy wewnątrz ciągu kwerendy są separatorami i nie określają dosłownej wartości ciągu.
• Rozróżnianie wielkich i małych liter zostaje usunięte. np., zwykła, ryba,  morska
• Następnie funkcja wyszukiwania próbuje dopasować pełny tekst każdego tokenu do wartości indeksowanej.
  • Bardziej złożone tokenowanie stosuje się w przypadku nazwy umowy (patrz poniżej).
• Użyto wyszukiwania zbiorczego, co oznacza, że każda umowa, która pasuje do co najmniej jednego tokena z co najmniej jednego wyszukiwalnego pola, jest uwzględniona w zwróconym zestawie danych.
  • Zwrócony zestaw danych jest sortowany według istotności z najbardziej istotnym wynikiem wyszukiwania na górze.

POLE TYTUŁ UMOWY

Jak wspomniano powyżej, w przypadku pola Tytuł umowy stosuje się bardziej zaawansowane tokenowanie ze względu na dodatkowy „dostosowany” tokenizer, który głównie tokenuje separatory kontekstu (przeciwnie do znaków specjalnych). Ten niestandardowy tokenizer różni się od standardowego w następujący sposób:

• Generuje tokeny prefiksu (do dziesięciu znaków) — token prefiksu to ciąg przyrostu dowolnego standardowego tokenu. Na przykład, jeżeli tokenem standardowym jest ryba, to tokeny przyrostu to: r, ry, ryb i ryba
  • Umożliwia to wyszukiwanie częściowych ciągów znaków od pierwszego znaku tokenu
  • Dopasowania wewnątrz ciągu są ignorowane. Na przykład, wyszukiwanie oba nie będzie zgodne ze słowem zobaczyć
• Dzielenie tokenów na znaki inne niż alfanumeryczne. Na przykład, ciąg: Super_Duper daje tokeny: Super i Duper
  • Znaki podkreślenia nie są separatorami w standardowym tokenizerze
• Dzielenie tokenów przy zmianie wielkości liter. Na przykład, ciąg: PowerShot daje tokeny: Power i Shot
• Dzielenie tokenów przy przejściu z liter do cyfr. Na przykład, ciąg XL500 daje tokeny XL i 500
• Usuwa z każdego tokenu separatory wiodące lub końcowe. Na przykład, ciąg: XL---42+'Autocoder’ daje tokeny: XL, 42 i Autocoder
• Usuwa angielskie zaimki dzierżawcze z końca każdego tokenu. Na przykład, ciąg: Dave's daje token: Dave

Należy pamiętać, że kombinacja standardowych i niestandardowych tokenizerów umożliwia wyszukiwanie pełnego ciągu tokenu (dzięki standardowemu tokenizerowi) i tokenów prefiksu (dzięki niestandardowemu tokenizerowi). Nie pozwala jednak na dopasowanie tokenu prefiksu, który jest separatorem.

Przykład: Jeśli umowa ma nazwę My_NDA

• Standardowy tokenizer wyprodukuje token, który będzie wyglądał następująco my_nda
• Niestandardowy tokenizer wyprodukowałby szereg tokenów: m, my, n, nd, nda, my_, my_n, my_nd, my_nda

Przykład 2: Jeśli umowa ma nazwę XL500

• Standardowy tokenizer wygeneruje token, który będzie wyglądał następująco xl500
• Niestandardowy tokenizer wygeneruje szereg tokenów: xl500, x, xl, 5, 50, 500, xl5, xl50

Wyszukiwanie ze specjalną składnią kwerendy

Zgodnie z opisem w sekcji powyżej funkcja wyszukiwania umowy wyszukuje przybliżone dopasowania wszystkich wyszukiwalnych pól umowy. Wyszukiwalna zawartość pola jest tokenizowana, a następnie tokeny te są dopasowywane do ciągu kwerendy w czasie wykonywania zapytania. Funkcja wyszukiwania umów przeprowadza również dopasowania prefiksów do dziesięciu znaków dla tych tokenów. Jeżeli w umowie zostanie znalezione co najmniej jedno dopasowanie tokena, umowa ta zostanie wyświetlona w wynikach wyszukiwania.  Rezultaty wyszukiwania są sortowane według istotności z najbardziej istotnym wynikiem wyszukiwania na górze.

Jednak dopasowywanie całej wartości pola, dopasowywanie frazy z wartości pola, wyszukiwanie umów, które nie zawierają określonego tokena, wyszukiwanie umów, które zawierają kilka tokenów jednocześnie (nie frazę), można uzyskać tylko za pomocą specjalnej składni. Język Sign Generic Query Language (SGQL) został opracowany w celu zaspokojenia potrzeb klientów w zakresie tych funkcji, które wymagają specjalnej składni.

ZASTRZEŻONE ZNAKI I SŁOWA

SGQL ma siedem zarezerwowanych znaków:

Te zarezerwowane znaki są używane w charakterze operatorów i określają cechy językowe w zapytaniu wyszukiwawczym. Jeśli zastrzeżony znak zostanie użyty niepoprawnie, zwracany jest błąd składni.  

Aby używać znaków zarezerwowanych jako zwykłych znaków w wyszukiwaniu, należy je wymazać. Na przykład, zapytanie

zawiera wszystkie znaki zastrzeżone, które są traktowane jako zwykłe znaki.

SGQL posiada również trzy słowa zarezerwowane dla operatorów:

Operatory muszą być zapisane wielką literą. Aby użyć operatorów jako zwykłych tokenów w zapytaniu, należy je ująć w podwójne cudzysłowy. Na przykład:

DOPASOWANIE FRAZ

Zwykła kwerenda o przybliżonym dopasowaniu będzie zgodna, jeśli DOWOLNY z tokenów pojawi się w polu (ale niekoniecznie wszystkie). Kolejność tokenów nie ma znaczenia, ponieważ tokeny nie muszą pojawiać się razem.

Kwerendy dopasowania frazy należy używać, kiedy potrzebne jest dokładne wyszukiwanie frazy bez rozróżniania wielkości liter w jednym lub kilku wyszukiwanych polach. Pozwala to na dopasowanie tam, gdzie kilka tokenów pojawia się w tym samym polu i tokeny te są wyświetlane po kolei w kolejności określonej w cudzysłowach.

Format składni kwerendy o dopasowanie frazy:

  lub 

Jeśli składnia kwerendy nie jest zgodna z regułami dla składni kwerendy dopasowania frazy, wyszukiwanie obejmuje kwerendę o przybliżonym dopasowaniu we wszystkich wyszukiwalnych polach.

Na przykład: query

będzie zgodna z umowami zawierającymi frazę „grupa studyjna” w dowolnym polu z możliwością wyszukiwania. Zwróć uwagę, że fraza „grupa - studyjna” nie będzie dopasowana dla tej kwerendy, ponieważ nie jest to dokładna fraza bez rozróżniania wielkości liter w porównaniu z „Grupa studyjna”.

Dopasowanie fraz może wystąpić w dowolnym miejscu kwerendy wyszukiwania. Na przykład

będzie dopasowaniem do tytułu „Materiały kursu dla MATEMATYKI 101 Grupa studyjna”, ponieważ tytuł ten zawiera słowo kluczowe „MATEMATYKA” oraz frazy „Materiały kursu” i „Grupa studyjna”.

PREFIKS NAZWY POLA

Kwerenda prefiksu nazwy pola powinna być używana w przypadku wyszukiwania tylko jednego, konkretnego pola w ramach umów użytkownika.

Kwerenda prefiksu nazwy pola musi zawierać prefiks nazwy pola, po którym następuje kwerenda wyszukiwania. Format składni kwerendy prefiksu nazwy pola:

Prefiks nazwy pola może występować przed tokenem lub przed nawiasem części kwerendy. Na przykład, w zapytaniu

wszystkie tokeny są dopasowywane do pola tytułu umowy.

W poniższym zapytaniu

tylko słowo „Witaj” ma prefiks nazwy pola, a słowo to jest dopasowywane tylko do pola tytułu umowy. Pozostałe słowa i frazy są dopasowywane do wszystkich wyszukiwanych pól.

Jeśli nie określono pola <field_name>, kwerenda obejmuje wszystkie pola obsługujące dopasowania frazy. W przeciwnym razie kwerenda obejmie tylko pola <field_name>. 

Jeśli składnia kwerendy nie jest zgodna z regułami składni kwerendy prefiksu nazwy pola, funkcja wyszukiwania umowy wykorzystuje pełną kwerendę i przeszukuje wszystkie wyszukiwalne pola. 

Na przykład kwerenda o prefiks nazwy pola:

przeprowadza wyszukiwanie tylko w polu zawierającym tytuł umowy.

Poniżej znajduje się lista prefiksów obsługiwanych przez kwerendy o nazwy pola. Prefiksy nazwy pola nie uwzględniają wielkości liter. 

W celu zapewnienia zgodności ze starszymi wersjami niektóre prefiksy nazw pól mają aliasy, których funkcjonalność jest równoważna oryginalnym prefiksom nazw pól. Te aliasy zostały wycofane i zostaną ostatecznie usunięte:

  * Zamiast nazwy „title” można użyć prefiksu nazwy pola „name”.

 ** Zamiast prefiksu „email” można użyć prefiksu nazwy pola „participantEmail”.  

*** Zamiast prefiksu „fullName” można użyć prefiksu nazwy pola „participantName”.

SYMBOLE WIELOZNACZNE

Symbol wieloznaczny ( gwiazdka * ) może być użyty do dopasowania prefiksu, po którym następuje nieograniczona liczba znaków w tokenie. Rozszerzanie symbolu wieloznacznego jest kosztowną operacją wykonywaną w czasie rzeczywistym, dlatego aby móc korzystać z tej funkcji, należy przestrzegać następujących zasad składni:

• Wiodące symbole wieloznaczne nie są dozwolone.
• Symbole wieloznaczne w środku tokena nie są dozwolone.
• Przedrostek nazwy pola jest wymagany dla tokena, który posiada operator rozszerzenia wieloznacznego.
• Operator wieloznaczny nie może być użyty więcej niż raz w zapytaniu.
• Kwerendy zawierające rozwinięcie wieloznaczne zwracają błąd przekroczenia limitu czasu, jeśli czas wykonania przekracza pięć sekund.

Na przykład: query

dopasowuje tokeny pola tytułowego

i 

Rozszerzanie symboli wieloznacznych to kosztowna operacja. Jeśli jest używana nierozsądnie, zużywa dużo zasobów systemowych i użytkownik może długo czekać na wyniki wyszukiwania. Aby uniknąć tych problemów, SGQL posiada ograniczenia w stosowaniu symboli wieloznacznych, które eliminują najbardziej kosztowne i zasobochłonne przypadki użycia. Im bardziej szczegółowe są tokeny, tym skuteczniejsze jest wyszukiwanie. Wyszukiwanie konkretnego słowa lub frazy jest zawsze bardziej efektywne niż wyszukiwanie z użyciem symboli wieloznacznych.

WYRAŻENIA LOGICZNE

SGQL obsługuje operatory logiczne: AND, OR i NOT, a także grupowanie tych operatorów za pomocą nawiasów. Operatory muszą być zapisane wielką literą.

Operator OR jest zawsze implikowany między tokenami. Na przykład

jest taki sam jak

Jeśli nie chcesz dołączać operatora OR ze względu na przejrzystość, nie musisz go podawać.

Operator NOT dotyczy tylko tokenów występujących bezpośrednio po NOT. Aby zastosować operator NOT do wielu tokenów, należy ująć te tokeny w nawiasy.

W poniższej tabeli opisano kolejność obliczania wyrażeń logicznych.

W poniższej tabeli znajdują się przykłady semantycznie równoważnych zapytań, które wyjaśniają pierwszeństwo operatorów w przypadku, gdy nie są podane operatory grupujące (nawiasy).