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:

######################### 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

###########################################################################################################################################

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 '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

######################### 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

####################################################################################################################################

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:

<?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>

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