Aller au contenu

Synchronisation automatique des médias

La tâche Business Portals - Synchronize Media met automatiquement à jour les images et vidéos du portail depuis Business Central. L’intervalle standard est de 60 minutes. Il n’est pas nécessaire de se connecter à la page de mise à jour manuelle à chaque actualisation.

L’actualisation utilise la sélection de médias, les business mappings et les filtres existants. Après réussite, le portail publie ensemble les nouveaux médias. En cas d’échec avant publication, les derniers médias publiés restent disponibles.

Info

Des versions compatibles de Business Central et du portail sont requises. Demandez à l’administrateur ou à l’hébergeur de mettre les deux à jour avant d’activer la tâche. Les installations NAV conservent la page de mise à jour manuelle.

Avant de commencer

L’administrateur ou l’hébergeur doit vérifier que Business Central peut joindre l’adresse du portail (elle doit être publique avec Business Central Online), que le portail peut enregistrer les médias et dispose d’espace libre, que le même Media Sync key est configuré des deux côtés et que la sélection des médias est correcte.

Media Sync key est distinct du secret client App Registration. Il fonctionne aussi avec les portails auto-hébergés et d’autres méthodes d’authentification Business Central. Voir Dépannage de la synchronisation des médias.

Choisir les portails à actualiser

Chaque exécution traite les portails dont Url est renseignée dans Business Portals - Portals, ainsi que l’URL de l’Endpoint sélectionné sous General dans Business Portals - Module Setup, si elle existe. Pour un portail auto-hébergé, sélectionnez ou créez un endpoint avec son adresse de base (par exemple https://portal.example.com, sans nom de page, requête ni fragment #!). Aucune référence supplémentaire n’est nécessaire. Les adresses normalisées identiques ne sont traitées qu’une fois ; l’échec d’un portail n’empêche pas les autres traitements.

Configurer Media Sync key

  1. Ouvrez Business Portals - Module Setup dans Business Central.
  2. Sous Media Synchronization, vérifiez Media Sync Key Configured.
  3. En l’absence de clé, choisissez Generate Media Sync Key.
  4. Copiez la valeur chiffrée affichée et conservez-la en lieu sûr. Elle commence par ENC:v1: et n’est affichée qu’à la génération.
  5. Pour les portails gérés avec App Registration, l’action tente de mettre à jour automatiquement la configuration ; vérifiez le message de résultat.
  6. Pour un portail auto-hébergé, transmettez la valeur de manière sécurisée à la personne responsable, qui l’installera selon le guide technique.

Warning

Générer une nouvelle clé remplace l’ancienne. Tous les portails doivent recevoir la nouvelle avant la reprise. Protégez cette valeur : ne l’ajoutez ni aux tickets d’assistance ni aux captures d’écran.

En cas d’échec de mise à jour automatique, corrigez la connexion ou les autorisations de publication puis choisissez Update Media Sync Key on Portals pour réessayer avec la clé stockée. Il n’est pas nécessaire d’en générer une autre. Module Setup et la clé sont partagés entre les sociétés ; le changement affecte aussi leurs tâches.

Créer l’entrée de la file de tâches

  1. Ouvrez le centre de rôles Business Portals Administrator dans la société concernée.
  2. Dans Job Queue Entries, ouvrez les actions et choisissez Create Default Entries.
  3. Ouvrez Business Portals - Synchronize Media, vérifiez la planification et l’état, puis choisissez Set Status to Ready.
Paramètre Valeur standard
Description Business Portals - Synchronize Media
Object Type to Run Codeunit
Object ID to Run 5492810
Parameter String SYNC_MEDIA
Number of Minutes Between Runs 60

Create Default Entries crée les entrées manquantes dans la société actuelle et conserve les entrées et réglages existants. Plusieurs sociétés peuvent actualiser les mêmes portails ; coordonnez les horaires. Voir File de tâches Business Portals.

Vérifier la première exécution

Exécutez la tâche une fois ou attendez son prochain lancement. Dans la société concernée, ouvrez Business Portals - Log, filtrez Source sur Portal media synchronization et examinez les résultats et le résumé (par exemple 1 updated, 0 unsupported, 0 failed). Vérifiez des images et vidéos représentatives dans le portail et actualisez le navigateur si nécessaire.

Résultat Signification
Updated Le portail a accepté une actualisation complète.
Unsupported Le point de terminaison est absent ; demandez à l’hébergeur de vérifier la version installée.
Failed L’actualisation a échoué du point de vue de Business Central ; consultez le message.

Info

Success dans l’historique de la file ne garantit pas que chaque portail a été actualisé. Les échecs figurent séparément dans Business Portals - Log et la tâche peut poursuivre ses exécutions. Voir Utilisation du journal.

Modifications, suppressions et mises à jour manuelles

Chaque actualisation réussie publie toute la sélection, même si elle est inchangée. Les médias désélectionnés disparaissent du cache actuel après réussite ; une sélection valide vide publie des dossiers vides. En cas d’échec, les anciens médias restent disponibles, même s’ils ont été modifiés ou supprimés dans Business Central. L’exécution suivante réessaie une actualisation complète. Le cache navigateur peut temporairement afficher une ancienne image.

La page manuelle UpdateImages.aspx reste disponible pour Business Central et NAV. Les deux méthodes utilisent le même mécanisme ; si elles se chevauchent, une nouvelle tentative peut être nécessaire. Consultez les journaux avant de réessayer.

Stockage et nettoyage

Après la mise à niveau du portail, les fichiers existants restent dans leurs dossiers d’origine jusqu’à la première actualisation réussie. Le portail conserve la génération actuelle et la précédente. Les anciennes générations peuvent être nettoyées 15 minutes après leur remplacement, les dossiers d’origine 15 minutes après la première publication réussie et les chargements inactifs après deux heures.

Le nettoyage intervient lors de demandes ultérieures ou de mises à jour manuelles, au plus une fois par minute ; ce n’est pas une tâche d’arrière-plan indépendante. Des exécutions manuelles fréquentes peuvent conserver temporairement plusieurs générations. Il n’existe pas de quota fixe : surveillez l’espace disque. Voir le guide technique de stockage.

Connexions HTTP

HTTPS est obligatoire par défaut. Laissez Allow HTTP Media Sync désactivé en usage normal. Un administrateur peut l’activer pour une connexion HTTP approuvée ou un tunnel de développement ; les adresses HTTPS restent en HTTPS. Les deux côtés doivent prendre cette option en charge.

Warning

HTTP ne chiffre pas les médias transférés. N’activez cette option qu’avec l’accord du responsable réseau et désactivez-la après le dépannage.