Differenze

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

--- documentazione_3di:extraway:ver_xw_jws [2014/02/05 23:11] – [Versione 3.7.5] rtirabassi
+++ documentazione_3di:extraway:ver_xw_jws [2014/02/07 15:50] (versione attuale) – eliminata mballerini
@@ Linea 1: / Linea 1: @@
-====== Versioni eXtraWay Web Services / PXML Web Services / Mobile Web Services ======
-La presente documentazione si riferisce ai Web Services di 3D Informatica.\\ Sino al maggio 2012 essi si distinguevano in Web Services principali e Web Services estesi, frutto solitamente di un'aggiunta di classi a quelli principali.\\ Per migliorare la manutenibilità del progetto pur consentendo di far uso di WS specializzati, ora convivono le due anime nello stesso pacchetto ed il fruitore deciderà quali Web Services utilizzare.\\ Se in precedenza esistevano i ''3diws'' ed i ''3diwsPXML'' ora esiste solo __''3diws''__.\\
-**[[http://intra.3di.it/manuali/3diws/index.html|Per accedere alla Techincal Reference del Web Service fare click qui.]]**
-Di seguito l'elenco delle versioni dei Web Service e delle loro caratteristiche.
-**N.B.:** Per quanto concerne la numerazione dei moduli si rimanda alla [[documentazione_3di:extraway:ver_xw|descrizione della numerazione adottata per il Server]].
-====== Versioni '3' ======
-===== Versione 3.7.6-7 =====
-  * Risoluzione del numero fisico in modo più spedito per migliorare le performance.
-  * Tutelata l'esecuzione dei comandi di Plug-In in modo che in caso di eccezione tornino un errore appropriato.
-  * Introdotta la possibilità di avere più estensioni del servizio di base.
-  * Introduzione di una sub-interfaccia per il solo utilizzo da parte di applicazioni (attualmente) mobile. Espone metodi singoli quindi accettabili per il paradigma wsdl 2.0.
-===== Versione 3.7.5 =====
-  * Revisione delle funzioni per la gestione dell'albero dei fascicoli con la possibilità di visualizzare dei documenti con numero massimo di documenti da mostrare.
-  * Cambiamenti nella checkFolderChildren() per superare limiti imposti in sede di ricerca.
-  * Corretto errore nel salvataggio dei gruppi.
-  * Introdotta chiamata diretta alle ''Stored Procedures'' e ''Plug-In'' in modalità sincrona o asincrona.
-  * Durante il salvataggio di record di tipo ''doc'', ''fascicolo'' e ''fascicolo_speciale'' consentito qualsiasi contenuto nell'elemento ''note'' in modo da poter utilizzare anche testo ricco HTML nel campo.
-  * Estesa la dimensione della pagina di codici del titolario in modo che riesca nell'intento di convalidare sempre il codice di Titolario di Classificazione con cui si salva un record. In precedenza il valore era limitato a 50 voci ma per titolari troppo estesi si avevano dei falsi negativi.
-  * Consentita l'introduzione di un nuovo file allegato per consentire l'applicazione della firma.
-  * Aggiunta la possibilità di modificare i ''rif_esterni'' di un documento se in bozza.
-  * Introdotti nuovi metodi per l'acquisizione del solo nome degli allegati e non del loro contenuto.
-  * All'atto del salvataggio di un documento in sede di checkInContentFile(), se si rilevano gli estremi della lavorazione (impronta) degli allegati lato server non si procede col calcolo dell'impronta sul fronte applicativo.
-  * Cambiamenti per far uso di uno specifico archivio ACL differente dal default((acl)).
-===== Versione 3.7.4 =====
-  * Corretta la chiamata alla funzione loadFirst() in modo che preveda un nuovo parametro //boolean// per richiedere l'uso della //Dll d'Archivio// all'atto del caricamento del record.
-  * Ampliato il log in caso di errore di modifica perché consenta di distinguere i diversi casi in cui la modifica viene negata per mancanza dei necessari diritti.
-  * Modificate le modalità di apertura della connessione in modo che, qualora si utilizzi un ACL specifico, esso venga effettivamente impostato nella connessione così da poter essere usato in modo appropriato da tutto il codice generico di docway (generic/code/broker).\\ Si ricorda che l'impostazione di un eventuale ACL specifico va compiuta nel file ''it.highwaytech.apps.generic.properties''.
-  * Aggiunta la possibilità, nei metodi ''indexPage()'', ''nextIndexPage()'' e ''prevIndexPage()'' di indicare l'ID di una selezione da utilizzare per un'analisi spettrale senza doversi preoccupare di modificare la selezione corrente che anzi rimane invariata consentendo un'analisi spettrale arbitraria senza impatti sul resto dell'applicazione.
-  * Revisione dei comandi di accesso agli indici finalizzato a poter impostare ulteriori parametri, come l'analisi spettrale svincolata dalla selezione corrente.
-  * Prevista la gestione del contesto che viene notificato al server unitamente all'utente. Il concetto di contesto assume un diverso significato su base applicativa e può essere sfruttato lato server.
-  * Modificata la chiamata alle //Stored Procedures// così da inviare in //Base64// tutti i parametri e poter quindi inviare anche materiale in ''XML''.\\ <color red>Questa modifica introduce l'utilizzo di una nuova versione di un ''jar'' esistente. In particolare si passa dalla versione ''1.3'' alla versione ''1.7'' della ''commons-codec''.\\ Questo richiede, a seguito di un aggiornamento del //Web Service// a questa versione o ad una versione successiva, di rimuovere la precedente ''commons-codec-1.3.jar'' che altrimenti vanifica l'intervento e causa malfunzionamenti.</color>
-  * <color blue>Modifica alla distribuzione. Ora la distribuzione del Web Service è priva dei 3 files di profilo (Vds 3diws/WEB-INF/classes/*.profile) che regolano il funzionamento del //Web Service// stesso.\\ La loro assenza comporta l'adozione di una serie di comportamenti di default e l'assenza del log del //Web Service//.\\ Questo comportamento è teso a non rischiare di sovrascrivere i files di properties personalizzati in ciascuna installazione all'atto dell'aggiornamento del //Web Service//.\\ Al posto dei files precedentemente distribuiti vengono ora forniti 3 files con estensione ''.properties.sample'' che gli utenti possono sfruttare per creare le proprie personalizzazioni.</color>
-  * Corretto errore nella composizione del comando di accesso ad una pagina di indici nella quale si esplicita una restrizione spettrale che non corrisponde alla selezione corrente ma ad altra selezione appositamente generata. Il parametro necessario a questo scopo non veniva correttamente inviato al server.
-===== Versione 3.7.3 =====
-  * Introdotte le chiamate ai //PlugIn// ed alle //Stored Procedures// sia in forma sincrona che in forma asincrona.
-  * Rilassato il test sull'elemento ''note'' dei ''doc'', ''fascicolo'' e ''fascicolo_speciale'' negli archivi di derivazione //xDocWayDoc// in modo che consentano l'inserimento di contenuti complessi e testo ricco(ad esempio HTML).
-===== Versione 3.7.2 =====
-  * Modificato il comportamento del WS in sede di accesso ad una pagina di vocabolario che risulti del tutto vuoto, non alimentato. Ora non viene più tornata eccezione bensì un risultato regolare ma vuoto.
-===== Versione 3.7.1 =====
-  * Introdotto il corretto test dei diritti per l'accesso alle //Unità Informative// di tipo ''comune'' delle quali era consentita la ricerca, la visualizzazione dei titoli ma non l'accesso diretto.
-===== Versione 3.7.0 =====
-  * Prima versione id cui si fa registrazione in questa documentazione.
-  * Modellati due distinti //Web Services// in grado di convivere. Ora esiste sia il Web Service standard che l'estensione PXML nello stesso pacchetto.
-  * Introdotta un'estensione della composizione della cache((Titoli)) dei documenti in modo che consenta di introdurre in essa direttamente un frammento XML.
-  * Consentito il salvataggio di ''persone_interne'' con l'assegnazione diretta dei suoi ''personal_rights'' senza dover passare dall'assegnazione del profilo.