Importando documentos XML personalizados

Documentos XML personalizados podem ser transformados no aplicativo por meio do uso de listas de códigos. Para permitir a implementação do processamento de documentos XML personalizados, estas listas de códigos estão disponíveis na área Dados principais do aplicativo:

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs

Pré-requisitos

Estas são as etapas de pré-requisitos antes de configurar esta funcionalidade:

  • Criar uma folha de estilo personalizada com um documento XML associado.
  • Determinar os valores desejados para o parceiro comercial, se ele não for um parceiro comercial padrão.

Configuração

Estes são os requisitos de configuração na área Dados principais:

  • Criar um código para a lista de códigos CustomTradingPartner utilizada no processo.
  • Criar um código para a lista de códigos CustomMessageTypes utilizada no processo. Este valor é usado para caixas suspensas para a seleção de tipos de mensagens padrão. Na tabela Propriedades da lista de códigos, crie um código com o identificador que corresponda ao tipo de documento definido no documento XML personalizado.
  • Crie um código para a lista de códigos CustomMessageFormats utilizada no processo. Este código é usado para determinar o tipo do documento XML.
    Nota

    O processo percorre todos os formatos de mensagem personalizados para encontrar um tipo de documento. Ele usa o primeiro formato de mensagem personalizado onde um valor é encontrado no elemento especificado.

    • Na caixa de diálogo Gerenciar propriedades de códigos, você deve definir um valor único no campo Identificador.
    • Defina o campo Elemento do tipo de mensagem na guia Valores 1 para o elemento no documento XML personalizado que determina o tipo de documento XML. Apenas a primeira instância desse elemento é utilizada no processo. Os elementos XML são suportados; entretanto, os atributos não são suportados.
  • Crie um código para a lista de códigos CustomMessageIDs utilizada no processo. Este código é usado para determinar o remetente e o destinatário do documento XML.
    • Especifique um identificador que corresponda ao código CustomMessageTypes criado.
    • Na guia Valores 1, você deve especificar pelo menos o ID do remetente posição 1 e o ID do ID do destinatário posição 1. Estes valores são elementos XML. O processo começa no local da primeira instância da Posição 1. Se a Posição 2 for especificada, ela continua na Posição 2. Se a Posição 3 for especificada, ela continua na Posição 3. Quando uma posição é especificada, ela deve existir no documento; caso contrário, o processamento não pode ser bem sucedido.
      Nota

      A primeira posição não é necessária para ser o elemento do documento.

  • Crie um código para a lista de códigos CustomStyleSheetRules utilizada no processo. Esse código é utilizado para determinar a folha de estilo utilizada para transformar o documento XML personalizado.
    • Na caixa de diálogo Gerenciar propriedades de códigos, especifique um identificador que é utilizado durante o processamento e mostrado em consultas e listas suspensas. Esse valor normalmente é o nome do arquivo da folha de estilo sem extensão de arquivo.
    • Na guia Valores 1, especifique estes valores de campo:
      • Especifique o nome do arquivo no campo Nome do arquivo de folha de estilo utilizado para a transformação. O nome do arquivo deve incluir a extensão do arquivo.
      • No campo Descrição do arquivo de formato de origem, especifique *nenhuma.
      • No campo Descrição do arquivo de formato de destino, especifique *nenhuma.
      • No campo Padrão de mensagem, selecione XML.

Configuração do Transformation

Estas são as etapas para a configuração do ID de parceiro:

  1. Selecione Transformation > Configuração > IDs de parceiro.
  2. Clique em Criar
  3. Na página ID de parceiro, selecione o tipo de mensagem personalizada na lista suspensa Tipo de mensagem.
  4. Selecione o parceiro comercial na lista suspensa Parceiro comercial.
  5. Na seção IDs de remetente/destinatário, especifique um ID de remetente e um ID de destinatário nos campos correspondentes.
  6. Na seção Mapeamento de parceiro interno/externo, especifique os valores nos campos de mapeamento.

Estas são as etapas para a configuração da regra de transformação:

  1. Selecione Transformation > Configuração > Regras de transformação.
  2. Clique em Criar para criar a regra de transformação.
  3. Na página Regras de transformação, selecione o parceiro comercial personalizado, tipo de mensagem personalizada e regra de folha de estilo personalizada dos campos correspondentes.

Estas são as etapas para a criação da folha de estilo personalizada:

  1. Selecione Transformation > Configuração > Folhas de estilo.
  2. Clique em Criar para criar o registro da folha de estilo personalizado.
  3. Na página Folhas de estilo, use o parceiro comercial personalizado e o nome da folha de estilo, incluindo a extensão do arquivo que foi criado para a regra da folha de estilo personalizada.

Processando documentos XML personalizados

Estas são as etapas para o processamento de documentos XML personalizados:

  1. Selecione Transformation > Importar mensagens para importar o documento XML. Ou, se a Configuração de cliente local foi implementada na área de Comunicações, importe o documento XML pelo Exchange Services.
    Nota

    Neste momento, o Conector do ION não é suportado.

  2. Selecione Transformation > Gerenciar mensagens.
  3. Na página Gerenciar mensagens, verifique os resultados. Corrija quaisquer valores necessários para o processamento.