Actions Playbook personnalisées

Personnalisez les interactions Playbook en configurant des conditions qui ajoutent des boutons, des listes déroulantes, des éléments de liste et des icônes interactives. Cette personnalisation vous permet de soumettre des formulaires, d’ouvrir des enregistrements, ainsi que d’effectuer et d’ignorer des activités dans toutes les expériences Playbook.

Vue d'ensemble

Les actions Playbook peuvent exécuter des scripts serveur, répartir des actions client ou afficher des composants d’interface utilisateur lorsqu’elles sont déclenchées. Lors de l’exécution de scripts serveur, la variable actuelle est liée à l’enregistrement associé à l’activité. Si vous souhaitez que les actions du client déclenchent des événements dans Générateur d'IU, reportez-vous à la section Configurer les actions du client UXF pour le playbook.

Les enregistrements de données de flux (sys_flow_data) sont souvent utilisés en tant qu’enregistrements associés pour contrôler la configuration d’un flux via un script serveur d’action. Ces scripts serveur peuvent définir l’état des flux sur Terminé ou Ignoré, ce qui permet à un agent d’affecter directement la logique d’un flux.

Les enregistrements de données de flux peuvent également collecter des données utilisateur auprès d’un agent pour les utiliser dans un flux.

Un enregistrement associé peut être lié à n’importe quelle table. Vous pouvez définir vos propres actions au-delà de ces actions par défaut pour exécuter la logique de workflow de processus business que vous souhaitez.

Vous pouvez activer la fonctionnalité Enregistrer et puis sur toutes les actions de script non serveur en cochant la case Requiert des champs de formulaire . Une action dotée de la fonctionnalité « enregistrer puis » soumet un formulaire, effectue des scripts clients et des validations de règles métier, et exécute l’action une fois l’enregistrement enregistré. L’action ne s’exécute pas si une validation ou une règle métier empêche l’enregistrement de sauvegarder. Par défaut, cette action déclenche l’envoi du formulaire par l’action d’interface utilisateur sysverb_ws_save, mais peut être remplacée en spécifiant une autre action d’interface utilisateur dans une propriété uiActionName de la charge utile de l’action client.

Actions par défaut

Les actions par défaut suivantes sont prises en charge dans Playbook.

Nom de l'action	Description
Ignorer skip_instructional	Ignore une étape du processus d’instruction
Ignorer skip_email	Ignore l’envoi d’un e-mail
Ignorer skip_knowledge	Ignore une étape du processus de connaissances
Ignorer skip_update	Ignore une étape du processus de mise à jour de l’enregistrement
Ignorer skip_list	Ignore une étape de processus de liste
Ignorer skip_create	Ignore une étape du processus de création d’un enregistrement
Marquer comme terminé complete_activity	Marquer une activité comme terminée
Créer un enregistrement create_record	Créer un enregistrement à partir d’un formulaire d’enregistrement
Envoyer un e-mail send_email	Informe l’automatisation des processus pour l’envoi d’e-mails
Redémarrer restart_activity	Redémarre l’activité
Ignorer skip_activity	Marquez les activités utilisant un enregistrement de l’état de l’expérience comme ignorées.
Afficher l'enregistrement Afficher l'enregistrement	Afficher l’enregistrement actuel
Enregistrer save_record	Enregistrer l'enregistrement actuel
Afficher les approbateurs Approbateurs des vues de Playbook	Afficher les approbateurs de cet enregistrement
Marquer comme terminé mark_complete_knowledge	Marque une étape de processus de connaissances comme terminée
Marquer comme terminé mark_complete_instructional	Marque une étape du processus d’instruction comme terminée
Marquer comme terminé mark_complete_list	Marque une étape de processus de liste comme terminée
Marquer comme terminé mark_complete	Marque le processus actuel comme terminé
Marquer comme terminé save_and_complete_activity	Enregistrer l’enregistrement actuel et marquer le processus comme terminé

Personnaliser les actions Playbook

Personnalisez les actions Playbook à l’aide de formulaires, de conditions, de scripts, de composants ou d’actions client. Cette personnalisation permet aux utilisateurs de soumettre des formulaires, d’ouvrir des enregistrements, d’effectuer et d’ignorer des activités.

Avant de commencer

Rôle requis : playbook_experience.admin

Pourquoi et quand exécuter cette tâche

• Les actions par défaut ne peuvent pas être modifiées. Ces actions sont affichées en lecture seule.
• Les actions ne peuvent s’appliquer qu’à un seul enregistrement.

Procédure

1. Créez l’action et spécifiez les détails.
   1. Accédez à la Expérience de playbook > Actions Actions Playbook, actions d’étape ou actions d’activité.
   2. Sélectionnez une affectation d’action ou cliquez sur Nouveau pour en créer une nouvelle.
      Remarque :

      Pour obtenir la liste des actions par défaut, consultez Actions Playbook.
   3. Renseignez les champs du formulaire.

      Tableau 1. Formulaire Affectation d’action

      Champ	Description
      Étiquette de l’action	Étiquette qui apparaît sur le bouton créé via l’action.
      Nom de l'action	Nom de votre action qui apparaît dans la liste d’affectation d’actions. Une affectation d’action en remplace d’autres portant le même nom.
      Implémenté en tant que	Type d’action implémentée. Par exemple, Composant de l’interface utilisateur.
      Spécifier le composant d’interface utilisateur	Lorsque le champ Implémenté en tant que est défini sur Composant d’interface utilisateur, ce champ spécifie un composant d’interface utilisateur qui s’affiche lorsque l’action est déclenchée.
      Info-bulle	Texte qui s’affiche lorsqu’un agent pointe son curseur sur un bouton ou une icône.
      Icône	Icône qui s’affiche dans la carte d’activité.
      Mode de rendu	Mode de rendu sur une carte Playbook. Spécifiez le mode de rendu de l’action sur la carte Playbook. Sélectionnez un bouton, une liste déroulante d’en-tête ou une icône d’en-tête.
      Type de bouton	Type de bouton affiché dans l’interface utilisateur de Playbook. Sélectionnez Primaire, Secondaire ou Tertiaire.
      Champs de formulaire requis	Option qui indique que l’action nécessite des données de l’utilisateur pour se poursuivre. Ce champ est utilisé dans l’interface utilisateur Playbook Experience de la manière suivante. Lorsqu’une activité contient un formulaire trop grand pour tenir sur une carte, le formulaire est masqué dans un modal. Lorsqu’une activité contient un formulaire, mais qu’elle ne comporte pas d’actions nécessitant des champs de formulaire, le formulaire n’est pas affiché. Au lieu de cela, les champs du formulaire sont restitués sous la forme d’une collection empilée de paires étiquette-valeur. Ce champ peut être remplacé par la création d’un convertisseur d’activité personnalisé.
      Description	Description de l’action qui s’affiche dans la liste Affectations d’action.
      Application	Application pour l’affectation d’action.
      Espace de travail	Espace de travail auquel l’action de playbook est associée. Par exemple, ServiceNow® ITSM ou RH. Remarque : Ce champ n’est pas obligatoire.
      Table	Champ permettant de limiter cette action aux activités avec cette table associée.
      Vue	Champ permettant de limiter cette action aux activités avec cette vue de formulaire.
      Actif	Option permettant d’activer l’action.
      Ordre	Entier qui détermine la priorité de cette action par rapport aux actions correspondantes portant le même nom. Plus le nombre est bas, plus il est susceptible d’être sélectionné par rapport à d’autres actions. Cet ordre vous permet de remplacer d’autres actions par les vôtres. La pratique typique consiste à utiliser des nombres qui se comptent par centaines. Par exemple, 100, 200, 300 ou 400.

2. Configurez les conditions de l’action.
   1. Cliquez sur l’onglet Conditions .
   2. Renseignez les champs du formulaire.

      Tableau 2. Formulaire de conditions

      Champ	Description
      Condition de script	Condition de script pour l’affectation d’action. Saisissez sn_playbook. PlaybookExperience.parentRecordContainsPlaybook(current).PlaybookExperience.parentRecordContainsPlaybook(current). Ce script vous permet d’afficher un Playbook uniquement lorsque l’enregistrement a déclenché l’exécution d’un processus. Remarque : L’ajout de requêtes impliquant plusieurs jointures peut altérer les performances.
      Conditions du client	Choisissez des conditions pour limiter les collisions en fonction de votre cas d’utilisation.
      Conditions d'enregistrement	Choisissez des conditions pour limiter les collisions en fonction de votre cas d’utilisation.
      Rôles requis	Rôles pour limiter l’accès au Playbook.
      Nécessite la création de l'accès	Options pour exiger la création de l’accès.
      Nécessite l'accès en lecture	Option pour exiger l’accès en lecture.
      Nécessite l'accès en écriture	Options pour exiger l’accès en écriture.
      Nécessite la suppression de l'accès	Options pour exiger la suppression de l’accès.

3. Si Script serveur est sélectionné dans le champ Implémenté en tant que , fournissez un script pour l’action.
   • Les scripts serveur peuvent référencer l’enregistrement associé d’une activité à l’aide de la Current variable.
   • L’appel current.update() met à jour l’enregistrement associé avec les valeurs fournies par l’utilisateur à partir des formulaires incorporés sur les cartes Playbook.
4. Si l’action du client est sélectionnée dans le champ Implémenté en tant que , spécifiez éventuellement le mappage de charge utile dans l’onglet Attributs d’action .

   Le mappage de charge utile vous permet de remplacer des portions de la charge utile répartie par l’action du client. Par exemple, l’action du client Afficher un aperçu de l’enregistrement vous permet d’ouvrir un enregistrement dans un nouvel Espace de travail onglet. À l’aide du mappage de charge utile, vous pouvez spécifier un onglet d’élément connexe qui s’affiche lorsque le formulaire s’ouvre. Définissez le defaultTab pour ce faire.

5. Si Composant d’interface utilisateur est sélectionné dans le champ Implémenté en tant que , spécifiez éventuellement les attributs du composant dans l’onglet Attributs du composant .
6. Cliquez sur Envoyer.

Appliquer des actions Playbook à des expériences Playbook

Appliquer des actions playbook par défaut ou personnalisées aux expériences playbook.

Avant de commencer

Rôle requis : playbook_experience_admin

Procédure

1. Accédez à la Tous > Expérience de playbook > Expériences Playbook.
2. Sélectionner une expérience playbook.
3. Cliquez sur la liste connexe Mappage des actions.
4. Cliquez sur Nouveau.
5. Renseignez les champs du formulaire.

   Tableau 3. Carte d'affectation de l'action d'Expérience de playbook

   Champ	Description
   Affectation d'action	Sélectionner l’affectation de l’action déclarative
   Expérience de playbook	Choisir l’expérience de playbook à laquelle appliquer l’action
   Application	Application dans laquelle l’action est appliquée
   Définition d'activité	Sélectionner la définition d’activité pour appliquer l’action

6. Cliquez sur Envoyer.
7. Dans la section Liens connexes, sélectionnez l’onglet Mappage de l’expérience de playbook .
8. Vérifiez que l’expérience de playbook a été ajoutée à la table.

Que faire ensuite

Intégrez votre expérience Playbook à Espace de travail.