Actions Playbook personnalisées

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

Vue d'ensemble

Lorsqu’elles sont déclenchées, les actions du playbook peuvent exécuter des scripts serveur, répartir des actions client ou afficher des composants d’interface utilisateur. 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 de serveur d’actions. 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 mettre en œuvre la logique de workflow de processus business que vous souhaitez.

Vous pouvez activer la fonctionnalité enregistrer puis sur toutes les actions des scripts non-serveur en cochant la case Requiert des champs de formulaire . Une action dotée de la fonctionnalité enregistrer puis soumet un formulaire, exécute des scripts clients et des validations de règles métier, puis 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 d’être enregistré. Par défaut, cela déclenche l’envoi du formulaire par l’action d’interface utilisateur sysverb_ws_save, mais peut être remplacé en spécifiant une autre action d’interface utilisateur dans une propriété uiActionName de la charge utile de l’action du 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 connaissance
Ignorer skip_update	Ignore une étape du processus d’enregistrement de mise à jour
Ignorer skip_list	Ignore une étape de processus de liste
Ignorer skip_create	Ignore une étape du processus de création d’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 nouveau 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 du processus de connaissance comme terminée
Marquer comme terminé mark_complete_instructional	Marque qu’une étape du processus d’instruction est 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 du Playbook

Personnalisez les actions du playbook à l’aide de formulaires, de conditions, de scripts, de composants ou d’actions du client. Cette personnalisation permet aux utilisateurs de soumettre des formulaires, d’ouvrir des enregistrements et d’effectuer ou 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, reportez-vous à la section 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éé par l’action.
      Nom de l'action	Nom de votre action qui apparaît dans la liste d’affectation d’actions. Une affectation d’action 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 de l’interface utilisateur, ce champ spécifie un composant de l’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 le bouton, la liste déroulante d’en-tête ou l’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 Expérience Playbook de la manière suivante. Lorsqu’une activité contient un formulaire trop grand pour tenir sur une carte, le formulaire est masqué dans une fenêtre modale. Lorsqu’une activité contient un formulaire, mais ne comporte pas d’actions nécessitant des champs de formulaire, le formulaire n’est pas restitué. Au lieu de cela, les champs du formulaire sont affiché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 affichée dans la liste Affectations d’actions.
      Application	Application pour l’affectation de l’action.
      Espace de travail	Espace de travail auquel l’action du 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 probable qu’il soit 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. Définissez 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(actuel). Ce script vous permet d’afficher un Playbook uniquement lorsque l’enregistrement a déclenché une exécution de processus. Remarque : L’ajout de requêtes impliquant plusieurs jointures peut nuire aux 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 permettant d’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 permettant d’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 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 parties de la charge utile répartie par l’action du client. Par exemple, l’action du client 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. Pour ce faire, définissez le defaultTab .

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 personnalisées ou par défaut aux expériences de playbook.

Avant de commencer

Rôle requis : playbook_experience_admin

Procédure

1. Accédez à la Tout > 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 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.