Saltar al contenido

Crear y configurar un proyecto en Jitterbit Integration Studio

Introducción

Un proyecto es una colección de uno o más flujos de trabajo que comprenden y ejecutan un caso de uso de integración. Los proyectos son el "contenedor" para las operaciones que están organizadas en flujos de trabajo, así como otros componentes del proyecto que pueden ser parte de una operación o existir en otra parte del proyecto.

Esta página describe cómo crear y configurar un nuevo proyecto desde Integration Studio, cómo abrir un proyecto existente, cómo editar la configuración de proyectos existentes y cómo eliminar proyectos existentes.

También se pueden crear nuevos proyectos de Integration Studio utilizando recetas de integración de Integration Studio o plantillas de procesos de Integration Studio proporcionadas a través de Jitterbit Marketplace. Para obtener información sobre cómo crear un nuevo proyecto de Integration Studio desde Marketplace, consulte Iniciar un proyecto de receta o plantilla.

Crear un nuevo proyecto

Los nuevos proyectos se crean desde la página de Proyectos. Esta página contiene un repositorio de proyectos de Integration Studio accesibles. Si no hay proyectos accesibles en la organización seleccionada, no se listan.

Para crear un nuevo proyecto de Integration Studio, haga clic en Nuevo Proyecto:

header

Al hacer clic en Nuevo Proyecto, se abre la pantalla de configuración del proyecto. Hay cuatro pestañas disponibles: Pestaña General, Pestaña Diseñador, Pestaña Despliegue y Pestaña Avanzada.

Tenga en cuenta que un proyecto no se despliega automáticamente después de su creación (consulte Despliegue del proyecto).

Para obtener información sobre cómo realizar cambios en la configuración del proyecto después de su creación, consulte Editar la configuración del proyecto más adelante en esta página.

Nota

La configuración en las pestañas Despliegue y Avanzada (descritas a continuación) solo puede ser establecida por usuarios con una combinación de permisos de rol de organización Admin y acceso Escritura en el entorno (consulte Permisos y acceso de Harmony). Para los usuarios sin el permiso de rol apropiado, se muestra el siguiente mensaje: "No hay ningún requisito proporcionado por su organización."

General tab

project new general

Esta pestaña tiene las siguientes configuraciones:

  • Nombre del proyecto: Ingresa un nombre para identificar el proyecto. El nombre del proyecto debe ser único para cada entorno y no puede estar ya en uso como un nombre de proyecto de Design Studio en el mismo entorno. Si ya existe un proyecto con el mismo nombre en la nube de Harmony, ve a la página de Management Console > Projects para gestionar el proyecto desplegado.

    Consejo

    Al renombrar un proyecto que ha sido desplegado previamente, el nuevo nombre del proyecto se refleja automáticamente en la nube de Harmony sin requerir un nuevo despliegue.

  • Entorno: Usa el menú desplegable para seleccionar un entorno existente donde deseas crear el proyecto. Los administradores de la organización pueden configurar nuevos entornos a través de la página de Management Console > Environments.

    Consejo

    Si no ves un entorno recién creado disponible para seleccionar, actualiza la página de Projects para forzar una recarga de los entornos.

    Al editar la configuración de un proyecto, ten en cuenta que el entorno no se puede cambiar. Sin embargo, el proyecto puede ser transferido a otro entorno.

  • Descripción: Ingresa una descripción opcional para el proyecto. Esta descripción aparecerá en la página de Projects y puede ser útil para ayudar a los colaboradores del proyecto a entender el proyecto.

Al editar la configuración de un proyecto, esta información está disponible en la pestaña General:

edit general tab

Pestaña del Diseñador

proyecto nuevo diseñador

Esta pestaña tiene la siguiente configuración:

  • Numerar automáticamente las operaciones en el lienzo de diseño: Seleccione para mostrar un número secuencial precediendo cada nombre de operación en el lienzo de diseño. Los números de operación corresponden con el flujo de trabajo en el que se encuentra cada operación. Por ejemplo, en el flujo de trabajo 2.0, las operaciones se numeran automáticamente como 2.0, 2.1, 2.2, y así sucesivamente. La numeración automática se muestra solo en el momento del diseño; los números no aparecen como parte del nombre de la operación en los registros de operaciones.

Pestaña de Despliegue

proyecto nuevo despliegue

Esta pestaña tiene la siguiente configuración:

  • Requerir comentarios al desplegar: Seleccione para requerir que cada vez que se despliegue este proyecto, se presente un diálogo que requiera agregar un comentario.
  • Requerir etiquetas al desplegar: Seleccione para requerir que cada vez que se despliegue este proyecto, se presente un diálogo que requiera agregar una etiqueta.
  • Regla de validación HTTP: Habilitada por defecto. Deshabilitar esta configuración no es normalmente necesario. Para más información, consulte errores de regla de validación HTTP en Validez de operación.

Pestaña Avanzada

proyecto nuevo avanzado

Esta pestaña tiene la siguiente configuración:

  • Habilitar nuevo analizador de scripts de Jitterbit: Habilitado por defecto a partir de la versión 10.68 / 11.6. Deshabilitar esta configuración no es normalmente necesario y se aconseja solo si experimenta una salida de script inesperada.

  • Preservar nombres JSON: Determina qué método de procesamiento de esquema se utiliza durante el diseño del proyecto y en tiempo de ejecución, ya sea procesamiento de preservación de nombres JSON (habilitado), o procesamiento JSON legado (deshabilitado). La versión utilizada por defecto depende de cuándo se creó el proyecto y la versión del agente en uso:

    • Procesamiento de preservación de nombres JSON: El predeterminado para proyectos creados después del [lanzamiento 11.48 Harmony] y que se ejecutan en la versión del agente 11.48 o posterior.

    • Procesamiento JSON legado: El predeterminado para proyectos creados antes del [lanzamiento 11.48 Harmony] o aquellos que se ejecutan en la versión del agente 11.47 o anterior. La configuración Preservar nombres JSON se puede habilitar en tales proyectos una vez que la versión del agente se actualice a 11.48 o posterior.

Importante

Al habilitar esta configuración, tenga en cuenta que el procesamiento de preservación de nombres JSON se utiliza solo para operaciones y esquemas configurados después de la habilitación. Al habilitar esta función, se recomienda que todas las operaciones y esquemas sean reconfigurados, ya que utilizar ambos métodos de procesamiento de esquema dentro de un solo proyecto puede causar inconsistencias dentro del proyecto.

Abrir un proyecto existente

Los proyectos existentes se muestran en la página de Proyectos filtrados por entorno. Utilice el menú desplegable Filtrar por para seleccionar un entorno diferente para su organización seleccionada:

entornos

Consejo

Los entornos disponibles son para su organización seleccionada. La organización seleccionada se puede cambiar en la barra de navegación superior (ver Cambio de la organización seleccionada en Portal Harmony).

Los proyectos existentes se pueden abrir desde la vista de mosaico del proyecto o desde la vista de lista del proyecto. Para obtener detalles sobre todas las opciones disponibles en cada una de estas vistas, consulte Proyectos.

  • Vista de mosaico del proyecto: Haga clic en el ícono de vista de mosaico para ingresar a la vista de mosaico. Luego, pase el cursor sobre un mosaico de proyecto y seleccione Ver/Editar para abrir el proyecto en el diseñador de proyectos:

    card view flip cropped

  • Vista de lista del proyecto: Haga clic en el ícono de vista de lista para ingresar a la vista de lista. Luego, pase el cursor sobre la celda vacía en la columna de Acciones y haga clic en el ícono de editar para abrir el proyecto en el diseñador de proyectos:

    list view

Editar la configuración del proyecto

Un proyecto se configura primero durante la creación del proyecto, que se cubrió anteriormente en esta página. Después de crear un proyecto, se pueden editar los ajustes del proyecto para realizar cambios en el nombre del proyecto, la descripción o para exportar o eliminar el proyecto.

La opción Configuración del proyecto es accesible desde estas ubicaciones:

Esto abre la pantalla de configuración del proyecto. Hay cuatro pestañas disponibles, como se describe arriba, y estas opciones adicionales:

edit project settings

  • Guardar: Guarda y cierra la configuración del proyecto. Este botón estará habilitado solo después de que haya realizado cambios en la configuración existente.

  • Cancelar: Cierra la configuración del proyecto sin guardar.

  • Exportar: Genera e inicia la descarga de un archivo JSON del proyecto de Integration Studio. Una exportación de proyecto puede ser utilizada, por ejemplo, como una copia de seguridad del proyecto o para compartir una copia del mismo. Para más detalles, consulta Exportaciones e importaciones de proyectos.

  • Mover a la papelera: Elimina el proyecto del entorno en Integration Studio y de la nube de Harmony. Los proyectos pueden ser restaurados hasta 90 días después de haber sido movidos a la papelera. Después de 90 días, el proyecto se elimina permanentemente y no puede ser restaurado (consulta Eliminar y restaurar un proyecto más adelante en esta página).

Eliminar y restaurar un proyecto

Puedes eliminar, restaurar o eliminar permanentemente un proyecto desde la página de Proyectos.

La opción Mover a la papelera es accesible desde estas ubicaciones:

Al hacer clic en Mover a la papelera, un mensaje de confirmación te pide que confirmes que deseas mover el proyecto a la papelera:

Texto del diálogo

Proyecto de ejemplo será movido a la papelera.

Este proyecto será eliminado permanentemente después de 90 días. El historial del proyecto no puede ser restaurado.

Las opciones Restaurar y Eliminar permanentemente son accesibles desde la página de Proyectos (consulta Vista de mosaico o Vista de lista en Proyectos).

Al hacer clic en Eliminar permanentemente, un mensaje de confirmación te pide que confirmes que deseas eliminar permanentemente el proyecto:

Texto del diálogo

Proyecto de ejemplo será eliminado permanentemente y no podrá ser recuperado.

Por favor, escribe "ELIMINAR" para confirmar:

Debes escribir la palabra DELETE para habilitar el botón Eliminar.

Solución de problemas

Las razones comunes por las que no puedes eliminar un proyecto son que el proyecto tiene proyectos dependientes o que el proyecto tiene operaciones con un estado incompleto.

Proyectos transferidos

Si el proyecto que intentas eliminar ha sido transferido, no se puede eliminar hasta que primero elimines todos los proyectos más abajo en la cadena de transferencia (ver Cadenas de transferencia en Transferir un proyecto). Después de hacer clic en Eliminar en el diálogo Eliminar para siempre, un segundo diálogo indica que el proyecto no se puede eliminar e incluye los nombres y entornos de los proyectos transferidos que impiden la eliminación:

Texto del diálogo

Este proyecto no se puede eliminar porque ha sido migrado a uno o más otros entornos. Para eliminar este proyecto, debes eliminar estos proyectos relacionados:

  • Entorno: Ejemplo env 1

    • Proyecto: Ejemplo proyecto 1

  • Entorno: Ejemplo env 2

    • Proyecto: Ejemplo proyecto 2

Para resolver, primero elimina todos los proyectos más abajo en esa cadena de transferencia (listados en el diálogo), y luego intenta eliminar el proyecto original nuevamente.

Operaciones con un estado incompleto

Los proyectos con operaciones enviadas que están en un estado incompleto no se pueden mover a la papelera. Si el proyecto que intentas mover a la papelera tiene alguna operación en un estado incompleto, incluyendo Enviado, Recibido, Pendiente, Ejecutándose, Cancelación solicitada o Estado retrasado, se devolverá un mensaje de error.

Para resolver, puedes cancelar operaciones incompletas desde estas ubicaciones: