Migración a Cloud (JCMA)

A partir de la versión 1.3.0, Jira Issue Picker DC está preparado para acompañar tu migración de Jira Data Center a Jira Cloud utilizando el Jira Cloud Migration Assistant (JCMA). Cuando ejecutes una migración con JCMA, el complemento empaqueta automáticamente los valores de tus campos Issue Picker y sus configuraciones, y los entrega al complemento equivalente en Cloud: Dynamic Work Item Picker (DWIP).

El resultado: los issues que llegan a Cloud conservan los valores que tenían los campos Issue Picker en DC, sin que ningún administrador tenga que recapturarlos manualmente.

Lado Cloud del flujo

Esta página describe únicamente el lado DC de la migración. La recepción y aplicación de los valores en Cloud la realiza el complemento Dynamic Work Item Picker (Cloud). Asegúrate de tenerlo instalado en tu sitio de Cloud antes de iniciar la migración con JCMA.

¿Qué se migra?

Cuando JCMA ejecuta la migración del proyecto que contiene campos Issue Picker, Jira Issue Picker DC entrega a Cloud:

Valores de los campos (jip-field-data)

Para cada issue migrado que tenga al menos un campo Issue Picker con valor, se envía:

• El issue de origen (clave e ID en DC).
• El campo (nombre e ID del custom field).
• La lista de issues seleccionados dentro del campo, expresados como issue keys.

Los valores almacenados internamente como IDs numéricos se resuelven a sus issue keys antes de exportarse, de modo que, una vez completada la migración, los enlaces apunten correctamente a los nuevos issues en Cloud incluso si sus IDs internos cambian.

Configuración por contexto (jip-field-config)

Para cada campo Issue Picker y cada uno de sus contextos nativos de Jira, se exporta la configuración guardada en el panel del complemento:

Configuración exportada	Descripción
Filtro JQL	El JQL que restringe los issues seleccionables.
Nota	El texto informativo configurado para los usuarios.
Tipo de Selección	SINGLE (simple) o MULTI (múltiple).
Ignorar Contexto del Proyecto	Si la búsqueda ignora o no el contexto nativo.
Atributos de Vista	Mostrar Prioridad, Asignado y/o Estado.
Título del Panel de Enlaces Entrantes	El nombre personalizado del panel de referencias.
Contextos asociados	Esquema, proyectos asociados y si la configuración es global o específica del contexto.

De este modo, la administración del campo en Cloud parte del mismo estado que tenía en DC y no es necesario reconfigurar los campos uno por uno.

Requisitos Previos

Antes de iniciar la migración con JCMA, verifica que se cumplen estos requisitos:

• ✅ Jira Issue Picker DC instalado y actualizado a la versión 1.3.0 o superior en tu instancia de Data Center.
• ✅ Dynamic Work Item Picker (DWIP) instalado en tu sitio de Jira Cloud, en la versión 2.8.0 o superior. Consulta la guía de migración en Cloud para los detalles del lado receptor.
• ✅ Jira Cloud Migration Assistant (JCMA) instalado en Data Center y configurado contra el sitio de Cloud de destino.
• ✅ Existe en Data Center al menos un usuario activo en el grupo jira-administrators (o un usuario admin). Este usuario se utiliza para ejecutar las búsquedas JQL que recolectan los issues con valores del campo Issue Picker.

precaución

Si no existe ningún administrador activo, el listener registrará un error en el log y completará la exportación sin enviar valores. Verifica este punto antes de lanzar la migración.

Cómo ejecutar la migración

El proceso de migración se opera completamente desde JCMA; Jira Issue Picker DC participa automáticamente cuando detecta que una migración ha comenzado.

1. En Data Center, abre Administración de Jira → Sistema → Migrar a Cloud (Jira Cloud Migration Assistant).
2. Crea o reutiliza un plan de migración que incluya los proyectos donde se utilizan campos Issue Picker.
3. En el paso de Apps, JCMA listará automáticamente Jira Issue Picker como una aplicación migrable y la asociará con Dynamic Work Item Picker en Marketplace. Confirma que el complemento aparece marcado para migrar.
4. Lanza la migración como lo harías habitualmente.

Durante la fase de migración de apps, JCMA invoca al listener del complemento, que recorre todos los campos Issue Picker de la instancia, recopila sus valores y configuraciones, y los entrega a Cloud. No se requiere ninguna acción manual adicional en DC.

Trazas en el log

Para seguir el progreso, puedes consultar el log de Jira. El listener emite mensajes con el prefijo JCMA: indicando el número de campos detectados, los issues procesados por página y el tamaño de los paquetes enviados a Cloud.

Verificación posterior a la migración

Una vez que JCMA reporte la migración como completada:

1. Accede al sitio de Jira Cloud destino.
2. Abre algunos issues migrados que en DC tenían campos Issue Picker con valores.
3. Comprueba que los campos equivalentes (ahora de tipo Dynamic Work Item Picker) muestran las mismas selecciones que en DC, apuntando a los issues correctos.
4. Como administrador, abre la configuración de uno de estos campos en Cloud y verifica que el JQL, los atributos de vista y el modo de selección se han preservado.

Si todos los puntos anteriores se cumplen, la migración del complemento ha sido exitosa.

Plan de contingencia

Si por alguna razón JCMA no pudiera completar la entrega de los valores (por ejemplo, una migración interrumpida o un fallo de red), existen dos rutas alternativas para re-hidratar los campos en Cloud sin tener que repetir la migración completa:

• Script vía REST API: utilizando las APIs de Jira Cloud, es posible escribir un script que recorra los issues afectados y aplique los valores del campo Dynamic Work Item Picker usando el mapping de claves DC → Cloud que JCMA genera.
• Exportación/Importación CSV: para volúmenes acotados, los valores pueden exportarse desde DC a CSV y reimportarse en Cloud usando la importación nativa.

Ambos mecanismos están diseñados como respaldo. La ruta recomendada y soportada por defecto es siempre JCMA.