Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- documentazione_3di_riservata:docway4:procedimenti-api-dw4 [2020/03/17 12:00] – [Configurazione Tipi di Documenti] mbernardini
+++ documentazione_3di_riservata:docway4:procedimenti-api-dw4 [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
@@ Linea 1: / Linea 1: @@
-====== Procedimenti API - DocWay4 ======
-Avvio di procedimenti agganciati a protocolli di DocWay4. Funzionalità sviluppate per CRV (Consiglio Regionale del Veneto), per maggiori informazioni consultare EasyProject:
-  * [[https://3dinformatica.easyproject.com/issues/19484|Task #19484 - Avvio workflow su documenti protocollati]]
-  * [[https://3dinformatica.easyproject.com/projects/942|CRV - Mev]]
-===== Attivazione/Configurazione =====
-Per abilitare la gestione dei procedimento occorre attivare la property '**enableGestioneProcedimentiApi**' all'interno del file //it.highwaytech.apps.xdocway.properties// (attenzione, di default la property non è presente, così come tutto il blocco di gestione dei procedimenti - in caso di attivazione deve essere aggiunta al file sul configuratore).
-Di seguito è riportato il blocco completo di properties di xdocway per la gestione dei procedimenti:
-<code>
-#### Procedimenti API - Integrazioni CRV ####
-# Abilitazione della gestione dei procedimenti (integrazione con API). ('si', 'no' - Default = 'no')
-enableGestioneProcedimentiApi=no
-# Definizione dell'URL di endpoint dei WebServices di Workflow di API
-#procedimentiApi.wsWorkflow.endpoint=http://192.168.42.33:7080/axis/services/WSWorkflow
-procedimentiApi.wsWorkflow.endpoint=
-# Query da utilizzare per il recupero dei procedimenti per i quali deve essere tentato l'avvio del workflow su API. Se non specificata, di default
-# vengono tentati gli avvii su tutti i procedimenti nuovi (in attesa di invio) e su quelli per i quali era stato riscontrato un errore.
-#procedimentiApi.wsWorkflow.query=([xml,/doc/extra/procedimenti/procedimento/@wf]=wait or error)
-procedimentiApi.wsWorkflow.query=
-# Parametri aggiuntivi necessari all'avvio del workflow (possono non essere settati se i valori di default non variano)
-#procedimentiApi.wsWorkflow.nomeIter=ATTIVITA_ISTITUZIONALE
-#procedimentiApi.wsWorkflow.applicazione=CRVPRO
-#procedimentiApi.wsWorkflow.utente=ws
-#############################################
-</code>
-Sempre all'interno del file //it.highwaytech.apps.xdocway.properties// occorre configurare la property '**procedimentiApi.wsWorkflow.endpoint**' se si vuole abilitare l'avvio di workflow su API in caso di procredimenti avviati su documenti protocollati. Nel caso in cui la property non venga configurata l'avvio di workflow non sarà mai tentato.
-Le altre property indicate sono invece facoltative e devono essere configurate solo nel caso in cui sia necessario variare i valori di default previsti.
-**N.B.**: Oltre alla configurazione del file di properties xdocway occorre procedere con le seguenti altre configurazioni al fine di abilitare correttamente tutte le funzionalità legate ai procedimenti:
-  * Configurazione delle legislature gestite su DocWay;
-  * Configurazione delle tipologie di documenti;
-  * Import su eXtraWay dei tipi di procedimento che possono essere avviati sui documenti.
-==== Configurazione Legislature ====
-Il file di configurazione delle legislature è lo stesso utilizzato per la gestione dei repertori per legislatura.
-Si tratta di un file xml (**legislature.xml**) presente all'interno della directory //DocWay4-service/application/xdocway//. Di seguito viene mostrato il contenuto di default:
-<code>
-<?xml version="1.0" encoding="UTF-8"?>
-<listof_legislatura>
-  <legislatura numero="1" dataInizio="19700707" dataFine="19750614">
-    <descrizione>I Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="2" dataInizio="19750715" dataFine="19800607">
-    <descrizione>II Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="3" dataInizio="19800608" dataFine="19850511">
-    <descrizione>III Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="4" dataInizio="19850617" dataFine="19900515">
-    <descrizione>IV Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="5" dataInizio="19900506" dataFine="19950422">
-    <descrizione>V Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="6" dataInizio="19950423" dataFine="20000416">
-    <descrizione>VI Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="7" dataInizio="20000417" dataFine="20050402">
-    <descrizione>VII Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="8" dataInizio="20050403" dataFine="20100327">
-    <descrizione>VIII Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="9" dataInizio="20100328" dataFine="20150612">
-    <descrizione>IX Legislatura</descrizione>
-  </legislatura>
-  <legislatura numero="10" dataInizio="20150616" dataFine="20200616">
-    <descrizione>X Legislatura</descrizione>
-  </legislatura>
-</listof_legislatura>
-</code>
-L'elenco di legislature di default è stato generato a partire da un export dal DB Oracle attualmente utilizzato dal CRV. La procedura di generazione del file è descritta (e disponibile) sul progetto __//DocWay4-service/test/resources/readme.txt//__. Allo stato attuale l'esecuzione della procedura richiede un ambiente di sviluppo configurato.
-Nel caso in cui sia necessario aggiornare il file, la copia aggiornata di esso deve essere caricata all'interno della directory del configuratore (es. /opt/3di.it/conf/DocWay4-service/application/xdocway).
-==== Configurazione Tipi di Documenti ====
-Il file xml di configurazione delle tipologie di documenti è il seguente:
-  * **DocWay4-service/application/xdocway/procedimenti_api/tipologie.xml**
-Così come per il file delle legislature, il set di tipi di default è stato generato a partire da un export dal DB Oracle attualmente utilizzato dal CRV. Anche in questo caso per maggiori informazioni sulla procedura adottata consulare il file __//DocWay4-service/test/resources/readme.txt//__.
-Di seguito viene mostrata una porzione del file di default:
-<code>
-<?xml version="1.0" encoding="UTF-8"?>
-<listof_tipologie>
-  <tipologia id="6" enabled="true">
-    <description>Albo fornitori</description>
-  </tipologia>
-  <tipologia id="111" enabled="true">
-    <description>Allegato per pubblicazione web</description>
-  </tipologia>
-  <tipologia id="123" enabled="true">
-    <description>Allegato specifico</description>
-  </tipologia>
-  <tipologia id="74" enabled="true">
-    <description>Atto ispettivo</description>
-  </tipologia>
-  <tipologia id="146" enabled="true">
-    <description>Bilancio società controllata</description>
-  </tipologia>
-  <tipologia id="7" enabled="true">
-    <description>Convocazione Consiglio regionale</description>
-  </tipologia>
-  <tipologia id="8" enabled="true">
-    <description>Convocazione Organo interno</description>
-  </tipologia>
-  <tipologia id="103" enabled="true">
-    <description>Convocazioni/o.d.g.</description>
-  </tipologia>
-  ...
-  <tipologia id="145" enabled="false">
-    <description>Verifica è funzionale</description>
-  </tipologia>
-  <tipologia id="107" enabled="true">
-    <description>Visti contabili</description>
-  </tipologia>
-  <tipologia id="44" enabled="true">
-    <description>Visto o rinvio</description>
-  </tipologia>
-</listof_tipologie>
-</code>
-==== Import Tipi di Procedimenti ====