| Entrambe le parti precedenti la revisioneRevisione precedenteProssima revisione | Revisione precedente |
| documentazione_3di_riservata:docway4:raccoglitore_indice [2016/11/23 16:40] – [Configurazione indici.xml] mbernardini | documentazione_3di_riservata:docway4:raccoglitore_indice [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1 |
|---|
| ====== Raccoglitori di tipo 'INDICE' ====== | |
| |
| * Raccoglitori "speciali" per i quali è definito un set di documenti da generare automaticamente in fase di creazione del raccoglitore | |
| * Su ogni documento generato verranno settati come RPA e CC gli stessi assegnatari indicati sul raccoglitore (ereditarietà degli assegnatari) | |
| * Widget specifico per l'anteprima dei documenti contenuti nel raccoglitore | |
| * Possibilità di modifica rapida dei documenti contenuti | |
| * Pulsante di aggregazione di tutti i documenti contenuti nel raccoglitore (allegati o eventuali campi custom HTML) in un unico PDF | |
| * Possibilità di registrare il PDF generato come nuovo documento (linkato al raccoglitore) | |
| * Possibilità di generare una copertina per il raccoglitore (tramite applicazione dei campi del raccoglitore ad un template RTF) | |
| * Sia sul raccoglitore che sui documenti contenuti (autogenerati e non) è possibile utilizzare i campi custom | |
| ===== Configurazione ===== | |
| |
| * Per attivare la gestione dei raccoglitori di tipo indice occorre settare la property //abilitaIndiceRaccoglitori// all'interno del file //it.highwaytech.apps.xdocway.properties//. L'elenco completo delle properties è indicato di seguito: | |
| |
| <code> | |
| ######################### Indice su Raccoglitori ########################################################################################## | |
| |
| # Abilita la gestione dei raccoglitori speciali di tipo indice (generazione automatica di raccoglitori utilizzati come contenitori di una lista | |
| # di documenti predefinita) ('si', 'no' - Default = 'no') | |
| abilitaIndiceRaccoglitori=no | |
| |
| # Nuovo documento da widget del raccoglitore di tipo indice. Definizione delle tipologie di documenti che possono essere generati (con | |
| # relativa definizione) | |
| # indiceRaccoglitori.nuovoDoc.tipologie=<DOCTIPO>[_<CODREP>][,<DOCTIPO>[_<CODREP>]]...[,<DOCTIPO>[_<CODREP>]] | |
| # dove: | |
| # <DOCTIPO> rappresenta la tipologia di documento (arrivo, partenza, varie, interno) | |
| # <CODREP> rappresenta l'eventuale codice di repertorio | |
| # es: indiceRaccoglitori.nuovoDoc.tipologie=varie,varie_tckt,arrivo | |
| indiceRaccoglitori.nuovoDoc.tipologie= | |
| |
| # Per ogni tipologia definita in 'indiceRaccoglitori.nuovoDoc.tipologie' è possibile specificare la classificazione (sia il codice che la | |
| # descrizione) da assegnare al documento (se non indicata viene impostato: 00/00 - non classificato) | |
| #indiceRaccoglitori.nuovoDoc.<DOCTIPO>[_<CODREP>].codClassif= | |
| #indiceRaccoglitori.nuovoDoc.<DOCTIPO>[_<CODREP>].descrClassif= | |
| |
| # Eventuali xpath (interni ai documenti contenuti nel raccoglitore) che contengono un testo HTML che deve essere convertito in PDF in fase di aggregazione | |
| # di tutti i documenti. E' possibile specificare più xpath separandoli da virgola (per ogni documento contenuto nel raccoglitore verranno valutati | |
| # tutti gli xpath specificati). | |
| # indiceRaccoglitori.htmlContent.xpaths=XPATH[,XPATH] | |
| |
| # Elenco di estensioni di documenti supportate in aggregazione di file PDF | |
| indiceRaccoglitori.supportedFiles=.doc,.docx,.xls,.xlsx,.odt,.ods,.pdf | |
| |
| # Abilitazione dell'import di documenti da Sigico2 in editing rapido di documenti contenuti in un raccoglitore di tipo indice ('si', 'no' - Default = 'no') | |
| indiceRaccoglitori.abilitaImportSigico2=no | |
| |
| ########################################################################################################################################### | |
| </code> | |
| |
| * E' possibile definire più tipologie di raccoglitori di tipo indice ed assegnare ad ognuna un set differente di documenti | |
| * La definizione del raccoglitore (tipologia, nome, documenti autogenerati) avviene attraverso il file **indici.xml** nella directory //DocWay4-service/application/xdocway/indiceRaccoglitori// (per maggiori dettagli sulla definizione del raccoglitore si rimanda a '[[documentazione_3di_riservata:docway4:raccoglitore_indice&#configurazione_indicixml|Configurazione indici.xml]]') | |
| * Attraverso la property //indiceRaccoglitori.htmlContent.xpaths// è possibile specificare gli xpath relativi a campi custom di tipo HTML che dovranno essere gestiti nell'editing rapido di documenti dal widget del raccoglitore e che saranno convertiti e inclusi nel PDF finale | |
| * ESEMPIO: //indiceRaccoglitori.htmlContent.xpaths=/doc/extra/indice/html// | |
| * La property //indiceRaccoglitori.nuovoDoc.tipologie// viene utilizzata per definire le tipologie di documenti che potranno essere aggiunti al raccoglitore tramite il widget | |
| * ESEMPIO: //indiceRaccoglitori.nuovoDoc.tipologie=arrivo,varie,varie_docistr// | |
| * Per ogni tipologia di documento deve essere specificata la classificazione da settare | |
| * L'RPA e i CC associati a nuovi documenti saranno gli stessi indicati sul raccoglitore | |
| * La property //indiceRaccoglitori.supportedFiles// definisce le estensioni di files che devono essere gestite in fase di produzione del PDF del raccoglitore (aggregato di tutti i documenti inclusi). Tutti i file con estensione differente da quelle indicati verranno ignorati in fase di merge | |
| * ESEMPIO: //indiceRaccoglitori.supportedFiles=.doc,.docx,.xls,.xlsx,.odt,.ods,.pdf,.png,.tiff,.tif// | |
| * Di default sono gestite le seguenti estensioni: .doc,.docx,.xls,.xlsx,.odt,.ods,.pdf | |
| |
| ==== Copertina del raccoglitore ==== | |
| |
| * Attivazione su file //it.highwaytech.apps.xdocway.properties// | |
| |
| <code> | |
| ######################### Doc2Attachments ########################################################################################## | |
| |
| # Definizione di template RTF da utilizzare per generare allegati PDF contenenti delle informazioni contenute negli XML di | |
| # documenti/raccoglitori/fascicoli. Al momento questa funzione è disponibile solo sui raccoglitori di tipo indice (download della | |
| # copertina del raccoglitore, generata in base al contenuto dei campi custom) | |
| # doc2attachment.<TIPO>[_<CODICE>].template=<NOME_FILE_RTF> | |
| # dove: | |
| # <TIPO> è la tipologia di record (arrivo, partenza, interno, varie, fascicolo, raccoglitore) - SUPPORTATO SOLO raccoglitore | |
| # <CODICE> è l'eventuale codice di repertorio, raccoglitore o fascicolo (LOWERCASE) | |
| # <NOME_FILE_RTF> è il nome del template RTF da utilizzare per la generazione dei PDF di output | |
| # es: doc2attachment.raccoglitore_corte.template=copertina_corte.rtf | |
| |
| #################################################################################################################################### | |
| </code> | |
| |
| * Il file RTF indicato come template deve essere creato all'interno di '//DocWay4-service/META-INF/modelli/doc2attachments//' sulla directory del configuratore | |
| * Dopo l'elaborazione degli xpath all'interno del template RTF il risultato verrà convertito in PDF (la copertina del raccoglitore scaricata sarà in formato PDF) | |
| * All'interno della webapp DocWay4-service (//DocWay4-service/WEB-INF/META-INF/modelli/doc2attachments//) è caricato un file di esempio di template (**sample.rtf**) | |
| |
| |
| ==== Configurazione indici.xml ==== | |
| |
| Esempio di XML di definizione di raccoglitori di tipo indice: | |
| |
| <code> | |
| <?xml version="1.0" encoding="utf-8"?> | |
| <listof_indici> | |
| <raccoglitore codice="CORTE"> | |
| <descrizione>Indice di Ricerca</descrizione> | |
| <documenti> | |
| <doc tipo="varie"> | |
| <classif cod="00/00">00/00 - non classificato</classif> | |
| <oggetto>Cenni del fatto</oggetto> | |
| <repertorio cod="DOCISTR" /> | |
| </doc> | |
| ... | |
| <doc tipo="varie"> | |
| <classif cod="00/00">00/00 - non classificato</classif> | |
| <oggetto>Giurisprudenza costituzionale</oggetto> | |
| <repertorio cod="DOCISTR" /> | |
| <cc_aggiuntivi> | |
| <rif nome_persona="Stagni Simone" nome_uff="Servizio Tecnico Bologna" cod_persona="PI000008" cod_uff="00003" diritto="CC" /> | |
| </cc_aggiuntivi> | |
| </doc> | |
| </documenti> | |
| <output> | |
| <doc tipo="varie"> | |
| <classif cod="00/00">00/00 - non classificato</classif> | |
| <repertorio cod="RICERCA" /> | |
| </doc> | |
| </output> | |
| </raccoglitore> | |
| </listof_indici> | |
| </code> | |
| |
| __Definizione dei raccoglitori__: | |
| |
| * '/listof_indici/raccoglitore' per ogni raccoglitore di tipo indice da gestire | |
| * '/listof_indici/raccoglitore/@codice': codice del raccoglitore | |
| * '/listof_indici/raccoglitore/descrizione': descrizione del raccoglitore | |
| * '/listof_indici/raccoglitore/documenti/doc': definizione dei documenti da generare in fase di creazione del raccoglitore | |
| * '/listof_indici/raccoglitore/output/doc': eventuale documento di output sul quale può essere salvato il PDF risultante dall'aggregazione di tutti i documenti inclusi nel documento | |
| |
| __Per ogni documento da generare in fase di creazione del documento è possibile definire__: | |
| |
| * '/listof_indici/raccoglitore/documenti/doc/@tipo': tipologia del documento da creare (arrivo, partenza, interno, varie) | |
| * '/listof_indici/raccoglitore/documenti/doc/classif/@cod': codice di classificazione da settare | |
| * '/listof_indici/raccoglitore/documenti/doc/classif': descrizione della classificazione da settare | |
| * '/listof_indici/raccoglitore/documenti/doc/oggetto': oggetto da settare per il documento (//verrà aggiunto come prefisso l'oggetto del raccoglitore che lo contiene//) | |
| * '/listof_indici/raccoglitore/documenti/doc/repertorio/@cod': eventuale codice del repertorio da settare sul documento (non obbligatorio, solo se occorre creare dei repertori) | |
| * '/listof_indici/raccoglitore/documenti/doc/cc_aggiuntivi': definizione di eventuali CC da settare sul documento in aggiunta a quelli ereditati dal raccoglitore | |
| * //TUTTE LE ALTRE PROPRIETA' DEL DOCUMENTO VERRANNO GENERATE IN AUTOMATICO DALLA PROCEDURA DI CREAZIONE// | |
| |
| __Caratteristiche del documento di output__: | |
| |
| * '/listof_indici/raccoglitore/output/doc/@tipo': tipologia del documento di output (arrivo, partenza, interno, varie) | |
| * '/listof_indici/raccoglitore/output/doc/classif/@cod': codice di classificazione da settare | |
| * '/listof_indici/raccoglitore/output/doc/classif': descrizione della classificazione da settare | |
| * '/listof_indici/raccoglitore/output/doc/repertorio/@cod': eventuale codice del repertorio da settare sul documento (non obbligatorio) | |
| * L'oggetto del documento sarà lo stesso indicato sul raccoglitore | |
| * Gli assegnatari del documento saranno gli stessi indicati sul raccoglitore | |
| * //TUTTE LE ALTRE PROPRIETA' DEL DOCUMENTO VERRANNO GENERATE IN AUTOMATICO DALLA PROCEDURA DI CREAZIONE// | |
