As definições WSDL podem ser importadas utilizando o comando
(mqsicreatemsgdefsfromwsdl).
Antes de começar:
Antes de tentar esta tarefa, leia as seguintes informações:
O importador da linha de comandos WSDL permite criar
um novo conjunto de mensagens ativado por espaço de nomes no qual os arquivos de
definição de mensagem serão colocados. Ele também permite incluir arquivos de definição
de mensagem em um conjunto de mensagens existente que é ativado por espaço de nomes.
Se você estiver incluindo novos arquivos de definição de mensagem em um
conjunto de mensagens existente, o conjunto de mensagens deve ter uma camada de
formato físico XML. Para melhor a interoperabilidade de serviços da Web, evite customização desnecessária da camada de formato físico XML para mensagens que participem de processos de serviços da Web.
Quando você cria um novo conjunto de
mensagens a partir da linha de comandos, por padrão, somente as
informações lógicas são criadas. Se você precisar de formatos físicos no conjunto de mensagens,
terá duas opções:
- Crie um novo conjunto de mensagens baseado em um conjunto de mensagens existente. As informações de formato físico do conjunto de mensagens
base também são criadas no novo conjunto de mensagens.
- Utilize o WebSphere Message Broker
Toolkit para criar ou abrir
o conjunto de mensagens e incluir diretamente os formatos físicos no conjunto de mensagens antes
de importar as definições WSDL para ele.
Antes de iniciar a
importação, o comando mqsicreatemsgdefsfromwsdl copia os arquivos
WSDL necessários para o espaço de trabalho. Eles são o arquivo WSDL de nível superior e
quaisquer arquivos adicionais que possam ter sido importados por ele. Os arquivos
são copiados no conjunto de mensagens especificado em uma pasta chamada
importFiles e são removidos depois que a importação é concluída.
Isso permite que
você os atualize e execute neles a validação, no
WebSphere Message Broker
Toolkit posteriormente.
Para importar definições WSDL utilizando a linha de comandos:
- Feche o WebSphere Message Broker
Toolkit. O WebSphere Message Broker
Toolkit não deve estar em execução quando você utilizar o importador
da linha de comandos.
- Chame o comando mqsicreatemsgdefsfromwsdl a partir de um prompt de comandos;
você deve especificar o nome do projeto do conjunto de mensagens, o nome do caminho do
diretório no qual o arquivo WSDL de nível superior está localizado, o nome desse
arquivo, o local do espaço de trabalho e qualquer outro parâmetro opcional que você
precisar. Se desejar incluir
formatos físicos no novo conjunto de mensagens criado pelo comando mqsicreatemsgdefsfromwsdl,
especifique o conjunto de mensagens base que contém estes formatos físicos,
como o parâmetro -base na linha
de comandos de importação.
- Quando o comando for concluído, verifique o arquivo de log. O nome do arquivo
de log é o nome que você especificou no comando e possui a extensão de arquivo
*.wsdl.report.txt. Esse relatório é criado quando você chamar o comando mqsicreatemsgdefsfromwsdl
e, por padrão, é gravado no diretório a partir do qual o comando foi chamado. O relatório fornece as seguintes informações:
- Detalhes dos parâmetros utilizados quando o
mqsicreatemsgdefsfromwsdl
foi chamado.
- O nome do arquivo que foi importado.
- Detalhes do processo de importação (por exemplo, avisos
que foram gerados e objetos de modelo de mensagem que foram criados).
- Inicie o WebSphere Message Broker
Toolkit e alterne para a Perspectiva do Desenvolvimento de Aplicativos do Intermediário. O arquivo de definição de mensagem criado pelo comando
mqsicreatemsgdefsfromwsdl é visível no projeto que você especificou.
Se ocorrer um erro durante a importação de uma definição
WSDL, verifique cuidadosamente quaisquer erros que forem relatados.
Por padrão,
todos os erros são gravados na tela e no arquivo descrito acima. Para coletar informações adicionais sobre a importação,
especifique o parâmetro da linha de comandos
-v (Verboso).
Esse parâmetro exibe
informações mais detalhadas conforme o andamento da importação.