documentazione:manuali:4.1:manuale_web_services_ricerca_dei_documenti.html

Le query con cui è possibile ricercare i documenti nell'archivio Titulus sono espresse secondo la sintassi:

([NOT] [<canale di ricerca>]=<termini>) [<operatore> ([<canale di ricerca>]=termini) ...]

Dove:

• <canale di ricerca>: alias o percorso XPath che rappresenta l’elemento o l’attributo su cui compiere la ricerca.
• <termini>: una o più parole che rappresentano il testo cercato. È possibile usare wildcard quali l’asterisco (“*”) o il punto interrogativo (“?”) in qualsiasi punto della parola.
• <operatore>: operatore booleano AND, OR.
• [NOT] : (elemento opzionale) negazione dell’espressione che segue.

Di seguito si riporta la sintassi da usare per esprimere le ricerche su un intervallo di valori (per es. una data):

• intervallo chiuso (estremi compresi):

  [<canale di ricerca>]={val1|val2}

  (es. [docdataprot]={20110101|20110131});

• intervallo aperto (estremo compreso):

  [<canale di ricerca>]={|val2} (fino a val2 compreso) o [<canale di ricerca>]={val1|} (a partire da val1 compreso);

• intervallo chiuso (estremi esclusi):

  [<canale di ricerca>]={val1^val2}

  (es. [docdataprot]={20110101^20110131});

• intervallo aperto (estremo escluso):

  [<canale di ricerca>]={^val2} (fino a val2 escluso) o [<canale di ricerca>]={val1^} (a partire da val1 escluso).

Le ricerche per intervallo di valori possono essere espresse anche mediante gli operatori “⇐”, “>=”, “<” o “>”. Esempi:

([docdataprot]>=20130603) AND ([docdataprot]⇐20130802)

([docdataprot]>20130603) AND ([docdataprot]<20130802)

• Ricerca del documento con numero di protocollo “2004-UNBOCLE-0000437”:

  ([docnumprot]=2004-UNBOCLE-0000437)

• Ricerca dei documenti del 2004 con oggetto che contiene “offerta Titulus 97”:

  ([doc_anno]=2004) AND ([doc_oggetto]=offerta Titulus 97)

• Ricerca dei documenti in cui Mario Rossi (codice PI000046) figura come RPA:

  [doc_rifinternirifdirittocodpersonacodfasc]=RPA|PI000046|

• Ricerca dei documenti protocollati dal 1 Gennaio 2011 al 31 Gennaio 2011:

  ([docdataprot]={20110101|20110131})

• Ricerca dei documenti dell'albo ufficiale di ateneo da pubblicare il 2 Marzo 2011:

  ([/doc/repertorio/@cod/]=“ALBO”) AND ([/doc/pubblicazione/@dal/]={|20110302}) AND ([/doc/pubblicazione/@al/]={20110302|})

• [docnumprot]: numero protocollo nella forma <anno>-<cod.amm.+cod.aoo>-<numero 7 cifre>
• [doc_repertorionumero]: numero di repertorio nella forma <codice>^<cod.amm.+cod.aoo>-<anno><numero 7 cifre>
• [doc_tipo]: tipo documento (“partenza” o “arrivo” o “interno” o “varie”)
• [doc_anno]: anno
• [doc_bozza]: flag che individua le bozze di documento (“si”) [doc_codammaoo]: codice che individua in maniera univoca una AOO (concatenazione di codice amministrazione e codice AOO)
• [docdataprot]: data di protocollo (espresso nella forma aaaammgg oppure “gg/mm/aaaa”)
• [doc_dataarrivo]: data di arrivo di un documento (espresso nella forma aaaammgg oppure “gg/mm/aaaa”)
• [doc_annullato]: flag che individua un documento annullato (“si”)
• [doc_repertoriocod]: codice repertorio
• [doc_oggetto]: oggetto del documento
• [doc_classif]: classificazione del documento (es: VII/3 – varie) [doc_classifcod]: codice classificazione (03/04) [doc_filesfiletesto]: testo estratto dai file associati al documento
• [doc_note]: note registrate nel documento
• [doc_allegato]: info sugli allegati
• [doc_rifesternirifnome]: nome destinatario o mittente esterno (a seconda della tipologia di documento)
• [docrifesternirifdataprot]: data protocollo del documento per il mittente
• [docrifesternirifnprot]: numero protocollo del documento per il mittente
• [doc_rifesternirifreferentenominativo]: nome firmatario (se arrivo) o cortese attenzione (se partenza)
• [doc_postit]: testo nel post-it
• [doc_postitoperatore]: nome operatore che ha registrato il post-it
• [doc_autore]: autore per documenti non protocollati
• [doc_voce_indice]: voce di indice usata per inserire il documento (per ricerche FULL TEXT) ¹⁾
• [doc_voce_indice_exact]: voce di indice usata per inserire il documento (per ricerche ESATTE, cioè NON full text) ²⁾

• [sed_nrecord]: nrecord (id) di una seduta
• [sed_organocod]: codice dell'organo della seduta
• [sed_codammaoo]: codice AMMAOO della seduta
• [sed_stato]: stato della seduta
• [seddataconvocazione]: data di convocazione della seduta
• [sedannoconvocazione]: anno di convocazione della seduta
• [sed_nominativo]: nominativo dei componenti della seduta
• [sed_presenza]: presenza dei componenti della seduta
• [sed_odgpropostanrecord]: nrecord (id) delle proposte all'ordine del giorno
• [sed_verbalenrecord]: nrecord (id) del verbale della seduta

Il criterio di ordinamento da seguire per presentare i risultati di una ricerca deve essere espresso secondo la seguente sintassi:

XML(xpart:XPATH1),xml(xpart:XPATH2),...,xml(xpart:XPATHN)

Dove XPATH1, XPATH2, … XPATHN rappresentano i campi xml su cui effettuare l'ordinamento e “XML” indica un ordinamento crescente, mentre “xml” uno decrescente.

Esempio:

XML(xpart:/doc/@data_prot),xml(xpart:/doc/@num_prot),XML(xpart:/doc/repertorio/@numero)