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

Introducción

La transferencia de proyectos mueve proyectos entre entornos dentro de una única organización de Harmony. Esta función te ayuda a promover cambios de diseño a través de tu ciclo de vida de desarrollo. Usa la transferencia de proyectos para mantener entornos separados de desarrollo, pruebas y producción. La transferencia de proyectos garantiza una implementación controlada de cambios.

La transferencia de proyectos proporciona una implementación controlada 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, las pruebas y la producción. La transferencia de proyectos crea un registro de auditoría para rastrear el historial de transferencias con fines de cumplimiento.

Puedes usar 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 etapas de desarrollo.
• Mantener configuraciones específicas del entorno.
• Preservar el historial de transferencias y las dependencias.

Para mover proyectos entre organizaciones, consulta Exportaciones e importaciones de proyectos.

Puedes transferir proyectos usando cualquiera de estas dos opciones:

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

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

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

Puedes transferir proyectos o componentes independientemente de si han sido implementados o no.

Requisitos previos

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

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

• Verifica que el entorno de destino tenga el tipo de agente necesario (nube o privado) si usas funciones limitadas a un tipo de agente específico.

Cadenas de transferencia

Una cadena de transferencia es una secuencia vinculada de entornos a través de los cuales se mueve un proyecto 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:

[Development] → [QA/Testing] → [Production]
     ↓               ↓               ↓
  (Create)      (Test/Fix)      (Go Live)

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 repruebas.
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 en 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 desde el cual se transfirió. 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 obtener 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 obtener más información, consulta Exportaciones e importaciones de proyectos. Renombrar un proyecto transferido no rompe la cadena. Solo las exportaciones e importaciones de proyectos pueden crear copias independientes.

Mejores prácticas

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

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

• Haz que el primer ambiente de la cadena sea accesible para quienes puedan necesitar hacer cambios al proyecto con el tiempo. Recomendamos no tener un solo desarrollador diseñando el proyecto en una organización personal. Si esto sucede, primero exporta el proyecto original e importalo al ambiente que iniciará la cadena. Realiza cambios futuros al proyecto en el ambiente que inicia la cadena.

Transferencia de proyectos

Puedes transferir proyectos usando cualquiera de estas dos opciones:

1. Transferencia de proyecto completo: Transferir el proyecto completo a un ambiente. (Esta opción aparece como Migrar en la interfaz actual.)
2. Transferencia selectiva: Transferir solo componentes especificados a un ambiente.

Transferir un proyecto completo

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

Cuando se transfiere un proyecto a otro entorno, todos los roles de los que es miembro el usuario que realiza la transferencia y que tienen acceso al entorno de destino se habilitan de forma predeterminada en la pestaña Roles de usuario del proyecto de destino. Al transferir a un proyecto existente, esos roles se habilitan además de cualquier rol ya habilitado en el proyecto de destino.

La opción Migrate es accesible desde estas ubicaciones:

• La barra de herramientas del proyecto. Para obtener más información, consulta Menú de acciones del proyecto en Barra de herramientas del proyecto.
• El lienzo de diseño. Para obtener más información, consulta Menú de acciones Implementar/migrar en Lienzo de diseño.

Al seleccionar Migrate, se abre una pantalla de configuración. Puedes elegir el entorno de destino y si deseas transferir los valores de variables de proyecto individuales:

• Organization y Project: La organización de Harmony donde reside el proyecto y el nombre del proyecto a transferir, separados por una coma.

• Current environment y Target environment: Se enumeran el entorno actual donde reside el proyecto y el entorno de destino donde se transferirá el proyecto, junto con su tipo de grupo de agentes asociado (agente 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 se ha transferido al entorno de destino, el proyecto del entorno de destino se sobrescribe utilizando las selecciones para los valores de variables de proyecto que se indican a continuación.

  Precaución

  Si el proyecto de origen utiliza conectores que solo están disponibles en agentes privados, no puedes transferirlo a un entorno asociado con un grupo de agentes en la nube. Estos entornos aún aparecen en el menú desplegable Target Environment, pero no se pueden seleccionar.

• Project history tag name: Ingresa una etiqueta para identificar 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.

• Global Endpoints: Se enumeran los puntos de conexión globales utilizados por el proyecto que se transfiere y que no existen en el entorno de destino. Cuando se transfiere el proyecto, el punto de conexión global se agrega a ese entorno y requiere configuración después de la transferencia.

• Migrate all variable values: Selecciona esta opción para transferir todos los valores de variables de proyecto. Si el proyecto ya existe en el entorno de destino, los valores de todas las variables de proyecto reemplazan las variables de proyecto existentes. La primera vez que se transfiere un proyecto, esta opción está seleccionada de forma predeterminada. Las transferencias posteriores tienen como valor predeterminado Select variable values to migrate.

• Select variable values to migrate: Selecciona esta opción para transferir todos los componentes del proyecto y metadatos del proyecto, excepto los valores de las variables de proyecto enumeradas en Exclude. Si el proyecto ya existe en el entorno de destino, todos los componentes del proyecto, incluidos los valores de las variables de proyecto enumeradas en Include, se reemplazan.

  Cuando se selecciona Select variable values to migrate, ninguna variable de proyecto se selecciona para transferencia de forma predeterminada a menos que el proyecto ya exista en el entorno de destino. Cuando el proyecto ya se ha transferido, las variables de proyecto nuevas o renombradas se seleccionan para transferencia de forma predeterminada, pero se excluyen las variables cuyos valores han sido modificados.

  • Search: Ingresa cualquier parte del nombre de una variable de proyecto para filtrar la lista de variables de proyecto en el entorno actual.
  • Current environment: Selecciona las variables de proyecto cuyos valores deseas transferir al entorno de destino. A medida que seleccionas variables de proyecto, aparecen en Include. Los enlaces Select all y Deselect all agregan o borran todas las selecciones de variables de proyecto a la vez.
  • Exclude: Variables de proyecto cuyos valores se excluyen de la transferencia. Si el proyecto ya existe en el entorno de destino y ya contiene la variable de proyecto, se conserva su valor existente en el entorno de destino. Si la variable de proyecto aún no existe, el componente de variable de proyecto se transfiere pero no se le asigna ningún valor.
  • Include: Variables de proyecto cuyos valores se incluyen en la transferencia. Si el proyecto ya existe en el entorno de destino y ya contiene la variable de proyecto, su valor existente en el entorno de destino se sobrescribe.

• Migrar: Haz clic para transferir el proyecto al ambiente seleccionado. Si el proyecto ya ha sido transferido al ambiente destino, un mensaje te pide que confirmes que deseas transferir. Esta transferencia sobrescribe el proyecto existente en el ambiente destino usando las selecciones de valores de variables de proyecto anteriores.

  Texto del diálogo

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

  Cuando hagas clic en Continuar, si la transferencia al ambiente destino es exitosa, el proyecto transferido se abre en el diseñador de proyectos.

Transferencia selectiva

La transferencia selectiva te permite transferir solo componentes especificados de un proyecto. Esta función te ayuda a evitar interferir con el trabajo que otros colaboradores están realizando en el mismo proyecto y ambiente. Usa la transferencia selectiva cuando desees promover tus cambios sin sobrescribir el trabajo de otros usuarios en el ambiente destino.

Cuando se transfiere un proyecto a otro ambiente, todos los roles de los que es miembro el usuario que realiza la transferencia y que tienen acceso al ambiente destino se habilitan de forma predeterminada en la pestaña Roles de usuario del proyecto destino. Al transferir a un proyecto existente, esos roles se habilitan además de cualquier rol ya habilitado en el proyecto destino.

Para transferir solo componentes especificados de un proyecto, usa el menú de acciones del proyecto o el menú de acciones de operaciones en un proyecto y haz clic en Transferencia selectiva:

Paso 1: Selecciona el ambiente destino y la etiqueta

En este paso, selecciona un ambiente destino y especifica una etiqueta.

• Proyecto de origen: Se muestra el nombre y el ambiente de tu proyecto actual.

• Ambiente destino: Elige el ambiente donde deseas transferir los componentes seleccionados.

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

• Comentario: Agrega un comentario opcional describiendo 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: Selecciona componentes adicionales

En este paso, puedes seleccionar componentes individuales según tus necesidades.

Los componentes que se muestran en el lado destino 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 ambientes de origen y destino:

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

Una nueva operación se añade al lienzo de diseño del proyecto destino en la misma posición relativa respecto a sus operaciones vecinas que en el proyecto origen. Por ejemplo, si las operaciones A, C y B existen en ese orden en el proyecto origen, y el proyecto destino contiene A y B pero no C, transferir C la coloca inmediatamente después de A y antes de B. Cualquier cadena de operaciones que conecte la operación transferida con otras operaciones, como On Success, On Fail, On SOAP Fault, o enlaces de función RunOperation, se preservan en el proyecto 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 selecciona, estos componentes se reemplazan en el proyecto destino.

  Un icono Ver cambios aparece junto a las filas de componentes de script, transformación, punto de conexión del conector y actividad del conector. Haz clic en él para abrir una vista de diferencias que muestre una comparación lado a lado del contenido del componente antes y después del cambio. Los siguientes controles están disponibles en la barra de título de la vista de diferencias:

  • Expandir: Abre la vista de diferencias en una nueva ventana emergente. Haz clic de nuevo para devolverla a la posición insertada.
  • Maximizar / Restaurar: Expande la vista de diferencias para llenar el espacio de pantalla disponible o la devuelve a su tamaño predeterminado.
  • Cerrar: Cierra la vista de diferencias.

  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. La vista de diferencias muestra dos paneles lado a lado:

    

    Las líneas eliminadas se resaltan en rojo (panel izquierdo) y las líneas añadidas se resaltan en verde (panel derecho). Para transformaciones, cada regla de asignación modificada aparece como una sección contraíble etiquetada con la ruta del campo (por ejemplo, "Regla de asignación json/isActive"). Haz clic en el símbolo de intercalación para expandir o contraer secciones individuales.

  • Vista de diferencias de comparación de campos: Se utiliza para puntos de conexión del conector y actividades del conector. La vista de diferencias muestra una tabla con columnas Nombre, Antes y Después que enumeran cada campo modificado:

    

    Los valores de campo modificados se resaltan en rojo (columna Antes) y verde (columna Después), y los valores sensibles como contraseñas se enmascaran. La barra de título de la vista de diferencias muestra el tipo y nombre del componente (por ejemplo, "Punto de conexión: HTTP v2" o "Actividad: GET").

    Nota

    Las filas mostradas para una actividad del conector reflejan sus propiedades de configuración subyacentes, que no siempre se alinean uno a uno con las pantallas de configuración basadas en pasos de la actividad. Por ejemplo, la actividad Query de Salesforce presenta varios pasos de configuración que todos actualizan una única propiedad de consulta subyacente, por lo que editar campos en varios pasos de la actividad puede aparecer como una única fila modificada en la diferencia.

• Eliminar: Componentes que existen en el proyecto destino pero no en el proyecto origen. Cuando se selecciona, estos componentes se eliminan del proyecto 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.

• Seleccionar dependencias automáticamente: Activa esta opción para controlar cómo se manejan las dependencias de componentes durante la transferencia. Cuando está habilitada (predeterminado), seleccionar un componente selecciona automáticamente todas sus dependencias requeridas, que no se pueden deseleccionar individualmente. Cuando está deshabilitada, puedes seleccionar componentes individuales sin incluir automáticamente sus dependencias.

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

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

• Anterior: Regresa al paso anterior.

• Siguiente: Continúa al siguiente paso.

• Transferir: Se encuentra deshabilitado a menos que se hayan completado todos los pasos en la configuración de transferencia. Cuando se habilita, haz clic para iniciar el proceso de transferencia con tus componentes y configuración seleccionados. Cuando se completa la transferencia, aparece un diálogo de confirmación con una opción para abrir el proyecto en el entorno de destino.

• Cancelar: Cancela la transferencia y regresa al proyecto.

Paso 3: Configurar variables

En este paso, puedes administrar 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 deselecciona, el valor de la variable del proyecto no se reemplaza.

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

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

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

• Anterior: Regresa al paso anterior.

• Siguiente: Continúa al siguiente paso.

• Transferir: Se encuentra deshabilitado a menos que se hayan configurado todos los pasos. Cuando se habilita, haz clic para iniciar el proceso de transferencia con tus componentes y configuración seleccionados. Cuando se completa la transferencia, aparece un diálogo de confirmación con una opción para abrir el proyecto en el entorno de destino.

• Cancelar: Cancela la transferencia y regresa al proyecto.

Paso 4: Configurar programaciones

En este paso, configura cómo se transfieren las programaciones para tus operaciones.

• Transferir configuración de programación para operaciones: Activa o desactiva esta opción para habilitar o deshabilitar la transferencia de configuraciones de programación. Cuando se habilita, puedes seleccionar programaciones para transferir al proyecto de destino.

Las programaciones se organizan en categorías según su acción de transferencia. Puedes expandir una programación para ver a qué operaciones está asignada. Las operaciones marcadas con una etiqueta Asignada están actualmente asignadas a esa programación en el proyecto de origen.

• Crear: Programaciones que existen en el proyecto de origen pero no en el proyecto de destino. Cuando se seleccionan, las programaciones y sus asignaciones se crean en el proyecto de destino.

• Sobrescribir: Programaciones 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, las programaciones y sus asignaciones se reemplazan en el proyecto de destino.

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

• Desasignar: Programaciones que existen en ambos proyectos y han sido desasignadas de operaciones en el proyecto de origen. Cuando se seleccionan, estas programaciones se desasignan de operaciones para el proyecto de destino.

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

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

• Anterior: Regresa al paso anterior.

• Siguiente: Continúa al siguiente paso.

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

• Cancelar: Cancela la transferencia y regresa al proyecto.