Atualizando um Esquema XML Alterado

Se tiver criado um projeto que usa um Esquema XML e o Esquema XML for alterado, será possível tentar atualizar o Esquema XML existente com o novo Esquema XML.

Sobre Esta Tarefa

A atualização em um novo Esquema XML significa que qualquer uma das entidades do projeto que fazem interface com o Esquema XML pode ser afetada pela mudança. As seguintes entidades do projeto podem ser afetadas pela mudança do Esquema XML:
  • Mapas que fazem referência ao Esquema XML, mapas independentes e os mapas sequenciais nas atividades.
  • Variáveis que fazem referência ao Esquema XML.
  • Expressões XPath nas orquestrações.
  • Expressões XPath usadas nas chaves de tarefa.
  • Algumas configurações de Terminal.
  • Condições definidas nas orquestrações.
Durante o processo de atualização, o Studio relata quais entidades do projeto são afetadas pela mudança antes que ela seja confirmada.

Por exemplo, um Esquema XML define um parâmetro de entrada para a atividade Mapear Variáveis. Na área de janela Da Orquestração da atividade Mapear Variáveis, há links entre os nós do parâmetro de entrada para os nós dos parâmetros de saída. Quando o Esquema XML que define o parâmetro de entrada é atualizado no novo Esquema XML, esses links poderão não ser mais válidos se os nós de entrada tiverem sido renomeados ou removidos no novo Esquema XML. Você deve recriar os links para que a orquestração seja válida novamente.

Em alguns casos, o Studio evita completamente o upload de um novo Esquema XML pelas seguintes razões:
  • O novo Esquema XML é inválido.
  • O upload do novo Esquema XML para substituir o existente resultaria em um projeto inválido.
Nota: A atualização de um Esquema XML existente (conforme descrito no procedimento abaixo) é diferente do carregamento de diversos Esquemas XML para um projeto arrastando um arquivo para a guia Projeto ou clicando com o botão direito do mouse na pasta Esquemas XML na guia Projeto e selecionando Incluir Documento. A atualização de um Esquema XML existente substitui o Esquema XML existente no projeto enquanto que o upload do mesmo arquivo na guia Projeto cria duas instâncias do Esquema XML no projeto.

Procedimento

  1. Abra o Esquema XML já usado no projeto que deverá ser substituído pelo novo Esquema XML. Abra a representação gráfica ou a visualização de origem do Esquema XML:
    • Representação Gráfica: Abra a guia Projeto e dê um clique duplo no Esquema XML no diretório Esquemas XML. Os nós do Esquema XML são exibidos na guia Esquema XML. Na guia Esquema XML, clique em qualquer nó do Esquema XML.
    • Visualização de Origem: Abra a guia Projeto e dê um clique duplo no Esquema XML no diretório Esquemas XML. Os nós do Esquema XML são exibidos na guia Esquema XML. Clique com o botão direito do mouse na guia e selecione a opção Visualizar Origem no menu. Na guia Esquema XML, clique em qualquer linha do Esquema XML.
  2. Selecione um novo Esquema XML para substituir o Esquema XML existente, usando uma das seguintes opções:
    • Se a Representação Gráfica do Esquema XML for aberta, será possível arrastar um arquivo de Esquema XML do sistema de arquivos local para o Esquema XML aberto na guia Esquema XML.
    • Selecione a opção Arquivo > Atualizar no menu da barra de ferramentas do Studio. A caixa de diálogo Atualizar o Documento de Esquema Atual é exibida. No campo Local, especifique o local do novo Esquema XML a partir de um local da Web externo ou do sistema de arquivos.
  3. Clique em OK. A caixa de diálogo A Atualização do Esquema XML Afeta as Entidades do Projeto Dependentes Listadas é exibida e quaisquer entidades do projeto possivelmente afetadas pela substituição do Esquema XML original pelo novo Esquema XML são listadas.
  4. Opcional: Na caixa de diálogo, clique em qualquer uma das entidades dependentes listadas para visualizar a entidade afetada no Studio.
  5. Clique em Atualizar. O Studio tenta atualizar o projeto com o novo Esquema XML e o resultado da atualização tentada depende das seguintes condições:
    • Se qualquer uma das mudanças no Esquema XML resultar em um projeto corrompido após a atualização ou o novo Esquema XML for inválido, uma caixa de diálogo Erro será exibida descrevendo o problema com o Esquema XML. Clique em OK. A atualização é cancelada, o Esquema XML é revertido para o Esquema XML original e o projeto não é alterado.
    • Se as mudanças no Esquema XML não resultarem em um projeto corrompido e o Esquema XML for válido, a atualização ocorrerá e o Esquema XML original será substituído pelo novo Esquema XML. Algumas das entidades do projeto podem ficar inválidas após a atualização e podem precisar de limpeza. Por exemplo, links nas áreas de janela Mapear Entradas e Mapear Saídas podem precisar ser recriados após a atualização. Para localizar os erros de validação, abra uma orquestração e selecione Orquestração > Validar no menu da barra de ferramentas do Studio.
  6. Clique em Fechar.