Binary

Binary es un componente que te permite trabajar con archivos binarios dentro de tu dashboard de Nappai. Puedes cargar archivos desde una cadena Base64, desde una URL o desde datos estructurados, y el componente los convierte en un objeto binario que puedes usar en el resto de tu flujo de trabajo.

¿Cómo funciona?

Binary procesa los datos localmente dentro del entorno de Nappai. Cuando seleccionas una operación, el componente toma la entrada correspondiente (por ejemplo, una cadena Base64 o una URL), la convierte en un objeto binario y la devuelve como salida. Si activas el Mapping Mode, puedes enviar varios registros a la vez y el componente los procesa en lote, lo que facilita la automatización de tareas repetitivas.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• From Base64: Convierte una cadena Base64 en un archivo binario.
• From URL: Descarga el archivo desde la URL proporcionada y lo convierte en binario.
• From structured data: Toma datos estructurados (por ejemplo, un objeto JSON con contenido Base64 y metadatos) y crea el archivo binario correspondiente.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

• Fixed (Fijo): Escribes el valor directamente en el campo.
• Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
• Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

• Operations: Elige la operación que quieres ejecutar.

  • Visible en: From Base64, From URL, From structured data

• Base64 Content: El contenido Base64 del archivo cuando proviene de datos estructurados.

  • Visible en: From structured data

• Base64 String: La cadena Base64 del archivo cuando usas la operación From Base64.

  • Visible en: From Base64

• File Name: El nombre del archivo cuando usas la operación From structured data.

  • Visible en: From structured data

• Mapping Mode: Activa el modo de mapeo para procesar múltiples registros en lote.

  • Visible en: From Base64, From URL, From structured data

• Mime Type: El tipo MIME del archivo (por ejemplo, application/pdf, image/jpeg, video/mp4, audio/mpeg). Se usa cuando la operación es From structured data.

  • Visible en: From structured data

• URL: La URL del archivo cuando usas la operación From URL.

  • Visible en: From URL

Salidas

• Binary: Devuelve un objeto binario que contiene el archivo procesado. Puedes usar este objeto en componentes posteriores, como almacenamiento, envío por correo o análisis de contenido.

Ejemplo de Uso

Supongamos que quieres convertir una imagen que ya tienes en Base64 en un archivo que puedas guardar en tu sistema de archivos.

1. Arrastra el componente Binary al canvas.
2. Selecciona la operación From Base64.
3. En el campo Base64 String, pega la cadena Base64 de la imagen.
4. (Opcional) En File Name, escribe foto.jpg.
5. Conecta la salida Binary a un componente de almacenamiento, por ejemplo, “Save File”.
   El flujo guardará la imagen en tu sistema de archivos.

Si en lugar de una cadena Base64 tienes la URL de la imagen, simplemente cambia la operación a From URL, ingresa la URL en el campo URL y sigue los mismos pasos.

Componentes Relacionados

• File Upload – Permite subir archivos directamente desde el navegador.
• URL Fetcher – Descarga contenido de una URL y devuelve texto o datos binarios.
• BinaryBaseComponent – Base sobre la que se construye Binary, útil para entender la lógica subyacente.

Consejos y Mejores Prácticas

• Usa Mapping Mode cuando necesites procesar listas de archivos, como un lote de imágenes de un cliente.
• Si trabajas con archivos grandes, considera usar la operación From URL para descargar directamente sin cargar el contenido en memoria.
• Siempre verifica el tipo MIME cuando recibes datos estructurados para asegurarte de que el archivo se maneje correctamente.

Consideraciones de Seguridad

• Evita exponer URLs sensibles en la interfaz pública; utiliza tokens de acceso o autenticación cuando sea necesario.
• Cuando trabajes con Base64, valida la longitud y la integridad del contenido para prevenir ataques de inyección.
• Si el archivo proviene de fuentes externas, escanea el contenido antes de almacenarlo o procesarlo para evitar malware.