Você pode utilizar o assistente de Novo Arquivo de Definição de Mensagem no WebSphere Message Broker Toolkit para criar uma nova definição de mensagem de um Esquema XML
Antes de Iniciar você deve concluir as seguintes tarefas:
Antes de começar esta tarefa, você deve estar ciente dos seguintes pontos:
- Se estiver importando uma coleta de arquivos de Esquema XML relacionados,
você será avisado para usar o comando mqsicreatemsgdefs.
Isto importa todos os arquivos de Esquema XML em uma única operação e ajusta
automaticamente os caminhos de importação e inclusão.
- Se o conjunto de mensagens no qual você está incluindo o novo
arquivo de definição de mensagem tiver uma camada de formato de ligação
XML, mas não tiver suporte a espaço
de nomes, o esquema importado é modificado para remover os espaços de
nomes. Por essa razão, você deve ativar o suporte ao espaço de nomes antes de importar um esquema.
- Se o conjunto de mensagens no qual você está incluindo o novo arquivo de
definição de mensagem não tiver uma camada de formato de ligação XML,
mas tiver suporte a espaço de nomes, somente as
informações lógicas aparecerão no modelo.
Por esta razão, você deve incluir a camada física no conjunto de mensagens antes de importar o esquema. Isso irá assegurar que o conjunto de mensagens esteja preenchida com as configurações e valores do esquema. O Esquema XML não é modificado para remover os espaços de nomes.
- Se o conjunto de mensagens no qual você está incluindo o novo
arquivo de definição de mensagem não
tiver uma camada de formato de ligação XML e não tiver suporte a espaço de nomes,
somente as informações lógicas aparecerão no modelo e o esquema
importado será modificado para remover os espaços de nomes.
- Se estiver trabalhando com um conjunto de mensagens que não tenha
suporte a espaço de nomes, você deve especificar as preferências que
se aplicam ao importar um esquema para o conjunto de mensagens. Essas preferências permitem especificar como o
importador trata determinadas construções de esquemas individuais. Você pode
rejeitar o esquema se forem encontradas quaisquer ocorrências da construção
ou modificar essas ocorrências. Se escolher modificar, o importador
modifica todas as ocorrências da construção.
- A extensão para o arquivo de Esquema XML deve ser .xsd em minúsculas.
As seguintes etapas criam um srquivo de definição de mensagem completamento novo ou sobrescreve o conteúdo de um arquivo existente.
Para criar uma definição de mensagem a partir de um arquivo
de Esquema XML:
- 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 WebSphere Message Broker Toolkit. Como alternativa, você pode abrir o assistente clicando com o botão direito em um arquivo *.xsd previamente importado para o WebSphere Message Broker
Toolkit e clicando em New> Arquivo de Definição de Mensagem no menu.
- Na lista de opções exibida, clique em arquivo de Esquema XML para selecioná-lo e clique em Avançar.
- Percorra o restante do assistente preenchendo os detalhes
conforme necessário. O tempo de processamento para a importação do Esquema XML variará conforme o tamanho e complexidade desse esquema. Em um esquema grande e complexo, pode levar mais tempo para importar o arquivo, gerar o arquivo de registro e exibir quaisquer avisos ou erros da lista de tarefas.
Quando tiver concluído a importação do Esquema XML utilizando o assistente:
- Verifique cuidadosamente o arquivo de registro para verificar a ocorrência de avisos ou erros no relatório criado quando o arquivo é importado. Estes avisos fornecem informações sobre se o esquema falhou na importação ou precisou ser modificado para que fosse importado com êxito.
Esse relatório pode ser encontrado na estrutura de diretório log dentro do projeto que contém a definição de
mensagem que você tentou criar. O relatório possui uma extensão de arquivo .xsd.report.txt,
prefixada com o nome especificado para o arquivo de nova definição de mensagem.
- Reveja as mensagens que são mostradas na lista de tarefas WebSphere Message Broker Toolkit para verificar se apareceram novos avisos
ou erros. Apesar de você poder ter importado um esquema perfeitamente válido, a lista de tarefas exibirá quaisquer avisos ou erros que existirem no arquivo de definição de mensagem. As situações a seguir são exemplos de onde as mensagens aparecem:
- Se o Esquema XML que você está importando contiver as construções
xsd:key, xsd:keyref e xsd:unique, aparecerão mensagens de aviso
indicando que essas construções não são suportadas e serão ignoradas
pelo intermediário. Se preferir excluir essas construções, abra o arquivo de definição de mensagem no editor de Definição de Mensagem e exclua as construções, conforme descrito em Conjuntos de Mensagens: Excluindo Objetos.
A
exclusão das construções também remove as mensagens de aviso da lista
de tarefas. Se decidir não excluir as construções, elas permanecerão
no modelo de mensagem mas não serão implementadas pelo
intermediário nem serão utilizadas para qualquer outra finalidade. As
mensagens de aviso permanecerão na lista de tarefas, mas você poderá
utilizar o modelo de mensagem normalmente.
- Se o Esquema XML que está sendo importado contiver
construções xsd:redefine, aparecerão mensagens de erro na lista de tarefas para informar
que esta construção não é suportada. Se você clicar com o botão direito nas mensagens de erro e
selecionar Correção Rápida, será possível optar por converter as construções xsd:redefine
em construções xsd:include. Isto também remove as mensagens de erro.
- Se o Esquema XML que está sendo importado contiver
construções xsd:attribute que contém ambos um valor fixo e um valor padrão, mensagens de erro aparecerão na lista de tarefas para dizer que esta construção não é suportada. Contudo, um esquema ainda é importad oe o valor fixo utilizado, não o valor padrão. As mensagens de erro podem ser ignoradas.
- Se estiver importando uma coleção de arquivos de Esquema XML
relacionados e o Editor de Definição de Mensagem não for capaz de
resolver os links entre dois dos arquivos importados, aparecerão mensagens
na lista de tarefas para indicar que os tipos referidos ou outros
objetos não podem ser localizados. Se isso ocorre, consulte Resolvendo Problemas ao Desenvolver Modelos de Mensagens para obter informações adicionais.