Esta seção descreve como criar uma nova definição de mensagem a partir de um Esquema XML 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 considerar os pontos
listados abaixo:
- Para criar um novo arquivo de definição de mensagem a partir de
um esquema XML, o arquivo de esquema já deve estar presente no workbench, por exemplo, no projeto do
conjunto de mensagens. Isso permite que você selecione o arquivo de
esquema no assistente de Novo Arquivo de
Definição de Mensagem.
- 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 essa razão, você deve incluir a camada física no conjunto de mensagens antes de importar o esquema.
Isso irá assegurar que 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 Esquema XML deve ser .xsd
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
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 workbench. Como alternativa, abra o assistente clicando com o botão direito do mouse em um arquivo *.xsd já 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
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.
Eles 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órios 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 mostradas na lista de tarefas do workbench
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.
Abaixo estão alguns
exemplos de situações em que essas 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 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 do mouse nas mensagens de erro e
selecionar Correção Rápida, poderá optar por converter as construções xsd:redefine
em construções xsd:include. Isto também remove as mensagens de erro.
- 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 arquivos importados, surgirão mensagens
na lista de tarefas para indicar que os tipos referenciados ou outros
objetos não podem ser encontrados. Se isso ocorrer, consulte Resolvendo Problemas ao Desenvolver Modelos de Mensagens para obter informações adicionais.