Dépannage de la synchronisation des médias
Cette page s’adresse aux administrateurs et techniciens responsables du serveur, du déploiement et du réseau. Pour la configuration et l’utilisation courante, voir Synchronisation automatique des médias.
Commencer par le journal Business Central
Dans la société ayant exécuté la tâche, ouvrez Business Portals - Log, filtrez Source sur Portal media synchronization, puis examinez chaque échec et le résumé. Notez l’heure, l’URL ou référence du portail, l’opération et le statut HTTP. Comparez avec le journal serveur (l’hébergement peut utiliser UTC). L’historique de la file peut afficher Success malgré l’échec d’un portail.
Ne joignez jamais Media Sync key, valeurs chiffrées, signatures ou fichiers de configuration complets aux demandes d’assistance.
Configurer le portail
Le point de terminaison est <portal-base>/MediaSync.ashx. Déployez ensemble le handler et la bibliothèque mis à jour avec l’extension Business Central compatible. Installez la clé chiffrée comme MediaSyncKey dans le fichier actif :
| Version du portail | Fichier actif |
|---|---|
| Version 2.7.x.x et ultérieure | Auth.config |
| Configuration antérieure à 2.7.x.x | CustomSettings.config |
Les portails répertoriés valident PortalReference par rapport à l’enregistrement du portail. L’Endpoint sélectionné dans Module Setup utilise une authentification autonome et ne nécessite pas de référence. Les portails gérés reçoivent les clés via la connexion de publication ; les portails auto-hébergés nécessitent une installation manuelle. Réessayez une mise à jour gérée avec Update Media Sync Key on Portals.
Warning
Les valeurs ENC:v1 sont déchiffrables par le portail et doivent être protégées comme des identifiants. Ne les publiez pas dans les paramètres accessibles au navigateur ni dans les journaux.
Messages et réponses HTTP courants
| Message/statut | Vérifications |
|---|---|
| Aucun portail actualisé/non pris en charge/en échec | Vérifiez les URL de la liste et de l’Endpoint sélectionné. |
| Invalid URL | Utilisez l’adresse de base, sans page, identifiants, requête, fragment, ponctuation finale ni espace. HTTPS est le défaut. |
| Échec de transport | Vérifiez Allow HttpClient Requests, DNS, pare-feu, certificats et accessibilité depuis le serveur Business Central. Un accès depuis le PC ne prouve pas celui du serveur. |
| HTTP 400 | Vérifiez opération et diagnostic. HTTP est refusé sauf activation signée de Allow HTTP Media Sync ; IIS peut aussi refuser un nom d’hôte invalide. |
| HTTP 401 | Vérifiez MediaSyncKey, la référence éventuelle et la synchronisation de l’horloge. |
| HTTP 403 | Vérifiez IIS, hébergement, proxy et restrictions d’accès à MediaSync.ashx. |
| HTTP 404/410 | Déployez le handler et la bibliothèque à jour au chemin de base. Un endpoint absent est ignoré, sans actualisation. |
| HTTP 409 | Une autre actualisation a pu publier d’abord, ou la requête a été répétée/hors séquence. Attendez le prochain lancement ou réessayez après la fin des mises à jour concurrentes. |
| HTTP 413 | Vérifiez les limites serveur et proxy ; le maximum du protocole est 1 Mio. |
| HTTP 500 | Vérifiez diagnostics, droits de fichiers, conversions et espace disque ; conservez le cache actuel. |
| HTTP 502 via tunnel/proxy | Examinez l’erreur proxy et la connexion upstream, ainsi que le port et protocole locaux. Un 502 ne prouve pas une limitation. |
| Réponse de synchronisation invalide | Vérifiez page de connexion, HTML d’erreur, redirection ou réponse incompatible ; contrôlez proxy et version. |
Lire les diagnostics du portail
Le handler consigne les échecs via le traçage de l’application. Activez la journalisation des erreurs sur l’hôte et reproduisez un lancement. Dans Azure App Service Windows, réglez Application logging (Filesystem) sur Error, puis consultez Log stream ou LogFiles/Application via Kudu (distinct du journal HTTP IIS). Recherchez Media synchronization authentication failed ou Media synchronization failed. Les diagnostics précisent le contrôle en échec mais omettent secret et signature. Un écart d’horloge supérieur à cinq minutes indique un problème d’horloge UTC ou de version d’émetteur.
Portails locaux, tunnels et HTTPS
Business Central Online ne peut pas joindre le localhost du PC ; utilisez un tunnel accessible ou un portail hébergé. Un tunnel HTTPS vers un upstream HTTP présente une connexion HTTP au portail. Utilisez HTTPS local approuvé ou activez Allow HTTP Media Sync. Cette option est signée ; ajouter l’en-tête manuellement n’authentifie pas la requête. Mettez à jour les deux côtés avant le test. En cas d’Invalid Hostname, vérifiez la liaison IIS Express et le Host header. En cas de passerelle, vérifiez upstream et disponibilité du site local. Consultez l’entrée de journal propre au portail.
Comprendre stockage et nettoyage
Chemins relatifs à la racine du site :
| Chemin | Rôle |
|---|---|
temp/img, temp/video |
Médias d’origine jusqu’à la première publication réussie. |
temp/media-cache/<guid>/img et /video |
Générations complètes de médias. |
App_Data/media-sync/current |
Génération publiée actuelle. |
App_Data/media-sync/previous |
Génération précédente conservée pour récupération, sans restauration automatique. |
App_Data/media-sync/<guid>/ |
Lots chargés, état ou données temporaires manuelles. |
App_Data/media-sync/<guid>.retired |
Heure de retrait via la date de modification. |
App_Data/media-sync/*.nonce |
Protection contre la répétition des requêtes authentifiées. |
App_Data/media-sync/cleanup.timestamp |
Coordination de l’intervalle de nettoyage. |
Les URL /temp/img/... et /temp/video/... sont réécrites vers la génération actuelle. IIS doit exécuter les modules gérés pour les requêtes statiques (runAllManagedModulesForAllRequests="true"). Les fichiers absents ne reviennent pas aux anciennes copies. Les générations actuelle et précédente sont protégées ; les anciennes peuvent être nettoyées 15 minutes après retrait. Les dossiers d’origine peuvent être supprimés entièrement 15 minutes après la première publication, y compris les fichiers supplémentaires.
Les actualisations automatiques réussies tentent de supprimer les lots ; les manuelles tentent de supprimer leur dossier temporaire. Les fichiers inactifs sont éligibles après deux heures, les nonce après 15 minutes. Le nettoyage n’a lieu que lors de requêtes authentifiées ultérieures ou de mises à jour manuelles, au plus une fois par minute. S’il reste des fichiers, vérifiez pointeurs, dates, activité, verrous et droits. Les avertissements nécessitent une journalisation Warning.
Warning
Ne supprimez pas systématiquement la génération actuelle et ne modifiez pas les pointeurs. Une actualisation nécessite de l’espace supplémentaire ; il n’existe pas de quota fixe. Surveillez l’espace libre.
Hébergement et récupération
Le portail nécessite un stockage inscriptible partagé pour App_Data/media-sync et temp/media-cache, avec verrous exclusifs, remplacement de fichiers et déplacements de répertoires sur le même volume. L’identité de l’application doit pouvoir lire, créer, déplacer et supprimer. Les grandes sélections doivent respecter les limites de délai, mémoire et disque de l’hôte.
En cas d’échec avant publication, les médias actuels restent disponibles. Un délai dépassé après publication peut être signalé en erreur par Business Central alors que le portail a basculé. Vérifiez le pointeur et les médias visibles ; une nouvelle synchronisation complète est sans risque.