> ## 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.

# External playlists

Au lieu d'utiliser une **playlist définie manuellement**, vous pouvez lier votre playlist à une **source de données externe** telle qu'une **base de données SQL Server, un fichier XML ou un fichier Microsoft Excel**. Cela permet des **mises à jour de données en temps réel** pour contrôler dynamiquement le contenu affiché.

Pour plus de détails sur **la liaison d'un élément** à une source de données externe, consultez **les propriétés du fournisseur de données** et **le travail avec les fournisseurs de données**.

***

## **Structure XML pour les listes de lecture externes**

Pour être reconnues par **PADS4**, les listes de lecture externes doivent suivre une **structure XML spécifique**. Voici un exemple :

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<PlayList>
  <PlayListElement ContentType="3" Duration="5000" Effect="999" EffectDuration="1000">Text of the first playlist item</PlayListElement>
  <PlayListElement ContentType="3" Duration="5000" Effect="999" EffectDuration="1000">Text of the second playlist item</PlayListElement>
</PlayList>
```

### **Détails clés :**

* Les éléments textuels de la liste de lecture peuvent contenir **plusieurs lignes**, séparées par un **\[Enter]**.
* **Duration** et **EffectDuration** sont mesurés en **millisecondes**.

***

## **Déterminer la structure XML correcte**

Chaque **type d'élément** nécessite un **format XML** légèrement différent. Pour garantir la structure correcte, suivez ces étapes :

1. **Insérez le type d'élément** qui lira la liste de lecture externe (par exemple, un **élément vidéo/son** pour une liste de lecture vidéo).
2. **Ajoutez manuellement des exemples d'éléments de liste de lecture** avec un contenu similaire à ce qui sera dans la source de données.
3. **Ouvrez la fenêtre de liste de lecture** et récupérez la structure XML.
4. **Copiez le XML dans le presse-papiers** et collez-le dans votre source de données.
5. **Modifiez la structure** pour répondre exactement à vos besoins.

***

## **Lecture des listes de lecture externes**

Le comportement d'une **liste de lecture externe** est déterminé par :

* La **structure XML** fournie par la source de données.
* Les **options de liste de lecture** définies dans l'élément de page.
* Les paramètres de **durée par défaut** et **effets de transition par défaut**.
* Si **le défilement des données** est activé, la **propriété d'intervalle de défilement** influencera également la lecture.

***

## **Stockage des listes de lecture dans une colonne (uniquement pour le fournisseur de données XML)**

Si vous devez stocker des **listes de lecture imbriquées** dans un **fichier XML**, l'analyseur XML peut mal interpréter la structure. Pour éviter cela, **remplacez** `<` et `>` par `&lt;` et `&gt;`.

### **Exemple de XML corrigé :**

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<list>
  <item>
    &lt;?xml version="1.0" encoding="utf-8"?&gt;
    &lt;PlayList&gt;
      &lt;PlayListElement ContentType="3" Duration="5000" Effect="999" EffectDuration="1000"&gt;Text of the first playlist item&lt;/PlayListElement&gt;
      &lt;PlayListElement ContentType="3" Duration="5000" Effect="999" EffectDuration="1000"&gt;Text of the second playlist item&lt;/PlayListElement&gt;
    &lt;/PlayList&gt;
  </item>
</list>
```

***

## **Résumé des énumérations de liste de lecture**

### **Valeurs de type de contenu**

| Valeur | Description                                                                                             |
| ------ | ------------------------------------------------------------------------------------------------------- |
| **0**  | Nom de fichier de la bibliothèque de contenu (fichier stocké dans la **bibliothèque de contenu PADS4**) |
| **1**  | Chemin complet du fichier (fichier situé en dehors de la **bibliothèque de contenu PADS4**)             |
| **2**  | Séparateur (pause entre les éléments de la liste de lecture)                                            |
| **3**  | Contenu intégré (par exemple, texte)                                                                    |
| **4**  | Contenu hexadécimal (par exemple, **commandes RS-232**)                                                 |

***

### **Valeurs d'effet**

| Valeur  | Description                                                           |
| ------- | --------------------------------------------------------------------- |
| **0**   | Aucun                                                                 |
| **1**   | Défilement vers le haut                                               |
| **2**   | Défilement vers le bas                                                |
| **3**   | Défilement vers la gauche                                             |
| **4**   | Défilement vers la droite                                             |
| **5**   | Barres horizontales                                                   |
| **6**   | Barres verticales                                                     |
| **7**   | Stores horizontaux                                                    |
| **8**   | Stores verticaux                                                      |
| **9**   | Rectangle en expansion                                                |
| **10**  | Cercle tranché                                                        |
| **11**  | Effet aléatoire                                                       |
| **12**  | Fondu entrant                                                         |
| **13**  | Dissolution                                                           |
| **14**  | Retournement                                                          |
| **15**  | Rétrécissement vers le centre                                         |
| **16**  | Division horizontale                                                  |
| **17**  | Division verticale                                                    |
| **18**  | Twister                                                               |
| **19**  | Zoom avant                                                            |
| **20**  | Tourner la page depuis la gauche                                      |
| **21**  | Tourner la page depuis la droite                                      |
| **22**  | Tourner la page vers la droite                                        |
| **23**  | Tourner la page vers la gauche                                        |
| **24**  | Déplacement vers la gauche                                            |
| **25**  | Déplacement vers la droite                                            |
| **26**  | Déplacement vers le haut                                              |
| **27**  | Déplacement vers le bas                                               |
| **28**  | Réservé                                                               |
| **29**  | Flush (**effet HTML5 Viewer**)                                        |
| **30**  | Vortex (**effet HTML5 Viewer**)                                       |
| **31**  | Rebond (**effet HTML5 Viewer**)                                       |
| **999** | Effet par défaut (utilise la propriété **Default Transition Effect**) |

***

### **Notes finales**

* L'utilisation de **listes de lecture externes** garantit des **mises à jour dynamiques du contenu** sans intervention manuelle.
* **Les fournisseurs de données** peuvent être utilisés pour récupérer des éléments de liste de lecture en temps réel.
* Testez toujours votre **structure XML** en récupérant un **exemple de PADS4** avant de l'implémenter dans un environnement de production.
