Section Monitor Sync
Monitor Sync
Monitor Sync est une fonctionnalité qui permet au lecteur de synchroniser périodiquement des copies locales de fichiers avec leurs sources distantes via HTTP ou FTP. Typiquement, cette fonctionnalité est utilisée pour récupérer de petits fichiers de données contenant des informations sensibles au facteur temps, telles que des informations sur la météo ou les cours de la bourse.
La section Monitor Sync contient deux onglets :
- URLs – Permet de configurer les fichiers à synchroniser. Pour un tutoriel approfondi, consultez Moniteur de synchronisation.
- Core – Contrôle le comportement de synchronisation global du moniteur.
Note : Cette section est l'une des nombreuses sous « Configuration Profile Properties » pour les lecteurs. Pour des informations générales, voir Profils de configuration - Lecteurs. Pour les profils de serveur Edge, voir Profils de configuration - Serveurs Edge.
La fonction Monitor Sync permet aux opérateurs de s'identifier et de communiquer avec leurs Broadsign Control Players en utilisant des cookies.
Il est possible de configurer les Broadsign Control Players pour récupérer des fichiers à partir de serveurs HTTP tiers externes, par exemple, les gagnants du loto ou les flux météorologiques. Ces serveurs utilisent parfois des cookies pour conserver des informations entre les appels. Les fonctionnalités de Monitor Sync permettent aux utilisateurs de serveurs HTTP tiers externes de tirer parti de cette fonctionnalité HTTP standard. Par exemple, la source distante peut envoyer un cookie tel qu'un Session Id via le Protocole de synchronisation du moniteur de Broadsign. Le Broadsign Control Player réutilisera le cookie envoyé lors des requêtes suivantes.
Les cookies HTTP reçus dans un en-tête de réponse HTTP par les requêtes Monitor Sync seront envoyés avec les appels HTTP suivants au même domaine. Le chemin et la durée de validité du cookie seront respectés s'ils sont définis.
Notez également que :
- Les cookies ne seront pas partageables avec les packages HTML ni les redirections Web.
- Les cookies ne seront pas partageables lors de la synchronisation de dossiers distants FTP.
Exemple
Cette section décrit un scénario illustratif.
- Le cookie sera renvoyé dans l'en-tête
Set-Cookiede la réponse Monitor Sync, au format suivant : - Lors des requêtes suivantes, Monitor Sync enverra l'en-tête
Cookieavec la valeur suivante : - Lorsqu'une nouvelle session est démarrée, la prochaine réponse de Monitor Sync renverra l'en-tête
Set-Cookiecontenant un nouveau cookie. Ce nouveau cookie devrait alors remplacer l'ancien. - Le composant Monitor Sync de Broadsign reçoit le cookie et est le seul composant qui nécessite d'accéder au cookie.
SESSIONID=ztu968v9pw5ghESE; Path=/; Secure; HttpOnly; SameSite=Strict
SESSIONID=ztu968v9pw5ghESE
L'onglet URLs contient toutes les informations relatives aux fichiers synchronisés par Monitor Sync. Lors de l'ajout d'une nouvelle URL, vous pouvez spécifier une source http ou ftp.
Pour un tutoriel approfondi, consultez Moniteur de synchronisation.
Dans l'onglet URLs, vous pouvez basculer entre le mode basique et le mode avancé :
- Mode de base – Présente une interface utilisateur graphique.
- Mode avancé – Peut être utile si vous souhaitez copier et coller une configuration compliquée dans une autre sans avoir à la recréer via l'interface. Voir Mode avancé.
Pour ouvrir la boîte de dialogue Synchronization URL, cliquez sur Add.
Les paramètres suivants sont disponibles :
- Remote URL
- Destination Path
- Append Player ID to Remote URL
- Append Location Code to Remote URL
- Use URL Variables
- Synchronization Options
- Scripting Options
Remote URL
- Description – L’adresse web du serveur distant à partir duquel récupérer les informations.
- Requirements – Doit commencer par http://, https://, ou ftp://.
- Encoding Credentials – Les noms d'utilisateur et les mots de passe peuvent être encodés directement dans l'URL.
Exemple : http://username:passwd@test.com/test.xml .
Destination Path
- Description – Chemin d'accès local sur le système du lecteur où est stocké le contenu synchronisé. Le chemin peut être relatif ou absolu.
- Absolute Path – Assurez-vous que l'utilisateur Broadsign Control Player dispose des autorisations de lecture/écriture sur ce dossier.
- Relative Path – Le contenu est synchronisé avec le chemin de données de l'application du lecteur, qui se trouve à l'un des emplacements suivants :
- Lecteur dédié Windows 10 – C:\ProgramData\BroadSign\bsp\share\bsp\sync
- Windows 10 non dédié – C:\Users\[NOM_UTILISATEUR]\AppData\Roaming\BroadSign\bsp\share\bsp\sync
- Lecteur dédié Windows 11 – C:\ProgramData\BroadSign\bsp\share\bsp\sync
- Windows 11 non dédié – C:\Users\[NOM_UTILISATEUR]\AppData\Roaming\BroadSign\bsp\share\bsp\sync
- Linux – /opt/broadsign/suite/bsp/share/bsp/sync
Exemple : c:\quelquechose
Note : Si vous utilisez la fonctionnalité SmartFeed, ce chemin est obligatoire. Si aucun chemin spécifique n'est requis, indiquez le répertoire courant (« . »).
Append Player ID to Remote URL
- Description – Modifie dynamiquement l'URL en fonction de l'identifiant du lecteur. Cela vous permet de cibler des lecteurs spécifiques en incluant l'identifiant unique du lecteur dans l'URL.
- Exemple FTP :
- URL FTP d'origine – ftp://test.com/files
- Nouvelle URL – ftp://test.com/files/12345
où 12345 est l'ID du lecteur qui récupère l'URL
- Exemple HTTP :
- URL HTTP d'origine – http://test.com/test.xml
- Nouvelle URL – http://test.com/test.xml?player_id=12345678
où 12345678 est l'ID du lecteur récupérant l'URL
Append Location Code to Remote URL
- Description – Modifie dynamiquement l'URL en fonction du code de localisation. Cela vous permet de cibler des écrans spécifiques en ajoutant leur code de localisation à l'URL.
- Exemple FTP (avec code d'emplacement « YUL ») :
- URL FTP d'origine – ftp://test@test:wether.example.com/test
- Nouvelle URL FTP – ftp://test@test:wether.example.com/test/YUL
Note : Si vous avez activé l'ajout de l'ID du lecteur et du code de localisation, Broadsign Control Player ajoutera d'abord le code de localisation, puis l'ID du lecteur. Par exemple : ftp://test@test:weather.example.com/test/YUL/123456/
Use URL Variables
- Description – Transforme dynamiquement l'URL demandée par Broadsign Control Player en utilisant des variables de contenu. Se référer à Variables de contenu pour obtenir la liste et la description des variables disponibles.
- Format – Les variables sont identifiées par {{variable_name}}.
- Toutes les variables automatiques, ainsi que les variables du lecteur et/ou de l'unité d'affichage, peuvent être utilisées et suivent les mêmes règles d'héritage.
- Les variables liées au contenu diffusé sont exclues (frame_id, frame_resolution, ad_copy_id, campaign_id).
- Le remplacement de variable peut se produire n'importe où dans l'URL, sauf dans le protocole.
- Il est possible d'avoir plusieurs variables dans la même URL.
- Par exemple, si l'URL distante est http://cdn.test.com/audience/{{display_unit_id}}.csv et que l'identifiant de l'unité d'affichage du lecteur est 33333, l'URL demandée par le lecteur sera : http://cdn.test.com/audience/33333.csv.
Synchronization Options
Protocol
Dans les profils de configuration v13.2+, ce paramètre définit le protocole à utiliser lors de la synchronisation des dossiers. Les protocoles disponibles sont FTP et HTTP/HTTPS.
Les options Sync behavior diffèrent selon le protocole sélectionné. FTP est le protocole par défaut.
Avertissement : Soyez prudent lorsque vous utilisez les options de comportement de synchronisation. Les fichiers et dossiers qui existent dans le chemin de destination qui n'existent pas sur le serveur FTP distant seront supprimés. Pour cette raison, un chemin de destination de « c:\ » détruira effectivement votre système d'exploitation. Soyez prudent.
Sync Behavior
Comment la synchronisation est appliquée. Vous pouvez sélectionner l'une des options suivantes :
- Sync file – Copie un fichier distant spécifique sur la machine locale.
- Sync remote folder – Copie l'intégralité du dossier distant sur la machine locale, mais sans les sous-dossiers. Il vérifie également l'horodatage des fichiers afin d'éviter que le lecteur ne télécharge à nouveau le contenu.
- Sync remote folder and subfolders – Synchronisation récursive de tous les sous-dossiers également.
- Sync using manifest – Synchronise les fichiers en fonction des informations définies dans le fichier manifeste. Cette option est disponible uniquement pour le protocole HTTP/HTTPS.
- Le chemin d'accès au fichier manifeste est défini dans le champ Remote URL.
- L'emplacement sur le système du lecteur local où le contenu synchronisé sera stocké est défini dans le champ Destination path.
Note : Si vous utilisez l'option Sync remote folder ou Sync remote folder and subfolders, sachez que Broadsign Control ne prend en charge que les serveurs HTTP Nginx, Apache et IIS avec l'affichage des répertoires activé. Broadsign Control utilise des configurations natives, donc si vous modifiez le format de date, par exemple, la synchronisation risque de ne pas fonctionner correctement.
Pour plus d'informations sur le format à utiliser pour un fichier manifeste, consultez Synchronisation des manifestes pour HTTP/HTTPS.
Lorsque vous utilisez les options Sync remote folder et Sync remote folder and subfolders, l’URL source doit effectivement contenir un dossier réel. Par exemple, ftp://user:pass@ftp.example.com/folder/ fonctionnerait, alors que ftp://user:pass@ftp.example.com/ ne fonctionnerait pas.
Sync Mode
Méthode de synchronisation utilisée. Vous pouvez sélectionner l'une des options suivantes :
-
Atomic – Télécharge tous les fichiers depuis l'URL distante FTP ou HTTP/HTTPS vers le lecteur avant d'apporter toute modification au contenu.
Note : Lors de la synchronisation des fichiers, le lecteur garantira une transmission atomique. Cela garantit que le lecteur ne recevra pas une copie partielle des données distantes. Tous les fichiers sont synchronisés localement sous forme de fichiers .part. Lorsque la transaction est effectuée avec succès, Broadsign leur redonne leurs noms d'origine.
-
Progressive – Apporte des modifications au lecteur pour chaque fichier dès son téléchargement.
Refresh Period
Définit la fréquence de synchronisation locale de l'URL distante, c'est-à-dire la fréquence à laquelle le lecteur vérifie la présence de nouveaux fichiers sur l'URL distante. Exprimé en hh:mm:ss.
Timeout Period
Contrôle la durée d'attente du lecteur en cas de délai d'expiration du serveur, c'est-à-dire la durée pendant laquelle le lecteur attendra avant de mettre fin aux connexions bloquées. Par défaut, 30 secondes.
Scripting Options
- Enable SmartFeed – Vous pouvez activer la fonctionnalité SmartFeed de Broadsign. Voir SmartFeed.
- Edit Script – Ouvre l'éditeur de script. Pour plus d'informations, consultez SmartFeed.
Expiry Period
Lorsqu'une URL de synchronisation de moniteur est directement associée à une copie publicitaire, cette option devient disponible dans l'onglet URLs de la copie publicitaire.
La copie publicitaire peut être supprimée de la boucle lorsque le flux de données associé devient obsolète. En règle générale, cette option est activée lorsque le choix est fait qu'il est préférable de ne pas afficher de contenu plutôt que du contenu obsolète. La période spécifiée peut s'écouler parce que le serveur distant n'est pas disponible ou que le contenu du flux distant n'a pas changé.
Broadsign vous permet de définir une liste de fichiers à synchroniser. Cette liste est définie dans un fichier manifeste.
Le fichier manifeste peut être utilisé lorsque le protocole sélectionné est HTTP/HTTPS. Lors de l'utilisation d'un tel fichier, le comportement suivant est observé :
- Les fichiers qui n'ont pas été modifiés ne sont pas récupérés à nouveau.
- Les dossiers sont automatiquement créés sur le système de fichiers local selon les besoins.
- Tous les dossiers ou fichiers déjà présents sur le système de fichiers local et qui ne figurent plus dans le fichier manifeste sont supprimés.
Format de fichier manifeste
Si vous avez configuré l'URL de synchronisation pour qu'elle pointe vers un manifeste, vous devez définir le fichier manifeste au format suivant :
{
"metadata": {
"version":1,
"utc_generation_time_ms":1560801541230
},
"files": [{
"url":"https://example.com/doc/file1.png",
"utc_last_modified_time_ms":1560801541230,
"md5":"12341234234234234",
"local_path":"sync/file1.png"
},
{
"url":"https://example.com/doc/file2.png",
"utc_last_modified_time_ms":1560801541230,
"md5":"12341234234234234",
"local_path":"sync/file2.png"
},
{
"url":"https://example.com/doc/media/file1.png",
"utc_last_modified_time_ms":1560801541230,
"md5":"12341234234234234",
"local_path":"sync/media/file1.png"
},
{
"url":"https://example.com/temp/b/file1.png",
"utc_last_modified_time_ms":1560801541230,
"md5":"12341234234234234",
"local_path":"sync/media/b/file1.png"
}]
}
Paramètres manifestes
Le tableau suivant décrit les paramètres disponibles dans le fichier Manifest :
| Paramètre | Description |
|---|---|
| metadata | Contient les métadonnées du fichier manifeste. |
| metadata.version | Version du protocole cible. |
| metadata.utc_generation_time_ms | Données de génération du fichier Manifest, en millisecondes, depuis l'époque (UTC). |
| files | Liste des fichiers à synchroniser. |
| file.url | Lien HTTP/HTTPS complet vers le contenu du fichier à synchroniser. |
| file.utc_last_modified_time_ms | Dernière modification, en millisecondes, depuis l'époque (UTC). |
| file.md5 | Garantit l'absence de corruption de fichiers pendant le transfert (facultatif). |
| file.local_path |
Chemin local où le fichier est enregistré. Le chemin est toujours relatif au Destination path spécifié dans la fenêtre Synchronization URL (voir Paramètres de configuration pour plus de détails). |
L'onglet Core offre un mécanisme permettant de mettre à jour périodiquement un fichier local à partir d'une source distante. Pour plus de détails sur les variables et leur utilisation, consultez Variables de contenu.
| Contenu | Description |
| Enabled | Permet de contrôler si le mécanisme de synchronisation du moniteur est activé sur le lecteur. |
| Respect network controls | Contrôle si le lecteur respectera les plages horaires de contrôle réseau en ce qui concerne la fonction de synchronisation des fichiers. Voir Contrôle du réseau. |
|
Append Resource ID Append Location Code Append Address |
Contrôle s'il faut ajouter des variables dynamiques telles que l'identifiant de ressource du lecteur, le code postal et l'adresse aux URL HTTP récupérées afin de permettre une logique côté serveur intelligente qui personnalise le document de réponse pour chaque client. Pour plus de détails, voir Variables de contenu. |



