Antes de começar:
Para concluir esta tarefa, você deve ter concluído as tarefas a seguir:
Além disso, antes de iniciar esta tarefa, você deve observar
os seguintes pontos:
- Para criar um novo arquivo de definição de mensagens a partir de
um esquema XML, o arquivo de esquema já deve estar presente no , 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 Mensagens.
Para obter informações sobre como incluir arquivos no espaço de
trabalho, consulte Importando Sistemas de Arquivos no.
- 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. Portanto, é recomendável ativar o suporte a
espaço de nomes antes de importar um esquema. Para obter informações
adicionais sobre como ativar o suporte a espaço de nomes, consulte
Criando um Conjunto de Mensagem.
- 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. O esquema XML não é
modificado para remover os espaços de nomes. Você pode incluir a camada física ao conjunto de mensagens antes ou
depois de importar um esquema XML, mas é
recomendável que você adicione a camada
física antes da importação. Para
obter informações sobre como incluir um formato de ligação XML,
consulte Incluindo um Formato de Ligação XML.
- 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. Para obter informações
adicionais sobre como configurar essas preferências, consulte
Configurando Preferências de Conjuntos de Mensagens.
Observe que a extensão para o
arquivo deve ser .xsd em letras minúsculas. 
As etapas a seguir abrangem a criação de um arquivo de
definição de mensagens 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 .
- Abra o assistente de Novo Arquivo
de Definição de Mensagem clicando em Arquivo > Novo >
Arquivo de Definição de Mensagem no menu . Outra opção é abrir
o assistente clicando com o botão direito do mouse em um arquivo
*.xsd importado
anteriormente para o workbench e clicar em Novo > Arquivo
de Definição de Mensagens no menu.
- Na lista de opções exibida, clique em Arquivo
de Esquema XML para selecioná-lo e clique em
Avançar.
- Na lista de arquivos do workbench que será exibida, clique
no arquivo de esquema XML que você quer importar e, em seguida,
clique em Avançar. Se você tiver aberto o
assistente conforme descrito na etapa 3 acima, o arquivo
*.xsd no qual você clicou com o botão
direito já estará selecionado quando a próxima página aparecer.
- Na lista de conjuntos de mensagens mostrada em
Conjuntos de Mensagens, clique no conjunto de
mensagens de destino para o arquivo de definição de mensagens que
você está criando. O campo Nome do Arquivo de Definição de Mensagens será preenchido automaticamente com o nome do arquivo padrão, com base no nome do arquivo sendo importado.Se necessário,
você poderá alterar o nome de arquivo padrão exibido para um novo
nome de sua escolha.
- Opcional: Para substituir o conteúdo de um arquivo de definição
de mensagens existente:
- Digite o nome do arquivo existente no campo Nome do Arquivo de Definição de Mensagens.
- Selecione a caixa de opções Sobrescrever o
conteúdo do arquivo existente sem avisar. O
arquivo existente será sobrescrito sem que um aviso seja exibido.
- Clique em Avançar. Seu esquema XML será validado.
- Opcional: Na lista de elementos globais que será exibida,
selecione as caixas de opções dos elementos globais (com base nos tipos
complexos globais) a partir dos quais deseja criar mensagens. Utilize os botões Selecionar Tudo e
Cancelar Toda a Seleção para selecionar todos
os elementos globais da lista ou nenhum elemento global da lista.
Dica: Apenas os
elementos globais nos tipos complexos globais ficam visíveis. Nenhum
outro elemento global fica visível.
- Opcional: Se o conjunto de mensagens de destino do arquivo
de definição de mensagens que você está criando não tiver o suporte a
espaço de nomes ativado, é possível clicar em
Avançar. Com isso, será apresentada uma janela
que permite que você inclua espaços de nomes adicionais.
- Clique em Concluir. O arquivo de definição de mensagens é criado a partir do esquema XML
e é aberto no Editor de Definição de Mensagens.
- Ao concluir a importação do esquema XML utilizando o
assistente, verifique cuidadosamente eventuais erros no relatório que
é criado durante a importação do arquivo. Esse relatório
pode ser encontrado no diretório log
dentro do projeto que contém a definição de mensagens que você tentou
criar. O relatório tem uma extensão
*.xsd.report.txt, antecedida do nome
que você especificou para o novo arquivo de definição de mensagens.
Após importar os arquivos de esquema XML, reveja
as mensagens mostradas na lista de tarefas para verificar se apareceu
algum novo aviso ou erro. Abaixo estão listados 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
mensagens no Editor de Definição de Mensagens 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 estiver importando uma coleção de arquivos de esquema XML
relacionados e o Editor de Definição de Mensagens 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 Problemas ao Desenvolver Modelos de Mensagem para obter informações
adicionais.