Comparar y combinar proyectos

Comparar le permite ver exactamente qué difiere entre dos proyectos y, en las partes que se pueden copiar con seguridad, combinar los cambios seleccionados de uno en otro. Está pensado para dos situaciones cotidianas:

Promover cambios entre entornos: revise qué es diferente entre un proyecto de QA (desarrollo) y su equivalente de producción, y luego traslade a producción solo los cambios que desee.
Revisar frente a una instantánea o copia anterior: compare un proyecto con una copia de sí mismo (por ejemplo, un clon mensual) para ver qué cambió.

Usted mantiene el control en todo momento: no se escribe nada hasta que selecciona elementos concretos y los aplica, y puede validar antes con una ejecución de prueba.

Emparejadas elemento por elemento (por id en las copias, por nombre en los proyectos independientes), cada diferencia se marca como modificada, agregada o igual. Usted elige cuáles combinar: nada llega a producción hasta que lo aplica.

Cómo funciona la correspondencia

Para comparar dos proyectos, PlaidCloud tiene que decidir qué elemento de la izquierda corresponde a qué elemento de la derecha. Elige la estrategia automáticamente:

Las copias y las instantáneas del mismo proyecto se emparejan por su id interno (un clon conserva los mismos ids), de modo que incluso los elementos con otro nombre coinciden con precisión.
Los proyectos independientes, como un proyecto de QA y un proyecto de producción creado por separado, no comparten ids, así que se emparejan por nombre. Cuando esto ocurre, los elementos se etiquetan con (name-matched).

La correspondencia por nombre es lo que hace útil una comparación de QA con producción, ya que los dos proyectos se crearon por separado. También tiene límites: los elementos con nombres duplicados no siempre se pueden emparejar uno a uno, y un elemento marcado con ambiguous match significa que más de un candidato compartía el mismo nombre; revíselos manualmente antes de combinar.

Hay una tercera forma de emparejar, que se usa cuando un proyecto se creó copiando del otro: emparejar por ese linaje de copia registrado, de modo que una copia con otro nombre siga coincidiendo con su original. No se elige automáticamente; se solicita con Volver a sincronizar en…, como se explica en Resincronización desde el proyecto del que copió.

Apertura de una comparación

Abra Analyze
Seleccione Proyectos en la barra de menús superior
Haga clic con el botón derecho en el proyecto desde el que desea empezar (o use su menú de acciones) y elija Comparar con…
En la ventana Comparar proyectos, el proyecto desde el que empezó aparece completado como Origen
Elija el proyecto de Destino en la lista desplegable: el proyecto con el que desea comparar
Haga clic en Comparar

Ambos proyectos deben estar en el mismo espacio de trabajo.

Lectura de la comparación

El lado izquierdo agrupa todas las diferencias bajo su categoría: Flujos de trabajo (con sus Pasos anidados debajo), Variables, Dimensiones, Editores, UDF, Vistas y Tablas.

Cada elemento lleva una insignia con su estado:

Agregado: está en el origen pero no en el destino (se crearía en el destino)
Modificado: está en ambos, pero la configuración difiere
Eliminado: está en el destino pero no en el origen
Sin cambios: idéntico en ambos lados (oculto de forma predeterminada)

Seleccione un elemento modificado para ver sus detalles a la derecha: una tabla Campo / Origen / Destino con lo que cambió, y debajo la Diferencia de configuración completa. Si la diferencia de un elemento es muy grande, se trunca; haga clic en Expandir diferencia completa para cargar la versión completa.

Cómo centrar la lista

Filtrar por nombre o ruta reduce el árbol a los elementos que coinciden.
Las casillas de estado muestran u ocultan los elementos Agregado, Modificado, Eliminado y Sin cambios.
Requiere atención manual muestra solo los cambios que no se pueden combinar automáticamente (véase más abajo).

Qué se puede combinar

No todas las diferencias se pueden copiar de forma segura entre proyectos. La comparación etiqueta cada elemento para que siempre sepa qué se puede combinar:

Los flujos de trabajo, los pasos y las variables se pueden combinar.
Las dimensiones, los editores, las UDF, las vistas y las tablas son de solo visualización: aparecen en la comparación para que pueda revisarlos, pero se copian con sus propias herramientas específicas, no desde aquí.

Algunos cambios individuales también se marcan como manual (con un candado) incluso dentro de una categoría que se puede combinar, porque aplicarlos automáticamente no sería seguro. El panel de detalles explica el motivo y qué hacer en su lugar. Los casos más comunes:

Los pasos en una comparación por nombre (QA frente a producción) son solo de revisión: la configuración de un paso puede hacer referencia a conexiones y agentes específicos de cada entorno, por lo que se copia manualmente. Use la diferencia para ver con precisión qué cambiar en el destino.
La eliminación de variables no se aplica por usted: quite la variable manualmente en el proyecto de destino.

La línea de resumen le muestra la distribución de un vistazo, por ejemplo “12 combinables · 5 de solo visualización” y “3 requieren atención manual”.

Combinación de cambios

Seleccione los elementos que desea copiar del origen al destino. Use Seleccionar todo para elegir todos los elementos combinables que se muestran en ese momento, o seleccione varias filas individuales. Los elementos de solo visualización y los manuales no se pueden seleccionar.
Haga clic en Ejecución de prueba para validar la selección sin escribir nada. PlaidCloud informa de cuántas operaciones se aplicarían (nuevas frente a actualizadas) y señala las que fallarían.
Cuando la ejecución de prueba tenga buen aspecto, haga clic en Aplicar (ya sea desde el resultado de la ejecución de prueba o desde el pie).
Confirme la operación en el cuadro de diálogo Confirmar combinación.

Los elementos combinados conservan su identidad en el destino, de modo que puede volver a ejecutar la comparación más adelante y combinar más cambios sin crear duplicados.

Si algo sale mal

El destino cambió: si otra persona modificó el destino después de que usted cargara la comparación, la combinación se detiene para evitar sobrescribir su trabajo. Actualice la comparación y vuelva a aplicar.
Combinación aplicada parcialmente: si una operación falla a mitad de camino, las restantes se notifican como pendientes. Corrija la causa y elija Reintentar las pendientes, o cancele y actualice.

Resincronización desde el proyecto del que copió

La comparación funciona entre dos proyectos cualesquiera de un espacio de trabajo. Pero cuando el destino se creó copiando desde el origen (con Copiar proyecto en un proyecto existente), PlaidCloud recuerda qué objeto del destino procede de qué objeto del origen. Volver a sincronizar usa esa memoria para comparar ambos según la forma en que realmente están relacionados, en lugar de adivinar a partir de ids y nombres.

Esto es lo que permite que un mismo inquilino tenga Dev, QA y producción como proyectos separados y promueva cambios de uno a otro. Copia Dev en QA una vez; a partir de entonces, al volver a sincronizar QA con Dev solo se muestra lo que cambió en Dev desde entonces, y puede trasladar a QA las piezas que elija; después, QA a producción de la misma manera. Sin exportar, sin archivos, sin un segundo espacio de trabajo.

Por qué es importante

Una comparación ordinaria de dos proyectos creados de forma independiente tiene que emparejar los elementos por nombre, porque no comparten ids. Eso funciona hasta que la copia cambió el nombre de algo. Cuando Copiar proyecto incorpora un objeto cuyo nombre o id ya existía en el destino, le da al objeto entrante una identidad nueva (con copy añadido), de modo que una comparación simple ve la copia con otro nombre como algo sin relación con su original del origen: el elemento del origen aparece como Agregado y su propia copia en el destino como Eliminado, una junto a otra. Estaría viendo dos mitades del mismo objeto sin forma de alinearlas.

Volver a sincronizar los empareja por descendencia, es decir, por el linaje de copia registrado, de modo que un objeto con otro nombre o con otro número sigue coincidiendo con aquel del que procede, y solo los cambios genuinos aparecen como diferencias.

Ejecución de una resincronización

Abra Analyze
Seleccione Proyectos
Haga clic con el botón derecho en el proyecto desde el que copió (el origen, por ejemplo Dev) o use su menú de acciones, y elija Volver a sincronizar en…
Elija el destino en el que copió anteriormente, por ejemplo QA
Haga clic en Volver a sincronizar

La ventana es la misma ventana Comparar proyectos, y todo lo que se explica en Lectura de la comparación, Qué se puede combinar y Combinación de cambios se aplica sin cambios. La única diferencia es cómo se emparejan los elementos.

Cuando no hay linaje que usar

Volver a sincronizar necesita una copia registrada entre los dos proyectos. Si vuelve a sincronizar un par que nunca estuvo conectado por Copiar proyecto, o que lo estuvo solo en parte, PlaidCloud se lo indica en lugar de fingir:

Sin ningún linaje: un banner indica que la comparación recurrió al emparejamiento ordinario y no es una resincronización. Se comporta exactamente como una comparación normal, incluida la división entre Agregado y Eliminado para cualquier elemento al que una copia anterior habría cambiado el nombre. Esto es lo que ve si vuelve a sincronizar dos proyectos sin relación, o un par de proyectos conectados por una importación de archivo en lugar de por Copiar proyecto.
Linaje parcial: si la copia abarcó solo algunas categorías, un banner nombra las que recurrieron al emparejamiento ordinario. Esas categorías se emparejan entonces por nombre, lo que combina el mismo subconjunto seguro que una comparación de QA con producción: los cambios de variables y de registros de flujos de trabajo pasan, mientras que los pasos y los flujos de trabajo recién agregados pasan a ser solo de revisión (véase Qué se puede combinar).

En cualquier caso, el emparejamiento que realmente obtuvo es lo que la ventana muestra y combina: una resincronización nunca degrada en silencio a una correspondencia por nombre mientras le dice que coincidió por linaje.

Información relacionada

Administrar proyectos: control de versiones y seguimiento de puntos en el tiempo dentro de un solo proyecto
Archivar un proyecto: capture una instantánea de un punto en el tiempo con la que pueda comparar más adelante
Flujos de trabajo: la primitiva de automatización entre cuyos proyectos se combina una comparación