$app.sendNotification

Description

Déclenche une notification explicite pour le dossier.

La méthode $app.sendNotification est avant tout destinée à envoyer des notifications personnalisées. Par exemple, en déclarant une notification de ce genre dans le config.xml:

<notification name="my-custom-notification">someScript.ewts</notification>

on pourra alors forcer le déclenchement de la notification en invoquant la méthode

$$app.sendNotification("my-custom-notification");

Envoi de notification automatique

Certaines méthodes de gestion de dossier ($doc.create, $doc.open, etc.) ont une option notify qui permet d'activer l'envoi des notifications.

Syntaxe

$app.sendNotification( context , name [ , suffix [ , parameters ] ] )

Paramètres

context string / map

Objet décrivant l'élément pour lequel on souhaite obtenir les droits. Le paramètre peut désigner soit un contexte (exprimé en tant que string en clair ou sous forme de hash) ou une map décrivant le contexte.

name string

Nom de la notification. La valeur doit correspondre à une notification déclarée dans le fichier de configuration. Le moteur autorise toutefois l'emploi de notifications personnalisées.

suffix string

Suffixe de notification (p.ex. before, after, etc.)

parameters map

Ensemble de paramètres à passer à la notification. Attention, dans le cas de notifications standards (c.-à-d. des notifications reconnues par le moteur), l'application est responsable de reprendre les bonnes valeurs de paramètres, c'est-à-dire des valeurs qui correspondent à ce que le moteur utilise lorsqu'il envoie lui-même les notifications.

Retour

Map contenant toutes les variables du scope racine du dernier script évalué. Ce map contient toutes les variables exportées par le script. La méthode retourne null si aucun événement correspondant n'est défini dans le fichier de config.

Exemple

Non disponible