El Content Sync Toolkit muestra qué falta sincronizar desde una instancia de Xperience by Kentico hacia su destino de Content Sync. La 1.0.0-beta.4 es la actualización más grande hasta ahora. Las páginas de estado se mudan dentro de la aplicación Content synchronization de Xperience. Comparan todos los idiomas a la vez y muestran quién cambió por última vez cada elemento. Además explican más de lo que encuentras ahí: elementos eliminados en el origen, elementos movidos a otro workspace y elementos bloqueados por un elemento enlazado.

Instalar o Actualizar

Actualiza el paquete en ambas instancias, el origen y el destino de Content Sync:

dotnet add package XperienceCommunity.ContentSyncToolkit --version 1.0.0-beta.4

El registro ahora es una sola llamada. AddContentSyncToolkitAdmin() ya no hace falta, y dejarla no cambia nada:

builder.Services.AddContentSyncToolkit();

Un paso que no puedes saltarte: los editores necesitan el permiso View en Content synchronization (Role management → el rol → Add permission set). La antigua aplicación Sync status y su permiso ya no existen, así que sin él tus editores reciben Access Denied después de actualizar.

Dentro de Content Synchronization

El toolkit era su propia aplicación, Sync status. Pero Xperience ya tiene un lugar para esto: Configuration → Content synchronization, con su List of content synchronizations. Las pestañas Pages y Content hub ahora están justo al lado, en /admin/content-sync, así que lo pendiente y lo ya sincronizado quedan en un solo lugar.

La pestaña Pages dentro de Content synchronization, con las páginas pendientes primero, luego las sincronizadas, y las columnas Language y Modified by

Primero lo Pendiente, Nada Oculto

Ahora se listan todos los elementos, ordenados por estado: lo que una sincronización cambiaría va primero, y In sync al final. Si solo quieres ver lo pendiente, marca el nuevo filtro Hide items in sync, y Xperience lo recuerda.

Esto salió del issue #33, reportado por Elisha Neil Powers. ¡Gracias! La página se abría en el primer canal o workspace en orden alfabético. Cuando ese no tenía nada que listar, Xperience ocultaba toda la barra de herramientas, Filter incluido, así que los editores no tenían cómo elegir otro. Ahora la página se abre en el primer canal o workspace con contenido publicado que el editor puede ver. Y como se listan todos los elementos, la barra se queda.

Todos los Idiomas a la Vez

Antes elegías un idioma, y era fácil pasar por alto un cambio pendiente en otro. Ahora, sin idioma seleccionado, se lista cada versión de idioma, una fila por versión. En una instancia con más de un idioma, la columna Language indica qué versión es cada fila, y la fila abre esa versión. Elige un idioma en el filtro para ver solo ese.

Quién lo Cambió

La nueva columna Modified by muestra quién editó por última vez cada elemento en esta instancia. Guardar un borrador cuenta. Así, antes de sincronizar el cambio de otra persona, sabes a quién preguntarle. El filtro Only my changes, desactivado por defecto, lista solo los elementos que editaste tú por última vez.

El panel de filtros con Workspace, Language, Only my changes, Hide items in sync, Status, Content type y las fechas de publicación

Deleted Here y Moved Here

Content Sync no puede eliminar contenido en el destino, así que el toolkit muestra los elementos que solo existen ahí como Only on target y sugiere eliminarlos allí. Ese consejo era incorrecto en dos casos comunes.

Deleted here. Si el elemento sigue en la papelera de reciclaje de esta instancia, aparece como Deleted here. El tooltip dice quién lo eliminó, cuándo y hasta cuándo se puede restaurar, y la fila enlaza a la papelera:

Una fila Deleted here con el enlace In recycle bin y un tooltip que dice quién la eliminó y hasta cuándo se puede restaurar

Moved here. Un elemento del Content hub movido a otro workspace parecía faltar en el anterior. Ahora aparece como Moved here, con el nombre de su nuevo workspace. No lo elimines en el destino: al sincronizarlo desde su nuevo workspace, también se mueve allí.

Un tooltip Moved here: movido a Dancing Goat Events aquí, pero todavía en este workspace en el destino

Incompatible por Elementos Enlazados

Content Sync se niega a sincronizar un elemento cuando un elemento al que enlaza, o una de sus páginas padre, tiene un tipo de contenido que el destino no acepta. Antes, esos elementos mostraban un estado con el que la sincronización después fallaba. Ahora aparecen como Incompatible, y el tooltip nombra el elemento que lo causa.

El Orden de Páginas Es Opcional

Reordered, para una página en otra posición entre sus hermanas en el destino, ahora viene desactivado por defecto. Muchos sitios no muestran las páginas en el orden del árbol, así que casi siempre era ruido. Si el tuyo sí, por ejemplo un menú construido a partir del árbol, actívalo de nuevo con ContentSyncToolkit:ComparePageOrder. Las páginas bajo otro padre siempre aparecen como Moved.

Sigue Siendo Rápido en Sitios Grandes

Todas estas consultas tenían que seguir siendo rápidas en un sitio grande, así que volví a medir con la misma configuración que para la beta.3: 20.000 páginas y 20.000 elementos del Content hub, los primeros 2.000 también en español. Luego hice el tipo de cambios que acumula un origen ocupado entre sincronizaciones: elementos republicados, borradores, despublicados, nuevos, movidos y 2.300 eliminados, la mayoría todavía en la papelera.

Solicitud del listado, 20.000 elementos por pestaña Pages Content hub
Administrador: paginar, ordenar, buscar, filtrar 0,4–0,5 s 0,3 s
Administrador: primera visita, consultando el destino 1,7 s 0,9 s
Editor que ve las páginas por permisos de página 0,8–0,9 s 0,3 s

Todos los estados salieron como se esperaba, Deleted here y Moved here incluidos.

Actualización

Actualiza ambas instancias. Un destino con la beta.3 sigue funcionando con un origen con la beta.4, pero no puede mostrar Deleted here para páginas. Después de actualizar:

  • Otorga View en Content synchronization a los roles de tus editores.
  • Actualiza tus marcadores: las páginas pasaron de /admin/content-sync-status a /admin/content-sync.
  • Si dependías de Reordered, configura ContentSyncToolkit:ComparePageOrder en true.

Si llamas a los servicios del toolkit desde tu propio código, algunas firmas cambiaron, así que recompílalo. Las notas de la versión las detallan.

La versión se verificó en ambos extremos del rango soportado, Xperience by Kentico 30.8.0 y 31.9.1. Consulta Compatibility.md para el registro completo. Todavía es una beta, así que las APIs y el comportamiento pueden cambiar antes de la 1.0.0.

Lo Que Sigue

Lo próximo en lo que estoy trabajando es sincronizar directamente desde la lista: selecciona los elementos que quieras, o usa una acción Sync en una fila, sin tener que buscar cada uno en el árbol de páginas o en el Content hub. El feedback es bienvenido mediante issues en GitHub, y la guía de uso tiene los detalles de configuración y uso.

Eso es todo por hoy.

¡Hasta la próxima publicación!