Saltar al contenido principal
Version: 2.0.0

Reglas de sincronización

Una regla define qué elemento de trabajo se crea en el sitio remoto, cuándo se crea y qué contenido se transfiere. Antes de crearla, configura una conexión disponible y confirma que la cuenta técnica tenga permiso para crear en el destino.

Configurar una regla​

El asistente tiene seis pasos:

  1. Conexión: elige el sitio remoto y asigna un nombre claro a la regla.
  2. Espacios: selecciona el espacio y el tipo de elemento locales, y el espacio y tipo remotos.
  3. Disparador: elige una transición del workflow, un valor de campo o el escalamiento manual desde el panel.
  4. Mapeo: relaciona los campos locales con los campos del elemento remoto.
  5. Políticas: decide qué comentarios y archivos se transfieren y en qué idioma escribirá la aplicación sus avisos.
  6. Revisión: comprueba la configuración y selecciona Armar payload para generar la vista previa de la prueba en seco. Después, elige Guardar inactiva o Guardar y activar.

Una regla no se guarda si la conexión no está disponible, falta permiso de creación, queda sin mapear un campo obligatorio del remoto, los tipos no son compatibles o se duplica una condición activa. El mensaje indica qué debes corregir.

Mapear campos​

Para cada campo remoto, puedes usar una de estas fuentes:

  • Campo local: copia el valor del elemento local.
  • Valor fijo: usa el mismo valor en cada elemento remoto creado por la regla.
  • Plantilla: combina texto con valores como {{local.key}} y {{local.summary}}.
  • Traducción de opciones: convierte valores locales en valores remotos y define un valor predeterminado.

Los campos de usuario del sitio remoto solo admiten un valor fijo. La aplicación no busca ni convierte automáticamente un usuario local en una cuenta del sitio remoto. Para definir el usuario de destino, introduce el identificador de cuenta de una cuenta válida del sitio remoto como valor fijo.

Conserva la clave en el resumen​

El resumen del elemento remoto debe incluir {{local.key}}, la clave del elemento local. Sin un mapeo personalizado, se usa:

[{{local.key}}] {{local.summary}}

La clave permite reconocer el origen y evita crear duplicados si hay un reintento. La regla no se guarda si la plantilla del resumen la omite.

Asistente de reglas en el paso de mapeo, con la plantilla del resumen que incluye la clave local.

Elegir cuándo se crea el elemento remoto​

  • Transición: el elemento remoto se crea al ejecutar la transición elegida. Puedes añadir un validador al workflow para comprobar antes los campos obligatorios.
  • Valor de un campo: se crea cuando el campo alcanza uno de los valores configurados. Si falta un campo obligatorio remoto, la transición no se bloquea; se informa del error en el elemento local.
  • Solo manual: la persona autorizada usa Escalar desde el panel.

Una misma regla y un mismo elemento local crean como máximo un elemento remoto. Un doble clic, un reintento o una respuesta tardía no crean otro elemento.

Configurar comentarios​

Para los comentarios que salen del sitio local, elige:

  • Todos: envía los comentarios nuevos.
  • Con prefijo: envía solo los comentarios que empiezan con el prefijo indicado; puedes quitar el prefijo al enviarlos.
  • Solo desde el panel: envía solo los comentarios escritos desde la acción del panel.

Las notas internas de Jira Service Management no se envían, salvo que la regla permita explícitamente compartirlas. En el sentido de vuelta, los comentarios nuevos del remoto llegan al elemento local con una cabecera que identifica su autoría. En Jira Service Management, configura si deben quedar como internos o públicos. Los comentarios de la cuenta técnica no se vuelven a importar.

La aplicación evita bucles y comentarios duplicados. Si un comentario supera los 32.000 caracteres, se trunca y se indica que el texto original continúa en el elemento de origen.

Configurar adjuntos​

Elige una política para cada dirección:

  • Ninguno: no transfiere adjuntos.
  • Referenciados en comentarios: transfiere los archivos mencionados en comentarios que sí se sincronizan.
  • Todos los nuevos: intenta transferir los adjuntos nuevos cubiertos por la regla.

El tamaño máximo predeterminado es 10 MB por archivo. Algunas extensiones están bloqueadas. Si se omite un archivo por tamaño, extensión o permisos, la aplicación lo explica en un comentario de destino y en la bitácora. Un archivo ya copiado no se vuelve a subir y los archivos subidos por la aplicación no rebotan al otro sitio.

Limitación de 1.0.0: la política Todos los nuevos no copia los adjuntos que se añaden después del escalamiento inicial. Si necesitas transferirlos, cita el adjunto en un comentario sincronizado.

El texto enriquecido se adapta al otro sitio: las menciones se convierten en @Nombre y no notifican a usuarios remotos; las imágenes incrustadas se representan como [Adjunto: archivo] y se transfieren como archivos adjuntos. El contenido que no se pueda convertir se sustituye por [Contenido no compatible omitido].

Idioma y prueba en seco​

En Idioma de las plantillas, elige Español o Inglés para los avisos que la aplicación escriba en los elementos. El inglés es el valor predeterminado. Esta opción es independiente del idioma de la interfaz, que está disponible en español, inglés y portugués de Brasil.

Antes de activar la regla, en el paso Revisión, selecciona Armar payload con un elemento de ejemplo. La vista previa de la prueba en seco muestra los campos que se enviarían y no crea ni modifica nada en el sitio remoto. Si cambias la regla o el ejemplo, vuelve a seleccionar Armar payload para revisar el resultado actualizado.

Prueba en seco con un elemento de ejemplo; el payload no se envía al sitio remoto.