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 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 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 la cual 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

Se recomienda seguir 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, se recomienda 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. Se recomienda 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.

Cuando seleccionas 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 añade 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 recién añadidas 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 añaden 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, aparece un mensaje pidiendo que confirmes que deseas transferir. Esta transferencia sobrescribe el proyecto existente en el ambiente destino usando 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 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 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 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 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 mostrados 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 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 del usuario. Cuando se selecciona, estos componentes se reemplazan en el proyecto 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:

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

  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 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 el símbolo de intercalación para expandir o contraer secciones individuales.

  • Vista de diferencias de comparación de campos: Se utiliza para herramientas, notificaciones por correo electrónico, operaciones, endpoints de conector y actividades de conector. Muestra una tabla con columnas Nombre, Antes y Después que enumeran 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 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 diferencia insertada de ese contenido del campo, mostrada como una diferencia 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.

    Nota

    Las filas mostradas para una actividad de 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 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.

Se pueden seleccionar o deseleccionar componentes en las categorías Crear, Sobrescribir y Eliminar para configurar la 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, se pueden seleccionar componentes individuales sin incluir automáticamente sus dependencias.

• 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 completado todos los pasos en la configuración de transferencia. Cuando está habilitado, haz clic para iniciar el proceso de transferencia con los componentes y la 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, se puede 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.

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

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

Se pueden seleccionar o deseleccionar variables del proyecto en las categorías Crear, Sobrescribir y Eliminar para configurar la 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 desactiva, el valor de la variable del proyecto no se reemplaza.

  Esta casilla se selecciona automáticamente cuando se selecciona una variable (individualmente o a través de Seleccionar todo). Cuando se deselecciona una variable, esta casilla se desactiva 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: Deshabilitado a menos que se hayan configurado todos los pasos. Cuando está habilitado, haz clic para iniciar el proceso de transferencia con los componentes y la 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 los horarios para tus operaciones.

• Configuración de horario de transferencia para operaciones: Activa o desactiva esta opción para habilitar o inhabilitar la transferencia de configuraciones de horario. Cuando está habilitada, puedes seleccionar horarios para transferir al proyecto de 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 la etiqueta Asignado 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 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 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 de destino.

  Haz clic en el icono Ver cambios para abrir una vista de comparación de campos que muestre 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: Horarios que existen en el proyecto de destino pero no en el proyecto de origen. 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 de origen. Cuando se seleccionan, estos horarios se desasignan de operaciones para el proyecto de destino.

• 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: Deshabilitado a menos que todos los pasos hayan sido configurados. 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 de destino.

• Cancelar: Cancela la transferencia y regresa al proyecto.