Importando documentos XML e não XML personalizados

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

  • CustomMessageTypes
  • CustomMessageFormats
  • CustomMessageIDs
  • CustomBODsOutToIONDesk

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.
    • Para documentos XML, esse código é usado para determinar o tipo de documento.
      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.
    • Para documentos personalizados que não sejam XML, esse código é usado para identificar estas propriedades:
      • A mensagem começa com - Os seis primeiros caracteres para identificar a mensagem
      • Padrão de mensagem - O padrão de mensagem a ser associado à mensagem
      • Tipo de mensagem - O tipo de mensagem a ser associado à mensagem
  • Crie um código para a lista de códigos CustomMessageIDs utilizada no processo.
    • Para documentos XML, esse código é usado para determinar o remetente e o destinatário do documento.
      • 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.

    • Da mesma forma, para arquivos não XML, você pode criar um código para a lista de códigos CustomMessageTypes para determinar o remetente e o destinatário do arquivo.
      • Especifique um identificador que corresponda ao código CustomMessageTypes criado.
      • Na guia Valores 1, especifique os valores da posição 1 do remetente e do destinatário: Quando o processo é iniciado, a posição 1 verifica se o texto inserido na lista de códigos corresponde aos caracteres do início do arquivo não XML. Em seguida, usa a numeração iniciada em 1 para encontrar o índice inicial, que é a posição 2, e o índice final, que é a posição 3, para identificar o remetente ou o destinatário.
  • 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 personalizado.
    • Essa é a configuração obrigatória para documentos XML personalizados:
      • 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 de 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.
    • Essa é a configuração obrigatória para documentos não-XML personalizados:
      • 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 de arquivo de formato de origem, especifique o nome do arquivo de formato.
        • No campo Descrição do arquivo de formato de destino, especifique *nenhuma.
        • No campo Padrão de mensagem, selecione o padrão não XML apropriado na lista suspensa (por exemplo, selecione Valores separados por vírgula para arquivos de texto).
  • Crie uma lista de códigos CustomBODsOutToIONDesk que permite que BODs de saída personalizados sejam enviados do ION Connector para o ION Desk
    Nota

    Essa lista de códigos deve seguir o formato Verbo.Nome. Na caixa de diálogo Gerenciar propriedades de códigos, um exemplo de valor no campo Identificador é Processar PurchaseOrder, com uma descrição do BOD personalizado no campo Descrição.

Configuração de Transformação

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

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

Estas são as etapas 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 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 Transformação > Importar mensagens para importar o documento XML. Ou, se a Configuração de cliente local tiver sido implementada na área de Comunicações, importe o documento XML pelo Exchange Services.
    Nota

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

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