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.

Per i dettagli di relativi ad implementazioni e/o risoluzione di errori su una specifica versione riferirsi sempre alla pagina di “dettaglio rilasci”.

• Aggiornare il file .conf.xml di xdocwaydoc con quello compatibile con la versione 4.16.0 di DocWay

• Aggiornare il file .conf.xml di xdocwaydoc con quello compatibile con la versione 4.15.0 di DocWay (gestione dei procedimenti avviati su documenti)

<!-- 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" />

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

<key name="XML,/doc/postit/postit_file/@id" attach="yes"/>

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

<key name="XML,/doc/rif_interni/rif/@cod_fasc" empty_key="yes" />

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

• 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

• Richiede l'upgrade a Java8

• 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

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

• Aggiornare il file .conf.xml di docway con quello compatibile con la versione 4.8.0 di DocWay (attr_collate vistoDa)

• 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

• 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

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

• 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 (dettagli di funzionamento del configuratore).