Transferir (migrar) un proyecto a un entorno en Jitterbit Studio

Introducción

La transferencia de proyectos mueve proyectos entre entornos dentro de una sola organización de Harmony. Esta función ayuda a promover cambios de diseño a través de su ciclo de vida de desarrollo. Utilice la transferencia de proyectos para mantener entornos de desarrollo, prueba y producción separados. La transferencia de proyectos garantiza un despliegue controlado de cambios.

La transferencia de proyectos proporciona un despliegue controlado al mover proyectos o componentes a través de etapas de desarrollo de manera planificada. Mantiene el aislamiento del entorno al mantener separados el desarrollo, la prueba y la producción. La transferencia de proyectos crea un registro de auditoría para rastrear el historial de transferencias para cumplir con las normativas.

Puede utilizar la transferencia de proyectos para lograr lo siguiente:

• Mover proyectos o componentes entre entornos en la misma organización.
• Promover cambios a través de las etapas de desarrollo.
• Mantener configuraciones específicas del entorno.
• Preservar el historial de transferencias y dependencias.

Puede transferir proyectos utilizando cualquiera de estas dos opciones:

1. Transferencia de proyecto completo: Transfiera todo el proyecto a un entorno. (Esta opción aparece como Migrar en la interfaz actual.)

2. Transferencia selectiva: Transfiera solo los componentes especificados a un entorno.

La siguiente tabla compara las características clave de cada opción de transferencia:

Prerrequisitos

Antes de transferir un proyecto o componente de proyecto, completa estos requisitos:

• Asegúrate de tener el acceso apropiado en ambos entornos, el de origen y el de destino.

• Verifica que el entorno de destino tenga el tipo de agente necesario (en la nube o privado) si utilizas funciones que están limitadas a un cierto tipo de agente.

Cadenas de transferencia

Una cadena de transferencia es una secuencia vinculada de entornos a través de los cuales un proyecto se mueve durante su ciclo de vida. Una vez establecidas, estas cadenas crean dependencias que debes gestionar cuidadosamente.

Flujo de transferencia típico

Un flujo de trabajo típico implica estos pasos:

[Desarrollo] → [QA/Pruebas] → [Producción]
     ↓               ↓               ↓
  (Crear)      (Probar/Corregir)      (Entrar en Vivo)

1. Crea un proyecto en un entorno de desarrollo.
2. Transfiere a un entorno de QA (Aseguramiento de Calidad) para pruebas.
3. Corrige cualquier problema en el entorno de desarrollo.
4. Transfiere al entorno de QA nuevamente para volver a probar.
5. Transfiere de QA a producción cuando esté listo.
6. Repite los pasos 3-5 para cambios continuos.

Las transferencias de proyectos se basan en IDs internos, no en nombres, por lo que los proyectos renombrados mantienen sus relaciones de transferencia.

Dependencias de cadena

La transferencia de proyectos crea estas dependencias permanentes entre proyectos:

• No se pueden eliminar proyectos si existen proyectos dependientes aguas abajo.

• Las cadenas no se pueden romper sin eliminar proyectos aguas abajo.

• Renombrar proyectos no afecta las relaciones de cadena.

Un proyecto transferido tiene una dependencia del proyecto del cual fue transferido. No se puede eliminar un proyecto al inicio de una cadena de transferencia hasta que se eliminen todos los proyectos más abajo en la cadena. Para más información, consulta Eliminar un proyecto en Creación y configuración de proyectos.

Solo se puede romper una cadena de transferencia eliminando proyectos más abajo en la cadena o exportando e importando el proyecto. Para más información, consulta Exportaciones e importaciones de proyectos. Renombrar un proyecto transferido no rompe la cadena.

Mejores prácticas

Recomendamos estas mejores prácticas al diseñar una cadena de transferencia:

• Realiza cambios de diseño solo en el primer entorno de la cadena. En el ejemplo de flujo de transferencia típico, este es el entorno de desarrollo. En entornos posteriores, recomendamos que solo cambies los valores de las variables del proyecto. Realiza estos cambios dentro de la aplicación Studio para que aparezcan en el historial del proyecto. Los cambios en los valores de las variables del proyecto realizados desde la página Proyectos de la Consola de Administración no aparecen en el historial del proyecto. Durante la transferencia del proyecto, puedes seleccionar si transferir todos los valores de las variables del proyecto o solo los valores de variables del proyecto seleccionados (descritos en la siguiente sección).

• Haz que el primer entorno de la cadena sea accesible para aquellos que puedan necesitar realizar cambios en el proyecto con el tiempo. Recomendamos no permitir que un solo desarrollador diseñe el proyecto en una organización personal. Si esto sucede, primero exporta el proyecto original y luego impórtalo en el entorno que iniciará la cadena. Realiza futuros cambios en el proyecto en el entorno que inicia la cadena.

Transferencia de proyectos

Se pueden transferir proyectos utilizando cualquiera de estas dos opciones:

1. Transferencia completa del proyecto: Transfiere todo el proyecto a un entorno. (Esta opción aparece como Migrar en la interfaz actual.)
2. Transferencia selectiva: Transfiere solo los componentes especificados a un entorno.

Transferir un proyecto completo

Cuando se transfiere un proyecto completo utilizando la opción Migrar, se transfieren todos los componentes del proyecto y los metadatos del proyecto.

La opción Migrar es accesible desde estas ubicaciones:

• La barra de herramientas del proyecto. Para más información, consulte el menú de acciones del proyecto en la barra de herramientas del proyecto.
• El lienzo de diseño. Para más información, consulte el menú de acciones de desplegar/migrar en el lienzo de diseño.

Cuando seleccione Migrar, se abrirá una pantalla de configuración. Puede elegir el entorno objetivo y si desea transferir los valores de las variables del proyecto:

• Organización y Proyecto: La organización Harmony donde reside el proyecto y el nombre del proyecto que se va a transferir, separados por una coma.

• Entorno actual y Entorno objetivo: El entorno actual donde reside el proyecto y el entorno objetivo al que se transferirá el proyecto se enumeran junto con su tipo de grupo de agentes asociado (grupo de agentes en la nube o agente privado).

  Cuando se transfiere el proyecto, el proyecto existente en el entorno actual permanece sin cambios. Si el proyecto ya ha sido transferido al entorno objetivo, el proyecto del entorno objetivo se sobrescribe utilizando las selecciones para los valores de las variables del proyecto a continuación.

  Advertencia

  Si el proyecto fuente utiliza conectores que están disponibles solo en agentes privados, no se puede transferir a un entorno asociado con un grupo de agentes en la nube. Estos entornos aún aparecen en el menú desplegable de Entorno objetivo, pero no se pueden seleccionar.

• Nombre de la etiqueta del historial del proyecto: Ingrese una etiqueta para etiquetar el evento de transferencia. La etiqueta aparece como una etiqueta en el evento de transferencia y se registra en los detalles de implementación accesibles desde el historial del proyecto. Se recomienda ingresar una etiqueta única, pero no es obligatorio.

• Puntos finales globales: Cualquier punto final global utilizado por el proyecto que se está transfiriendo y que no existe en el entorno objetivo se enumera. Cuando se transfiere el proyecto, el punto final global se agrega a ese entorno y necesita configuración después de la transferencia.

• Migrar todos los valores de las variables: Seleccione esta opción para transferir todos los valores de las variables del proyecto. Si el proyecto ya existe en el entorno objetivo, los valores de todas las variables del proyecto reemplazan las variables del proyecto existentes. La primera vez que se transfiere un proyecto, esta opción se selecciona de forma predeterminada. Las transferencias posteriores se predeterminan a Seleccionar valores de variables para migrar.

• Seleccionar valores de variables para migrar: Seleccione esta opción para transferir todos los componentes del proyecto y los metadatos del proyecto, excepto los valores de las variables del proyecto que se enumeran bajo Excluir. Si el proyecto ya existe en el entorno de destino, todos los componentes del proyecto, incluidos los valores de las variables del proyecto que se enumeran bajo Incluir, se reemplazan.

  Cuando se selecciona Seleccionar valores de variables para migrar, no se seleccionan variables del proyecto para la transferencia de forma predeterminada, a menos que el proyecto ya exista en el entorno de destino. Cuando el proyecto ya ha sido transferido, las variables del proyecto que se han agregado o renombrado se seleccionan para la transferencia de forma predeterminada, pero las variables cuyos valores han cambiado se excluyen.

  • Buscar: Ingrese cualquier parte del nombre de una variable del proyecto para filtrar la lista de variables del proyecto en el entorno actual.
  • Entorno actual: Seleccione las variables del proyecto cuyos valores desea transferir al entorno de destino. A medida que selecciona variables del proyecto, aparecen bajo Incluir. Los enlaces Seleccionar todo y Deseleccionar todo agregan o eliminan todas las selecciones de variables del proyecto a la vez.
  • Excluir: Variables del proyecto cuyos valores están excluidos de la transferencia. Si el proyecto ya existe en el entorno de destino y ya contiene la variable del proyecto, su valor existente en el entorno de destino se mantiene. Si la variable del proyecto no existe, entonces el componente de la variable del proyecto se transfiere pero no se le asigna ningún valor.
  • Incluir: Variables del proyecto cuyos valores están incluidos en la transferencia. Si el proyecto ya existe en el entorno de destino y ya contiene la variable del proyecto, su valor existente en el entorno de destino se sobrescribe.

• Migrar: Haga clic para transferir el proyecto al entorno seleccionado. Si el proyecto ya ha sido transferido al entorno de destino, un mensaje le pide que confirme que desea transferir. Esta transferencia sobrescribe el proyecto existente en el entorno de destino utilizando las selecciones para los valores de las variables del proyecto anteriores.

  Texto del diálogo

  Confirmar migración
  Ya existe un proyecto con el mismo nombre en el entorno de destino. ¿Está seguro de que desea sobrescribirlo?

  Cuando haga clic en Continuar, si la transferencia al entorno de destino tiene éxito, el proyecto transferido se abrirá en el diseñador de proyectos.

Transferencia selectiva

La transferencia selectiva le permite transferir solo componentes específicos de un proyecto. Esta función ayuda a evitar interferir con el trabajo que otros colaboradores están realizando en el mismo proyecto y entorno. Utilice la transferencia selectiva cuando desee promover sus cambios sin sobrescribir el trabajo de otros usuarios en el entorno de destino.

Para transferir solo componentes específicos de un proyecto, utilice el menú de acciones del proyecto o el menú de acciones de operación en un proyecto y haga clic en Transferencia Selectiva:

Paso 1: Seleccionar entorno de destino y etiqueta

En este paso, seleccione un entorno de destino y especifique una etiqueta.

• Proyecto fuente: Se muestra el nombre y el entorno de su proyecto actual.

• Entorno de destino: Elija el entorno donde desea transferir los componentes seleccionados.

• Nombre de la etiqueta del historial del proyecto: Ingresa un nombre de etiqueta para identificar la transferencia en el historial del proyecto.

• Comentario: Agrega un comentario opcional que describa los cambios o el propósito de esta transferencia.

• Siguiente: Haz clic para proceder a la selección de componentes.

• Cancelar: Cancela la transferencia y regresa al proyecto.

Paso 2: Seleccionar componentes adicionales

En este paso, puedes seleccionar componentes individuales según tus necesidades. Cuando seleccionas componentes para transferir, el sistema incluye automáticamente las dependencias requeridas.

Los componentes listados en el lado objetivo de la pantalla muestran la etiqueta de la última transferencia en la que fueron incluidos.

Los componentes se agrupan según su estado en los entornos de origen y destino:

• Crear: Componentes que existen en el proyecto de origen pero no en el proyecto de destino. Cuando se seleccionan, estos componentes se crean en el proyecto de destino.

• Sobrescribir: Componentes que existen en ambos proyectos pero tienen contenido diferente según la fecha de última modificación y la comparación de usuarios. Cuando se seleccionan, estos componentes se reemplazan en el proyecto de destino.

• Eliminar: Componentes que existen en el proyecto de destino pero no en el proyecto de origen. Cuando se seleccionan, estos componentes se eliminan del proyecto de destino.

• Sin cambios: Componentes que existen en ambos proyectos y tienen el mismo contenido según la fecha de última modificación y la comparación de usuarios. Estos componentes no se pueden seleccionar.

Puedes seleccionar o deseleccionar componentes en las categorías Crear, Sobrescribir y Eliminar para configurar tu transferencia.

• Mostrar: Mostrar datos ocultos de Última Modificación. Haz clic para mostrar esta información.

• Ocultar: Ocultar los datos visibles de Última Modificación. Haz clic para ocultar esta información.

• Prev: Regresar al paso anterior.

• Next: Proceder al siguiente paso.

• Transfer: Deshabilitado a menos que todos los pasos en la configuración de transferencia se hayan completado. Cuando está habilitado, haz clic para iniciar el proceso de transferencia con los componentes y la configuración seleccionados. Cuando la transferencia esté completa, aparece un cuadro de diálogo de confirmación con una opción para abrir el proyecto en el entorno de destino.

• Cancel: Cancelar la transferencia y regresar al proyecto.

Step 3: Configurar variables

En este paso, puedes gestionar cómo se transfieren las variables del proyecto al entorno de destino.

Las variables del proyecto se agrupan según su estado en los entornos de origen y destino:

• Crear: Variables del proyecto que existen en el proyecto de origen pero no en el proyecto de destino. Cuando se seleccionan, estas variables del proyecto se crean en el proyecto de destino.

• Sobrescribir: Variables del proyecto que existen en ambos proyectos pero tienen contenido diferente según la fecha de última modificación y la comparación de usuarios. Cuando se seleccionan, estas variables se reemplazan en el proyecto de destino.

• Eliminar: Variables del proyecto que existen en el proyecto de destino pero no en el proyecto de origen. Cuando se seleccionan, estas variables del proyecto se eliminan del proyecto de destino.

• Sin cambios: Variables del proyecto que existen en ambos proyectos y tienen el mismo contenido según la fecha de última modificación y la comparación de usuarios. Estas variables del proyecto no se pueden seleccionar.

Puedes seleccionar o deseleccionar variables del proyecto en las categorías Crear, Sobrescribir y Eliminar para configurar tu transferencia.

• Incluir valor predeterminado: Cuando se selecciona, esta opción reemplaza el valor de la variable del proyecto en el proyecto de destino con el valor predeterminado del proyecto de origen. Cuando se desmarca, el valor de la variable del proyecto no se reemplaza.

  Esta casilla de verificación se selecciona automáticamente cuando seleccionas una variable (individualmente o a través de Seleccionar todo). Cuando deseleccionas una variable, esta casilla de verificación se desmarca y se deshabilita.

• Mostrar: Mostrar datos ocultos de Última Modificación. Haga clic para mostrar esta información.

• Ocultar: Ocultar datos visibles de Última Modificación. Haga clic para ocultar esta información.

• Anterior: Regresar al paso anterior.

• Siguiente: Proceder al siguiente paso.

• Transferir: Deshabilitado a menos que todos los pasos hayan sido configurados. Cuando esté habilitado, haga clic para iniciar el proceso de transferencia con sus componentes y configuración seleccionados. Cuando la transferencia esté completa, aparece un cuadro de diálogo de confirmación con una opción para abrir el proyecto en el entorno de destino.

• Cancelar: Cancelar la transferencia y regresar al proyecto.

Paso 4: Configurar horarios

En este paso, configure cómo se transfieren los horarios para sus operaciones.

• Transferir configuraciones de horarios para operaciones: Active esta opción para habilitar o deshabilitar la transferencia de configuraciones de horarios. Cuando está habilitado, puede seleccionar horarios para transferir al proyecto de destino.

Los horarios están organizados en categorías según su acción de transferencia. Puede expandir un horario para ver a qué operaciones está asignado. Las operaciones marcadas con una etiqueta Asignado están actualmente asignadas a ese horario en el proyecto fuente.

• Crear: Horarios que existen en el proyecto fuente pero no en el proyecto de destino. Cuando se seleccionan, los horarios y sus asignaciones se crean en el proyecto de destino.

• Sobrescribir: Horarios que existen en ambos proyectos pero tienen contenido diferente basado en la fecha de última modificación y comparación de usuarios. Cuando se seleccionan, los horarios y sus asignaciones se reemplazan en el proyecto de destino.

• Eliminar: Horarios que existen en el proyecto de destino pero no en el proyecto fuente. Cuando se seleccionan, estos componentes se eliminan del proyecto de destino. Cuando se seleccionan, estos horarios se eliminan del proyecto de destino.

• Desasignar: Horarios que existen en ambos proyectos y han sido desasignados de operaciones en el proyecto fuente. Cuando se seleccionan, estos horarios se desasignan de operaciones para el proyecto de destino.

• Mostrar: Mostrar datos ocultos de Última Modificación. Haga clic para mostrar esta información.

• Ocultar: Ocultar datos visibles de Última Modificación. Haga clic para ocultar esta información.

• Prev: Regresar al paso anterior.

• Next: Proceder al siguiente paso.

• Transfer: Deshabilitado a menos que todos los pasos hayan sido configurados. Cuando esté habilitado, haga clic para iniciar el proceso de transferencia con sus componentes y configuración seleccionados. Cuando la transferencia esté completa, aparece un cuadro de diálogo de confirmación con una opción para abrir el proyecto en el entorno de destino.

• Cancel: Cancelar la transferencia y regresar al proyecto.