> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pads4.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Viewer Variables

**Viewer Variables** sont des outils puissants qui permettent un contenu dynamique et contextuel dans les présentations PADS4. Ce sont des **variables personnalisables** attribuées à chaque Viewer et automatiquement remplies pendant l'affichage des présentations. Ces variables permettent la personnalisation du contenu **sans avoir besoin de créer plusieurs présentations** pour différents emplacements ou appareils.

***

## **Que sont les Viewer Variables ?**

* **Des espaces réservés spécifiques au Viewer** qui peuvent ajuster dynamiquement le contenu affiché dans les présentations.
* Utilisées dans **le texte, les fournisseurs de données, les filtres, les règles, les liaisons de propriétés**, et plus encore.
* **Identifiées** dans le contenu en utilisant le format :\
  `#<Viewer Variable name>#`\
  *(Exemple : `#Store Name#`)*

***

## **Où définir les Viewer Variables ?**

### **1. System Management Application (Recommandé)**

* **Ajouter et gérer** les Viewer Variables.
* Attribuer des **valeurs par défaut** qui s'appliquent à tous les Viewers.
* Assure un **contrôle centralisé** et empêche la création ou la suppression non autorisée via PADS4 Agent.

### **2. PADS4 Agent**

* Ajuster les **valeurs pour les Viewers individuels** sous l'onglet **Server**.
* Remplace la valeur par défaut attribuée dans System Management.

### **3. Fenêtre Viewer Options (sur l'appareil Viewer)**

* Ajuster les Viewer Variables directement sur le Viewer pour des **ajustements locaux**.

***

## **Example: Personalized Text with Viewer Variables**

Si vous définissez une Viewer Variable`#Store Name#` avec la valeur par défaut **"New York Health"**, et utilisez ce texte dans un élément de texte :

> **Welcome to the #Store Name#.**

Pendant la lecture, il affichera automatiquement :

> **Welcome to the New York Health.**

Si vous mettez à jour la variable dans PADS4 Agent ou les options du Viewer (par exemple, vers "Chicago Health"), le contenu s'ajustera **sans modifier la présentation**.

***

## **Où les Viewer Variables peuvent-elles être utilisées ?**

* **Champs de texte** dans les éléments.
* **Data Providers** (requêtes, filtres, expressions, tri, chemins de fichiers).
* **Rules** pour le comportement dynamique du contenu.
* **Property bindings**.
* **Playlists** pour les séquences média.
* **Références de fichiers** (par exemple, sélectionner dynamiquement des images en fonction de l'emplacement du Viewer).

***

## **Exemples d'automatisation utilisant les Viewer Variables**

| **Cas d'utilisation**                                | **Exemple**                                                                              |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Informations personnalisées du magasin               | Afficher le nom et l'adresse spécifiques du magasin par Viewer.                          |
| Sélection de produits basée sur la taille du magasin | Filtrer les produits en fonction d'une Viewer Variable comme `#StoreSize#`.              |
| Données spécifiques à la région                      | Utiliser `#Country#` ou des Viewer Variables basées sur le GPS pour du contenu localisé. |
| Affichage dynamique de carte                         | Afficher différentes cartes en fonction de la variable de localisation.                  |

***

## **Quand les Viewer Variables sont-elles transformées en valeurs réelles ?**

| **Contexte**                                                     | **Quand remplacées**                                                                                             |
| ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Dans les sources de données (SQL, XML, JSON, RSS)**            | Lorsque le Viewer lit ou reçoit des données de la source.                                                        |
| **Dans les Data Providers (filtre, tri, expressions)**           | Au début de la récupération des données. Les nouvelles valeurs de variables affectent la prochaine récupération. |
| **Dans les présentations (texte, image, vidéo)**                 | Au démarrage de la présentation.                                                                                 |
| **Dans les règles (règles d'élément, de page, de présentation)** | Au moment où la règle est vérifiée (pas de mise à jour automatique si la variable change).                       |
| **Property bindings (avec data provider)**                       | Lors de la lecture programmée des données.                                                                       |
| **Playlists**                                                    | Remplacées lors du chargement. Pour les playlists alternées, mises à jour au cycle suivant.                      |

***

## **Gestion des Playlists avec les Viewer Variables**

* **Playlist à élément unique, non alternante** :\
  La Viewer Variable est remplacée au moment du chargement et **reste statique** jusqu'au prochain chargement.
* **Playlist alternante** :\
  La Viewer Variable est mise à jour **à chaque intervalle**, permettant des changements dynamiques.

***

## **Remarques importantes**

* **N'utilisez PAS les Viewer Variables pour des valeurs qui changent constamment.**\
  Les Viewer Variables **ne sont pas conçues** pour fonctionner comme des sources de données à haute fréquence (utilisez des Data Providers pour cela).
* Les changements dans les Viewer Variables **ne déclenchent pas automatiquement** la réévaluation de toutes les règles ou l'actualisation du contenu, sauf en cas de rechargement.
* **Fichiers en dehors de la Content Library** référencés avec des Viewer Variables peuvent **ne pas se synchroniser correctement**—conservez les fichiers dans la Content Library.

***

## **Avantages clés**

* **Gestion centralisée du contenu** avec personnalisation locale dynamique.
* **Une seule présentation** desservant plusieurs Viewers avec un contenu unique.
* Facile à mettre à jour et à maintenir—**changez la valeur de la variable, pas la présentation**.
* Améliore **l'automatisation et la communication ciblée** sans reconception complexe.
