Alcance
Guest Code establece un nuevo modo de extender y personalizar las funcionalidades de Finnegans GO mediante scripts de Python. Esto hace más efectiva la gestión, ya que permite a los usuarios desarrollar soluciones a medida y automatizar procesos directamente desde la plataforma.
Desde los scripts de Python creados, es posible interactuar con distintas herramientas del sistema y resolver necesidades específicas, brindando una trazabilidad clara de las acciones ejecutadas a través de su monitor de logs.
¿Qué es Guest Code?
Es una aplicación de GO que permite a los usuarios crear scripts de Python de forma simple, sin necesidad de infraestructura externa. Estos scripts de Python se desarrollan directamente desde la plataforma y se ejecutan de forma temporal cuando son invocados. Cada script genera una URL única (conocida como “endpoint”) que puede ser utilizada por distintas herramientas del sistema Finnegans GO.
¿Cuál es el problema que resuelve?
Tradicionalmente, para integrar procesos automáticos o extender funcionalidades en Finnegans GO, era necesario desarrollar y alojar scripts de Python externos. Esto implicaba:
- Contar con infraestructura propia: La necesidad de servidores o servicios de alojamiento externos.
- Conocimiento técnico especializado: Requería experiencia en desarrollo y mantenimiento de estos servicios.
- Costos operativos continuos: Mantener los servicios activos generaba gastos, incluso cuando no estaban en uso.
Guest Code elimina estas barreras al permitir la creación de scripts de Python directamente en la plataforma, sin depender de infraestructura externa. Esto resulta en una reducción significativa de costos, tiempos de implementación y la necesidad de intervención técnica avanzada.
¿Qué tecnologías utiliza?
- Lenguaje: Python (se requiere conocimiento básico para el desarrollo de scripts).
- Asistente: Finni, una herramienta de inteligencia artificial integrada que asiste en la generación automática del código.
- Output: Una URL (endpoint) que actúa como punto de acceso para el script de Python, permitiendo su uso en BPROCs, Deals, BModeler y otras herramientas.
¿Quiénes pueden usarlo?
Guest Code está disponible para los usuarios que tienen contratada la aplicación App Builder y Dai Builder en Finnegans GO.
DAI Builder es una aplicación que integra todas las herramientas NO CODE de Finnegans GO. Permite hacer extensiones funcionales sin escribir código y está constituida por una parte de AppBuilder.
Por su parte, AppBuilder es una aplicación que integra todas las herramientas NO CODE y LOW CODE de Finnegans GO. La diferencia es que permite hacer extensiones funcionales requiriendo conocimientos básicos de programación y base de datos.
Para conocer más sobre el funcionamiento de Dai Builder te recomendamos leer el siguiente instructivo
¿Cómo se usa Guest Code?
A continuación, se detallan los pasos para crear y gestionar un script en Guest Code:
- Ingresar a la aplicación Guest Code: Accede a la aplicación desde el menú principal de la plataforma Finnegans GO.
- Crear un nuevo script: Haz clic en el botón “Nuevo script” para iniciar el proceso.
- Completar los campos requeridos:
- Nombre (obligatorio): Un nombre descriptivo para tu script.
- Endpoint (obligatorio): Será la parte final de la URL única de tu script. Debe escribirse en minúsculas y con guiones. Una vez guardado, este campo no se puede editar.
- Descripción (opcional): Una breve explicación de la funcionalidad del script.
- Script en Python (obligatorio): Aquí es donde deberás escribir o pegar tu código Python. Puedes utilizar Fini para asistirte en la creación.
- Guardar el script: Una vez completados los campos, guarda el script.
- Se generará automáticamente una URL única (endpoint) para tu script, la cual podrás copiar y utilizar.
- El script aparecerá en la grilla principal de Guest Code.
- Por defecto, el estado del script será “Activo”. Un script solo se ejecutará si se encuentra en este estado.
Monitor de ejecución
El monitor de ejecución de Guest Code es una herramienta fundamental para supervisar el rendimiento y diagnosticar posibles problemas en tus scripts.
Desde el panel de scripts:
-
Posicionarse sobre el script: En la grilla de scripts, selecciona el script del cual deseas ver el monitor.
-
Acceder al monitor: Haz clic en el icono de menú (⋮) asociado al script y selecciona la opción “Ver monitor”.
-
Visualización de la grilla: Se mostrará una grilla con los siguientes detalles de cada ejecución:
- ID Ejecución: Identificador único de cada ejecución.
- Status http: si indica 200 se ejecutó correctamente, 300 redirección, 400 error del lado del cliente y 500 error del lado del servidor.
- Estado de ejecución: indica si fue ok o error.
- Tiempo de ejecución: Duración de la ejecución del script.
- Fecha de ejecución: Fecha y hora en que se ejecutó el script.
- Usuario: persona que ejecutó el script.
Estructura y formato del script
Para que un script sea compatible y se ejecute correctamente en Guest Code, debe seguir una estructura y utilizar librerías específicas:
- Función principal main():
Todo el código principal de tu script debe estar contenido dentro de una función llamada main(). - Librerías permitidas: Solo se permite el uso de librerías estándar de Python y las librerías específicas provistas por Finnegans.
Consideraciones técnicas y errores comunes
Es importante tener en cuenta los siguientes puntos para un uso efectivo de Guest Code:
- Edición del endpoint: Una vez que un script ha sido creado y guardado, el campo “Endpoint” no puede ser modificado.
- Estado del script: Un script solo se ejecutará si su estado es “Activo”. Si está inactivo, no responderá a las invocaciones.
- Validación de sintaxis: Actualmente, Guest Code no cuenta con validación automática de la sintaxis del código Python. Se recomienda encarecidamente probar y depurar el código antes de su uso en producción para evitar errores.
- Asistencia de Finni: Aunque Finni puede ayudar en la creación y corrección del código, es fundamental que el usuario tenga conocimientos básicos de Python para comprender y depurar los scripts.
- Coherencia del entorno: El entorno de ejecución (organización, sesión, token) debe coincidir con el contexto en el que se está probando el script para asegurar su correcto funcionamiento.