Historial del proyecto en Jitterbit Studio

Introducción

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

Acceder al historial del proyecto y snapshots

Se puede acceder al cajón de Historial del proyecto desde las siguientes ubicaciones:

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

El cajón contiene dos pestañas:

• Historial del proyecto: Muestra una lista de cambios e implementaciones 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 historial del proyecto

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

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

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 la cadena se resalta en azul.

  

• Menú de período de tiempo: Selecciona Últimos 30 días, Últimos 60 días, Últimos 90 días o Últimos 180 días.

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

  • Todos los eventos: Muestra todos los eventos del historial del proyecto con cualquier etiqueta.
  • Implementaciones: Muestra solo eventos de implementación.
  • Migraciones: Muestra solo transferencias completas de proyectos.
  • Importaciones: Muestra solo eventos de importación.
  • Transferencias: Muestra solo eventos de transferencia selectiva.
  • Etiquetados: Muestra 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 al encabezado de un día para expandir o contraer todos los eventos de ese día.

Los siguientes controles adicionales están disponibles:

• Expandir / Contraer todo: Expande o contrae todos los detalles del evento a la vez.
• Restaurar última versión implementada: Restaura el proyecto a la última implementación.
• Descargar como CSV: Descarga los datos del historial filtrado actual.

Tipos de evento

La siguiente tabla describe cada tipo de evento:

Información detallada de cambios

Para componentes de script, transformación, herramienta, notificación por 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 bajo 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 (mostrados 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 de campo de notificación por correo electrónico, como cambios de destinatario, asunto o mensaje.
• Cambios de configuración de operación, como cambios de programación, acción u opción.
• Cambios de campo de variable de proyecto, como cambios de valor predeterminado o descripción.
• Cambios de campo de configuración de actividad y punto de conexión de conector, incluidos cambios de campo 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 muestre 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"). Los siguientes controles están disponibles en la barra de título:

• 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 está disponible cuando la diferencia 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 cambiada 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 por 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 cambiado:

  

  Una fila cambiada tiene un tinte rojo en la columna Before y verde en la columna After, y los caracteres o palabras específicos que cambiaron dentro de un valor se resaltan más fuertemente. Los campos relacionados se agrupan bajo encabezados de sección, como las condiciones individuales de una herramienta Decision, los grupos de opciones anidados 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 mostrarse en la tabla, o cuyo valor es un objeto o matriz (mostrado como una cadena JSON), incluye un icono de expansión. Haz clic en el icono para abrir una comparación en línea del contenido de ese campo, mostrada como una comparación de código con líneas eliminadas resaltadas en rojo y líneas añadidas 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 añadidos al esquema se resaltan en verde.

Administrar snapshots

Los snapshots capturan el estado del proyecto en momentos específicos. Se crean snapshots automáticos 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 del 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 etiquetas 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 del proyecto 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 el control de versiones y la organización.

Requisitos de etiquetas

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 en la pestaña Deploy. Cuando está habilitado, ves un diálogo que solicita la etiqueta o comentario requerido cuando implementas el proyecto.

Añadir o editar etiquetas

Para añadir 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 una etiqueta única pero no es requerida).

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

4. Haz clic en Save.

Puedes editar etiquetas y comentarios que hayas añadido. Las etiquetas y comentarios añadidos por otros usuarios son de solo lectura.

Restaurar un proyecto

Las copias de seguridad del proyecto 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 de historial del proyecto, localiza el evento o snapshot que deseas restaurar.

2. Pasa 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 desplegar el estado restaurado.

Alternativamente, 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 ocurriera 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:

• Un diálogo informativo aparece 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.