Esta seção descreve como criar uma nova definição de mensagem a partir do WSDL
utilizando o assistente de Arquivo de Nova Definição de Mensagem no workbench.
Antes de começar:
Para concluir esta tarefa, você deve ter concluído as tarefas a seguir:
Antes de iniciar esta tarefa, é necessário notar os seguintes pontos:
- Para assegurar a mais alta interoperabilidade de seus serviços da Web, é recomendável:
- Utilizar o estilo de documento de WSDL sempre que possível
- Quando a utilização de WSDL estilo rpc é necessária, utilize codificação literal
- Quando a utilização de estilo rpc com codificação SOAP for necessária, assegure que as definições de operação WSDL sejam qualificadas por um atributo de espaço de nomes válido
- Opcionalmente, as definições WSDL podem ser divididas em vários arquivos. A organização típica
é que um arquivo de definição de serviço de nível superior importe um
arquivo de ligação, o arquivo de ligação importe um arquivo de definição de mensagem e este, finalmente,
importe ou inclua arquivos de definição de esquema.
- Ao criar um arquivo de nova definição de mensagem a partir de um arquivo WSDL, o arquivo WSDL
já deve estar presente em seu projeto do conjunto de mensagens. Se o WSDL estiver
dividido em vários arquivos conforme descrito acima, será possível importar o arquivo de definição de serviço
de nível superior ou o arquivo de ligação. Neste caso, o arquivo importado e os arquivos
aos quais ele se refere utilizando um local relativo deverão estar no espaço de trabalho
antes da execução da importação de WSDL.
- Quando estiver importando dois ou mais arquivos WSDL que compartilham definições de esquema
comuns, é recomendável importá-los em projetos do conjunto de mensagens separados
para evitar a possibilidade de conflitos de nomes.
- É necessário incluir uma camada do formato de ligação XML e ativar o suporte a espaço de nomes para o conjunto de mensagens no qual está sendo incluído o novo arquivo de definição de mensagem. Para aprimorar
a interoperabilidade de serviços da Web, é recomendável evitar customização desnecessária
da camada do formato de ligação XML para mensagens que participam
de processos de serviços da Web.
Importante: Observe que a extensão para o arquivo deve ser .wsdl
em minúsculas.
As etapas a seguir abrangem a criação de um arquivo de
definição de mensagem totalmente novo e o processo de sobrescrever o
conteúdo de um arquivo existente.
Para criar uma definição de mensagem
a partir de um arquivo ou arquivos WSDL:
- Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
- Abra o assistente de Novo Arquivo
de Definição de Mensagem clicando em Arquivo > Novo >
Arquivo de Definição de Mensagem no menu workbench. Como alternativa, é possível
abrir o assistente clicando com o botão direito em um arquivo .wsdl
importado anteriormente para o workbench e clicando em Novo > Arquivo
de Definição de Mensagem no menu.
- Na lista de opções exibida, clique em Arquivo WSDL
para selecioná-lo e, em seguida, clique em Avançar.
- Percorra o restante do assistente preenchendo os detalhes
conforme necessário.
Nota: - Vários painéis e opções podem estar sujeitos às configurações feitas no assistente
e é possível que eles nem sempre apareçam.
- Alguns campos no assistente podem estar esmaecidos. Provavelmente, isto é devido
ao fato de o campo ter uma configuração obrigatória ou não ser utilizado
devido a outras configurações já feitas.
Quando tiver concluído a importação de WSDL utilizando o assistente:
- Verifique com atenção se existem erros no relatório criado durante
a importação do arquivo. Esse relatório
pode ser encontrado no diretório registro
dentro do projeto que contém a definição de mensagem que você tentou
criar. O relatório tem um descritor de arquivo .wsdl.report.txt,
prefixado com o nome especificado para o novo arquivo de definição de mensagem.
- Reveja as mensagens mostradas na lista de tarefas do workbench
para verificar se apareceram novos avisos ou erros.
Nota: As definições de mensagens de Envelope SOAP e codificação SOAP requeridas
são automaticamente incluídas no conjunto de mensagens durante a importação. Se necessário,
você também pode importá-las manualmente por meio do assistente do Arquivo de Nova Definição de Mensagem,
selecionando a nova opção Mensagem Fornecida pela IBM.