Reutilizar puntos finales y scripts en Jitterbit Studio

Introducción

Esta guía describe técnicas para reutilizar trabajo en proyectos de Studio: construir un proyecto base reutilizable, configurar puntos finales dinámicamente con variables, reutilizar scripts independientes e importar componentes individuales de un proyecto existente. Aplicar estas técnicas reduce la duplicación y mantiene la configuración consistente entre proyectos y entornos.

Proyecto base

Un escenario típico para reutilizar un proyecto implica el desarrollo de un proyecto base con el uso extensivo de variables globales y, especialmente, variables de proyecto.

Los elementos configurables (como credenciales de puntos finales, mapeos de campos opcionales, consultas parametrizadas, direcciones de correo electrónico y nombres de archivos) pueden ser expuestos como variables de proyecto.

El proyecto base también puede contener funciones comunes como manejo de errores o el uso de cachés a nivel de entorno.

Al exportar un proyecto base, seleccione Incluir valores de variables de proyecto para preservar los valores predeterminados de todas las variables de proyecto en la exportación. Esto es importante para un proyecto base construido en torno a una configuración parametrizada. También puede elegir si incluir credenciales, notificaciones por correo electrónico y horarios de operación. Consulte Exportar un proyecto para ver el conjunto completo de opciones de exportación.

El archivo JSON exportado puede ser importado como un nuevo proyecto en cualquier entorno u organización. El proyecto importado no se despliega automáticamente después de la importación; configure los valores de variables de proyecto específicos del entorno antes de desplegar.

Reutilización de puntos finales

Los puntos finales, creados al configurar una conexión y actividades asociadas utilizando conectores, se utilizan con frecuencia en operaciones. Sin embargo, no es necesario construir un punto final único para cada operación. Dado que las configuraciones de actividad aceptan variables para rutas y nombres de archivos, se pueden construir puntos finales genéricos una vez y luego configurarlos dinámicamente utilizando variables globales y de proyecto.

Por ejemplo, suponga que se crea una conexión HTTP v2 y una actividad asociada, y la configuración de la actividad especifica una ruta definida por una variable global, como gv_http_path. Se puede utilizar un script controlador para poblar gv_http_path según sea necesario.

Otro ejemplo es una actividad de Consulta de Base de Datos con una condición. Su condición WHERE se puede asignar a una variable global, como gv_database_condition.

La mayoría de los puntos finales tienen la capacidad de configurarse utilizando variables.

Reutilización de scripts

Los scripts independientes que realizan una función específica, como devolver una búsqueda en la base de datos o calcular un resultado a partir de una serie de argumentos, pueden ser candidatos para reutilización, particularmente si se utilizan en múltiples operaciones.

Por ejemplo, si un script utiliza la función DBLookup contra una tabla de base de datos, y esta función se utiliza en todo el proyecto, entonces se puede construir un script independiente (separado de una operación). Utilizando la función ArgumentList o variables globales simples, el script puede aceptar argumentos y devolver un resultado. Dado que cada cadena de operación es un ámbito diferente, el mismo script se puede llamar de manera segura desde múltiples operaciones simultáneas.

Para obtener orientación sobre cómo almacenar credenciales en variables de proyecto de manera segura, consulte Gestionar credenciales de puntos finales. Para convenciones de nomenclatura que mantengan las variables de proyecto consistentes en un proyecto base, consulte Utilizar una convención de nomenclatura para variables.

Importación selectiva de componentes

En lugar de importar un proyecto base completo, puede importar componentes específicos (como puntos finales individuales o scripts) de un proyecto existente o un archivo JSON de proyecto a un proyecto existente. Esto es útil cuando se desea reutilizar un punto final bien probado o un script compartido sin importar el resto de un proyecto base.

Para importar componentes de manera selectiva, abre el menú de acciones del proyecto y haz clic en Importar desde el proyecto. La importación se lleva a cabo en dos pasos:

1. Opciones de importación: Elige entre subir un archivo JSON de proyecto local o seleccionar un proyecto existente en el mismo entorno que el proyecto de destino.

2. Elegir componentes: Navega por los componentes por categoría y selecciona los que deseas importar. Por defecto, Autoseleccionar dependencias está habilitado, lo que incluye automáticamente todas las dependencias requeridas de un componente seleccionado.

   Si un componente importado comparte un nombre con un componente existente del mismo tipo, el conflicto debe resolverse antes de que la importación pueda completarse. Para los endpoints, puedes usar un endpoint existente o crear uno nuevo. Para otros componentes, puedes reemplazar el componente existente o mantener ambos (el componente importado se renombra con un sufijo numérico).

   Los componentes importados se agrupan en una carpeta personalizada etiquetada como Importado con la fecha y hora de la importación.

Para obtener todos los detalles, consulta Importación selectiva en Exportar e importar un proyecto.