Manuale Ricerca dei documenti tramite Web Services

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 - canale attivato a partire dalla release 4.0.4.1 di Titulus)
• [doc_voce_indice_exact]: voce di indice usata per inserire il documento (per ricerche ESATTE, cioè NON full text - canale attivato a partire dalla release 4.0.4.1 di Titulus)

Canali di ricerca per fascicoli speciali

Le ricerche sui fascicoli speciali devono sempre riportare il corretto codice di classificazione del fascicolo, quindi si dovreà sempre valorizzare il campo [fasc_classif_cod] con la classificazione configurata per il fascicolo speciale. Si veda la documentazione specifica, ma normalmente la classificazione è la seguente:

• 05/00 per fascicoli studenti
• 07/00 per fascicoli del personale
• 10/00 per fascicoli di persona giuridica

Quindi una query che deve selezionare dei fascicoli studenti dovrà avere sempre il filtro

[fasc_classifcod]=05/00)

Così come una query che deve selezionare sia fascicoli studenti che del persoanle dovrà avere sempre il filtro

[fasc_classifcod]=05/00 OR 07/00)

Altri canali di ricerca per fascicoli speciali

• /fascicolo/oggetto Nominativo
• /fascicolo/fascicolo_speciale/@categoria
• /fascicolo/fascicolo_speciale/@cod_fis
• /fascicolo/fascicolo_speciale/@categoria_tipo
• /fascicolo/fascicolo_speciale/@corso_studio
• /fascicolo/fascicolo_speciale/@data_assunzione
• /fascicolo/fascicolo_speciale/@data_cessazione
• /fascicolo/fascicolo_speciale/@data_immatricolazione
• /fascicolo/fascicolo_speciale/@data_nascita
• /fascicolo/fascicolo_speciale/@matricola
• /fascicolo/fascicolo_speciale/@normativa
• /fascicolo/fascicolo_speciale/@stuid
• /fascicolo/fascicolo_speciale/@tipo_corso
• /fascicolo/fascicolo_speciale/@nazione
• /fascicolo/fascicolo_speciale/@partita_iva
• /fascicolo/fascicolo_speciale/@posizione
• /fascicolo/fascicolo_speciale/@pers_id
• /fascicolo/fascicolo_speciale/@id_acl
• /fascicolo/fascicolo_speciale/@id_anagrafica_esterna

Esempio ricerca fascicoli speciali

Cerca lo studente e/o il dipendente con il codice fiscale corrispondente

([fasc_classifcod]=05/00 OR 07/00) AND [/fascicolo/fascicolo_speciale/@cod_fis]=dltdv278d22h440z

Cerca lo studente Mario Rossi

[fasc_classifcod]=05/00 AND [fasc_ogggetto]="Mario Rossi"

Cerca tutti gli studente di nome Mario

[fasc_classifcod]=05/00 AND [fasc_ogggetto]=Mario

Canali di ricerca non più supportati

Canali di ricerca non più supportati

• [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)