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.

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 descrizione della numerazione adottata per il Server.

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

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

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

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

• 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¹⁾ 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.