Java SOAP Client - Global Procurement

WebEDI – Scambio elettronico documenti
Java SOAP Client
Manuale per l’installazione
Tipologia
Titolo
Identificativo
Documento
Java SOAP Client
Descrizione del documento e schema XML
ManualeInstallazioneSoapCli
ent
Versione e Data
Pag.
di
1
7
WebEDI – Scambio elettronico documenti
Sommario
SOMMARIO ............................................................................................................................................................................................................................................................................ 2
1
INTRODUZIONE ............................................................................................................................................................................................................................................................ 3
2
JAVA VIRTUAL MACHINE ......................................................................................................................................................................................................................................... 4
3
INSTALLAZIONE DI SOAPCLIENT ........................................................................................................................................................................................................................... 4
3.1
3.2
4
CODICI DEI DOCUMENTI IN TRANSITO DA ENEL ............................................................................................................................................................................................................ 6
CODICI DEI DOCUMENTI IN TRANSITO VERSO ENEL ...................................................................................................................................................................................................... 6
USO DI JAVA SOAP CLIENT ....................................................................................................................................................................................................................................... 7
Tipologia
Titolo
Identificativo
Documento
Java SOAP Client
Manuale di installazione
ManualeInstallazioneSoapCli
ent
Versione e Data
Pag.
di
2
7
WebEDI – Scambio elettronico documenti
1
Introduzione
Il presente documento viene redatto con lo scopo di fornire una guida rapida per l’installazione del Java SOAP Client predisposto da Enel per l’invio e la ricezione
automatica di documenti commerciali in formato elettronico (XML) tramite il canale Web EDI (SOAP-EDI)
Tipologia
Titolo
Identificativo
Documento
Java SOAP Client
Manuale di installazione
ManualeInstallazioneSoapCli
ent
Versione e Data
Pag.
di
3
7
WebEDI – Scambio elettronico documenti
2
Java Virtual Machine
Per il funzionamento di Java Soap Client è necessario che sul computer sul quale viene eseguito, sia installato il software Java Virtual Machine di versione “1.6” o successiva (in seguito
“JVM”). Qualora fosse necessario, tale software è disponibile gratuitamente al sito internet http://java.sun.com .
3
Installazione di SoapClient
Il file “ENEL_Accesso_WS.rar” contiene tutti i files di Java Soap Client.
• Estrarre l’intero contenuto del file “ENEL_Accesso_WS.rar” su una cartella di lavoro (in avanti indicata con <dir>). In questa verrà inserita la cartella “client” con il seguente
contenuto:
•
Tramite un editor di testo (ad esempio Blocco Note) creare un file “.bat” all’interno inserendo il seguente comando:
java -jar <dir>\client\ClientSoap.jar <dir>\client\config.xml
Tipologia
Titolo
Identificativo
Documento
Java SOAP Client
Manuale di installazione
ManualeInstallazioneSoapCli
ent
Versione e Data
Pag.
di
4
7
WebEDI – Scambio elettronico documenti
•
Dopo aver chiuso e salvato il file ClientSoap.bat, chi sta installando per la prima volta il client SOAP, tramite un editor di testo, deve compilare il file config.xml come di
seguito indicato:
Indicare “S” se la connessione
ad Internet avviene tramiteun
Proxy Server
(“N” in caso contrario)
Indicare “S” il Proxy Server
utilizzato è di tipo SOCKS
(“N” in caso contrario)
Se si utilizza un Proxy Server,
indicarne l’indirizzo
Indicare la porta utilizzata dal
Proxy Server
UserName e Password per
l’autenticazione al Proxy Server
Posizione in cui verranno
salvati eventuali documenti
(Files XML) ricevuti da Enel
Posizione dei documenti (Files
XML) da inviare ad Enel
Indicare “T” per effettuare i
test di invio/ricezione o “E” per
effettuare scambi reali
(ambiente di esercizio)
Contiene l’indicazione dei tipo
documenti che si indende
ricevere da Enel. Vanno indicati
i codici riportati di seguito
separati da uno spazio
Tipologia
Titolo
Identificativo
Documento
Java SOAP Client
Manuale di installazione
ManualeInstallazioneSoapCli
ent
Versione e Data
userid/password abilitata
all’accesso al portale Enel
fornitori.
identificativo=userid
password=password
Se impostato a “S” elimina i
files XML dopo il primo invio
con esito positivo
Pag.
di
5
7
WebEDI – Scambio elettronico documenti
Chi invece utilizzava la precedente versione può utilizzare il vecchio file “config.xml”.
3.1
Codici dei documenti in transito da Enel
Per la valorizzazione del tag <documenti> nel file config.xml
Tipo di documento
Codice documento (da aggiungere nel tag <documenti>)
Assegnazione fabbisogno
Avviso di pagamento
10
4
Benestare
3.2
3
Movimenti impresa
15
Ricevuta di ritorno
5
Specifica d’ordine
2
Verbale Consegna Lavori
7
Codici dei documenti in transito verso Enel
Qui riportati solo a titolo informativo
Tipo di documento
Codice documento
Avviso di collaudo
11
Avviso di merce pronta
12
Comunicazione di consegna
13
Documento di trasporto
14
Fattura
9
Libretto di misura
8
Tipologia
Titolo
Identificativo
Documento
Java SOAP Client
Manuale di installazione
ManualeInstallazioneSoapCli
ent
Versione e Data
Pag.
di
6
7
WebEDI – Scambio elettronico documenti
4
Uso di Java Soap Client
Dopo aver predisposto (se necessario) la cartella per la ricezione dei documenti (Es.: “c:\xml\in”) ed inserito i files XML da inviare nella cartella di spedizione (Es.: “c:\xml\out”), è
sufficiente avviare il file SoapClient.bat.
L’esecuzione può richiedere da pochi secondi a qualche minuto in funzione di:
• numero di documenti scambiati;
• condizioni della rete.
Al termine dell’esecuzione Java Soap Client avrà scritto, nella cartella da cui viene eseguito il client, un report relativo alle attività effettuate ed agli eventuali errori verificatisi durante
l’esecuzione.
Java Soap Client è distribuito gratuitamente da Enel allo scopo di fornire un esempio funzionante di impiego delle funzionalità del Web Service SOAP-EDI.
Al fine di non sottovalutare le potenzialità di automazione ed integrazione tra sistemi informativi offerte da tale Web Service, è consigliabile evitare di considerare Java Soap Client
come “canale di comunicazione con Enel” in quanto esso è solo un esempio di utilizzo di tale canale.
Tipologia
Titolo
Identificativo
Documento
Java SOAP Client
Manuale di installazione
ManualeInstallazioneSoapCli
ent
Versione e Data
Pag.
di
7
7