Déclencher manuellement un Playbook

Utilisez un script serveur pour déclencher manuellement un playbook.

Déclencher la fonction Playbook

Déclenchez manuellement un Playbook à l’aide d’une fonction de script serveur avec le code suivant :

sn_playbook.PlaybookExperience.triggerPlaybook('<scoped name>',parentRecord);

Remplacez < nom du champ d’application > par le nom du champ d’application de votre playbook. Pour trouver le nom inclus dans le périmètre, localisez la définition du processus dans la table sys__process_definition et copiez les champs de nom et de périmètre de l’application. Remplacez parentRecord par l’entrée/l’enregistrement parent sur lequel vous souhaitez exécuter le processus.

En cas d’échec, le script serveur lève une exception. Vous pouvez ajouter un message d’information en cas de réussite et un message d’erreur en cas d’échec.

Fonctions d’aide

Utilisez la fonction scriptable suivante pour déterminer si un Playbook est déjà en cours d’exécution sur un enregistrement avant d’afficher une action d’interface utilisateur ou une action déclarative pour le déclencher.

sn_playbook.PlaybookExperience.parentRecordContainsPlaybook(parentRecord, '<scoped name>')

Pour afficher tous les playbooks exécutés sur un enregistrement parent donné, utilisez le code suivant :

sn_playbook.PlaybookExperience.getPlaybooksForParentRecord(parentRecord)

Ces informations peuvent être utilisées pour contrôler quand afficher une action de playbook de déclenchement telle qu’une action d’interface utilisateur.

La section suivante est un exemple d’utilisation de la fonction de déclenchement du playbook pour créer un bouton Ajouter un playbook.

Créer une action d’interface utilisateur Ajouter un Playbook

Créer une action d’interface utilisateur Ajouter un Playbook dans l’espace de travail.

Avant de commencer

Rôle requis : workspace_admin

Procédure

1. Accédez à la Tout > Définitions système > Actions d'interface utilisateur.
2. Cliquez sur Nouveau.
3. Renseignez les champs du formulaire.
   Remarque :

   D’autres champs que ceux de la table suivante apparaissent dans le formulaire, mais ils ne fonctionnent pas dans les espaces de travail. Pour en savoir plus sur chaque champ du formulaire Actions d’interface utilisateur, reportez-vous Configurer des actions d’interface utilisateur personnalisées dans legacy workspaceà .

   Tableau 1. Formulaire Action d’interface utilisateur

   Champ	Description
   Nom	Nom de l’action d’interface utilisateur. Cela apparaît dans l’interface utilisateur de l’espace de travail, par exemple, Ajouter un playbook d’intégration.
   Table	Table à laquelle l’action d’interface utilisateur s’applique. Chaque fois qu’un agent affiche un enregistrement de cette table, cette action d’interface utilisateur s’affiche.
   Ordre	Placement dans la liste horizontale des actions d’interface utilisateur. De gauche à droite, les numéros d’ordre vont du plus petit au plus grand.
   Nom de l'action	Équivalent du nom qui apparaît dans les journaux et les colonnes de table, par exemple, interaction_add_onboarding
   Actif	Basculez pour faire apparaître l’action d’interface utilisateur.
   Afficher la mise à jour	Activer/désactiver cette option pour afficher la mise à jour dans la table.
   Condition	Conditions qui doivent être remplies pour que l’action d’interface utilisateur s’affiche, par exemple, current.canWrite() && !sn_playbook. PlaybookExperience.parentRecordContainsPlaybook(current, « sn_pad_demo.playbook_onboarding_demo »).
   Script	Script côté serveur qui implémente l’action d’interface utilisateur.
   Application	Application à laquelle ce composant s’applique. Global signifie que le composant s’applique à toutes les applications.

4. Pour créer un script côté serveur qui implémente l’action ajouter un playbook, saisissez le script dans le champ Script .

   try{
   	current.update();
   	sn_playbook.PlaybookExperience.triggerPlaybook('sn_pad_demo.playbook_onboarding_demo',current);
   	gs.addInfoMessage(gs.getMessage("Onboarding Playbook added to Interaction."));
   } catch(e){
   		gs.addErrorMessage(e.getMessage());
   }

   Le système ignore les scripts clients inclus dans ce champ. Vous ne pouvez utiliser le champ de script client de l’espace de travail que pour les scripts clients. Remplacez sn_pad_demo.playbook_onboarding_demo par le nom délimité de votre playbook. Pour trouver le nom inclus dans le périmètre, localisez la définition du processus dans la table sys__process_definition et copiez les champs de nom et de périmètre de l’application.

5. Dans l’onglet Espace de travail , sélectionnez : Bouton de formulaire d’espace de travail pour faire apparaître le bouton Ajouter un playbook sur la ligne des actions d’interface utilisateur ou Menu de formulaire d’espace de travail pour le faire apparaître sous forme de liste dans la liste de menu.
6. Dans le champ Script client de l’espace de travail , créez un script client spécifique à l’espace de travail.
   Workspace présente des limitations de scripting client similaires à celles de Portail de services. Par exemple, pour ouvrir un formulaire en cliquant dessus, vous pouvez ajouter le script client suivant :

   function onClick(g_form) {
   
   }