Guía para escribir jobs
En OpenFn, la automatización de workflows y la integración de datos se logran mediante la creación de jobs.
Esta guía te presenta los conceptos clave y las buenas prácticas para escribir jobs. Sirve tanto para quienes recién empiezan a programar como para programadores de JavaScript con experiencia. De hecho, incluso si ya tienes experiencia con JavaScript, hay varios patrones clave del ecosistema de OpenFn que es importante aprender.
Si escribes jobs en la app de la plataforma (Lightning), puedes usar el AI Assistant como ayuda. Lo encontrarás en el Inspector.
Un job es un conjunto de código JavaScript que realiza una tarea concreta, como obtener datos de Salesforce o convertir datos JSON al estándar FHIR.
Cada job usa exactamente un adaptor (a menudo llamado "conector") para realizar su tarea. El adaptor ofrece un conjunto de funciones auxiliares (operaciones) que facilitan la comunicación con una fuente de datos.
Esta guía sirve por igual para escribir jobs en la app (Lightning) o con la CLI.
Puedes encadenar varios jobs en un workflow. Un patrón común es usar un job para obtener datos de la fuente de datos A, otro job para convertir o transformar esos datos para que sean compatibles con la fuente de datos B, y un tercer job para subir los datos transformados a la fuente de datos B.
Para saber más sobre el diseño y la implementación de workflows, consulta Crear y gestionar workflows.
Próximos pasos
La mejor forma de aprender a escribir jobs de OpenFn es escribir jobs de OpenFn.
Puedes empezar con la CLI y ejecutar jobs en tu computadora. Después, mira el desafío de la CLI para poner a prueba de verdad tus habilidades para escribir jobs.
Si ya quieres empezar a usar la app, mira esta guía para crear tu primer workflow.
El diseño de workflows no es un problema trivial, así que quizás también quieras revisar la documentación del proceso de diseño de workflows.
A medida que tus jobs crecen, empezarás a escribir funciones auxiliares dentro de ellos para analizar, mapear o reformatear datos. Puedes hacer pruebas unitarias de esas funciones como con cualquier otro código JavaScript: expórtalas en el nivel superior, compila tu proyecto con la CLI y apunta un ejecutor de pruebas a la salida. Consulta Escribir pruebas unitarias para tus jobs.
Si tienes preguntas sobre cómo escribir jobs, pregunta en la comunidad para recibir ayuda del equipo principal de OpenFn y de otros implementadores.