Crear y configurar un proyecto en Jitterbit 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 Studio, cómo abrir un proyecto existente, cómo editar la configuración de los proyectos existentes y cómo eliminar proyectos existentes.

También se pueden crear nuevos proyectos de Studio utilizando recetas de integración de Studio o plantillas de proceso de Studio proporcionadas a través de Jitterbit Marketplace. Para obtener información sobre cómo crear un nuevo proyecto de 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 Studio accesibles. Si no hay proyectos accesibles en la organización seleccionada, no se listan.

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

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

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

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.

Pestaña 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 puede ser cambiado. 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:

• Entorno: El entorno en el que reside el proyecto (especificado durante la creación del proyecto o transferencia).

• Grupo de Agentes: El grupo de agentes asociado con el entorno en el que reside el proyecto (especificado en la Consola de Administración).

• Creado el: La fecha y hora en que se creó el proyecto.

Pestaña de roles de usuario

La pestaña de Roles de usuario controla qué roles pueden ver el proyecto en la página de Proyectos en Studio y en la página de Proyectos en la Consola de Administración. La pestaña contiene un cuadro de búsqueda y una tabla con las siguientes columnas:

• Rol de Usuario: Enumera los roles en la organización. Los roles que aparecen dependen de tu membresía de rol, como se describe a continuación.

• Acceso de Rol: El nivel de acceso más alto que tiene el rol en el entorno. Los valores posibles son Ver Registros, Leer, Ejecutar y Escribir.

• Habilitado: Un interruptor que controla si el proyecto es visible en la página de Proyectos en Studio y en la página de Proyectos de la Consola de Administración.

Cuando se crea un nuevo proyecto, todos los roles de los que el usuario creador es miembro se habilitan por defecto, junto con el rol de Administrador, que siempre está habilitado.

Los roles que aparecen en la tabla y si su configuración de Habilitado se puede alternar dependen de tu membresía de rol. Para modificar los interruptores de Habilitado, los usuarios deben tener acceso al entorno de Escribir. Los usuarios con acceso al entorno de Ver Registros, Leer o Ejecutar pueden ver la pestaña pero no pueden editarla.

• Si eres miembro de un rol con permiso de Admin, la tabla enumera todos los roles en la organización que tienen al menos acceso de Ver Registros al entorno, con el rol de Administrador siempre listado primero. Todos los interruptores se pueden alternar, excepto el rol de Administrador y el último rol del que eres miembro.

• Si no eres miembro de un rol con permiso de Admin, solo aparecen en la tabla los roles a los que perteneces. Si perteneces exactamente a un rol, su interruptor está habilitado y no se puede cambiar. Si perteneces a más de un rol, sus interruptores se pueden alternar individualmente, pero al menos uno debe permanecer siempre habilitado.

El rol de Administrador siempre se muestra con su interruptor habilitado permanentemente.

Los cambios en la configuración de visibilidad de roles tienen efecto inmediato y no requieren un despliegue del proyecto.

Pestaña Diseñador

Esta pestaña tiene las siguientes configuraciones:

• Auto-numerar operaciones en el lienzo de diseño: Seleccionar 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 auto-numeran 2.0, 2.1, 2.2, y así sucesivamente. La auto-numeración se muestra solo en el tiempo de diseño; los números no aparecen como parte del nombre de la operación en los registros de operaciones.

Pestaña Despliegue

Esta pestaña tiene las siguientes configuraciones:

• Requerir comentarios al desplegar: Seleccionar para requerir que cada vez que se despliegue este proyecto, se presente un diálogo que requiera agregar un comentario.
• Requerir etiquetas al desplegar: Seleccionar 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. Normalmente no se requiere deshabilitar esta configuración. Para más información, ver errores de regla de validación HTTP en Solución de problemas de diseño de operaciones.

Pestaña Avanzada

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 de la [versión 11.48 de Harmony] y que se ejecutan en la versión del agente 11.48 o posterior.

  • Procesamiento JSON legado: El predeterminado para proyectos creados antes de la [versión 11.48 de 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.

Abrir un proyecto existente

Los proyectos existentes se muestran en la página de Proyectos filtrados por entorno. Solo se muestran los proyectos para los cuales su rol tiene habilitada la visibilidad (ver pestaña de roles de usuario). Utilice el menú desplegable de entorno para seleccionar un entorno diferente para su organización seleccionada.

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

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

  

• Vista de lista de proyectos: Haga clic en el ícono de vista de lista para ingresar a la vista de lista. Luego, pase el mouse 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:

  

Editar la configuración del proyecto

Un proyecto se configura inicialmente 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 la visibilidad de roles, o para exportar o eliminar el proyecto.

La opción Configuración del proyecto es accesible desde la página de Proyectos y la barra de herramientas del proyecto.

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

• 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 Studio. Una exportación de proyecto puede ser utilizada, por ejemplo, como una copia de seguridad del proyecto o para compartir una copia del proyecto. Para más detalles, consulta Exportaciones e importaciones de proyectos.

• Mover a la papelera: Elimina el proyecto del entorno en 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:

• La configuración del proyecto (consulta Editar la configuración del proyecto más arriba en esta página).
• La página de Proyectos (consulta Vista de tarjeta o Vista de lista en Proyectos).

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:

Las opciones Restaurar y Eliminar permanentemente son accesibles desde la página de Proyectos (consulta Vista de tarjeta 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:

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

Solución de problemas

Las razones comunes por las que puede que no puedas 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 puede ser eliminado e incluye los nombres y entornos de los proyectos transferidos que impiden la eliminación:

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 pueden ser movidos 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:

• La operación (ver estado de la operación en Lienzo de diseño).
• La tabla de registro de operaciones.
• La página de Tiempo de ejecución de la Consola de administración.