Les scripts permettent de créer des règles pour exécuter des actions pré-définies, selon un lien de cause à effet. Pour vulgariser: Si je fais ça, alors il se passe ça. 
Dans cet article, nous vous présentons les 3 usages les plus utilisés avec Zélit.

- Navigation dans l'application via un script.
- L'ouverture d'un dossier ou d'un document spécifique depuis une notification.
- L'ouverture d'un dossier ou d'un document spécifique depuis un fichier HTML. 

Prérequis :

Dans les exemples ci-dessous, nous vous fournissons les scripts à utiliser en fonction des situations. Il ne vous restera plus qu'à les personnaliser avec l'ID de vos dossiers/contenu.  L'ID correspond au dernier numéro de l'URL du dossier ou du contenu.

Pour les copier/coller directement depuis la barre d'URL:
- ID de dossiers: depuis votre Studio > Application > Contenus, naviguez dans l'arborescence jusqu'à vous trouver dans le dossier souhaité: L'ID est le dernier numéro de l'URL.
- ID d'un contenu: faites un clic-droit sur le bouton d'édition du contenu et cliquez sur "ouvrir dans un nouvel onglet". Récupérez le dernier numéro de l'URL.

Navigation dans l'application via un script

Cette première utilisation des scripts vous permet de naviguer entre les contenus de l'arborescence, sans suivre l'ordre général des dossiers/sous-dossiers/contenus.
Par exemple: En cliquant sur une miniature dans un dossier A, vous êtes directement redirigé vers le contenu d'un dossier B.

Pour mettre en place ce type de script, rendez-vous dans votre Studio > Application > Contenus, puis placez-vous à l'endroit de l'arborescence où le lien/script doit être inséré. Cliquez sur le bouton "Ajouter un contenus..." dans la colonne de droite > choisissez  "Nouveau script".

Dans la fenêtre de création, configurez votre miniature ainsi que le script suivant:

TouchSell.getNodeById( ID_DU_DOSSIER/DOCUMENT ).then(node => node.open())

Ouverture d'un dossier ou d'un document spécifique depuis une notification.

Les notifications permettent aux administrateurs de communiquer depuis le Studio avec leur utilisateurs qui utilisent l'application. Ces notifications sont régulièrement utilisées pour présenter ou pointer un contenu de l'application. Il est donc plus agréable pour tous de pouvoir accéder à ce contenu directement depuis la notification. 

Plus de détails dans l'article Faire un lien vers un document/dossier dans une notification

Voici le script à ajouter et personnaliser dans le bloc de contenu > Source. 

<p>
 <a
   href="#"
   onclick="TouchSell.getNodeById( ID_DU_DOSSIER/DOCUMENT ).then(node => node.open())"
 >
 Cliquez ici
 </a>
</p>

Ouverture d'un dossier ou d'un document spécifique depuis un fichier HTML

Les fichiers HTML intègrent souvent plusieurs liens différents, c'est pourquoi nous vous proposons d'y intégrer un script en 2 étapes:

Une première partie qui permet d'introduire la notion de script et son fonctionnement:

<script type="text/javascript">
function openNodeById(nodeId) {
  TouchSell.getNodeById(nodeId).then(node => node.open());
}
</script>

Et une seconde partie, qui sera à reproduire pour chaque lien à insérer:

<p>
 <a
  href="javascript:openNodeById(ID_DOSSIER/DOCUMENT)"
 >
 Ouvrir ce dossier
 </a>
</p>

Pour aller plus loin, consultez notre documentation technique.