Tekstsøgning i Adobe Acrobat Sign

• Oversigt
• Sådan virker tekstsøgning
  • FELTET AFTALETITEL
• Søgning med speciel forespørgselssyntaks
  • FORBEHOLDTE TEGN OG ORD
  • SÆTNINGSMATCH
  • PRÆFIKS FOR FELTNAVN
  • JOKERTEGN
  • BOOLESKE UDTRYK

Oversigt

Acrobat Sign giver mulighed for kompleks søgning for at finde indhold i brugerens aftaler. Søgefeltet på siden Administrer viser alle transaktioner, der matcher en streng, som er angivet for den valgte indholdskilde.

• Hvis du kigger på "dine aftaler", søger du efter dit indhold. Hvis du kigger på en delt konti, søger du efter den delte kontos indhold

Indholdet i nedenstående felter indekseres, når en transaktion oprettes/opdateres:

• Titel – Aftaletitel.
• Note – En privat aftalenote lavet af deltageren, som ikke er synlig for andre.
• Meddelelse – En liste over meddelelser, der er synlige for denne deltager (inkluderer både offentlige og private meddelelser).
• Originalt filnavn – Originalt navn på en uploadet fil, der er knyttet til aftalen.
• Mail – Modtagesr (inklusive CC'er) eller afsenders mailadresse.
• Fulde navn – For- og efternavn på modtageren (inklusive CC'er) eller afsenderen.
• Jobtitel – Jobtitel på modtageren (inklusive CC'er) eller afsenderen i deres virksomhed.
• Firmanavn – Firma- eller organisationsnavn på modtageren (inklusive CC'er) eller afsenderen.
• Modtagergruppenavn – Navn på det ad-hoc-aftalegruppenavn, som modtagere kan tilhøre.
• Tekstfeltindhold – Brugerleveret tekstfeltindhold i formularen.
• Delers fulde navn – Fulde navn på den, der deler aftalen. I tilfælde af ikke-deling er dette navnet på brugeren.
• Delerens modtagergruppenavn – Modtagergruppenavnet på den, der deler aftalen. I tilfælde af ikke-deling er dette brugerens modtagergruppenavn.
• Eksternt ID – Afsenders tildelte ID til aftalen, der kan have alle former, men normalt i form af "<groupID>:<ID>". Eksternt ID videregives i opkaldet til aftaleoprettelses-API'en.
• Eksternt gruppe-ID – Afsendertildelt gruppe-ID til aftalen, der kan være af enhver form, normalt brugt som præfiks for eksternt ID. Eksternt gruppe-ID videregives i opkaldet til aftaleoprettelses-API'en. Du er forpligtet til at indstille eksternt ID, hvis du indstiller parameter for eksternt gruppe-ID.
• Transaktions-id – id tildelt til aftalen af Acrobat Sign ved oprettelse.

Sådan virker tekstsøgning

Hvis du søger efter strengen: "En simpel fisk"

• Acrobat Sign tokeniserer strengen ved at bruge mellemrum som afgrænsere. Ovenstående eksempelstreng er opdelt i tre tokens: En, simpel og fisk
  • Tegn i strengforespørgsel tilhører en af tre forskellige typer: bogstav, tal eller skilletegn.
  • Tegn, der betragtes som afgrænsere (ud over mellemrum), er: ~ ` ! @ # $ % ^ & * ( ) - + = { } [ ] | \ . , : ; " ' < > ? /
    • Punktum, kolon og apostrof forbliver som en del af et symbol, hvis tegn før og efter dette symbol er af samme type.
    • Citater, der omgiver hele forespørgselsstrengen, er ikke skilletegn og angiver en bogstavelig strengværdi (frase)
    • Citater inde i en forespørgselsstreng er skilletegn og angiver ikke en bogstavelig strengværdi.
• Skelnen mellem små og store bogstaver er fjernet. f.eks., en, simpel, og fisk
• Søgningen prøver derefter at matche den fulde tekst af hvert symbol til en indekseret værdi
  • Der opstår mere kompleks tokenisering for Aftaletitel (se nedenfor)
• Der anvendes en inklusive søgning, hvilket betyder, at hver aftale, der matcher mindst én token fra mindst ét søgbart felt, er inkluderet i det returnerede datasæt
  • Det returnerede datasæt er sorteret efter relevansscore med det mest relevante søgeresultat øverst.

FELTET AFTALETITEL

Som angivet ovenfor har feltet Aftalenavn mere avanceret tokenisering pga. en ekstra "tilpasset" tokenizer, der primært tokeniserer på kontekstskilletegn (i modsætning til eksplicitte tegn). Den tilpassede tokenizer er anderledes end standarden pga. følgende:

• Præfikstokens (op til ti tegn) genereres – en præfikstoken er den gradvise streng for enhver standardtoken. Hvis f.eks. standardtokenen er fisk, er de gradvise tokens: f, fi, fis og fisk
  • Dette tillader søgning efter delvise strenge, forudsat du starter ved tokenens første tegn
  • Matches midt i strengen ignoreres. Søgning efter f.eks. lej vil ikke matche ordet lejlighed
• Opdel tokens ved ikke-alfanumeriske tegn. f.eks. strengen: Super_Duper giver tokenen: Super og Duper
  • Underscores afgrænser ikke standardtokenizer
• Opdel tokens ved skift mellem små/store bogstaver. Strengen: PowerShot giver f.eks. tokenen: Power og Shot
• Opdel tokens ved skift mellem bogstaver/tal. Strengen XL500 giver f.eks. tokenen: XL og 500
• Fjerner foranstillede og efterstillede afgrænsere fra hver token. F.eks.: Strengen: XL---42+'Autocoder' giver tokensene:  XL, 42 og Autocoder
• Fjerner det engelske ejefalds-s ('s) fra slutningen af hver token. Strengen: Daves giver f.eks. tokenen: Dave

Bemærk, at kombinationen af standard og brugerdefinerede tokens giver dig mulighed for at søge efter den fulde tokenstreng (takket være standard-tokens) og præfikset-tokens (takket være den brugerdefinerede tokens). Du vil stadig ikke matche et præfikstoken, der spænder over en skilletegn. 

Hvis du f.eks. har en aftale med navnet Min_NDA

• Vil standardtoken give en token, som ser sådan ud: min_nda
• Den brugerdefinerede tokenizer ville producere en række tokens: m, min, n, nd, nda, min_, min_n, min_nd, min_nda

Eksempel 2: Hvis du har en aftale med navnet XL500

• Standardtokenizeren vil producere en token, der ser sådan ud: xl500
• Den brugerdefinerede tokenizer ville producere en række tokens: xl500, x, xl, 5, 50, 500, xl5, xl50

Søgning med speciel forespørgselssyntaks

Som beskrevet i afsnittet ovenfor udfører aftalesøgning et omtrentligt match mellem alle søgbare felter i en aftale. Søgbart feltindhold tokeniseres, og derefter matches disse tokens med forespørgselsstrengen på forespørgselstidspunktet. Aftalesøgning udfører også et præfiksmatch på op til ti tegn for disse tokens. Hvis der findes mindst ét token-match i en aftale, vises den pågældende aftale i søgeresultaterne. Det returnerede datasæt er sorteret efter relevansscore med det mest relevante søgeresultat øverst.

Matchninger af en hel feltværdi, matchninger af en sætning fra en feltværdi, søgninger efter aftaler, der ikke indeholder et bestemt token, søgninger efter aftaler, der indeholder flere tokens på samme tid (ikke en sætning), kan dog kun opnås med en særlig syntaks. Sign Generic Query Language (SGQL) blev udviklet for at imødekomme kundernes behov for disse funktioner, som kræver særlig syntaks.

FORBEHOLDTE TEGN OG ORD

SGQL har syv forbeholdte tegn:

Disse forbeholdte tegn bruges som operatører og definerer sprogfunktioner i en søgeforespørgsel. Hvis et forbeholdt tegn bruges forkert, returneres en syntaksfejl.  

Hvis du vil bruge forbeholdte tegn som almindelige tegn i en søgeforespørgsel, skal de udelades. For eksempel har søgeforespørgslen

alle forbeholdte tegn, som er udelade, og de behandles som almindelige tegn.

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

Operatørerne skal stå med store bogstaver. For at bruge operatører som almindelige tokens i en søgeforespørgsel, skal de være dobbeltciterede. For eksempel:

SÆTNINGSMATCH

En regelmæssig omtrentlig match forespørgsel vil matche, hvis bare ÉN token vises i et felt (men ikke nødvendigvis alle), og token-rækkefølgen er irrelevant, da tokens ikke behøver at blive vist sammen.

En forespørgsel på sætningsmatch skal bruges, når du vil søge på en bestemt sætning i en eller flere søgbare felter. Det gør det muligt at matche, når flere tokens vises i det samme felt, og disse tokens vises i den rækkefølge, der er angivet i anførselstegnene.

Syntaksformat for forespørgsel om frasematch:

  eller 

Hvis forespørgselssyntaksen ikke følger reglerne for en forspørgselssyntaks for sætningsmatch, udfører søgningen en regelmæssig, omtrentlig matchforespørgsel blandt alle søgbare felter.

F.eks. forespørgsel

vil matche aftaler, der indeholder udtrykket "studiegruppe" i alle søgbare felter. Bemærk, at udtrykket "studie - gruppe"ikke bliver matchet for denne forespørgsel, da det ikke er en præcis sætning, hvor der ikke skelnes mellem store og små bogstaver i forhold til "Studiegruppe".

Et sætningsmatch kan vises hvor som helst i en søgning. For eksempel

vil matche titlen "Kursusmaterialer" til MATH 101 "Studiegruppe" da denne titel indeholder nøgleordet "MATH" og udtrykkene "Kursusmaterialer" og "Studiegruppe".

PRÆFIKS FOR FELTNAVN

En feltnavnpræfiksforespørgsel skal bruges, når der kun søges efter ét bestemt felt i brugerens aftaler.

Feltnavnepræfiksforespørgslen skal indeholde et feltnavnepræfiks efterfulgt af en søgeforespørgsel. Syntaksformat for forespørgsel om feltnavnspræfiks:

Feltnavnepræfikset kan vises foran et token eller foran en parentesdel af en forespørgsel. For eksempel i søgeforespørgslen

er alle tokens matchet med feltet aftaletitel.

I søgeforespørgslen nedenfor

har kun ordet 'Hej' et feltnavnpræfiks, og dette ord matches kun med aftaletitelfeltet. De øvrige ord og sætninger er matchet med alle søgbare felter.

Hvis <field_name> ikke er angivet, vil alle felter, der understøttes for sætningsmatchet, blive forespurgt. Ellers forespørges kun feltet <field_name>. 

Hvis forespørgselssyntaksen ikke følger reglerne for feltnavnets præfiksforespørgselssyntaks, bruger Aftalesøgning hele forespørgslen som en søgeforespørgsel og udfører en søgning blandt alle søgbare felter. 

For eksempel feltnavnepræfiksforespørgslen:

skal kun udføre en søgning mod det felt, der indeholder navnet på aftalen.

Nedenfor er en liste over præfikser, der understøttes for forespørgsel om feltnavnpræfiks. Feltnavnspræfikser skelner ikke mellem store og små bogstaver. 

For bagudkompatibilitet har nogle af feltnavnspræfikserne aliasser, som i funktionalitet svarer til de oprindelige feltnavnspræfikser. Disse aliasser er forældede og vil til sidst blive fjernet:

  *  Feltnavnspræfiks 'navn' kan bruges i stedet for 'titel'.

 ** Feltnavnspræfikset 'deltagermail' kan bruges i stedet for 'mail'.  

*** Feltnavnets præfiks 'deltagernavn' kan bruges i stedet for 'fuldtnavn'.

JOKERTEGN

Et jokertegn (stjerne *) kan bruges til at lave en præfiksmatch efterfulgt af et ubegrænset antal tegn i et token. Udvidelse af jokertegn er en omfattende operation, der sker på runtime, så følgende syntaksregler skal følges for at kunne bruge denne funktion:

• Ledende jokertegn er ikke tilladt.
• Jokertegn i midten af et symbol er ikke tilladt.
• Der kræves et feltnavnpræfiks for et token, der har en jokertegnudvidelsesoperatør.
• En jokertegnoperatør kan ikke bruges mere end én gang i en forespørgsel.
• Forespørgsler, der indeholder en jokertegnudvidelse, returnerer en timeout-fejl, hvis udførelsestiden overstiger fem sekunder.

F.eks. forespørgsel

matcher titelfeltet tokens

og

Jokertegnudvidelser er en dyr operation. Hvis det bruges uklogt, bruger det en masse af systemressourcer, og du kommer til at vente længe på dine søgeresultater. For at undgå disse problemer har SGQL begrænsninger på brug af jokertegn, som eliminerer de mest omfattende og ressourcekrævende brugssager. Jo mere specifikke dine tokens er, jo mere effektiv er din søgning. Søgning efter et bestemt ord eller sætning er altid mere effektivt end en søgning, der bruger et jokertegn.

BOOLESKE UDTRYK

SGQL understøtter de booleske operatører AND, OR og NOT samt grupperingen af disse operatører ved hjælp af parenteser. Operatørerne skal stå med store bogstaver.

Operatøren OR er altid implicit mellem tokens. For eksempel

er den samme som

Medmindre du ønsker at medtage OR-operatøren af klarhedshensyn, behøver du ikke at angive det.

NOT-operatøren gælder kun for tokenet umiddelbart efter NOT. Hvis du vil anvende NOT-operatoren på flere tokens, skal du vedlægge disse tokens i parentes.

Følgende tabel beskriver den rækkefølge, hvori booleske udtryk evalueres.

I tabellen nedenfor kan du finde eksempler på semantisk, ækvivalente forespørgsler, der forklarer operatørforrang, hvis gruppering af operatører (parenteser) ikke er angivet.