Historial de proyectos en Jitterbit Studio

Introducción

Esta página describe cómo ver el historial de proyectos, gestionar snapshots y restaurar proyectos. El historial de proyectos se almacena durante un máximo de 180 días. Los snapshots permanecen disponibles indefinidamente. Al exportar un proyecto, se borran tanto el historial del proyecto como los snapshots de la versión exportada.

Acceder al historial de proyectos y snapshots

Se puede acceder al cajón Project history desde las siguientes ubicaciones:

• El lienzo de diseño (consulta Menú de acciones del lienzo de diseño).
• La página Projects (consulta Vista de tarjetas o Vista de lista).

El cajón contiene dos pestañas:

• Project history: Muestra una lista de cambios y despliegues del proyecto. Cada entrada incluye la fecha, hora y el usuario que realizó cada acción.
• Snapshots: Muestra una lista de snapshots creados automática o manualmente.

Ver el historial del proyecto

Los eventos del historial de proyectos se agrupan por día en orden cronológico inverso. Cada evento se lista individualmente con su marca de tiempo y muestra el nombre y la inicial del apellido del usuario.

Los eventos de cambio de componentes muestran un icono que identifica el tipo de componente. Coloca el cursor sobre el icono para ver una información sobre herramientas que muestre el tipo (por ejemplo, "Script", "Global Variable" o "Transformation").

Filtrar historial

Los siguientes controles están disponibles para filtrar la vista del historial:

• Cuadro de búsqueda: Ingresa una palabra clave única o una cadena de palabras clave. Solo aparecen los eventos que contienen la cadena de palabras clave, y esta se resalta en azul.

  

• Menú de intervalo de tiempo: Selecciona Last 30 days, Last 60 days, Last 90 days o Last 180 days.

• Menú de tipo de evento: Selecciona qué tipos de evento deseas mostrar. Las siguientes opciones están disponibles:

  • All events: Muestra todos los eventos del historial de proyectos con cualquier etiqueta.
  • Deploys: Muestra solo los eventos de despliegue.
  • Migrations: Muestra solo las transferencias de proyectos completas.
  • Imports: Muestra solo los eventos de importación.
  • Transfers: Muestra solo los eventos de transferencia selectiva.
  • Tagged: Muestra los eventos que han sido etiquetados.

Ver detalles del evento

Para ver o contraer los detalles del evento, haz clic en el símbolo de intercalación junto a un encabezado de día para expandir o contraer todos los eventos de ese día.

Los siguientes controles adicionales están disponibles:

• Expand / Collapse all: Expande o contrae todos los detalles del evento a la vez.
• Restore last deployed version: Restaura el proyecto a la última versión desplegada.
• Download as CSV: Descarga los datos del historial filtrado actual.

Tipos de evento

En la siguiente tabla se describe cada tipo de evento:

Información detallada de cambios

Para componentes de script, transformación, herramienta, notificación de correo electrónico, operación, variable de proyecto y configuración de actividad y punto de conexión de conector, la información detallada de cambios se muestra de forma predeterminada como puntos de viñeta anidados debajo de la entrada del evento de cambio:

Los cambios detallados pueden incluir lo siguiente:

• Cambios de tipo de script (por ejemplo, "Script type was changed from JavaScript to Jitterbit Script").
• Cambios de contenido de script (se muestran como "Script body was changed").
• Cambios de mapeo de transformación.
• Cambios de configuración de herramienta, como campos de condición, operadores y valores de una herramienta Decision.
• Cambios en campos de notificación de correo electrónico, como cambios en destinatario, asunto o mensaje.
• Cambios en la configuración de operación, como cambios en programación, acción u opción.
• Cambios en campos de variable de proyecto, como cambios en valor predeterminado o descripción.
• Cambios en campos de configuración de actividad y punto de conexión de conector, incluidos cambios en campos de autenticación (por ejemplo, "Authentication type changed").
• Otras actualizaciones de configuración directa.

Comparar cambios

Para eventos de cambio que incluyen actualizaciones de contenido o configuración, aparece un icono View changes junto a la entrada de detalle de cambio. Haz clic en View changes para abrir una vista de diferencias que muestra el contenido o la configuración del componente antes y después del cambio.

La barra de título de la vista de diferencias muestra la marca de tiempo del evento, el tipo de componente y el nombre del componente (por ejemplo, "7:06am Script: Fine Tune Data"). En la barra de título se encuentran disponibles los siguientes controles:

• Pop-out: Abre la vista de diferencias en una nueva ventana emergente.

• Maximize / Restore: Expande la vista de diferencias para llenar el espacio de pantalla disponible o la devuelve a su tamaño predeterminado.

• Close: Cierra la vista de diferencias.

Puedes arrastrar la vista de diferencias por su barra de título para reposicionarla en cualquier lugar de la pantalla, y redimensionarla arrastrando sus bordes o esquinas. Una barra de desplazamiento vertical se encuentra disponible cuando la vista de diferencias contiene muchos cambios.

La vista de diferencias utiliza uno de los siguientes formatos, según el tipo de componente:

• Vista de diferencias de código: Se utiliza para scripts y transformaciones. Muestra dos paneles uno al lado del otro:

  • Panel izquierdo: Muestra la versión anterior del contenido. Las líneas eliminadas se resaltan en rojo.

  • Panel derecho: Muestra la versión actualizada del contenido. Las líneas agregadas se resaltan en verde.

  Para transformaciones, cada regla de mapeo modificada aparece como una sección contraíble etiquetada con la ruta del campo (por ejemplo, "Mapping rule json/isActive"). Haz clic en el símbolo de intercalación para expandir o contraer secciones individuales.

• Vista de comparación de campos: Se utiliza para herramientas, notificaciones de correo electrónico, operaciones (incluidas sus programaciones, acciones y opciones), variables de proyecto, puntos de conexión de conector y actividades de conector. Muestra una tabla con columnas Name, Before y After que enumeran cada campo modificado:

  

  Una fila modificada se tiñe de rojo en la columna Before y verde en la columna After, y los caracteres o palabras específicas que cambiaron dentro de un valor se resaltan con mayor intensidad. Los campos relacionados se agrupan bajo encabezados de sección, como las condiciones individuales de una herramienta Decision, los grupos de opciones anidadas de un punto de conexión de conector o los pasos de una actividad de conector. Un campo cuyo valor hace referencia a una variable de proyecto o variable global se muestra como una referencia vinculada que muestra el nombre de la variable en lugar de su valor literal. Un campo de credencial, como una contraseña o token de seguridad, se enmascara en las columnas Before y After.

Un campo cuyo nombre o valor es demasiado largo para mostrar en la tabla, o cuyo valor es un objeto o arreglo (mostrado como una cadena JSON), incluye un icono de expansión. Haz clic en el icono para abrir una comparación insertada del contenido de ese campo, mostrada como una diferencia de código con líneas eliminadas resaltadas en rojo y líneas agregadas resaltadas en verde.

Para una actividad de conector que consulta o recupera datos, un campo Response puede mostrar el esquema de respuesta como un árbol expandible. Los campos agregados al esquema se resaltan en verde.

Administrar snapshots

Los snapshots capturan el estado de tu proyecto en momentos específicos. Los snapshots automáticos se crean durante implementaciones, transferencias e importaciones. También puedes crear snapshots manuales.

Crear un snapshot manual

Para crear un snapshot, completa estos pasos:

1. Abre la pestaña Snapshots en el panel de historial del proyecto.

2. Haz clic en el icono Create snapshot.

3. El diálogo New snapshot incluye los siguientes campos:

   

   • Tag: Ingresa una etiqueta única para etiquetar el snapshot (requerido).
   • Description: Ingresa una descripción opcional.

4. Haz clic en Save.

Los snapshots se almacenan indefinidamente.

Filtrar snapshots

Los siguientes controles están disponibles en la pestaña Snapshots:

• Search by tag: Ingresa nombres de etiqueta para encontrar snapshots específicos.

• Type menu: Filtra por snapshots Automatic o Manual:

  • Automatic: Los snapshots automáticos se capturan durante estos eventos:

    • Deployment: El diseñador de proyectos en el momento de la implementación.
    • Transfer or migration: El diseñador del proyecto de destino antes de que se aplique la transferencia o migración.
    • Import: El diseñador del proyecto antes de que se aplique la importación.

  • Manual: Snapshots creados manualmente.

Etiquetar eventos y snapshots

Los eventos de transferencia, implementación y restauración pueden incluir etiquetas y comentarios para versionado y organización.

Requisitos de etiqueta

Los eventos de transferencia deben etiquetarse desde la pantalla de transferencia del proyecto antes de que se pueda transferir el proyecto.

Los eventos de implementación se pueden configurar para requerir etiquetas o comentarios. Para requerir etiquetas o comentarios en el momento de la implementación, habilita Require tags when deploying en la configuración del proyecto, pestaña Deploy. Cuando está habilitado, ves un diálogo que solicita la etiqueta o comentario requerido cuando implementas el proyecto.

Agregar o editar etiquetas

Para agregar o editar una etiqueta, completa estos pasos:

1. Pasa el cursor sobre el evento o snapshot.

2. Haz clic en Details.

3. El diálogo incluye los siguientes campos:

   

   • Tag: Ingresa una etiqueta (se recomienda etiqueta única pero no es requerida).

   • Comment (eventos) o Description (snapshots): Ingresa información adicional.

4. Haz clic en Save.

Puedes editar las etiquetas y comentarios que agregaste. Las etiquetas y comentarios agregados por otros usuarios son de solo lectura.

Restaurar un proyecto

Los respaldos de proyectos se crean automáticamente cuando se transfiere, implementa o restaura un proyecto.

Restaurar a una versión específica

Para restaurar un proyecto, completa estos pasos:

1. En el cajón del historial del proyecto, localiza el evento o snapshot que deseas restaurar.

2. Coloca el cursor sobre el evento o snapshot.

3. Haz clic en Restaurar esta versión.

4. En el diálogo de confirmación, haz clic en Restaurar.

El diseñador de proyectos revierte a la versión seleccionada. Esta acción no afecta la versión implementada. Reimplementa el proyecto para implementar el estado restaurado.

Como alternativa, puedes restaurar tu proyecto a la última versión implementada usando el icono Restaurar última versión implementada (descrito arriba).

Restaurar proyectos dañados

Si un proyecto está dañado y no se puede abrir, puedes acceder al historial del proyecto desde el menú de acciones del proyecto en la página Proyectos y restaurar el proyecto a un estado anterior antes de que ocurra el daño.

Colaborar durante la restauración

Cuando varios usuarios trabajan en el mismo proyecto simultáneamente y alguien restaura el proyecto, ocurre lo siguiente:

• Aparece un diálogo informativo para todos los usuarios activos.
• Cerrar el diálogo actualiza su vista para reflejar el estado del proyecto restaurado.

Este comportamiento evita cambios inesperados en las sesiones de trabajo activas sin previo aviso.