Differenze

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

--- documentazione_3di_riservata:docway4:aggiornamento_docway [2021/04/12 17:29] – [Installazione ver. 4.16.0] fabio.guidotti
+++ documentazione_3di_riservata:docway4:aggiornamento_docway [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
@@ Linea 1: / Linea 1: @@
-====== Aggiornamenti DocWay4 ======
-<WRAP left round important 60%>
-**Questa pagina non sostituisce la procedura di installazione di DocWay4** (riferirsi sempre a quella per dettagli di installazione)
-</WRAP>
-<WRAP clear></WRAP>
-In questa pagina sono raccolte le linee guida utili su eventuali attività da compiere prima di procedere con l'installazione di una specifica versione di DocWay in sostituzione di una precedente (aggiornamento di DocWay).
-Seguire le indicazioni specificate all'interno di questa pagina permette di aggiornare DocWay (webapp DocWay4 e DocWay4-service) senza rischiare di perdere funzionalità o creare disservizi sul cliente.
-<WRAP center round info 100%>
-L'aggiornamento di una versione di DocWay **non recente** comporta l'applicazione di tutte le linee guida specificate per le versioni successive fino a quella che si sta installando!
-__Esempio__: //Se si sta passando da una versione 4.4.1 ad una versione 4.6.2 occorre applicare tutte le regole previste per le versioni 4.5.1, 4.5.3, 4.6.0,... fino alla 4.6.2//
-</WRAP>
-Per i dettagli di relativi ad implementazioni e/o risoluzione di errori su una specifica versione riferirsi sempre alla pagina di "[[documentazione_3di_riservata:docway4:dettaglio-rilasci|dettaglio rilasci]]".
-===== Installazione ver. 4.50.0 =====
-  * Aggiornare il file .conf.xml di xdocwaydoc con quello [[http://gitlab.bo.priv/docway4/archivi_conf_xml/-/blob/master/enterprise/db/xdocwaydoc/xdocwaydoc.conf.xml|compatibile con la versione 4.50.0 di DocWay]]
-<code>
-  <key name="XML,/doc/oggettoOriginale/" global="yes" />
-  ...
-  <search_alias search_name="doc_oggetto_originale" search_key="xml,/doc/oggettoOriginale"/>
-  ...
-  <profile type="title" value='..."^|oorig!~" XML,/doc/oggettoOriginale/'/>
-</code>
-===== Installazione ver. 4.16.0 =====
-  * Aggiornare il file .conf.xml di xdocwaydoc con quello [[http://gitlab.bo.priv/docway4/archivi_conf_xml/-/blob/dw4_4_16_0/enterprise/db/xdocwaydoc/xdocwaydoc.conf.xml|compatibile con la versione 4.16.0 di DocWay]]
-<code>
-  <key name="XML,/doc/rif_interni/rif/@notificaDifferita" empty_key="yes" key_style="single" />
-  <key name="XML,/doc/rif_interni/rif/@invioEMailFallito" empty_key="yes" key_style="single" />
-</code>
-<WRAP center round important 90%>
-**E' necessario reindicizzare l'archivio xdocwaydoc dopo aver aggiunto le chiavi**
-</WRAP>
-  * Aggiornare il file .conf.xml di acl con quello [[http://gitlab.bo.priv/docway4/archivi_conf_xml/-/blob/dw4_4_16_0/enterprise/db/acl/acl.conf.xml|compatibile con la versione 4.16.0 di DocWay]]
-<code>
-  <primary_node ud_name="struttura_esterna" ud_container="list_of_struttur">
-    ...
-    <key name="XML,/struttura_esterna/lista_dist_appartenenza/@nome" key_style="double"/>
-  </primary_node>
-  <primary_node ud_name="persona_esterna" ud_container="list_of_struttur">
-    ...
-    <key name="XML,/persona_esterna/lista_dist_appartenenza/@nome" key_style="double"/>
-  </primary_node>
-  <primary_node ud_name="lista_dist" ud_container="list_of_struttur">
-    <unique_rule search_rule="[XML,/lista_dist/@nrecord]"/>
-    <key name="XML,//@xml:space" key_style="skip"/>
-    <key name="XML,/lista_dist/@nrecord" serial_id="nrecord" key_style="single"/>
-    <key name="XML,/lista_dist/@id" serial_id="idlista" key_style="single"/>
-    <key name="XML,/lista_dist/nome" key_style="double"/>
-    <key name="XML,/lista_dist/descrizione_ld" key_style="multi"/>
-    <key name="XML,/lista_dist/storia/creazione/@data" value_type="date"/>
-    <key name="XML,/lista_dist/storia/ultima_modifica/@data" value_type="date"/>
-    <file_location mode="rule" rule="lista_dist" move_always="yes"/>
-  </primary_node>
-  <serials>
-    ...
-    <serial id="idlista" mask="LS######" skip_test="yes"/>
-  </serials>
-  <hw_fields>
-    ...
-    <search_alias search_name="@" search_key="xml,/lista_dist/nome"/>
-    <search_alias search_name="@" search_key="xml,/lista_dist/descrizione_ld"/>
-    <search_alias search_name="lista_dist_nome" search_key="xml,/lista_dist/nome"/>
-    <search_alias search_name="lista_dist_descrizioneld" search_key="xml,/lista_dist/descrizione_ld"/>
-    <search_alias search_name="struest_cod_listaDist" search_key="xml,/struttura_esterna/lista_dist_appartenenza/@cod"/>
-    <search_alias search_name="struest_listaDistribuzione" search_key="xml,/struttura_esterna/lista_dist_appartenenza/@nome"/>
-    <search_alias search_name="persest_cod_listaDist" search_key="xml,/persona_esterna/lista_dist_appartenenza/@cod"/>
-    <search_alias search_name="persest_listaDistribuzione" search_key="xml,/persona_esterna/lista_dist_appartenenza/@nome"/>
-  </hw_fields>
-  <profile type="title" value='...XML,/persona_interna/@nome_profilo "^|LD_N!~" XML,/lista_dist/nome XML,/persona_esterna/@cognome...'/>
-</code>
-===== Installazione ver. 4.15.0 =====
-  * Aggiornare il file .conf.xml di xdocwaydoc con quello [[http://gitlab.bo.priv/docway4/archivi_conf_xml/-/blob/dw4_4_15_0/enterprise/db/xdocwaydoc/xdocwaydoc.conf.xml|compatibile con la versione 4.15.0 di DocWay]] (gestione dei procedimenti avviati su documenti)
-<code>
-<!-- mbernardini 05/03/2020 : gestione procedimenti -->
-<key name="XML,/doc/extra/procedimenti/procedimento/@numero" serial_id="proc_numero" empty_key="yes"/>
-<key name="XML,/doc/extra/procedimenti/procedimento/@numero_procedimento" serial_id="proc_numero_procedimento" empty_key="yes"/>
-...
-<primary_node ud_name="tipoprocedimento" ud_container="list_of_tipoprocedimento">
-  <!-- Pre 2.0 -->
-  <unique_rule search_rule="[XML,/tipoprocedimento/@nrecord]"/>
-  <!-- End Pre 2.0 -->
-  <!-- 2.0 -->
-  <unique_rules>
-   <rule id="nrecord">
-      <xpath norm="xw::utils::algo::strnorm_num">/tipoprocedimento/@nrecord</xpath>
-   </rule>
-  </unique_rules>
-  <!-- End 2.0 -->
-  <key name="XML,/tipoprocedimento/@nrecord" serial_id="nrecord" key_style="single"/>
-  <key name="XML,//@xml:space" key_style="skip"/>
-  <file_location mode="rule" rule="tipoprocedimento" />
-</primary_node>
-...
-<!-- mbernardini 05/03/2020 : gestione procedimenti -->
-<serial id="proc_numero" mask="#####" prefix="yes" empty="yes" />
-<serial id="proc_numero_procedimento" mask="#######" prefix="yes" empty="yes" />
-</code>
-===== Installazione ver. 4.14.1 =====
-  * Aggiornare il file .conf.xml di xdocwaydoc con quello compatibile con la versione 4.14.1 di DocWay (aggiunta la gestione degli allegati nelle annotazioni / postit)
-<code>
-<key name="XML,/doc/postit/postit_file/@id" attach="yes"/>
-</code>
-===== Installazione ver. 4.13.0 =====
-  * Aggiornare il file .conf.xml di xdocwaydoc con quello compatibile con la versione 4.13.0 di DocWay (aggiunta la chiave nulla sul cod_fasc specificato sull'rpa del documento - ricerca di documenti non fascicolati)
-<code>
-<key name="XML,/doc/rif_interni/rif/@cod_fasc" empty_key="yes" />
-</code>
-===== Installazione ver. 4.11.3 =====
-  * Aggiornare il file .conf.xml di xdocwaydoc con quello compatibile con la versione 4.11.3 di DocWay (aggiunta la gestione della presa in carico su DocWay)
-===== Installazione ver. 4.11.0 =====
-  * Aggiornare il file .conf.xml di acl con quello compatibile con la versione 4.11.0 di DocWay (aggiunta la gestione delle deleghe su DocWay)
-  * Integrare i file dei diritti di //acl// e //xdocwaydoc// (se personalizzati a livello di configuratore) con il set di diritti necessari al funzionamento della delega e delle azioni massive tramite stored procedure LUA
-===== Installazione ver. 4.10.0 =====
-  * Richiede l'upgrade a **Java8**
-===== Installazione ver. 4.9.3 =====
-  * Aggiornare il file .conf.xml di acl con quello compatibile con la versione 4.9.3 di DocWay (aggiunta l'information unit Account e modificato il titolo)
-    * Si tratta di una InformationUnit non utilizzata da nessun cliente DocWay ma richiesta dal modulo ACL di EC
-===== Installazione ver. 4.9.0 =====
-  * Aggiornare il file .conf.xml di acl con quello compatibile con la versione 4.9.0 di DocWay (aggiunta la tipologia di casella di posta elettronica in  definizione del titolo)
-    * Questo aggiornamento è facoltativo, non comporta perdita di funzionalità. E' necessario nel caso si vogliano distinguere le caselle di archiviazione da quelle di interoperabilità direttamente da lista titoli su ACL
-    * Dopo l'aggiornamento del conf occorre riavviare il server eXtraWay e rigenerare i titoli (non è necessario reindicizzare l'archivio)
-===== Installazione ver. 4.8.0 =====
-  * Aggiornare il file .conf.xml di docway con quello compatibile con la versione 4.8.0 di DocWay (//attr_collate vistoDa//)
-===== Installazione ver. 4.7.0 =====
-  * Split delle caselle di posta definite sull'AOO
-    * Aggiornare il file .conf.xml di acl con quello compatibile con la versione 4.7.0 di DocWay (presenza dell'information unit **casellaPostaElettronica**)
-    * Lanciare la procedura di split delle caselle di posta tramite l'URL: http://HOST[:PORT]/DocWay4-service/application/xdocway/engine/create_mailbox_from_aoo.jsp
-  * Se sul cliente è stato personalizzato il file acl.xml sul configuratore (/opt/3di.it/conf/Docway4-service/base/acl/diritti) occorre portare i diritti relativi all'inserimento/aggiornamento delle caselle di posta (//ACL-31//, //ACL-32//)
-  * Modificare tutti i documentModel presenti sull'installazione del cliente, in particolare:
-    * Sostituire tutti gli xpath '**/aoo/**' con '**/casellaPostaElettronica/**' definiti sul documentModel (probabilmente saranno utilizzati dal metodo '//getXPathValue//'
-  * Aggiornare (se presente) **mailArchiver** alla versione //2.4.1//
-===== Installazione ver. 4.6.0 =====
-  * Eliminate le personalView dal file di properties di default in modo da risolvere incompatibilità con codici di repertorio utilizzati dai clienti.
-    * Di conseguenza tutte le **personalView** definite nel file it.highwaytech.apps.xdocway.properties interno alla webapp DocWay4-service devono essere **copiate nel file it.highwaytech.apps.xdocway.properties gestito dal configuratore**
-  * Visto che la versione 4.6.0 è stata portata su //Maven// occorre, __prima di procedere con l'installazione in produzione di DocWay__, che gli account sui clienti verifichino il corretto funzionamento di servizi particolari configurati sul cliente (es. firma remota Uniserv, servizi esterni come EquiNotifier, integrazione NAV, firma remota Avepa, ecc.)
-  * In caso di campi custom abilitati sul cliente verificare che nel file it.highwaytech.apps.generic.properties sul configuratore esista la property seguente (BUG corretto in versione successiva di DocWay):
-    * **customFields.relativePath=/customfields**
-===== Installazione ver. 4.5.3 =====
-  * I file di properties dell'applicazione DocWay4-service sono stati ripuliti da tutte le configurazioni relative a moduli aggiuntivi di DocWay (in questo modo si evita che i clienti possano attivare in autonomia moduli non previsti/acquistati).
-    * Questo comporta che tutte le properties relative a moduli utilizzati da uno specifico cliente che sono state rimosse dal file di default devono essere copiate all'interno dei file gestiti dal configuratore (in modo da evitare perdita di funzionalità, ad esempio: fatturePA).
-===== Installazione ver. 4.5.1 =====
-  * Copiare tutte le properties e i file di risorse (diritti, file di segnatura, repertori, ecc.) dell'applicazione installata presso il cliente all'interno della directory sulla quale opera il configuratore ([[documentazione_3di_riservata:docway4:migrazione_configurazioni|dettagli di funzionamento del configuratore]]).