Compatibilidad con la codificación de caracteres no Unicode en Logic Apps

Cuando se trabaja con cargas de texto, Azure Logic Apps deduce que el texto se codifica en un formato Unicode, como UTF-8. Es posible que tenga problemas para recibir, enviar o procesar caracteres con codificaciones diferentes en el flujo de trabajo. Por ejemplo, podría obtener caracteres dañados en archivos planos al trabajar con sistemas heredados que no admiten Unicode.

Para trabajar con texto que tenga otra codificación de caracteres, aplique la codificación base64 a la carga no Unicode. Este paso evita que Logic Apps dé por supuesto que el texto está en formato UTF-8. A continuación, puede convertir cualquier codificación compatible con .NET a UTF-8 mediante Azure Functions.

Esta solución funciona con flujos de trabajo multiinquilino y de un solo inquilino. También puede utilizar esta solución con el conector AS2.

Conversión de la codificación de carga

En primer lugar, compruebe que el desencadenador puede identificar correctamente el tipo de contenido. Este paso garantiza que Logic Apps ya no dé por supuesto que el texto es UTF-8.

Para los desencadenadores con el valor Inferir tipo de contenido, elija No. Si el desencadenador no tiene esta opción, el tipo de contenido se establece mediante el mensaje entrante.

Si usa el desencadenador de solicitud HTTP para el contenido text/plain, debe establecer el parámetro charset en el encabezado Content-Type de la llamada. Los caracteres pueden dañarse si no establece el parámetro charset o si el parámetro no coincide con el formato de codificación de la carga. Para obtener más información, vea cómo controlar el tipo de contenido text/plain.

Por ejemplo, el desencadenador HTTP convierte el contenido entrante en UTF-8 cuando el encabezado Content-Type se establece con el parámetro charset correcto:

{
    "headers": {
        <...>
        "Content-Type": "text/plain; charset=windows-1250"
        },
        "body": "non UTF-8 text content"
}

Si establece el encabezado Content-Type en application/octet-stream, también podría recibir caracteres que no sean UTF-8. Para obtener más información, vea cómo controlar el tipo de contenido application/octet-stream.

Contenido de codificación Base64

Antes de codificar contenido en base64, asegúrese de que ha convertido el texto a UTF-8. Si descodifica el contenido en base64 en una cadena antes de convertir el texto a UTF-8, los caracteres podrían devolverse dañados.

A continuación, convierta cualquier codificación compatible con .NET a otra codificación compatible con .NET. Revise el ejemplo de código de Azure Functions o el ejemplo de código de .NET:

Sugerencia

En el caso de las aplicaciones lógicas de un solo inquilino, puede mejorar el rendimiento y reducir la latencia mediante la ejecución local de la función de conversión.

Versión de Azure Functions

Este ejemplo va dirigido a la versión 2 de Azure Functions:

using System;
using System.IO;
using System.Text;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Azure.WebJobs.Host;
using Newtonsoft.Json;

public static class ConversionFunctionv2 {
  [FunctionName("ConversionFunctionv2")]
  public static IActionResult Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, TraceWriter log) {
    log.Info("C# HTTP trigger function processing a request.");

    Encoding inputEncoding = null;

    string requestBody = new StreamReader(req.Body).ReadToEnd();
    dynamic data = JsonConvert.DeserializeObject(requestBody);

    if (data == null || data.text == null || data.encodingInput == null || data.encodingOutput == null) {
      return new BadRequestObjectResult("Please pass text/encodingOutput properties in the input JSON object.");
    }

    Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

    try {
      string encodingInput = data.encodingInput.Value;
      inputEncoding = Encoding.GetEncoding(name: encodingInput);
    } catch (ArgumentException) {
      return new BadRequestObjectResult($"Input character set value '{data.encodingInput.Value}' is not supported. Supported values are listed at https://msdn.microsoft.com/en-us/library/system.text.encoding(v=vs.110).aspx.");
    }

    Encoding encodingOutput = null;
    try {
      string outputEncoding = data.encodingOutput.Value;
      encodingOutput = Encoding.GetEncoding(outputEncoding);
    } catch (ArgumentException) {
      return new BadRequestObjectResult($"Output character set value '{data.encodingOutput.Value}' is not supported. Supported values are listed at https://msdn.microsoft.com/en-us/library/system.text.encoding(v=vs.110).aspx.");
    }

    return (ActionResult) new JsonResult(
      value: new {
        text = Convert.ToBase64String(
          Encoding.Convert(
            srcEncoding: inputEncoding,
            dstEncoding: encodingOutput,
            bytes: Convert.FromBase64String((string) data.text)))
      });
  }
}

Versión de .NET

El ejemplo siguiente se usa con .NET Standard y la versión 2 de Azure Functions:

    using System;
    using System.IO;
    using System.Text;
    using Microsoft.AspNetCore.Mvc;
    using Microsoft.Azure.WebJobs;
    using Microsoft.Azure.WebJobs.Extensions.Http;
    using Microsoft.AspNetCore.Http;
    using Microsoft.Azure.WebJobs.Host;
    using Newtonsoft.Json;

    public static class ConversionFunctionNET
    {
        [FunctionName("ConversionFunctionNET")]
        public static IActionResult Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)]HttpRequest req, TraceWriter log)
        {
            log.Info("C# HTTP trigger function processing a request.");

            Encoding inputEncoding = null;

            string requestBody = new StreamReader(req.Body).ReadToEnd();
            dynamic data = JsonConvert.DeserializeObject(requestBody);

            if (data == null || data.text == null || data.encodingInput == null || data.encodingOutput == null)
            {
                return new BadRequestObjectResult("Please pass text/encodingOutput properties in the input JSON object.");
            }

            Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

            try
            {
                string encodingInput = data.encodingInput.Value;
                inputEncoding = Encoding.GetEncoding(name: encodingInput);
            }
            catch (ArgumentException)
            {
                return new BadRequestObjectResult($"Input character set value '{data.encodingInput.Value}' is not supported. Supported values are listed at https://msdn.microsoft.com/en-us/library/system.text.encoding(v=vs.110).aspx.");
            }

            Encoding encodingOutput = null;
            try
            {
                string outputEncoding = data.encodingOutput.Value;
                encodingOutput = Encoding.GetEncoding(outputEncoding);
            }
            catch (ArgumentException)
            {
                return new BadRequestObjectResult($"Output character set value '{data.encodingOutput.Value}' is not supported. Supported values are listed at https://msdn.microsoft.com/en-us/library/system.text.encoding(v=vs.110).aspx.");
            }

            return (ActionResult)new JsonResult(
                value: new
                {
                    text = Convert.ToBase64String(
                        Encoding.Convert(
                            srcEncoding: inputEncoding,
                            dstEncoding: encodingOutput,
                            bytes: Convert.FromBase64String((string)data.text)))
                });
        }
    }

Con estos mismos conceptos, también puede enviar una carga no Unicode desde el flujo de trabajo.

Conversiones de carga de ejemplo

En este ejemplo, la cadena de entrada de ejemplo codificada en base64 es un nombre personal, Héloïse, que contiene caracteres acentuados.

Entrada de ejemplo:

{  
    "text": "SMOpbG/Dr3Nl",
    "encodingInput": "utf-8",
    "encodingOutput": "windows-1252"
}

Salida de ejemplo:

{
    "text": "U01PcGJHL0RyM05s"
}

Envío de una carga no Unicode

Si necesita enviar una carga no Unicode desde el flujo de trabajo, siga los pasos para convertir la carga a UTF-8 en orden inverso. Mantenga el texto en UTF-8 tanto como sea posible dentro del sistema. A continuación, use la misma función para convertir los caracteres UTF-8 codificados en base64 a la codificación necesaria. Después, aplique la codificación en base 64 al texto y envíe la carga útil.

Conversión de cargas para AS2

También puede usar esta solución con cargas no Unicode en el conector AS2 v2. Si no convierte las cargas que pasa a AS2 a UTF-8, puede experimentar problemas con la interpretación de la carga. Estos problemas pueden dar lugar a una discrepancia con el hash MIC entre los asociados debido a caracteres mal interpretados.

Pasos siguientes