Differenze

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

--- documentazione_3di:extraway:ver_xw_jws [2014/02/05 17:47] – [Versioni eXtraWay Web Services / PXML Web Services] 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''__.\\
-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.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.