Environment Variable

Este componente actúa como un puente seguro entre tu flujo de trabajo y las configuraciones externas (variables de entorno) que has definido para tu proyecto. Es fundamental cuando necesitas que tus procesos sean flexibles, permitiendo cambiar valores clave (como URLs, claves o identificadores) sin necesidad de modificar el código o la estructura del flujo cada vez.

En lugar de escribir valores fijos, este componente te permite “preguntar” al sistema cuál es el valor actual de una variable específica, asegurando que estés utilizando siempre la configuración correcta para el entorno en el que estás trabajando.

¿Cómo funciona?

Imagina que tienes una lista de reglas o configuraciones guardadas para tu flujo de trabajo (por ejemplo, direcciones de servidores o identificadores de bases de datos). Este componente se encarga de buscar esa lista y encontrar el valor específico que necesitas.

El proceso ocurre en dos pasos sencillos:

Identificación: El componente verifica a qué “entorno” o proyecto pertenece tu flujo actual. Utiliza una lógica inteligente para asegurarse de que está mirando la configuración correcta, incluso si el flujo se está ejecutando en diferentes etapas.
Resolución: Una vez identificado el entorno correcto, busca dentro de la lista de variables de ese entorno la clave que tú seleccionaste y extrae su valor.

Si por alguna razón no encuentra el valor o la configuración, el componente devolverá un espacio vacío, lo que te permitirá identificar rápidamente si falta una configuración en lugar de causar errores silenciosos.

Conexión y Credenciales

Este componente no requiere que configures credenciales manuales (como contraseñas o claves de API) directamente en su interior. En su lugar, se conecta automáticamente a las variables de entorno que ya has definido previamente en la configuración de tu flujo de trabajo dentro del panel de Nappai.

Entradas

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

Variable Key: Esta es la entrada principal y obligatoria. Te permite seleccionar, mediante una lista desplegable, qué variable de entorno deseas recuperar. Las opciones que aparecen en esta lista se actualizan automáticamente según las variables que tengas definidas en tu entorno actual. Si necesitas ver las variables más recientes, puedes usar el botón de actualización disponible en la interfaz.
- Visible en: [Todas las operaciones]

Salidas

El componente produce una única salida llamada Value.

Esta salida contiene el texto (cadena de caracteres) del valor de la variable que seleccionaste. Si la variable no se encuentra o hay un problema de conexión, la salida será una cadena vacía. Este resultado está listo para ser conectado a otros nodos que necesiten leer o procesar ese dato específico (como un mensaje de texto, una URL o un identificador).

Ejemplo de Respuesta JSON

Cuando el componente se ejecuta correctamente, devuelve un objeto de mensaje con el siguiente formato: json { “text”: “valor_de_la_variable_encontrado” }

Nota: El campo text contiene el dato útil que podrás utilizar en los siguientes pasos de tu flujo.

Conectividad

Dado que este componente es una fuente de datos de configuración, generalmente se conecta a:

Componentes de Entrada de Datos: Nodos que requieren parámetros específicos (como URLs de API, nombres de bases de datos o rutas de archivos) pero que no deben estar “hardcodeados” en el código.
Lógica Condicional: Para tomar decisiones basadas en valores de configuración (ej. “Si la variable de entorno es ‘Producción’, entonces haz X”).

Su salida es versátil y puede alimentar cualquier componente que acepte texto o cadenas como entrada.

Ejemplo de Uso

Supongamos que estás creando un flujo para enviar correos electrónicos. Quieres que el servidor SMTP sea configurable para que puedas probarlo en un entorno de pruebas y luego usarlo en producción sin cambiar el código.

Defines una variable de entorno llamada SMTP_SERVER en la configuración de tu flujo de Nappai.
Añades el componente Environment Variable a tu canvas.
En el campo Variable Key, seleccionas SMTP_SERVER de la lista desplegable.
Conectas la salida Value del componente a la entrada Server Address de tu nodo de “Enviar Correo”.
Ahora, cuando cambies el valor de SMTP_SERVER en tu configuración, el flujo leerá automáticamente el nuevo servidor sin necesidad de toques manuales en el código.

Consejos y Mejores Prácticas

Mantén las claves claras: Al definir tus variables de entorno en la configuración de Nappai, utiliza nombres descriptivos (como DB_HOST en lugar de v1) para facilitar la selección en este componente.
Actualización de lista: Si acabas de crear o modificar una variable de entorno y no aparece en la lista desplegable Variable Key, utiliza el botón de recarga o actualiza la vista del componente para obtener las últimas opciones disponibles.
Manejo de errores: Si un nodo posterior falla, verifica siempre si la salida Value de este componente contiene texto o está vacía. Un valor vacío suele indicar que la variable de entorno no fue encontrada o no estaba definida correctamente.

Consideraciones de Seguridad

Acceso Restringido: Este componente solo puede leer variables de entorno asignadas específicamente al flujo de trabajo actual. No puede acceder a variables de otros flujos o proyectos por motivos de seguridad.
Protección de Datos: Al usar este componente, asegúrate de no exponer las variables de entorno sensibles (como contraseñas) en registros de log públicos o en outputs visibles a usuarios finales, si el sistema lo permite. El valor se recupera de forma segura desde la base de datos interna.