Tekstsøk i Adobe Acrobat Sign

• Oversikt
• Slik fungerer tekstsøk
  • AVTALETITTELFELTET
• Søk med spesiell spørringssyntaks
  • RESERVERTE TEGN OG ORD
  • UTTRYKKSMATCH
  • FELTNAVNPREFIKS
  • JOKERTEGN
  • BOOLSKE UTTRYKK

Oversikt

Acrobat Sign muliggjør komplekse søk for å finne innhold i brukerens avtaler. Søkelinjen på Administrer -siden, returnerer alle transaksjoner som stemmer overens med en streng som er gitt for den valgte innholdskilden.

• Hvis du ser på "Dine avtaler", søker du i innholdet ditt. Hvis du ser på en delt konto, søker du i innholdet for den delte kontoen.

Innholdet i feltene nedenfor indekseres når en transaksjon opprettes/oppdateres:

• Tittel – avtaletittel.
• Merk – et privat avtalenotat gjort av deltakeren som ikke er synlig for noen andre.
• Melding – en liste over meldinger som er synlige for denne deltakeren (inkluderer både offentlige og private meldinger).
• Originalt filnavn – originalt navn på en opplastet fil knyttet til avtalen.
• E-post – mottaker (inkludert mottakere av kopi) eller avsenderens e-postadresse.
• Fullt navn – for- og etternavn til mottakeren (inkludert mottakere av kopi) eller avsender.
• Stillingstittel – stillingstittelen til mottakeren (inkludert mottakere av kopi) eller avsender i deres firma.
• Firmanavn – firma- eller organisasjonsnavn på mottakeren (inkludert mottakere av kopi) eller avsender.
• Mottakergruppenavn – navn på ad-hoc-avtalegruppenavnet som mottakerne kan tilhøre.
• Tekstfeltinnhold – brukeroppgitt tekstfeltinnhold i skjemaet.
• Delerens fulle navn – fullt navn på den som deler avtalen. Dersom det ikke blir delt, er dette navnet på brukeren.
• Delerens mottakergruppenavn – mottakergruppenavnet til den som deler avtalen. Dersom det ikke blir delt, er dette mottakergruppenavnet til brukeren.
• Ekstern ID – avsenderens tildelte ID til avtalen som kan være av hvilken som helst form, men vanligvis i form av "<gruppeID>:<ID>". Ekstern ID sendes i kallet til API for avtaleoppretting.
• Ekstern gruppe-ID – avsenderens tildelte gruppe-ID til avtalen som kan være av hvilken som helst form, vanligvis brukt som et prefiks for ekstern ID. Ekstern gruppe-ID sendes i kallet til avtaleopprettings-API. Du må angi ekstern ID hvis du angir parameteren ekstern gruppe-ID.
• Transaksjons-ID – ID tilordnet avtalen av Acrobat Sign ved opprettelse.

Slik fungerer tekstsøk

Hvis du søkte etter strengen: "En enkel fisk"

• Acrobat Sign-søk "tokeniserer" strengen og bruker mellomrom som skilletegn. Eksempelstrengen over deles opp i tre tokener: En, enkel og fisk.
  • Tegn i strengsøk tilhører én av tre forskjellige typer: bokstav, tall eller skilletegn.
  • Tegn som behandles som skilletegn (annet enn mellomrom) er: ~ ` ! @ # $ % ^ & * ( ) - + = { } [ ] | \ . , : ; " ' < > ? /
    • Punktum, understreker og apostrof forblir som en del av et symbol hvis tegn før og etter dette symbolet er av samme type.
    • Sitater som omgir hele søkestrengen er ikke skilletegn og spesifiser en bokstavelig strengverdi (frase)
    • Sitater inne i en søkestreng er skilletegn og angir ikke en bokstavelig strengverdi.
• Skille mellom store/små bokstaver fjernes. f.eks., en, enkel, og fisk
• Søket prøver deretter å matche hver fulle tekst i hver token til en indeksert verdi.
  • Mer kompleks tokenisering skjer for Avtaletittel (se nedenfor).
• Et inkluderende søk brukes, som betyr at hver avtale som samsvarer med minst en token fra minst ett søkbart felt, inkluderes i datasettet som returneres.
  • Det returnerte datasettet er sortert etter relevansscore med det mest relevante søkeresultatet øverst.

AVTALETITTELFELTET

Som nevnt ovenfor har avtaletittel-feltet en mer sofistikert tokenisering på grunn av en ekstra "tilpasset" tokenisering som først og fremst tokeniserer på kontekstskilletegn (i motsetning til eksplisitte tegn). Denne tilpassede tokeniseringen er forskjellig fra standarden ved at:

• Prefiks-tokener (opptil ti tegn) genereres – Et prefiks-token er den inkrementelle strengen i et hvilket som helst standardtoken. Eksempel: Hvis standardtokenet er fisk, er de inkrementelle tokenene:f, fi, fis, og fisk
  • Dette gjør det mulig å søke etter delvise strenger, under forutsetning av du begynner med det første tegnet i tokenet.
  • De midterste strengsamsvarene blir ignorert. Eksempel: Et søk etter syn vil ikke matche med ordet sannsynligvis
• Del token ved ikke-alfanumeriske tegn. F.eks.: Strengen: Super_Duper gir tokenene: Super og Duper
  • Understreker er ikke skilletegn i standard tokenisering.
• Delte tokener ved overganger mellom store og små bokstaver. Eksempel: Strengen PowerShot gir tokenene Power og Shot
• Delte tokener ved overganger mellom bokstaver og tall. Eksempel: Strengen XL500 gir tokenene XL og 500
• Fjerner foranstilte eller etterstilte skilletegn fra hvert token. Eksempel: Strengen: XL---42+'Autocoder' gir tokenene:  XL, 42 og Autocoder
• Fjerner engelsk genitiv-s fra slutten av hvert token. Eksempel: Strengen Dave's gir tokenet: Dave

Vær oppmerksom på at kombinasjonen av standard og egendefinerte tokenisere lar deg søke etter den fullstendige tokenstrengen (takket være standard tokeniser) og prefikstokenene (takket være egendefinert tokeniser). Likevel vil du ikke matche et prefikstoken som strekker seg over et skilletegn. 

Eksempel: Hvis du har en avtale som heter My_NDA

• Standard tokenisering ville produsere et token som så slik ut my_nda
• Den tilpassede tokeniser ville produsere en serie av tokener: m, my, n, nd, nda, my_, my_n, my_nd, my_nda

Eksempel 2: Hvis du har en avtale med navnet XL500

• Standard tokenisering ville produsere et token som så slik ut xl500
• Den tilpassede tokeniseren vil produsere en serie tokener: xl500, x, xl, 5, 50, 500, xl5, xl50

Søk med spesiell spørringssyntaks

Som beskrevet i avsnittet ovenfor, utfører Avtalesøk en omtrentlig matching mellom alle søkbare felt i en avtale. Søkbart feltinnhold tokeniseres, og deretter matches disse tokenene med spørringsstrengen på spørringstidspunktet. Avtalesøk utfører også en prefiksmatch med opptil ti tegn for disse tokenene. Hvis det finnes minst ett token i en avtale, vil denne avtalen vises i søkeresultatene.  Søkeresultatene sorteres etter relevansscore med det mest relevante søkeresultatet øverst.

Samsvar med en hel feltverdi, samsvar med en setning fra en feltverdi, søk etter avtaler som ikke inneholder et bestemt token, søk etter avtaler som inneholder flere token samtidig (ikke en setning) kan imidlertid bare oppnås med en spesiell syntaks. SGQL (Sign Generic Query Language) ble utviklet for å imøtekomme kundenes behov for disse funksjonene som krever spesiell syntaks.

RESERVERTE TEGN OG ORD

SGQL har syv reserverte tegn:

Disse reserverte tegnene brukes som operatører og definerer språkfunksjoner i et søk. Hvis et reservert tegn brukes feil, returneres en syntaksfeil.  

Hvis du vil bruke reserverte tegn som vanlige tegn i et søk, må de kvalifiseres. For eksempel søkespørringen

har alle reserverte tegn kvalifisert, og de behandles som vanlige tegn.

SGQL har også tre reserverte ord for operatører:

Operatørene må ha store bokstaver. Hvis du vil bruke operatører som vanlige tokens i en søkespørring, må de ha to anførselstegn. Eksempel:

UTTRYKKSMATCH

En spørring med vanlig omtrentlig match vil matche hvis NOEN av tokenene vises i et felt (men ikke nødvendigvis alle), og tokenrekkefølgen er irrelevant siden tokener ikke nødvendigvis vises sammen.

En spørring med uttrykksmatching bør brukes når det kreves et uttrykkssøk blant alle søkbare felt. Den lar oss matche når flere tokener vises i samme felt, og disse tokenene vises i rekkefølgen angitt av anførselstegnene.

Syntaksformat for spørring med uttrykksmatch:

  eller 

Hvis spørringssyntaksen ikke følger reglene for en spørringssyntaks for uttrykksmatch, utfører søk en spørring med vanlig omtrentlig match blant alle søkbare felt.

For eksempel spørring

vil matche avtaler som inneholder frasen «undersøkelsesgruppe» i alle søkbare felt. Merk at uttrykket «studie - gruppe» ikke matches av denne spørringen, siden det ikke skilles mellom små og store bokstaver ved sammenligning med «Studiegruppe».

Uttrykksmatching kan vises et vilkårlig sted i en spørring. For eksempel:

vil matche tittelen «Kursmateriell for MATEMATIKK 101 Studiegruppe» siden denne tittelen inneholder nøkkelordet «MATEMATIKK» og frasene «Kursmaterialer» og «Studiegruppe».

FELTNAVNPREFIKS

En spørring med feltnavnprefiks bør brukes når du søker etter bare ett bestemt felt i brukerens avtaler.

Feltnavneprefiksspørringen må inneholde et feltnavneprefiks etterfulgt av en søkespørring. Syntaksformat for spørring med feltnavnprefiks:

Feltnavneprefikset kan vises foran et token eller foran en parentesert del av en spørring. For eksempel i søkespørringen

alle tokens er matchet mot feltet for avtaletittel.

I søkespørringen nedenfor

bare ordet «Hei» har et feltnavnprefiks, og dette ordet er bare matchet med tittelfeltet for avtalen. Resten av ordene og uttrykkene samsvarer med alle søkbare felt.

Hvis <felt_navn> ikke er angitt, vil det spørres mot alle felt som støttes for uttrykksmatch. Ellers spørres det bare mot <felt_navn>-feltet. 

Hvis spørringssyntaksen ikke følger reglene for syntaksen for feltnavnprefiksspørringen, bruker Avtalesøk hele spørringen som en søkespørring og utfører et søk blant alle søkbare felt. 

For eksempel feltnavneprefiksforespørselen:

utfører et søk kun mot feltet som inneholder tittelen på avtalen.

Nedenfor er en liste over prefikser som støttes for spørringen med feltnavnprefiks. Feltnavnprefikser skiller mellom store og små bokstaver. 

For bakoverkompatibilitet har noen av feltnavnprefiksene aliaser som i funksjonalitet tilsvarer de originale feltnavnprefiksene. Disse aliasene er avviklet og vil til slutt bli fjernet:

  *  Feltnavnsprefiks 'navn' kan brukes i stedet for 'tittel'.

 ** Feltnavnsprefiks 'deltakerE-post' kan brukes i stedet for 'e-post'.  

*** Feltnavnsprefiks 'deltakernavn' kan brukes i stedet for 'fulltNavn'.

JOKERTEGN

Et jokertegn ( stjerne * ) kan brukes til å gjøre en prefikssamsvar etterfulgt av et ubegrenset antall tegn i et token. Jokertegnutvidelse er en dyr operasjon som skjer ved kjøretid, så følgende syntaksregler må følges for å kunne bruke denne funksjonen:

• Ledende jokertegn er ikke tillatt.
• Jokertegn i midten av en token er ikke tillatt.
• Det kreves et feltnavnprefiks for et token som har en jokertegnutvidelsesoperator.
• En jokertegnoperator kan ikke brukes mer enn én gang i en spørring.
• Spørringer som inneholder en jokertegnutvidelse, returnerer en tidsavbruddsfeil hvis kjøretiden overstiger fem sekunder.

For eksempel spørring

samsvarer med tittelfelt-tokens

og

Jokertegn-utvidelse er en dyr operasjon. Hvis den brukes uklokt, brukes det mye systemressurser og du kan måtte vente lenge på søkeresultatene. For å unngå disse problemene har SGQL begrensninger på bruk av jokertegn, noe som eliminerer de dyreste og mest ressurskrevende brukstilfellene. Jo mer spesifikke tokenene dine er, desto mer effektivt er søket. Søking etter et bestemt ord eller uttrykk er alltid mer effektivt enn et søk som bruker et jokertegn.

BOOLSKE UTTRYKK

SGQL støtter de boolske operatørene: AND, OR og NOT i tillegg til gruppering av disse operatørene ved hjelp av parenteser. Operatørene må ha store bokstaver.

OR-operatøren er alltid implisitt mellom tokens. For eksempel:

er det samme som

Med mindre du ønsker å inkludere OR-operatøren av klarhetshensyn, trenger du ikke å angi det.

NOT-operatøren gjelder bare for tokens som umiddelbart etterfølger NOT. Hvis du vil bruke NOT-operatøren på flere tokens, må du omgi disse tokensene i parentes.

Følgende tabell beskriver rekkefølgen som boolske uttrykk evalueres i.

I tabellen nedenfor kan du finne eksempler på semantisk ekvivalente spørringer som forklarer operatørprioritet i tilfeller der grupperingsoperatorer (parenteser) ikke er angitt.