Conversión de datos

base64()

La función base64 toma una cadena de texto (o contenido binario) y la convierte a su representación en Base64. Este formato es el estándar universal para transmitir datos binarios (como imágenes, PDFs o archivos) a través de sistemas que solo aceptan texto, como el cuerpo de un JSON en una API o un correo electrónico.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cadena de texto): El texto o contenido que deseas codificar.

Ejemplos prácticos

Ejemplo 1: Codificar un texto simple Útil para autenticaciones básicas (Basic Auth) donde el usuario y contraseña deben ir codificados.

• Expresión: base64(‘admin:password123’)
• Resultado: «YWRtaW46cGFzc3dvcmQxMjM=»

Ejemplo 2: Preparar una imagen para una API Si tienes el contenido de una imagen y necesitas enviarlo en un JSON.

• Expresión: base64(outputs(‘Obtener_contenido_de_archivo’)?[‘body’])
• Escenario: Transforma el archivo «crudo» en una cadena de texto que cualquier servidor puede leer sin corromperse.

Ejemplo 3: Generar un Data URI para HTML Si quieres mostrar una imagen directamente en un correo usando código HTML.

• Expresión: concat(‘data:image/png;base64,’, base64(variables(‘vContenidoImagen’)))

decodeBase64()

Toma una cadena de texto que ha sido codificada en formato Base64 y la devuelve a su estado original de texto legible (string). Es la función que usas para «leer» el contenido de archivos de texto, configuraciones o mensajes que viajan de forma segura entre sistemas.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cadena de texto): El texto en Base64 que quieres decodificar.

Ejemplos prácticos

Ejemplo 1: Recuperar credenciales de un Header Si recibes un token de autenticación básica y quieres ver qué usuario es.

• Expresión: base64ToString(‘YWRtaW46cGFzc3dvcmQxMjM=’)
• Resultado: «admin:password123»

Ejemplo 2: Leer el contenido de un archivo .txt Si obtienes el contenido de un archivo de SharePoint y viene codificado.

• Expresión: base64ToString(outputs(‘Obtener_archivo’)?[‘body’])
• Resultado: «Este es el contenido real del documento…»

Ejemplo 3: Procesar metadatos de una API

• Expresión: base64ToString(variables(‘vDataCodificada’))

string()

La función string toma cualquier valor (un número entero, un decimal, un valor booleano, un objeto JSON o incluso una matriz) y lo convierte en una cadena de texto. Es el traductor universal que permite que datos de diferentes naturalezas puedan convivir en un mismo mensaje o campo de texto.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cualquier tipo): El dato que deseas transformar a texto.

Ejemplos prácticos

Ejemplo 1: Concatenar números con texto Si intentas unir un texto con un número de ID directamente, el flujo podría fallar.

• Expresión: concat(‘El número de ticket es: ‘, string(variables(‘vID_Numerico’)))
• Resultado: «El número de ticket es: 5025»

Ejemplo 2: Convertir un Booleano (True/False) A veces necesitas escribir el resultado de una condición en un Excel.

• Expresión: string(greater(10, 5))
• Resultado: «true» (en lugar del valor lógico, obtienes la palabra como texto).

Ejemplo 3: «Ver» un objeto JSON completo Si quieres enviar por correo todo el cuerpo de una respuesta de una API para depurar (debug).

• Expresión: string(outputs(‘Petición_HTTP’)?[‘body’])
• Resultado: Una cadena de texto con todo el código JSON que antes era un objeto complejo.

int()

La función int (abreviatura de integer) toma una cadena de texto que contiene un número o un número decimal y lo convierte en un número entero. Si le pasas un decimal, la función simplemente «corta» la parte decimal (no redondea, trunca). Es esencial cuando extraes datos de un archivo CSV, Excel o un formulario donde los números suelen llegar disfrazados de texto.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cadena de texto o Decimal): El valor que deseas transformar en entero.

Ejemplos prácticos

Ejemplo 1: Convertir texto de un formulario a número Imagina que un usuario escribe «25» en un campo de cantidad. Para usarlo en un cálculo, necesitas convertirlo.

• Expresión: int(’25’)
• Resultado: 25 (ahora es un número real, no texto).

Ejemplo 2: Truncar un valor decimal Si tienes un cálculo que da decimales pero solo necesitas la parte entera para un ID o contador.

• Expresión: int(10.99)
• Resultado: 10 (Recuerda: no redondea a 11, simplemente quita los decimales).

Ejemplo 3: Usar IDs en comparaciones de «Mayor que» Si recibes un ID de una API como ‘100’ y quieres saber si es mayor a 50.

• Expresión: greater(int(variables(‘vID_Texto’)), 50)
• Resultado: true

float()

La función float (de floating point o punto flotante) toma una cadena de texto o un número entero y lo convierte en un número decimal. A diferencia de int(), esta función conserva todo lo que hay después del punto. Es vital cuando recibes precios de una tienda online, tasas de cambio o medidas de sensores que vienen en formato de texto.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cadena de texto o Entero): El valor que deseas transformar en decimal.

Ejemplos prácticos

Ejemplo 1: Procesar un precio desde un correo

Imagina que recibes un dato como «19.99» pero el flujo lo detecta como texto.

• Expresión: float(‘19.99’)
• Resultado: 19.99 (Ahora puedes multiplicarlo por una cantidad).

Ejemplo 2: Asegurar precisión en una división

Si divides dos enteros (ej. 5 / 2), Power Automate a veces puede darte un entero truncado (2). Al convertir uno a float, fuerzas el resultado decimal (2.5).

• Expresión: div(float(5), 2)
• Resultado: 2.5

Ejemplo 3: Convertir un entero para comparaciones

• Expresión: float(100)
• Resultado: 100.0

bool()

La función bool (abreviatura de boolean) toma un valor y lo convierte en un dato lógico: true (verdadero) o false (falso). Es esencial porque, para Power Automate, el texto "true" no es lo mismo que el valor lógico true. Esta función elimina esa ambigüedad, permitiéndote usar resultados de formularios, respuestas de APIs o flags de bases de datos directamente en tus ramas de decisión.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cadena de texto o Entero): El valor que deseas transformar.
   • Si es la cadena ‘true’ (no importa mayúsculas/minúsculas) o el número 1, devuelve true.
   • Si es la cadena 'false' o el número 0, devuelve false.

Ejemplos prácticos

Ejemplo 1: Convertir una respuesta de Microsoft Forms Muchos formularios devuelven las respuestas de «Sí/No» como texto. Para usarlo en una condición de Power Automate de forma limpia:

• Expresión: bool(variables(‘vRespuestaForm’))
• Resultado: true (si la variable era el texto «true»).

Ejemplo 2: Procesar un «Flag» numérico de una base de datos En SQL es común usar 1 para activo y 0 para inactivo.

• Expresión: bool(outputs(‘Obtener_usuario’)?[‘esta_activo’])
• Resultado: true (si el valor en la base de datos es 1).

Ejemplo 3: Limpieza de datos externos

• Expresión: bool(‘False’)
• Resultado: false (valor lógico).

json()

La función json toma una cadena de texto (string) que tiene formato de objeto o matriz y la transforma en un objeto JSON real. Esto es crucial porque, aunque un texto parezca un JSON, Power Automate no te permitirá extraer sus propiedades (como el nombre o el ID) a menos que lo reconozca como un objeto mediante esta función.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cadena de texto o Binario): El texto que sigue la estructura de JSON (usando llaves {} o corchetes []) que deseas convertir.

Ejemplos prácticos

Ejemplo 1: Convertir un texto estático en objeto A veces necesitas crear un objeto rápido para usarlo más adelante en el flujo.

• Expresión: json(‘{«id»: 1, «nombre»: «Gemini»}’)
• Resultado: Un objeto donde puedes acceder a nombre directamente.

Ejemplo 2: Procesar la respuesta de una API «terca» Hay conectores que devuelven el cuerpo del mensaje como un simple texto. Sin json(), no podrías usar el contenido dinámico.

• Expresión: json(outputs(‘Solicitud_HTTP’)?[‘body’])
• Escenario: Transforma el texto plano recibido en un objeto que permite usar expresiones como body(‘Funcion_JSON’)?[‘status’].

Ejemplo 3: Convertir una cadena guardada en una variable

• Expresión: json(variables(‘vMiConfiguracionEnTexto’))

xml()

La función xml toma una cadena de texto que contiene marcado XML o, más comúnmente, un objeto JSON y lo convierte en un documento XML estructurado. Es fundamental cuando necesitas enviar datos a una API antigua que no acepta JSON, o cuando necesitas extraer información de un cuerpo XML que recibiste de un servicio externo.

Parámetros requeridos

Requiere exactamente un parámetro:

1. value (Cadena de texto o JSON): El contenido que deseas transformar a formato XML.

Ejemplos prácticos

Ejemplo 1: Convertir un objeto JSON a XML Esta es la forma más poderosa de usarlo. Defines tus datos como JSON y Power Automate construye las etiquetas XML por ti.

• Expresión: xml(json(‘{«root»: {«id»: 1, «status»: «Activo»}}’))
• Resultado:

<Root>
  <ID>1</ID>
  <Estado>Activo</Estado>
</Root>