Índice:
- ¿Qué es la Biblioteca de Funciones?
- Ventajas de la Biblioteca de Funciones.
- ¿Cómo crear una función?
- Parámetros configurables de una función
- Editando una función
- Eliminando una función
- Avisos de impacto
- ¿Cómo utilizar una función creada?
¿Qué es la Biblioteca de Funciones?
La Biblioteca de Funciones se encuentra en la sección de Acciones de los bloques del Builder. Permite que los creadores de bots creen funciones JavaScript globales, las cuales pueden ser accedidas por todos los bots de un contrato conectado.
Con la Biblioteca de Funciones, puedes centralizar y reutilizar lógicas comunes entre bots, reduciendo el trabajo repetido y aumentando la consistencia.
Imagen 01: Ubicación de la Biblioteca de funciones en el Builder.
Ventajas de la Biblioteca de Funciones
Centralización y reutilización: Crea funciones en un solo lugar y úsalas en varios bots.
Mantenimiento simplificado: Actualiza una función centralizada y propaga los cambios a todos los bots que la utilizan.
Reducción de errores: Reduce la duplicidad de código y los riesgos de inconsistencias.
Facilidad de gestión: Interfaz sencilla e intuitiva para crear, editar y eliminar funciones.
¿Cómo crear una función?
Existen tres formas de crear una nueva función en la Biblioteca de Funciones:
-
Dentro de un bloque en el Builder:
- Accede a la pestaña de Acciones.
- Haz clic en el botón Crear función.
-
Desde la Gestión de la Biblioteca de Funciones:
- Accede directamente a la Biblioteca de Funciones.
- Haz clic en el botón Crear función.
-
En una acción "Función de la Biblioteca":
- Al configurar una acción Función de la Biblioteca, haz clic en el botón Crear función.
Parámetros configurables de una función
- Clave: Nombre de la función. Puede contener caracteres en mayúsculas o minúsculas, pero no debe incluir espacios ni caracteres especiales.
- Descripción (Opcional): Una breve explicación para ayudar a entender la función.
- Variables de Entrada: Parámetros que la función JavaScript recibirá.
-
Contenido de la Función: El código JavaScript que se asociará a la función.
- Consejo: Utiliza el botón Expandir contenido para abrir un editor de código más grande y práctico.
Imagen 02: Parámetros configurables de una función.
Editando una función
- Ve a la lista de funciones.
- Haz clic en el ícono de tres puntos junto a la función deseada.
- Selecciona la opción Editar.
- Realiza los ajustes necesarios en los parámetros de la función.
- Haz clic en el botón Guardar cambios para aplicar las modificaciones.
Eliminando una función
- Ve a la lista de funciones.
- Haz clic en el ícono de tres puntos junto a la función deseada.
- Selecciona la opción Eliminar.
Avisos de impacto
Al editar o eliminar una función, el sistema mostrará una advertencia para evitar impactos no deseados:
Eliminación:
-
Si la función es utilizada por otros bots:
- El sistema listará los bots afectados.
- Proporcionará enlaces para acceder a esos bots.
- La eliminación será bloqueada hasta que la función se elimine manualmente de esos bots.
-
Si la función no está en uso:
- El sistema permitirá la eliminación sin restricciones.
Edición:
-
Si la función es utilizada por otros bots:
- El sistema listará los bots afectados y permitirá la edición.
-
Si la función no está en uso:
- La edición será permitida sin restricciones.
Imagen 03: Advertencia de impacto al editar una función.
¿Cómo utilizar una función creada?
Existen dos caminos principales para utilizar una función creada en la Biblioteca de Funciones:
- Usando en una acción "Ejecutar Script 2.0":
- Crea una acción de entrada/salida del tipo Ejecutar Script 2.0.
- Para invocar la función, utiliza el formato:
{{blipfunction.clave}}- blipfunction: Prefijo predeterminado de la Biblioteca de Funciones (no puede ser modificado).
- clave: Nombre de la función creada.
- Completa la configuración de la acción según sea necesario.
Imagen 04: Llamando a una función de la Biblioteca en la acción 'Ejecutar Script 2'.
- Usando en una acción “Función de la biblioteca”:
- Crea una acción de entrada/salida del tipo Función de la Biblioteca.
- En la lista de funciones disponibles, selecciona la función deseada.
- Configura los demás parámetros según sea necesario.
Imagen 05: Seleccionando una función en la acción 'Función de la biblioteca'.
Para más información, acceda a la discusión sobre el tema en nuestra comunidad o a los videos en nuestro canal. 😃