Page History

Estamos em processo de migrar todas as nossas mensagens padronizadas para o formato JSON. Consequentemente, também estamos adaptando os EAIs que as utilizam.Durante esse período de transição, faz-se necessária a existência de uma camada de conversão automática.

O conversor recebe uma mensagem em XML e a retorna na nova estrutura definida em JSON, e vice-versa. Estão disponibilizados dois métodos públicos estáticos na classe Conversor: 

• ConvertXMLToJSON
• ConvertJSONToXML

Importando o Conversor

• Importar a DLL do conversor (StandardMessageConversor.dll). 
          Trata-se de uma DLL desenvolvida em .Net CORE, e portanto pode ser importada em qualquer programa que tenha suporte para tal. 
• Importar a DLL do Newtonsoft          
           Para projetos em ADVPL, precisa ser utilizada a versão 9.0.1. Para projetos em .NET, qualquer versão acima dessa pode ser utilizada.

Convertendo de XML para JSON 

  string generatedMsg = Conversor.ConvertXMLToJSON(message);

    /// <summary>
    /// Recebe uma mensagem padronizada em XML e a retorna em JSON
    /// </summary>
    /// <param name="message">Mensagem no formato XML</param>
    /// <returns>Mensagem padronizada no formato JSON</returns>
    public static string ConvertXMLToJSON(string message);

Convertendo de JSON para XML

  string generatedMsg = Conversor.ConvertJSONToXML(message, "upsert");

     /// <summary>
    /// Recebe uma mensagem padronizada em JSON e a retorna em XML
    /// </summary>
    /// <param name="message"> Mensagem no formato JSON</param>
    /// <param name="restVerb"> Verbo em que a mensagem foi recebida pela API Rest. Exemplos: "upsert", "delete". 
    /// O valor colocado nessa variavel será apresentado no elemento Event de BusinessEvent
    /// </param>
    /// <returns>Mensagem padronizada no formato XML</returns>
    public static string ConvertJSONToXML(string message, string restVerb);

Transações suportadas

Abaixo encontram-se as transações que estão sendo suportadas pelo conversor.