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

Introducción

La transferencia de proyectos mueve proyectos entre ambientes dentro de una sola 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 ambientes 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 ambiente al mantener el desarrollo, las pruebas y la producción separados. La transferencia de proyectos crea un registro de auditoría para rastrear el historial de transferencias con propósitos de cumplimiento.

Puedes usar la transferencia de proyectos para lograr lo siguiente:

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

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

Para mover un proyecto junto con la API personalizada que lo usa, consulta Incluir proyectos de Studio vinculados en Exportar e importar APIs en API Manager.

Puedes transferir proyectos usando cualquiera de estas dos opciones:

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

2. Transferencia selectiva: Transferir solo componentes especificados a un ambiente.

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

Puedes transferir proyectos o componentes tanto si han sido implementados como si no.

Requisitos previos

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

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

• Verifica que el ambiente de destino tenga el tipo de agente necesario (nube o privado) si usas características que se limitan a un cierto tipo de agente.

Cadenas de transferencia

Una cadena de transferencia es una secuencia vinculada de ambientes 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 con cuidado.

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 ambiente de desarrollo.
2. Transfiere a un ambiente de QA (Aseguramiento de Calidad) para pruebas.
3. Corrige cualquier problema en el ambiente de desarrollo.
4. Transfiere al ambiente de QA nuevamente para repruebas.
5. Transfiere de QA a producción cuando esté listo.
6. Repite los pasos 3-5 para cambios futuros.

Las transferencias de proyecto 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 proyecto crea estas dependencias permanentes entre proyectos:

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

• No se pueden interrumpir cadenas sin eliminar proyectos aguas abajo.

• Renombrar proyectos no afecta las relaciones de cadena.

Un proyecto transferido tiene una dependencia del proyecto desde el que se transfirió. No puedes eliminar un proyecto al inicio de una cadena de transferencia hasta que elimines todos los proyectos más adelante en la cadena. Para obtener más información, consulta Eliminar un proyecto en Creación y configuración de proyectos.

Solo puedes interrumpir una cadena de transferencia eliminando proyectos aguas abajo o exportando e importando el proyecto. Para obtener más información, consulta Exportaciones e importaciones de proyectos. Renombrar un proyecto transferido no interrumpe la cadena. Solo las exportaciones e importaciones de proyectos pueden crear copias independientes.

Mejores prácticas

Te 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, te 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 de 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 proyecto, puedes seleccionar si deseas transferir todos los valores de variables de proyecto o solo valores de variables seleccionados (descrito en la siguiente sección).

• Haz que el primer ambiente de la cadena sea accesible para aquellos que puedan necesitar realizar cambios en el proyecto con el tiempo. Te recomendamos en contra de que un solo desarrollador diseñe el proyecto en una organización personal. Si esto ocurre, primero exporta el proyecto original e importarlo al ambiente que iniciará la cadena. Realiza cambios futuros al proyecto en el ambiente que inicia la cadena.

Transferencia de proyecto

Puedes transferir proyectos usando cualquiera de estas dos opciones:

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

Transferencia completa de proyecto

Cuando transfieres un proyecto completo usando la opción Migrar, se transfieren todos los componentes del proyecto y 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 Deploy/migrate 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 las variables de proyecto individuales:

• Organization y Project: La organización de Harmony donde reside el proyecto y el nombre del proyecto que se va 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 ha sido transferido al entorno de destino, el proyecto del entorno de destino se sobrescribe utilizando las selecciones para los valores de variables de proyecto a continuación.

  Precaución

  Si el proyecto de origen utiliza conectores que están disponibles solo 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 pueden ser seleccionados.

• Project history tag name: Introduce 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 introducir una etiqueta única, pero no es obligatorio.

• Global Endpoints: Se enumeran los extremos globales utilizados por el proyecto que se transfiere y que no existen en el entorno de destino. Cuando se transfiere el proyecto, el extremo global se añade a ese entorno y necesita 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 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 bajo Exclude. Si el proyecto ya existe en el entorno de destino, se reemplazan todos los componentes del proyecto, incluidos los valores de las variables de proyecto enumeradas bajo Include.

  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 ha sido transferido, las variables de proyecto recién añadidas o renombradas se seleccionan para transferencia de forma predeterminada, pero se excluyen las variables cuyos valores han sido modificados.

  • Search: Introduce 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. Al seleccionar variables de proyecto, aparecen bajo Include. Los enlaces Select all y Deselect all añaden o limpian todas las selecciones de variables de proyecto de una sola 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 no existe aún, entonces 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, aparece un mensaje pidiéndote que confirmes que deseas transferir. Esta transferencia sobrescribe el proyecto existente en el ambiente destino utilizando las selecciones de valores de variables del 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 específicos 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. Utiliza la transferencia selectiva cuando deseas 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 por defecto 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 específicos de un proyecto, utiliza el menú de acciones del proyecto o el menú de acciones de operación 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 origen: Se muestra el nombre y ambiente de tu proyecto actual.

• Ambiente origen: Muestra el ambiente desde el que se transfirió originalmente el proyecto (el inicio de su cadena de transferencia). Si el proyecto nunca ha sido transferido, este campo muestra Sin ambiente origen.

• Ambiente destino: Elige el ambiente donde deseas transferir los componentes seleccionados. El ambiente actual y el Ambiente origen desde el que se promovió el proyecto se excluyen de esta lista.

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

• Comentario: Añade 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 listados 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 entornos de origen y destino:

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

  Se añade una nueva operación al lienzo de diseño del proyecto de destino en la misma posición relativa respecto a sus operaciones vecinas que en el proyecto de origen. Por ejemplo, si las operaciones A, C y B existen en ese orden en el proyecto de origen, y el proyecto de destino contiene A y B pero no C, transferir C la coloca inmediatamente después de A y antes de B. Se preservan en el proyecto de destino las cadenas de operaciones que conectan la operación transferida con otras operaciones, como On Success, On Fail, On SOAP Fault, o enlaces de función RunOperation.

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

  Haz clic en el icono Ver cambios para abrir una vista de diferencias que muestre una comparación lado a lado del contenido del componente antes y después del cambio.

  La barra de título de la vista de diferencias muestra el tipo de componente y el nombre del componente (por ejemplo, "Endpoint: HTTP v2" o "Activity: GET"). Los siguientes controles están disponibles en la barra de título:

  • Abrir en ventana: Abre la vista de diferencias en una nueva ventana emergente. Haz clic de nuevo para devolverla a la posición en línea.
  • 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.

  Puedes arrastrar la vista de diferencias por su barra de título para reposicionarla en cualquier parte de la pantalla, y redimensionarla arrastrando sus bordes o esquinas. Una barra de desplazamiento vertical está disponible cuando las diferencias contienen 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 lado a lado:

    

    • 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 añadidas 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 la flecha para expandir o contraer secciones individuales.

  • Vista de diferencias de comparación de campos: Se utiliza para herramientas, notificaciones de correo electrónico, operaciones, endpoints de conector y actividades de conector. Muestra una tabla con las columnas Nombre, Antes y Después que listan cada campo modificado:

    

    Una fila modificada tiene un tinte rojo en la columna Antes y verde en la columna Después, y los caracteres o palabras específicos que cambiaron dentro de un valor se resaltan más intensamente. 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 endpoint 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 Antes y Después.

    Un campo cuyo nombre o valor es demasiado largo para mostrar 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 diferencia en línea del contenido de ese campo, mostrada como una diferencia de código con las líneas eliminadas resaltadas en rojo y las 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 agregados al esquema se resaltan en verde.

• Delete: 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.

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

Puedes seleccionar o deseleccionar componentes en las categorías Create, Overwrite y Delete para configurar tu transferencia.

• Autoselect dependencies: Alterna esta opción para controlar cómo se manejan las dependencias de componentes durante la transferencia. Cuando está habilitada (predeterminado), al seleccionar un componente se seleccionan 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.

• Show: Muestra datos de Last Modified ocultos. Haz clic para mostrar esta información.

• Hide: Oculta datos de Last Modified visibles. Haz clic para ocultar esta información.

• Prev: Regresa al paso anterior.

• Next: Procede al siguiente paso.

• Transfer: Deshabilitado a menos que se hayan completado todos los pasos en la configuración de transferencia. Cuando está habilitado, 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.

• Cancel: Cancela la transferencia y regresa al proyecto.

Step 3: Configure 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:

• Create: 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.

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

  Haz clic en el icono View changes para abrir una vista de diferencia de comparación de campos que muestra la configuración de la variable antes y después del cambio, utilizando el mismo formato y controles descritos en Step 2: Select additional components.

• Delete: 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.

• Unchanged: 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 del usuario. Estas variables del proyecto no se pueden seleccionar.

Puedes seleccionar o deseleccionar variables del proyecto en las categorías Create, Overwrite y Delete para configurar tu transferencia.

• Include default value: 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 borra, el valor de la variable del proyecto no se reemplaza.

  Esta casilla se selecciona automáticamente cuando seleccionas una variable (individualmente o mediante Select all). Cuando deseleccionas una variable, esta casilla se borra y se deshabilita.

• Show: Muestra datos de Last Modified ocultos. Haz clic para mostrar esta información.

• Ocultar: Oculta los datos de Última modificación visibles. 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 una opción para abrir el proyecto en el entorno destino.

• Cancelar: Cancela la transferencia y regresa al proyecto.

Paso 4: Configurar puntos finales de OAuth

En este paso, elige si deseas transferir las aplicaciones OAuth que utilizan los puntos finales en la transferencia. Una aplicación OAuth es un registro de aplicación que creas en la página Registros de aplicaciones de la Consola de administración para conectores de OAuth de 3 pasos (3LO).

Por defecto, las aplicaciones OAuth no se transfieren:

• Si se crea un punto final en el proyecto destino durante la primera transferencia, no tiene ninguna aplicación OAuth seleccionada. Después de la transferencia, selecciona una aplicación OAuth para el punto final en el entorno destino y autoriza la conexión.
• Si el punto final ya existe en el proyecto destino, su aplicación OAuth existente se conserva en transferencias posteriores.

Otras propiedades del punto final, como el nombre del punto final y el mecanismo de autenticación, se transfieren como es habitual.

Los puntos finales se organizan en categorías según su estado en los entornos de origen y destino (consulta Paso 2: Seleccionar componentes adicionales). Cada categoría muestra cuántos de sus puntos finales están seleccionados, por ejemplo Crear (0 de 1).

• Transferir aplicación: Marca la casilla de verificación junto a una categoría para transferir la aplicación OAuth para todos los puntos finales en esa categoría. Marca la casilla de verificación junto a un punto final individual para reemplazar la aplicación OAuth en el entorno destino con la aplicación OAuth del entorno de origen. Cuando esté desmarcada (por defecto), se conserva la aplicación OAuth del entorno destino.

• 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 una opción para abrir el proyecto en el entorno destino.

• Cancelar: Cancela la transferencia y regresa al proyecto.

Paso 5: Configurar horarios

En este paso, configura cómo se transfieren los horarios para tus operaciones.

• Transferir configuración de horarios para operaciones: Activa o desactiva esta opción para habilitar o deshabilitar la transferencia de configuraciones de horarios. Cuando esté habilitada, puedes seleccionar horarios para transferir al proyecto destino.

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

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

• Sobrescribir: Horarios 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, los horarios y sus asignaciones se reemplazan en el proyecto destino.

  Haz clic en el icono Ver cambios para abrir una vista de comparación de campos que muestra la configuración del horario antes y después del cambio, utilizando el mismo formato y controles descritos en Paso 2: Seleccionar componentes adicionales.

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

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

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

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

• Anterior: Volver al paso anterior.

• Siguiente: Ir al siguiente paso.

• Transferir: Deshabilitado a menos que todos los pasos estén configurados. Cuando esté habilitado, 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 la opción de abrir el proyecto en el ambiente de destino.

• Cancelar: Cancelar la transferencia y volver al proyecto.