web services servizio telematico dogane manuale per … · web services servizio telematico dogane...

21
Web Services Servizio Telematico Dogane Manuale per lutente Versione del 15 Luglio 2018 Pagina 1 di 21 Web Services Servizio Telematico Dogane MANUALE PER L'UTENTE

Upload: phungdiep

Post on 15-Feb-2019

267 views

Category:

Documents


1 download

TRANSCRIPT

Page 1: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 1 di 21

Web Services

Servizio Telematico Dogane

MANUALE PER L'UTENTE

Page 2: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 2 di 21

Indice

1 Introduzione .....................................................................................................................................3

2 Test funzionale dei web services .....................................................................................................6

3 Creazione del client........................................................................................................................10

3.1 Soluzioni Open Source............................................................................................................10

3.2 Soluzioni Proprietarie..............................................................................................................10

4 Funzionalità di base .......................................................................................................................13

4.1 LS ............................................................................................................................................13

4.2 DIR ..........................................................................................................................................13

4.3 PUT .........................................................................................................................................14

4.4 GET .........................................................................................................................................14

4.5 GETLOG .................................................................................................................................14

4.6 dirIvistoAnnullati ....................................................................................................................15

4.7 getIvistoAnnullati ....................................................................................................................15

5 Sicurezza ........................................................................................................................................16

6 WSDL – Servizio Telematico Dogane ..........................................................................................17

Page 3: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 3 di 21

1 Introduzione

Un Web Service è per definizione un servizio descritto dal fornitore (provider) in modo standard e

indipendente dal linguaggio di programmazione in cui è stato sviluppato.

Per usufruire dei Web Services forniti dal provider (servizio telematico doganale) occorre creare un

client di Web Services.

Ciò è possibile attraverso il file WSDL (Web Services Description Language) che definisce

l’interfaccia del servizio, cioè l’elenco delle operazioni fornite, i vari parametri che ogni operazione si

aspetta di ricevere da chi la richiama e l’elenco dei parametri che l’operazione fornisce come output.

Un Web Service viene richiamato parametricamente dall’utente del servizio (requester) attraverso

programmi applicativi e basandosi su un protocollo di chiamata remota, indipendente dalla rete e dai

linguaggi di programmazione, detto SOAP (Simple Object Access Protocol).

Un documento WSDL è un documento XML che contiene un insieme di definizioni per descrivere il

servizio (Web Service). Gli elementi più importanti utilizzati da WSDL sono i seguenti:

<types>

definisce i tipi di dati utilizzati nel servizio;

<message>

contiene le definizioni dei messaggi di scambio del servizio utilizzando parti definite come tipi

nella sezione types;

<portType> descrive il servizio, le operazioni che possono essere eseguite e i messaggi che sono coinvolti in queste operazioni. Per ogni metodo viene definito il messaggio di input ed il messaggio di

output. L’elemento porType può essere paragonato ad una libreria di funzioni in un

tradizionale linguaggio di programmazione;

< binding>

contiene il collegamento tra il portType (cioè la definizione astratta del servizio) e l’end-point

fisico. Questa informazione indica il protocollo da utilizzare e come ricondurre i messaggi di

input ed output al protocollo utilizzato;

<port>

definisce la porta di accesso al servizio .Un servizio può avere anche più porte ciascuna con un

nome e un protocollo di binding;

<service> contiene la definizione del servizio in termini della sua descrizione e della posizione fisica del servizio (tipicamente il suo URL) – definiti endpoint.

Page 4: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 4 di 21

Il file WSDL che descrive i servizi (Web Services) esposti dal servizio telematico doganale è

disponibile, per i client che devono utilizzarlo, collegandosi da un browser internet alle seguenti URL:

ambiente di prova:

https://ws-telematicoprova.adm.gov.it/TelematicoFtpEjbHttpRouter/TelematicoFtpWsBindingImplService/META-INF/wsdl/TelematicoFtp.wsdl

ambiente reale:

https://ws-telematico.adm.gov.it/TelematicoFtpEjbHttpRouter/TelematicoFtpWsBindingImplService/META-INF/wsdl/TelematicoFtp.wsdl

ed è riportato nel presente documento al capitolo 6 – WSDL – Servizio Telematico Dogane.

Per poter accedere alla pagina che espone il file WSDL è necessario inserire il nome utente e la

password. Digitando la URL del WSDL viene infatti visualizzata la seguente pagina di login: Il nome utente è il codice fiscale del soggetto che ha richiesto l'adesione al servizio telematico

seguito dal segno "-" e dal progressivo sede.

La password è la "Password di accesso all'applicazione", relativa al codice fiscale prima indicato, che

si trova indicata nella stampa fornita dal "Primo accesso".

Page 5: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 5 di 21

Una volta effettuato l’accesso con utente e password, il sistema fornisce in risposta il WSDL

dell’applicazione:

Page 6: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 6 di 21

2 Test funzionale dei web services

Si consiglia di effettuare un test sui Web Services esposti prima della creazione del client vero e

proprio.

A tale scopo l’utente si può avvalere ad esempio del tool SoapUI, uno strumento Java Open Source,

rilasciato sotto la licenza GNU LGPL (Lesser General Public License), estremamente utile e utilizzabile su qualsiasi piattaforma (Windows/Unix/Linux).

SoapUI è destinato a sviluppatori e collaudatori di servizi web in quanto consente di ispezionare i

servizi web, richiamarli, realizzarli e fare delle prove di carico.

I test funzionali e di caricamento possono essere fatti sia interattivamente, usando una comoda

interfaccia utente, che attraverso un processo automatico, grazie all'uso dei tool a linea di comando.

Per quanto riguarda le funzionalità di invocazione e analisi dei Web Services, SoapUI mette a

disposizione:

importazione del WSDL; generazione automatica delle richieste; supporto per i vari tipi di autenticazione (Digest, WS-Security, NTLM, ecc.); supporto di SOAP 1.1 e 1.2; editor con sintassi colorata e funzionalità di undo/redo e formattazione automatica.

Per lo sviluppo e la validazione dei Web Services vi sono:

generazione del codice sia Client che Server con supporto dei toolkit più diffusi: JBossWS,

JWSDP, Axis 1 e 2, XFire, .NET e gSOAP; generazione del WSDL da codice Java esistente; generazione delle classi di binding XML per JAXB e XMLBeans; validazione delle definizioni dei Web Services.

Inoltre è possibile usare potenti funzioni per quanto riguarda sia i test funzionali dei Web Service che

le prove di carico. In questo caso è possibile avere report dettagliati, statistiche varie, log completi e

analisi sulle prestazioni.

L’interfaccia dell’applicazione è intuitiva e facile da utilizzare come mostrato nella figura riportata di

seguito.

Page 7: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 7 di 21

Per effettuare i test di un web service è sufficiente creare un nuovo progetto specificando il nome ed il

file WSDL descrittore del servizio.

Verranno automaticamente create le chiamate ai diversi servizi esposti e per ogni chiamata sarà

visualizzata una scheda in basso in cui è possibile specificare una serie di proprietà da aggiungere alla

richiesta.

Page 8: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 8 di 21

Per i web services esposti dal servizio telematico tali proprietà consentono di specificare il Nome

utente e la Password per accedere al servizio.

Nella finestra centrale è possibile visualizzare la richiesta SOAP. Mentre nella combo in alto bisogna

specificare per ogni richiesta l’endpoint del servizio:

https://ws-telematicoprova.adm.gov.it/TelematicoFtpEjbHttpRouter/TelematicoFtpWsBindingImplService

Page 9: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 9 di 21

selezionando la freccia verde in alto a destra otteniamo la risposta SOAP del server.

In basso ci sono i vari log relativi alla chiamata.

Page 10: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 10 di 21

3 Creazione del client

Esistono diversi framework, Axis ne è un esempio, che a partire da un file WSDL creano il codice

Java sia lato client che lato server.

Questi framework possono essere integrati negli ambienti di sviluppo e quindi consentono di usufruire

delle varie funzionalità fornite all’interno di interfacce grafiche che agevolano lo sviluppatore.

Esistono diversi prodotti dedicati ai web services da integrare nei vari IDE (Integrated Development

Environment) sia nell’ambito open source che in quello commerciale.

3.1 Soluzioni Open Source

Gli IDE più conosciuti in ambito open source sono:

Eclipse

Netbeans

Essi rendono molto più agevole l’approccio top-down in quanto permettono di creare facilmente il

client del web service mediante un’interfaccia grafica partendo dal file WSDL.

Dobbiamo tener presente che un client di servizi web potrebbe a sua volta essere una web application

e quindi l’ambiente di sviluppo in tal caso avrebbe bisogno di un application server di supporto.

Eclipse è un ambiente di sviluppo integrato multi-linguaggio e multipiattaforma. Viene sviluppato da

una comunità strutturata sullo stile dell'open source. Uno dei componenti più utili, per lo sviluppo di

applicazioni Web, è certamente quello appartenente al progetto Web Tools Platform (WTP). WTP è

una piattaforma che estende le funzionalità base di Eclipse e include strumenti di vario genere che

possono facilitare in modo sostanziale il lavoro dello sviluppatore di web services; tra le funzionalità

che spiccano vi sono un editor specifico, tools per il testing e API per supportare il programmatore

durante la stesura del codice. L’application server che solitamente si utilizza con Eclipse è Tomcat.

NetBeans è un ambiente di sviluppo multi-linguaggio scritto interamente in Java. È stato scelto dalla

Sun Microsystems come IDE ufficiale. Possiede numerosi plug-in ed interessanti wizard per

sviluppare Web Services con facilità. L’application server che normalmente utilizza è Glassfish, che

rappresenta senza dubbio un’ottima soluzione.

3.2 Soluzioni Proprietarie

Oltre alle soluzioni open source descritte in precedenza ci sono diverse soluzioni proprietarie per la

creazione di un client di servizi web tra cui ad esempio:

RAD (Rational® Application Developer) di IBM.

Microsoft Visual Studio®

Page 11: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 11 di 21

In RAD la creazione delle classi java utili alla generazione del client è facile ed intuitiva. Basta

inserire nel progetto il file WSDL, cliccando poi col tasto destro selezionare “Servizi Web” e di

seguito “Genera Client”, apparirà la seguente finestra:

Qui lo sviluppatore potrà selezionare le varie opzioni di configurazione tra cui ad esempio il runtime

del servizio (JAX-WS nel nostro esempio).

Visual studio è un ambiente di sviluppo integrato sviluppato da Microsoft, che supporta attualmente

diversi tipi di linguaggio. Visual studio permette di creare client di web services grazie

all’integrazione del framework .NET. Dato il file WSDL del servizio Web, possiamo creare una classe

che faccia da proxy per una nostra futura pagina in ASP.NET, ovvero un componente che ci permetta

di accedere in modo trasparente al Web Service, senza preoccuparci delle modalità con le quali questo

viene chiamato ed utilizzato. La classe proxy metterà quindi a disposizione il servizio esattamente

come se fosse un componente da noi realizzato ed utilizzato nel progetto.

L'utility a riga di comando wsdl.exe dell'SDK di .NET ci permette di generare una classe proxy:

wsdl /language:CS http://localhost/webservice/wsftp.asmx?WSDL

Il parametro language ci permette di specificare uno dei linguaggi supporati dal .NET framework

(nell'esempio si è richiesto a wsdl.exe di generare una classe C#).

Il risultato della suddetta operazione è la generazione del file wsftp.cs, contenente il codice della

classe proxy per il servizio.

A questo punto non ci resta che compilare il file di cui sopra, sempre utilizzando l'SDK:

csc /t:library /out: wsftp.dll wsftp.cs /r:system.dll /r:system.xml.dll /r:system.web.services.dll

Page 12: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 12 di 21

Abbiamo cioè compilato la classe come libreria di classi (/t:library) indicando come risultato della

compilazione wsftp.dll ed utilizzando i metadata specificati nei parametri /r .

A questo punto il file wsftp.dll dovrà essere inserito nella cartella /BIN dell'applicazione che lo

utilizzerà.

Page 13: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 13 di 21

4 Funzionalità di base

4.1 LS

La funzione consente di estrarre e fornire la lista dei file di risposta ed esito disponibili per l’utente

autorizzato al servizio, effettuando la ricerca in base ad uno specifico pattern e limitatamente ad un

determinato intervallo temporale.

Input: rappresenta il pattern in base al quale viene filtrata la richiesta

Output: rappresenta la stringa che contiene l’esito dell’operazione e quindi il risultato della

richiesta

Di seguito un esempio dell’output opportunamente rivisitato nell’applicazione client a fronte del

pattern di input: 00001209.*

00001209.B99

00001209.UYY.p7m

00001209.UXX.p7m

00001209.UCC.p7m

00001209.UBB.p7m

00001209.UAA.p7m

00001209.UB2.p7m

00001209.UB1.p7m

00001209.P99

4.2 DIR

La funzione fornisce la lista dei file di risposta ed esito corredata con la relativa data dell’operazione

di invio al servizio telematico doganale.

La funzione effettua la ricerca per un determinato intervallo temporale.

Input: Pattern in base al quale filtrare la richiesta

Output: Stringa contenete il risultato dell’operazione

Di seguito un esempio dell’output opportunamente rivisitato da una possibile applicazione client a

fronte del pattern di input: 00001209.*

14076171,00001209.B99,RISPOSTA,Dec 28 19:18,112

14076157,00001209.UYY.p7m,RISPOSTA,Dec 09 17:05,1890

14076156,00001209.UXX.p7m,RISPOSTA,Dec 09 16:42,1890

14076155,00001209.UCC.p7m,RISPOSTA,Dec 09 16:13,1890

14076154,00001209.UBB.p7m,RISPOSTA,Dec 09 16:12,1890

14076153,00001209.UAA.p7m,RISPOSTA,Dec 09 13:32,1890

14076152,00001209.UB2.p7m,RISPOSTA,Dec 09 13:19,1890

14076171,00001209.P99,ESITO,Dec 09 19:22,330

Page 14: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 14 di 21

Nell’ordine i dati riportati sono: codice file, nome file ricevuta, tipo ricevuta, data, dimensioni

ricevuta.

4.3 PUT

La funzione realizza la trasmissione di un file al servizio telematico doganale.

Input: una stringa contenente il nome del file e un array di byte per il file stesso

Output: una stringa contenente il risultato dell’operazione.

In caso di esito positivo viene restituito il nome del file, la data di trasmissione e il codice del file.

In caso di esito negativo viene prodotta una segnalazione con il codice di errore riscontrato.

Si precisa che, poiché la funzione esposta prende in input la rappresentazione in byte del file che si

vuole trasmettere al servizio telematico doganale, la lettura iniziale del file e la successiva

trasformazione in array di byte sono demandati all’applicazione client.

Di seguito un esempio dell’output per esito positivo:

Upload del file: C:\Programmi\FirmaVerifica2.1\firmati\00001122.I08.p7m

Output : Caricato con successo.

Di seguito un esempio dell’output per esito negativo, dovuto al fatto che l’utente collegato ha codice

utente abilitato 0000 mentre ha trasmesso un file il cui nome presenta i primi 4 caratteri diversi da tale

codice:

Upload del file: C:\Programmi\FirmaVerifica2.1\firmati\057R1209.I0B.p7m

Output : Nome file fuori formato: deve iniziare con le prime 4 lettere del codice

utente.

4.4 GET

La funzione esposta realizza il download di un file di risposta o di esito secondo quanto richiesto

dall’utente.

Input: Stringa contenente il nome del file da scaricare.

Output: Il file richiesto in formato array di byte.

4.5 GETLOG

La funzione consente di effettuare il download del file di log degli errori delle operazioni effettuate in

un determinato intervallo di tempo.

Esempio di contenuto del file di log:

Page 15: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 15 di 21

[06/12/2010 12:26:20] 000010.13.CD2.p7m : Nome file fuori formato: la lunghezza è errata

[06/12/2010 09:48:13] 00000126.HAA : Il file non appartiene ad una tipologia abilitata

[06/12/2010 13:49:27] 057R1209.I0B.p7m : Nome file fuori formato: deve iniziare con le prime 4 lettere del

codice utente

[07/12/2010 15:33:26] 00001122.I05 : Verificare che il file sia stato firmato

[07/12/2010 15:35:52] 0103.Ra11 : Nome file fuori formato: la lunghezza è errata

4.6 dirIvistoAnnullati

La funzione fornisce l’elenco dei messaggi Ivisto annullati, corrispondenti ai messaggi inviati

dall’utente in un determinato arco temporale.

La funzione effettua la ricerca in un intervallo temporale che non può essere superiore a 60 giorni..

Input:

Data Da nel formato YYYY-MM-DD

Data a nel formato YYYY-MM-DD

Output:

Stringa contenente il risultato dell’operazione

Di seguito un esempio dell’output opportunamente rivisitato da una possibile applicazione client a

fronte dell’intervallo temporale impostato come segue:

14300831,00000707.Q08.p7m,07/07/2015 10:03:00,1912

14300771,00000625.QA3.p7m,26/06/2015 11:27:01,2804

14261950,00000218.QA1.p7m,17/06/2015 14:44:43,11858

14261944,00000217.QA3.p7m,10/06/2015 15:15:01,3697

Nell’ordine i dati riportati sono i seguenti: codice file, nome del messaggio ivisto annullato, data di

ricezione del messaggio ivisto annullato, dimensioni.

4.7 getIvistoAnnullati

Il file richiesto in formato array di byte

La funzione esposta realizza il download di un messaggio ivisto annullato.

Input: Stringa contenente il nome del messaggio ivisto annullato da scaricare

oppure

Input: Stringa contenente il codice del file relativo al messaggio ivisto annullato da scaricare.

Output:

-

-

-

Nome del messaggio ivisto annullato

Codice del messaggio ivisto annullato

Il messaggio ivisto richiesto in formato array di byte.

Page 16: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 16 di 21

5 Sicurezza

L’accesso ai Web Services è regolato da un’autenticazione di tipo BASIC per il passaggio delle

credenziali che saranno verificate dal sistema LDAP attualmente esistente.

In fase di realizzazione dell’applicazione client sarà dunque necessario definire, secondo lo standard

JAXWS, le policy di accesso al Web service.

L’utente deve cioè indicare username e password di accesso al momento della chiamata ai diversi

servizi.

Di seguito forniamo un esempio di una chiamata dell’operazione DIR realizzata in linguaggio java:

TelematicoFtpWsBindingImplProxy service = new TelematicoFtpWsBindingImplProxy();

BindingProvider bp = (BindingProvider) service._getDescriptor().getProxy();

bp.getRequestContext().put(BindingProvider.USERNAME_PROPERTY, "USERNAME");

bp.getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, "PASSWORD");

String result = service.dir(pattern);

Page 17: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 17 di 21

6 WSDL – Servizio Telematico Dogane

<?xml version="1.0" encoding="UTF-8" ?> - <wsdl:definitions

targetNamespace="http://webservices.ftp.telematico.dogana.dogane.ag_dogane.finanze.it" xmlns:impl="http://webservices.ftp.telematico.dogana.dogane.ag_dogane.finanze.it" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:intf="http://webservices.ftp.telematico.dogana.dogane.ag_dogane.finanze.it" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsi="http://ws- i.org/profiles/basic/1.1/xsd" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/">

- <wsdl:types> - <schema

targetNamespace="http://webservices.ftp.telematico.dogana.dogane.ag_dogane.finanze.it" xmlns="http://www.w3.org/2001/XMLSchema">

- <element name="lsResponse"> - <complexType> - <sequence>

<element name="lsReturn" nillable="true" type="xsd:string" /> </sequence> </complexType> </element>

- <element name="dir"> - <complexType> - <sequence>

<element name="pattern" nillable="true" type="xsd:string" /> </sequence> </complexType> </element>

- <element name="dirResponse"> - <complexType> - <sequence>

<element name="dirReturn" nillable="true" type="xsd:string" /> </sequence> </complexType> </element>

- <element name="getlog"> - <complexType>

<sequence /> </complexType> </element>

- <element name="getlogResponse"> - <complexType> - <sequence>

<element name="getlogReturn" type="xsd:base64Binary" /> </sequence> </complexType>

Page 18: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 18 di 21

</element> - <element name="get"> - <complexType> - <sequence>

<element name="fileName" nillable="true" type="xsd:string" /> </sequence> </complexType> </element>

- <element name="getResponse"> - <complexType> - <sequence>

<element name="getReturn" type="xsd:base64Binary" /> </sequence> </complexType> </element>

- <element name="put"> - <complexType> - <sequence>

<element name="fileMsg_Content" type="xsd:base64Binary" /> <element name="fileMsg_Nome" nillable="true" type="xsd:string" />

</sequence> </complexType> </element>

- <element name="putResponse"> - <complexType> - <sequence>

<element name="putReturn" nillable="true" type="xsd:string" /> </sequence> </complexType> </element>

- <element name="mget"> - <complexType> - <sequence>

<element name="mGetInput_Nome" nillable="true" type="xsd:string" /> <element name="mGetInput_Prog" nillable="true" type="xsd:string" />

</sequence> </complexType> </element>

- <element name="mgetResponse"> - <complexType> - <sequence>

<element name="mgetReturn" type="xsd:base64Binary" /> </sequence> </complexType> </element>

- <element name="ls"> - <complexType> - <sequence>

Page 19: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 19 di 21

<element name="pattern" nillable="true" type="xsd:string" /> </sequence> </complexType> </element> </schema> </wsdl:types>

- <wsdl:message name="putRequest"> <wsdl:part name="parameters" element="impl:put" />

</wsdl:message> - <wsdl:message name="putResponse">

<wsdl:part name="parameters" element="impl:putResponse" /> </wsdl:message>

- <wsdl:message name="getlogRequest"> <wsdl:part name="parameters" element="impl:getlog" />

</wsdl:message> - <wsdl:message name="dirRequest">

<wsdl:part name="parameters" element="impl:dir" /> </wsdl:message>

- <wsdl:message name="mgetRequest"> <wsdl:part name="parameters" element="impl:mget" />

</wsdl:message> - <wsdl:message name="getResponse">

<wsdl:part name="parameters" element="impl:getResponse" /> </wsdl:message>

- <wsdl:message name="lsRequest"> <wsdl:part name="parameters" element="impl:ls" />

</wsdl:message> - <wsdl:message name="lsResponse">

<wsdl:part name="parameters" element="impl:lsResponse" /> </wsdl:message>

- <wsdl:message name="getRequest"> <wsdl:part name="parameters" element="impl:get" />

</wsdl:message> - <wsdl:message name="mgetResponse">

<wsdl:part name="parameters" element="impl:mgetResponse" /> </wsdl:message>

- <wsdl:message name="dirResponse"> <wsdl:part name="parameters" element="impl:dirResponse" />

</wsdl:message> - <wsdl:message name="getlogResponse">

<wsdl:part name="parameters" element="impl:getlogResponse" /> </wsdl:message>

- <wsdl:portType name="TelematicoFtpWsBindingImpl"> - <wsdl:operation name="ls">

<wsdl:input name="lsRequest" message="impl:lsRequest" /> <wsdl:output name="lsResponse" message="impl:lsResponse" />

</wsdl:operation> - <wsdl:operation name="dir">

Page 20: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 20 di 21

<wsdl:input name="dirRequest" message="impl:dirRequest" /> <wsdl:output name="dirResponse" message="impl:dirResponse" />

</wsdl:operation> - <wsdl:operation name="getlog">

<wsdl:input name="getlogRequest" message="impl:getlogRequest" /> <wsdl:output name="getlogResponse" message="impl:getlogResponse" />

</wsdl:operation> - <wsdl:operation name="get">

<wsdl:input name="getRequest" message="impl:getRequest" /> <wsdl:output name="getResponse" message="impl:getResponse" />

</wsdl:operation> - <wsdl:operation name="put">

<wsdl:input name="putRequest" message="impl:putRequest" /> <wsdl:output name="putResponse" message="impl:putResponse" />

</wsdl:operation> - <wsdl:operation name="mget">

<wsdl:input name="mgetRequest" message="impl:mgetRequest" /> <wsdl:output name="mgetResponse" message="impl:mgetResponse" />

</wsdl:operation> </wsdl:portType>

- <wsdl:binding name="TelematicoFtpWsBindingImplSoapBinding" type="impl:TelematicoFtpWsBindingImpl">

<wsaw:UsingAddressing wsdl:required="false" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" />

<wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /> - <wsdl:operation name="ls">

<wsdlsoap:operation soapAction="ls" /> - <wsdl:input name="lsRequest">

<wsdlsoap:body use="literal" /> </wsdl:input>

- <wsdl:output name="lsResponse"> <wsdlsoap:body use="literal" />

</wsdl:output> </wsdl:operation>

- <wsdl:operation name="dir"> <wsdlsoap:operation soapAction="dir" />

- <wsdl:input name="dirRequest"> <wsdlsoap:body use="literal" />

</wsdl:input> - <wsdl:output name="dirResponse">

<wsdlsoap:body use="literal" /> </wsdl:output> </wsdl:operation>

- <wsdl:operation name="getlog"> <wsdlsoap:operation soapAction="getlog" />

- <wsdl:input name="getlogRequest"> <wsdlsoap:body use="literal" />

</wsdl:input>

Page 21: Web Services Servizio Telematico Dogane MANUALE PER … · Web Services Servizio Telematico Dogane – Manuale per l’utente Versione del 15 Luglio 2018 Pagina 3 di 21 1 Introduzione

Web Services Servizio Telematico Dogane – Manuale per l’utente

Versione del 15 Luglio 2018

Pagina 21 di 21

- <wsdl:output name="getlogResponse"> <wsdlsoap:body use="literal" />

</wsdl:output> </wsdl:operation>

- <wsdl:operation name="get"> <wsdlsoap:operation soapAction="get" />

- <wsdl:input name="getRequest"> <wsdlsoap:body use="literal" />

</wsdl:input> - <wsdl:output name="getResponse">

<wsdlsoap:body use="literal" /> </wsdl:output> </wsdl:operation>

- <wsdl:operation name="put"> <wsdlsoap:operation soapAction="put" />

- <wsdl:input name="putRequest"> <wsdlsoap:body use="literal" />

</wsdl:input> - <wsdl:output name="putResponse">

<wsdlsoap:body use="literal" /> </wsdl:output> </wsdl:operation>

- <wsdl:operation name="mget"> <wsdlsoap:operation soapAction="mget" />

- <wsdl:input name="mgetRequest"> <wsdlsoap:body use="literal" />

</wsdl:input> - <wsdl:output name="mgetResponse">

<wsdlsoap:body use="literal" /> </wsdl:output> </wsdl:operation> </wsdl:binding>

- <wsdl:service name="TelematicoFtpWsBindingImplService"> <wsdl:port name="TelematicoFtpWsBindingImpl"

binding="impl:TelematicoFtpWsBindingImplSoapBinding" /> </wsdl:service> </wsdl:definitions>