Variables

Las variables en Gigantics te permiten almacenar y gestionar valores de configuración e información sensible (como contraseñas o claves API) que pueden ser utilizadas en tus funciones personalizadas. Esta funcionalidad te ayuda a evitar escribir valores directamente en el código de tus funciones y proporciona una forma segura de gestionar datos sensibles.

Tipos de variables

Existen dos tipos de variables que puedes crear:

• Plain: Variables de texto normal que se almacenan tal cual
• Secret: Variables encriptadas para datos sensibles como contraseñas o claves API

Las variables Secret se encriptan antes de almacenarse en la base de datos y se muestran enmascaradas en la interfaz para evitar que sean vistas casualmente.

Creación y gestión de variables

Interfaz de usuario

La página de Variables presenta una vista de tabla con las siguientes columnas:

Añadir una nueva variable

1. Haz clic en el botón "Create" en la esquina superior derecha
2. Se abrirá un panel lateral con un formulario que contiene:
   • Name: Campo de texto para el identificador de la variable
   • Type: Selector desplegable para "Plain" o "Secret"
   • Value: Área de texto para variables Plain o campo de contraseña para variables Secret
3. Rellena los campos obligatorios
4. Haz clic en "Save" para crear la variable

Editar una variable

1. Haz clic en el menú de acciones (tres puntos) junto a cualquier variable
2. Selecciona "Edit" del menú desplegable
3. Modifica el nombre, tipo o valor de la variable según sea necesario
4. Haz clic en "Save" para actualizar la variable

Nota: Para variables Secret, si no cambias el valor, se conservará la visualización enmascarada (•••••••).

Eliminar una variable

1. Haz clic en el menú de acciones (tres puntos) junto a cualquier variable
2. Selecciona "Delete" del menú desplegable
3. Confirma la eliminación en el diálogo modal

Uso de variables en funciones

Las variables están diseñadas para ser utilizadas dentro de funciones personalizadas. Cuando creas una función que necesita valores de configuración externos o datos sensibles, puedes hacer referencia a variables en lugar de escribirlas directamente en el código.

Cómo referenciar variables

En el código de tu función personalizada, puedes usar variables con la siguiente sintaxis:

$(nombre_variable)

Por ejemplo, si tienes una variable llamada "api_key", la referenciarías como:

$(api_key)

Beneficios de usar variables

• Seguridad: La información sensible como contraseñas y claves API se encripta y enmascara
• Flexibilidad: Cambia fácilmente los valores de configuración sin modificar el código de la función
• Reutilización: Usa la misma variable en múltiples funciones
• Colaboración: Los miembros del equipo pueden usar variables sin ver sus valores reales

Buenas prácticas

1. Usa variables Secret para datos sensibles: Utiliza siempre el tipo "Secret" para contraseñas, claves API y otra información sensible
2. Nombres descriptivos: Usa nombres claros y descriptivos para que sea evidente su propósito
3. Variables específicas por entorno: Crea diferentes variables para distintos entornos (desarrollo, staging, producción) en lugar de cambiar valores
4. Limpieza regular: Elimina las variables no utilizadas para mantener tu proyecto organizado
5. Control de acceso: Solo otorga permisos de "ManageVariables" a usuarios que necesiten crear o modificar variables

Ejemplos de uso

• Almacenar cadenas de conexión a bases de datos para usar en funciones personalizadas
• Gestionar claves API para servicios externos
• Guardar valores de configuración como umbrales o límites
• Almacenar credenciales de servidores de correo para funciones de notificación