Tekstihaku Adobe Acrobat Signissa

• Yleiskatsaus
• Miten tekstihaku toimii
  • SOPIMUKSEN NIMI -KENTTÄ
• Haku erityisellä kyselysyntaksilla
  • VARATUT MERKIT JA SANAT
  • LAUSEVASTAAVUUS
  • KENTÄN NIMI -ETULIITE
  • JOKERIMERKIT
  • TOTUUSARVOLAUSEKKEET

Yleiskatsaus

Acrobat Signilla voidaan suorittaa monimutkaisia hakuja käyttäjän sopimusten sisältöihin. Hallinta-sivulta löytyvä hakupalkki palauttaa kaikki tapahtumat, jotka vastaavat mitä tahansa valittuun tietolähteeseen annettua merkkijonoa.

• Jos tarkastelet ”omia sopimuksiasi”, suoritat haun omista sisällöistäsi. Jos tarkastelet jaettua tiliä, suoritat haun kyseisten jaettujen tilien sisällöistä.

Alla olevien kenttien sisältö indeksoidaan, kun tapahtuma luodaan/päivitetään:

• Otsikko – Sopimuksen otsikko.
• Huomautus – Osallistujan tekemä yksityinen sopimusmuistiinpano, joka ei näy kenellekään muulle.
• Viesti – Luettelo viesteistä, jotka ovat näkyvissä tälle osallistujalle (sisältää sekä julkiset että yksityiset viestit).
• Alkuperäinen tiedostonimi – Sopimukseen liittyvän ladatun tiedoston alkuperäinen nimi.
• Sähköposti – Lähettäjän tai vastaanottajan (mukaan lukien kopion saajien) sähköpostiosoite.
• Koko nimi – Lähettäjän tai vastaanottajan (mukaan lukien kopion saajien) etu- ja sukunimi.
• Ammattinimike – Lähettäjän tai vastaanottajan (mukaan lukien kopion saajien) ammattinimike heidän yrityksessään.
• Yrityksen nimi – Lähettäjän tai vastaanottajan (mukaan lukien kopion saajien) yrityksen tai organisaation nimi
• Vastaanottajaryhmän nimi – Sen tilapäisen sopimusryhmän nimi, johon vastaanottajat voivat kuulua.
• Tekstikentän sisältö – Käyttäjän syöttämä tekstikentän sisältö lomakkeessa.
• Jakajan koko nimi – Sopimuksen jakajan koko nimi. Muissa kuin jakamistapauksissa, tämä on käyttäjän nimi.
• Jakajan vastaanottajaryhmän nimi – Sopimuksen jakajan vastaanottajaryhmän nimi. Muissa kuin jakamistapauksissa tämä on käyttäjän vastaanottajaryhmän nimi.
• Ulkoinen tunnus – Lähettäjän sopimukselle antama tunnus, joka voi olla minkä tahansa muotoinen, mutta joka on yleensä muodossa "<groupID>:<ID>". Ulkoinen tunnus välitetään sopimuksen luomisliittymän kutsussa.
• Ulkoinen ryhmätunnus – Lähettäjän sopimukselle antama ryhmätunnus, joka voi olla minkä tahansa muotoinen ja jota käytetään yleensä ulkoisen tunnuksen etuliitteenä. Ulkoinen ryhmätunnus välitetään sopimuksen luomisliittymän kutsussa. Ulkoinen ryhmätunnus -parametria asetettaessa on asetettava myös ulkoinen tunnus.
• Tapahtuman tunnus – Tunnus, jonka Acrobat Sign on antanut sopimukselle luomisen yhteydessä.

Miten tekstihaku toimii

Jos hait merkkijonoa: ”A simple fish”

• Acrobat Sign jäsentää merkkijonon käyttäen erottimina välilyöntejä. Edellä oleva esimerkkimerkkijono jaetaan kolmeksi tunnukseksi, jotka ovat: A, simple ja fish.
  • Merkkijonokyselyn merkit kuuluvat johonkin kolmesta eri tyypistä: kirjain, numero tai erotin.
  • Erottimina käsitellään (välilyönnin lisäksi) seuraavia merkkejä: ~ ` ! @ # $ % ^ & * ( ) - + = { } [ ] | \ . , : ; " ' < > ? /
    • Pisteet, alleviivaukset ja heittomerkit pysyvät osana tunnistetta, jos symbolia edeltävät ja seuraavat merkit ovat samaa tyyppiä.
    • Sellaiset lainausmerkit, jotka ympäröivät koko kyselymerkkijonoa, eivät ole erottimia ja määrittävät kirjaimellisen merkkijonon arvon (lauseen)
    • Kyselymerkkijonon sisällä olevat lainausmerkit ovat erottimia, eivätkä ne määritä kirjaimellista merkkijonon arvoa.
• Kirjainkokojen välinen ero poistetaan, esim. a, simple, and fish
• Haku yrittää sen jälkeen sovittaa kunkin tunnisteen koko tekstin indeksoituun arvoon
  • Sopimuksen nimen jäsentäminen on monimutkaisempaa (lisää alla)
• Käytössä on sisällyttävä haku, mikä tarkoittaa, että palautettavaan tietojoukkoon sisällytetään jokainen sopimus, joka vastaa vähintään yhtä tunnistetta vähintään yhdestä haettavasta kentästä
  • Palautettu tietojoukko lajitellaan relevanssipisteytyksen mukaan niin, että relevantein hakutulos on ylimpänä.

SOPIMUKSEN NIMI -KENTTÄ

Kuten edellä todettiin, Sopimuksen nimi -kentän jäsentäminen on monimutkaisempaa, sillä siinä käytetään ylimääräistä ”mukautettua” jäsennystoimintoa, joka suorittaa jäsennyksen ensisijaisesti kontekstierottimien (ei eksplisiittisten merkkien) perusteella. Tämä mukautettu jäsennystoiminto eroaa normaalista jäsennystoiminnosta usealla eri tavalla:

• Etuliitetunnukset (enintään 10 merkkiä) luodaan - Etuliitetunnus on minkä tahansa normaalin tunnuksen inkrementoiva merkkijono. esim. jos normaali tunnus on fish, inkrementoivat tunnukset ovat f, fi, fis ja fish
  • Näin voidaan hakea osittaisia merkkijonoja, jos aloitat symbolin ensimmäisellä merkillä
  • Merkkijonon keskellä olevat osumat ohitetaan. Jos haet esimerkiksi sanaa rent, osumaksi ei katsota sanaa apparently
• Katkaistut tekstialkiot muiden kuin aakkosnumeeristen merkkien kohdalla. esim. Merkkijono: Super_Duper tuottaa tekstialkiot: Super ja Duper
  • Alaviivat eivät ole normaalin jäsennystoiminnon erottimia.
• Jaa tunnukset kirjainkokomuutosten kohdalla. esim.: Merkkijono PowerShot tuottaa tekstialkiot: Power ja Shot
• Katkaistut tekstialkiot kirjain–numerosiirtymien kohdalla. Esimerkiksi merkkijono XL500 tuottaa tekstialkiot: XL ja 500
• Poistaa kunkin tekstialkion alku- tai loppuerottimen. Esimerkiksi merkkijono: XL---42+'Autocoder' tuottaa tekstialkiot XL, 42 ja Autocoder
• Poistaa englannin kielen possessiivisuffiksin (’s) kunkin tekstialkion lopusta. Esimerkiksi merkkijono: Dave's tuottaa tekstialkion Dave

Huomaa, että standardin ja mukautetun tekstialkion yhdistelmän avulla voit etsiä koko tekstialkion merkkijonoa (standardin tekstialkoiden luonnin ansiosta) ja etuliitteen tekstialkioita (mukautetun tekstialkion ansiosta). Silti valintasi ei vastaa etuliitteen tekstialkiota, joka käsittää erottimen. 

Esimerkki: jos sinulla on sopimus, jonka nimi on My_NDA

• Normaali jäsennystoiminto tuottaisi tekstialkion, joka näyttäisi tältä: my_nda
• Mukautettu jäsennystoiminto tuottaisi sarjan merkkejä: m, my, n, nd, nda, my_, my_n, my_nd, my_nda

Esimerkki 2: jos sinulla on sopimus, jonka nimi on XL500

• Normaali jäsennystoiminto tuottaisi tekstialkion, joka näyttäisi tältä: xl500
• Mukautettu jäsennystoiminto tuottaisi sarjan tekstialkioita: xl500, x, xl, 5, 50, 500, xl5, xl50

Haku erityisellä kyselysyntaksilla

Kuten edellä on kuvattu, sopimushaku suorittaa likimääräisen haun kaikista haettavissa olevista sopimuksen kentistä. Hakukelpoisen kentän sisältö muutetaan tekstialkioiksi, joita verrataan kyselyhetkellä niitä vastaaviin kyselymerkkijonoihin. Sopimushaku suorittaa näille tekstialkioille myös etuliiteyhteensopivuusvertailun enintään kymmenen merkin verran. Jos sopimuksesta löytyy vähintään yhden tekstialkion vastaavuus, kyseinen sopimus näkyy hakutuloksissa.  Hakutulokset lajitellaan relevanssipisteytyksen mukaan niin, että oleellisin hakutulos on ylimpänä.

Kokonaisen kentän arvon osumat, lauseosumat kenttäarvosta, sellaisten sopimusten haku, jotka eivät sisällä tiettyä tekstialkiota, sellaisten sopimusten haku, jotka sisältävät useita tekstialkioita samaan aikaan (ei lausetta), voidaan kuitenkin toteuttaa vain erityisellä syntaksilla. Sign Generic Query Language (SGQL) on kehitetty vastaamaan asiakkaiden tarpeeseen näistä ominaisuuksista, jotka edellyttävät erityistä syntaksia.

VARATUT MERKIT JA SANAT

SGQL:ssä on seitsemän varattua merkkiä:

Näitä varattuja merkkejä käytetään operaattoreina, ja ne määrittävät hakukyselyn kielitoiminnot. Jos varattua merkkiä käytetään väärin, tuloksena on syntaksivirhe.  

Jos haluat käyttää varattuja merkkejä tavallisina merkkeinä hakukyselyssä, niihin on laitettava koodinvaihtomerkki. Esimerkiksi hakukyselyssä

kaikkiin varattuihin merkkeihin on laitettu koodinvaihtomerkki, ja niitä käsitellään tavallisina merkkeinä.

SGQL:llä on myös kolme operaattoreille varattua sanaa:

Operaattorit on kirjoitettava isoin kirjaimin. Jos haluat käyttää operaattoreita tavallisina symboleina hakukyselyssä, niiden on oltava lainausmerkeissä. Esimerkiksi:

LAUSEVASTAAVUUS

Tavallinen likimääräinen vastaavuus-kysely täsmää, jos MIKÄ TAHANSA merkeistä esiintyy kentässä (mutta ei välttämättä jokainen), eikä niiden järjestyksellä ole merkitystä, koska merkkien ei tarvitse esiintyä yhdessä.

Lausekohtaista kyselyä tulisi käyttää, kun kirjainkoosta riippumaton tarkka lausehaku on tehtävä yhteen tai useampaan haettavissa olevaan kenttään. Siten voidaan löytää vastaavuuksia, kun samassa kentässä esiintyy useita tunnisteita yksi toisensa jälkeen ja ne ovat järjestyksessä, joka on määritelty lainausmerkkien sisällä.

Lausekohtaisen kyselyn syntaksin muoto:

  tai 

Mikäli kyselyn syntaksi ei noudata lausekohtaisen kyselyn syntaksin sääntöjä, sopimushaku suorittaa tavallisen likimääräisen kyselyn kaikista haettavissa olevista kentistä.

Esimerkiksi kysely

vastaa sopimuksia, joissa on lause ”opintoryhmä” missä tahansa haettavassa kentässä. Huomaa, että lause ”opinto - ryhmä” ei vastaa tätä kyselyä, koska se ei ole kirjainkoosta riippumaton tarkka lause verrattuna lauseeseen ”Opintoryhmä”.

Lausevastaavuus voi esiintyä missä tahansa hakukyselyn sisällä. Esimerkiksi

vastaa otsikkoa ”Kurssimateriaalit MATEMATIIKKA 101 Opintoryhmä”, koska tässä otsikossa on avainsana ”MATEMATIIKKA” ja lauseet ”Kurssimateriaalit” ja ”Opintoryhmä”.

KENTÄN NIMI -ETULIITE

Kentän nimen etuliite -kyselyä tulee käyttää, kun käyttäjän sopimuksista haetaan vain yhtä tiettyä kenttää.

Kentän nimen etuliitteen kyselyn on sisällyttävä kentän nimen etuliite, jota seuraa hakukysely. Kentän nimen etuliitekyselyn syntaksin muoto:

Kentän nimen etuliite voi näkyä symbolin tai kyselyn sulkeissa olevan osan edessä. Esimerkiksi hakukyselyssä

kaikki symbolit täsmäävät sopimuksen title-nimisen kentän kanssa.

Alla olevassa hakukyselyssä

vain sanalla "Hello" on kentän nimen etuliite, ja tätä sanaa verrataan ainoastaan sopimuksen otsikkokenttään (title). Loppuja sanoja ja lauseita verrataan kaikkiin haettaviin kenttiin.

Jos <field_name> ei ole määritetty, kysely tehdään jokaiseen kenttään, jossa lausevastaavuus on mahdollinen. Muussa tapauksessa kysely tehdään vain <field_name>-kentässä. 

Jos kyselyn syntaksi ei noudata kentän nimen etuliitteen kyselyn syntaksin sääntöjä, sopimushaku käyttää koko kyselyä hakulausekkeena ja suorittaa haun kaikkiin haettaviin kenttiin. 

Esimerkiksi kentän nimen etuliitteen kysely:

suorittaa haun vain sopimuksen nimen sisältävään kenttään.

Alla on luettelo kentän nimen etuliite -kyselyssä tuetuista etuliittelistä. Kenttien nimien etuliitteissä ei oteta huomioon kirjainkokoa. 

Aikaisempien versioiden kanssa yhteensopivuuden varmistamiseksi joidenkin kenttänimien etuliitteissä on aliaksia, jotka vastaavat toiminnaltaan alkuperäisiä kenttänimien etuliitteitä. Nämä aliakset ovat vanhentuneita, ja ne poistetaan ennen pitkää:

  *  Kentän nimen etuliitettä 'name' voidaan käyttää etuliitteen 'title' sijasta.

 ** Kentän nimen etuliitettä 'participantEmail' voidaan käyttää etuliitteen 'email' sijasta.  

*** Kentän nimen etuliitettä 'participantName' voidaan käyttää etuliitteen 'fullName' sijasta.

JOKERIMERKIT

Jokerimerkkiä ( tähti * ) voidaan käyttää tekemään etuliiteosuma, jota seuraa rajoittamaton määrä merkkejä hakualkiossa. Jokerimerkkilaajennus on raskas operaatio, joka tapahtuu ajon aikana, minkä takia seuraavia syntaksisääntöjä on noudatettava, jotta tätä toimintoa voidaan käyttää:

• Johtavia jokerimerkkejä ei sallita.
• Symbolin keskellä olevia jokerimerkkejä ei sallita.
• Kentän nimen etuliite on pakollinen hakualkiolle, jolla on jokerimerkin laajennusoperaattori.
• Jokerimerkkioperaattoria voidaan käyttää kussakin kyselyssä vain kerran.
• Jokerimerkkilaajennuksen sisältävät kyselyt palauttavat aikakatkaisuvirheen, jos suoritusaika on yli viisi sekuntia.

Esimerkiksi kysely

vastaa otsikkokentän merkkejä

ja

Jokerimerkkilaajennus on raskas operaatio. Jos sitä käytetään harkitsemattomasti, se kuluttaa paljon järjestelmäresursseja, ja saatat joutua odottamaan hakutuloksia pitkään. Näiden ongelmien välttämiseksi SGQL on rajoittanut jokerimerkin käyttöä, mikä poistaa raskaimmat ja resursseja kuluttavimmat käyttötapaukset. Mitä tarkempia käyttämäsi merkit ovat, sitä tehokkaampi kyselysi on. Tietyn sanan tai lauseen etsiminen on aina tehokkaampaa kuin jokerimerkkiä käyttävä haku.

TOTUUSARVOLAUSEKKEET

SGQL tukee Boolean-operaattoreita AND, OR, ja NOT sekä näiden operaattorien käyttöä heittomerkeissä. Operaattorit on kirjoitettava isoin kirjaimin.

OR-operaattoria tulee aina käyttää hakualkioiden välissä. Esimerkiksi

on sama kuin

Ellet halua sisällyttää operaattoria OR selkeyden vuoksi, sinun ei tarvitse määrittää sitä.

NOT-operaattori koskee vain sellaista hakualkiota, joka seuraa välittömästi NOT-operaattoria. Jos haluat käyttää NOT-operaattoria useaan hakualkioon, sinun on laitettava symbolit sulkeisiin.

Seuraavassa taulukossa kuvataan, missä järjestyksessä loogisia lausekkeita arvioidaan.

Alla olevasta taulukosta löydät esimerkkejä semanttisesti vastaavista kyselyistä, jotka selittävät operaattorin arvojärjestyksen, jos operaattorien ryhmittelyä (sulut) ei ole määritetty.