Solución de problemas de sincronización de medios
Esta página está dirigida a administradores y personal técnico responsable del servidor, despliegue y red. Para la configuración y el uso diario, consulte Sincronización automática de medios.
Empezar por el registro de Business Central
Abra Business Portals - Log en la empresa donde se ejecutó la cola, filtre Source por Portal media synchronization y revise cada fallo además del resumen. Anote hora, URL o referencia del portal, operación y estado HTTP. Compare con el registro del servidor y tenga en cuenta que el hosting puede usar UTC. El historial de la cola puede mostrar Success aunque un portal haya fallado.
No incluya Media Sync key, valores cifrados, firmas ni archivos completos de configuración en solicitudes de soporte.
Configurar el portal
El endpoint receptor es <portal-base>/MediaSync.ashx. Despliegue juntos el handler y la biblioteca actualizados, junto con la extensión compatible de Business Central. Instale la clave cifrada como MediaSyncKey en el archivo activo:
| Versión del portal | Archivo activo |
|---|---|
| Versión 2.7.x.x o posterior | Auth.config |
| Configuración anterior a 2.7.x.x | CustomSettings.config |
Los portales listados validan PortalReference frente al registro. El Endpoint seleccionado en Module Setup usa autenticación independiente y no requiere referencia. Los portales administrados reciben claves mediante la conexión de publicación; los autohospedados requieren instalación manual. Si falla la actualización administrada, reintente con Update Media Sync Key on Portals.
Warning
El portal puede descifrar los valores ENC:v1; protéjalos como credenciales. No los publique en ajustes visibles desde el navegador ni en registros.
Mensajes y respuestas HTTP habituales
| Mensaje/estado | Comprobaciones |
|---|---|
| Ningún portal actualizado/no compatible/fallido | Compruebe las URL de la lista y del Endpoint seleccionado. |
| Invalid URL | Use la dirección base, sin página, credenciales, consulta, fragmento, puntuación final ni espacios. HTTPS es el valor predeterminado. |
| Error de transporte | Compruebe Allow HttpClient Requests, DNS, firewall, certificados y acceso desde el servidor de Business Central. Poder abrirlo desde el PC no demuestra acceso del servidor. |
| HTTP 400 | Revise operación y diagnóstico. HTTP se rechaza salvo que Allow HTTP Media Sync esté habilitado y firmado; IIS también puede rechazar un hostname inválido. |
| HTTP 401 | Verifique MediaSyncKey, la referencia cuando corresponda y la sincronización del reloj. |
| HTTP 403 | Revise restricciones de IIS, hosting, proxy y acceso a MediaSync.ashx. |
| HTTP 404/410 | Despliegue el handler y la biblioteca actualizados en la ruta base. Un endpoint ausente se omite y no implica actualización. |
| HTTP 409 | Otra actualización pudo publicarse primero o la solicitud repetirse/llegar fuera de orden. Espere a la siguiente ejecución o reintente cuando termine la otra. |
| HTTP 413 | Revise límites del servidor y proxy; el máximo del protocolo es 1 MiB. |
| HTTP 500 | Revise diagnóstico, permisos de archivos, conversiones y espacio en disco; conserve la caché actual. |
| HTTP 502 por túnel/proxy | Revise el error del proxy y la conexión upstream, así como el puerto y protocolo local. Un 502 no demuestra limitación. |
| Respuesta de sincronización no válida | Compruebe si se devolvió inicio de sesión, HTML, redirección o respuesta incompatible; revise proxy y versión desplegada. |
Consultar diagnósticos del portal
El handler registra fallos mediante el trace logging de la aplicación. Active el registro de errores en el host y reproduzca una ejecución. En Azure App Service para Windows, use Application logging (Filesystem) en Error y revise Log stream o LogFiles/Application con Kudu; es distinto del registro HTTP de IIS. Busque Media synchronization authentication failed o Media synchronization failed. Los diagnósticos identifican la comprobación fallida, pero omiten secreto y firma. Una diferencia de reloj superior a cinco minutos indica un problema de reloj UTC o de versión del emisor.
Portales locales, túneles y HTTPS
Business Central Online no puede acceder al localhost del PC; use un túnel accesible o un portal alojado. Si un túnel HTTPS reenvía a HTTP, el portal recibe una conexión HTTP. Use HTTPS local de confianza o habilite Allow HTTP Media Sync. La opción forma parte de la firma; añadir manualmente una cabecera no autentica la solicitud. Actualice ambos extremos antes de probar. Ante Invalid Hostname, revise la vinculación de IIS Express y el Host header. Ante error de gateway, compruebe el upstream y que el sitio local siga activo. Consulte el registro específico del portal.
Entender almacenamiento y limpieza
Rutas relativas a la raíz del sitio:
| Ruta | Uso |
|---|---|
temp/img, temp/video |
Medios originales hasta la primera publicación correcta. |
temp/media-cache/<guid>/img y /video |
Generaciones completas de medios. |
App_Data/media-sync/current |
Generación publicada actual. |
App_Data/media-sync/previous |
Generación anterior para recuperación; no se restaura automáticamente. |
App_Data/media-sync/<guid>/ |
Lotes de carga, estado o datos temporales manuales. |
App_Data/media-sync/<guid>.retired |
Hora de retirada, indicada por la modificación del archivo. |
App_Data/media-sync/*.nonce |
Protección contra repetición de solicitudes autenticadas. |
App_Data/media-sync/cleanup.timestamp |
Coordinación del intervalo de limpieza. |
Las URL /temp/img/... y /temp/video/... se reescriben internamente a la generación actual. IIS debe ejecutar módulos administrados para solicitudes estáticas (runAllManagedModulesForAllRequests="true"). Los archivos ausentes no vuelven a copias antiguas. Las generaciones actual y anterior están protegidas; las antiguas pueden limpiarse 15 minutos tras retirarse. Las carpetas originales pueden eliminarse completas 15 minutos después de la primera publicación, incluidos archivos adicionales.
Las ejecuciones automáticas correctas intentan eliminar los lotes; las manuales limpian su carpeta temporal. Los temporales inactivos pueden limpiarse tras dos horas y los nonce tras 15 minutos. La limpieza solo se ejecuta en solicitudes autenticadas posteriores o actualizaciones manuales, como máximo una vez por minuto. Si quedan archivos, revise punteros, fechas, actividad, bloqueos y permisos. Las advertencias requieren registro de nivel Warning.
Warning
No elimine rutinariamente la generación actual ni edite los punteros. La actualización necesita espacio adicional y no existe una cuota fija; supervise el espacio libre.
Hosting y recuperación
El portal requiere almacenamiento escribible compartido para App_Data/media-sync y temp/media-cache, con bloqueos exclusivos y movimientos/sustituciones de archivos en el mismo volumen. La identidad de la aplicación necesita permisos de lectura, creación, movimiento y eliminación. Las selecciones grandes deben caber en los límites de tiempo, memoria y disco del host.
Si falla antes de publicar, los medios actuales se conservan. Si se agota el tiempo tras publicar, Business Central puede informar un error aunque el portal ya haya cambiado. Compruebe el puntero y los medios visibles; es seguro repetir una sincronización completa.