È possibile inviare richieste a servizi basati su SOAP, JMS
(Java Messaging Service), WebSphere MQ
e Microsoft .NET che utilizzano un
file WSDL (Web Service Description Language) per specificare il contenuto della
richiesta di servizio.
Prima di iniziare
Accertarsi di avere un file WSDL valido, accessibile sul file system, nello spazio di lavoro, a un URL specifico oppure in un repository UDDI (Universal Description Discovery and Integration) o IBM® WebSphere Service Registry and Repository.
Verificare che i file WSDL utilizzino la sintassi corretta per l'ambiente di test.
Il client del servizio generico potrebbe non funzionare con alcuni file WSDL.
Se il servizio utilizza l'autenticazione SSL (Secure Sockets Layer), creare una configurazione SSL prima di inviare la richiesta. Per ulteriori informazioni,
vedere Creazione di configurazioni SSL.
Se il servizio utilizza la sicurezza SOAP
per gli algoritmi di crittografia, firma o altri algoritmi di sicurezza, è necessario prima configurare l'ambiente con i file
di librerie e di configurazione corretti e creare quindi un profilo di sicurezza WSDL.
Per ulteriori informazioni,
vedere Configurazione dell'ambiente per la sicurezza SOAP e Creazione di profili di sicurezza per i file WSDL.
Per importare un
file WSDL da un sito protetto che richiede l'autenticazione reciproca, è necessario
avere il file archivio chiavi nello spazio di lavoro.
Informazioni su questa attività
Quando si crea una chiamata da un file WSDL, la chiamata viene configurata
automaticamente con qualsiasi endpoint SOAP, JMS, WebSphere MQ
o Microsoft .NET disponibile nel file
WSDL. Selezionare la configurazione di trasporto esistente nella pagina
Trasporto della richiesta.
Procedura
Per inviare una richiesta di servizio basata su un file WSDL:
- Fare clic sul pulsante della barra degli strumenti Apri il client di servizio generico
e selezionare la pagina Richieste.
- Fare clic su Aggiungi
e selezionare il metodo per aggiungere a un file WSDL oppure fare clic sul pulsante di
collegamento corrispondente nella pagina principale. - Fare clic su Aggiungi WSDL dallo spazio di lavoro per aggiungere
un file WSDL dallo spazio di lavoro locale.
- Fare clic su Aggiungi WSDL dal File System per
aggiungere un file WSDL dal file system.
- Fare clic su Aggiungi WSDL da URL per scaricare e
importare un WSDL in linea dal Web.
- Fare clic su Aggiungi WSDL da WSRR per aggiungere un WSDL
da WebSphere Service Registry
and Repository.
Immettere l'URL di WebSphere Service Registry
and Repository e
fare clic su Connetti. È possibile fare clic su Cerca
per esplorare il contenuto del repository.
- Fare clic su Aggiungi WSDL da UDDI per aggiungere un WSDL
da un repository UDDI (Universal Description Discovery and Integration).
Immettere l'URL dell'UDDI e fare clic su Connetti.
È possibile fare clic su Filtra
e Cerca per esplorare il contenuto del repository.
Nota: Se si sta importando il file WSDL da un sito protetto
che richiede l'autenticazione del certificato, fare clic su Importa
proprietà e, per Archivio chiavi, selezionare
il file di archivio chiavi che contiene il certificato da fornire
al server e, per Password archivio chiavi,
immettere la password.
- Fare clic su OK. Il file WSDL viene aggiunto alla Libreria richieste.
- Nella Libreria richieste, espandere il
file WSDL, il binding e l'operazione e selezionare quindi l'elemento di chiamata. Il client del server generico mostra 3 passi: Modifica dati, Richiama e Visualizza risposta. I dettagli della chiamata vengono visualizzati nel passo Modifica dati.
- Nella pagina Messaggio, utilizzare le viste Modulo, Struttura
ad albero oppure Origine per modificare il contenuto della richiesta. Ciascuna vista mostra un formato differente degli stessi dati. Per aggiungere
o rimuovere elementi XML nella vista Modulo o Struttura ad albero,
fare clic su per
essere conformi a un XSD (XML Schema Definition) specificato nel catalogo degli schemi.
- Nella pagina Trasporto, specificare la configurazione di trasporto
per la richiesta. Le informazioni di trasporto dal file WSDL vengono importate automaticamente
nella configurazione di trasporto.
Per Microsoft .NET, selezionare
la configurazione di trasporto corrispondente e specificare l'ubicazione
del file soaclient.exe.config. È necessario creare il
file manualmente. Per i dettagli, consultare Creazione delle configurazioni di trasporto Microsoft .NET.
Nota: Se si sta utilizzando IBM Security AppScan, è disponibile solo il protocollo di trasporto HTTP.
- Nella pagina Stack di richiesta, specificare se
sovrascrivere gli algoritmi di sicurezza o di elaborazione
applicati alla richiesta in uscita per il file WSDL. Fare clic su Mostra stack risposte per aggiungere una pagina Stack di risposta per modificare gli algoritmi di sicurezza o di elaborazione per le risposte in entrata.
Nota: Queste impostazioni si applicano solo alla richiesta corrente. se si desidera modificare lo stack di richieste o di risposte per
tutte le richieste che utilizzano il file WSDL corrente, fare clic su Modifica sicurezza WSDL per aprire l'Editor sicurezza WSDL.
- Quando si è pronti a inviare la richiesta di servizio, fare clic su Richiama. Il client del servizio generico invia la richiesta e visualizza la restituzione del messaggio sotto la pagina Visualizza risposta.
Operazioni successive
Le richieste eseguite correttamente vengono registrate e aggiunte all'elenco
Cronologia richieste. Se si sta utilizzando
IBM Rational Performance Tester o
IBM Rational Service Tester for SOA Quality,
è possibile creare un test di servizio facendo clic sul pulsante
Genera gruppo di programmi test
(
).