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 interoperabilidade mais alta de seus serviços da Web, você deve:
- 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 disposição típica seria: um arquivo de definição de serviço de nível superior importa um arquivo de ligação, o arquivo de ligação importa um arquivo de interface e este, por fim, importa ou inclui 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 importar dois ou mais arquivos WSDL que compartilham definições de esquema comum, você deve importá-los para projetos de conjunto de mensagens separados para evitar a probabilidade de conflitos de nomes.
- Você deve incluir uma camada de formato físico XML e ativar o suporte a espaço de nomes para o conjunto de mensagens no qual está incluindo o novo arquivo de definição de mensagem.
Para aprimorar a interoperabilidade dos serviços da Web, você deve evitar customização desnecessária da camada do formato físico 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 para Novo Arquivo de Definição de Mensagem, clicando em Arquivo > Novo > Arquivo de Definição de Mensagem, no menu do workbench. Como alternativa, é possível abrir o assistente clicando com o botão direito do mouse no arquivo .wsdl anteriormente importado 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. Isso, provavelmente, deve-se ao campo ter uma configuração obrigatória, o campo ter somente um valor possível ou não ser utilizado devido a outras configurações que já foram 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-file-name>.wsdl.report.txt, em que <wsdl-file-name> é o nome da definição WSDL que está sendo importada.
- 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.