• 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)
  • Da versione 4.9.3 di DocWay possibilità di utilizzare il file caricato sul primo documento dell'indice come copertina in sostituzione di quella autogenerata
• Sia sul raccoglitore che sui documenti contenuti (autogenerati e non) è possibile utilizzare i campi custom

• 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=

# Indica come occorre gestire la copertina dei raccoglitori di tipo indice. Se disattivato, la copertina verrà generata tramite template in 
# base ai dati (custom e non) del raccoglitore. Se attivato verrà utilizzata come copertina del raccoglitore il file contenuto nel primo
# documento incluso nel raccoglitore (primo nodo) - ('si', 'no' - Default = 'no')
indiceRaccoglitori.copertinaByVoce=no

# 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
• Attraverso la property indiceRaccoglitori.copertinaByVoce (aggiunta dalla versione 4.9.3 di DocWay) è possibile utilizzare come copertina del raccoglitore il file caricato sulla prima voce dell'indice (primo documento incluso nel raccoglore) in sostituzione di quella autogenerata

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

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)
  • Se vengono indicate tipologie di protocollo (arrivo, partenza, interno) il documento sarà generato in BOZZA
• '/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