`$script.setContext`¶

Description¶

Définit le contexte actuel pour l'exécution du script. Cela permet de définir le contexte de résolution des variables faisant référence à un contexte.

Différence avec $doc.open

Les méthodes $script.setContext et $doc.open ne remplissent pas le même rôle:

$script.setContext agit uniquement au niveau du script. Cette méthode est capable d'ouvrir un dossier si celui-ci n'est pas déjà ouvert, mais cela n'a d'effet que sur le script en cours. Le dossier est fermé une fois l'exécution du script terminée.
$doc.open ouvre un dossier et celui-ci reste ouvert au-delà de l'exécution du script. Cela signifie que l'application affichera le dossier ouvert à la fin de l'exécution du script.

Comme Ewt est capable d'ouvrir plusieurs dossiers simultanément, on peut également voir $script.setContext comme un moyen de basculer d'un dossier à l'autre lors de l'exécution du script.

À titre d'illustration, considérons le script suivant:

$doc.open({ modelName: "demande", docId: "afedc0ec-89b9-4781-a488-a2895ff9e6f6"});
$script.setContext({ modelName: "client", docId: "df0675fd-2039-43e1-a3de-7739f978407c" });
$logger.info(#numeroEGID);  // valeur lue du dossier "client"

Ce script ouvre un dossier du modèle "demande". Cela aura pour effet d'afficher le contenu de ce dossier dans le navigateur lors de l'affichage de la réponse du serveur. À la ligne 2, le script modifie le contexte courant d'exécution pour basculer sur un dossier "client". Cela a pour effet de charger le dossier "client" en mémoire, ainsi les références de contexte au sein du script porteront sur ce dossier, mais cela n'influe pas sur le dossier qui sera affiché au refresh.

Syntaxe¶

$script.setContext( contexte )

Paramètres¶

contexte string / map: Valeur décrivant le contexte. Le paramètre peut désigner soit un contexte (exprimé en tant que string en clair, p.ex. vendeur[123].info[123].nom ou sous forme de hash) ou un map décrivant le contexte.

Retour¶

Si le contexte peut être défini, la méthode retourne le contexte lui-même sous forme de map, sinon la méthode retourne null

Exemple¶

Non disponible

$script.setContext¶