In questo argomento viene descritta la procedura di creazione di una nuova definizione dei messaggi da un WSDL utilizzando la procedura guidata Nuovo file di definizione dei messaggi del workbench.
Prima di iniziare:
Per completare tale attività, terminare le procedure riportate di seguito:
Prima di iniziare tale attività, prendere in considerazione i punti riportati di seguito.
- Per garantire la massima interoperabilità dei propri servizi Web, è necessario effettuare quanto segue.
- Utilizzare lo stile documento di WSDL quando è possibile.
- Quando è necessario il WSDL stile rpc, utilizzare la codifica letterale.
- Quando è necessario utilizzare lo stile rpc con codifica SOAP, accertarsi che le definizioni dell'operazione WSDL siano qualificate con un attributo spazio dei nomi valido.
- È possibile dividere le definizioni WSDL in più file (facoltativo). La configurazione tipica prevede che un file di definizione servizi principale importi un file di associazione, che tale file di associazione importi un file di interfaccia e che infine questo importi o includa file di definizione di schema.
- Quando si crea un nuovo file di definizione dei messaggi da un file WSDL, è necessario che il file WSDL sia già presente nel progetto della serie di messaggi. Se il WSDL è diviso in più file come riportato sopra, sarà possibile importare il file di definizione servizi principale o il file di associazione. In tal caso, è necessario che il file importato e i file a cui fa riferimento mediante un percorso apposito si trovino nell'area di lavoro prima di eseguire l'importazione WSDL.
- Quando vengono importati due o più file WSDL che condividono definizioni di schema comuni, evitare conflitti di nomi importandoli in progetti di serie di messaggi separati.
- Aggiungere un livello del formato fisico XML e abilitare il supporto per lo spazio dei nomi per la serie di messaggi alla quale si aggiunge il nuovo file di definizione dei messaggi.
Per migliorare l'interoperabilità dei servizi Web, evitare personalizzazioni non necessarie del livello del formato fisico XML per i messaggi che partecipano alle elaborazioni dei servizi Web.
Importante: è necessario che l'estensione del file sia .wsdl in minuscolo.
Nella procedura riportata di seguito sono trattate sia la creazione di un file di definizione dei messaggi completamente nuovo che la
sovrascrittura del contenuto di un file esistente.
Per creare una definizione dei messaggi da file WSDL, effettuare la procedura riportata di seguito:
- Passare alla Prospettiva Sviluppo dell'applicazione
broker.
- Aprire la procedura guidata Nuovo file di definizione dei messaggi
facendo clic su File > Nuovo > File di definizione dei messaggi nel
menu workbench. In alternativa,
è possibile aprire la procedura guidata facendo clic con il pulsante destro del mouse su un file .wsdl importato in precedenza nel workbench e facendo clic su Nuovo > File di definizione dei messaggi nel menu.
- Nell'elenco delle opzioni visualizzato fare clic su File WSDL per selezionarlo, quindi su Avanti.
- Completare la procedura guidata compilando i campi come richiesto.
Nota: - Alcuni pannelli e opzioni dipendono dalle impostazioni configurate nella procedura guidata ed è possibile che non vengano visualizzati.
- È possibile che alcuni campi nella procedura guidata non siano selezionabili. È possibile che ciò avvenga perché il campo è dotato di impostazioni obbligatorie ed è possibile specificare un solo valore oppure non viene utilizzato a causa delle configurazioni effettuate per altre impostazioni.
Al termine dell'importazione WSDL mediante la procedura guidata, effettuare quanto segue.
- Verificare che non siano presenti errori nel prospetto creato durante l'importazione del file. È possibile trovare tale prospetto nella directory
log all'interno del progetto che contiene la definizione del messaggio per la quale è stato effettuato il tentativo di
creazione. Il prospetto è dotato di un descrittore del file <wsdl-file-name>.wsdl.report.txt, dove <wsdl-file-name> è il nome della definizione WSDL che si sta importando.
- Esaminare i messaggi visualizzati nell'elenco delle attività del workbench
per verificare se sono state visualizzate nuove avvertenze o errori.
Nota: le definizioni dei messaggi di codifica SOAP ed envelope SOAP richieste sono aggiunte in modo automatico alla serie di messaggi durante
l'importazione. Se necessario, è inoltre possibile importarle in modo manuale mediante la procedura guidata Nuovo file di definizione dei messaggi, selezionando la nuova opzione Messaggio fornito da IBM.