Importar documentos XML personalizados

Os documentos XML personalizados podem ser transformados na aplicação através da utilização 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 de Dados principais da aplicação:

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs

Pré-requisitos

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

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

Configuração

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

  • Crie um código para a lista de códigos CustomTradingPartner que é utilizada no processo.
  • Crie um código para a lista de códigos CustomMessageTypes que é utilizada no processo. Este valor é utilizado para caixas pendentes 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 que é utilizada no processo. Este código é utilizado para determinar o tipo de documento XML.
    Nota

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

    • Na caixa de diálogo Gerir propriedades de códigos, deve definir um valor único no campo Identificador.
    • Defina o campo Elemento de tipo de mensagem no separador Valores 1 para o elemento no documento XML personalizado que determina o tipo de documento XML. Apenas a primeira instância deste elemento é utilizada no processo. Os elementos XML são suportados; no entanto, os atributos não são suportados.
  • Crie um código para a lista de códigos CustomMessageIDs que é utilizada no processo. Este código é utilizado para determinar o remetente e o destinatário do documento XML.
    • Especifique um identificador que corresponda ao código CustomMessageTypes criado.
    • No separador Valores 1, deve especificar, no mínimo, a Posição 1 da ID do remetente e a Posição 1 da ID do destinatário. 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, prossegue para a Posição 2. Se a Posição 3 for especificada, prossegue para a Posição 3. Quando uma posição é especificada, deve existir no documento; caso contrário, o processamento não pode ser bem-sucedido.
      Nota

      Não é necessário que a primeira posição seja o elemento de documento.

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

Configuração da transformação

Estas são as etapas para configurar a ID do parceiro:

  1. Selecione Transformação > Configuração > ID de parceiros.
  2. Clique em Criar.
  3. Na página ID do parceiro, selecione o tipo de mensagem personalizada a partir da lista pendente Tipo de mensagem.
  4. Selecione o parceiro comercial na lista pendente Parceiro comercial.
  5. Na secção ID do remetente/destinatário, especifique uma ID do remetente e uma ID do destinatário nos respetivos campos.
  6. Na secção de Mapeamento de parceiro interno/externo, especifique os valores nos campos de mapeamento.

Estes são os passos para a criação da regra de transformação:

  1. Selecione Transformação > 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 a partir dos campos correspondentes.

Estes são os passos para a criação da folha de estilo personalizada:

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

Processar documentos XML personalizados

Estes são os passos para o processamento de documentos XML personalizados:

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

    Neste momento, o ION Connector não é suportado.

  2. Selecione Transformação > Gerir mensagens.
  3. Na página Gerir Mensagens, verifique os resultados. Corrija quaisquer valores necessários para o processamento.