---
sourceDocument: Interface utilisateur de la Now Platform Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/platform-user-interface

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Interface utilisateur de la Now Platform Xanadu

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Actions Playbook personnalisées

# Actions Playbook personnalisées {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes de lecture

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 {#playbook-actions-components__section_ecg_qzs_1mb}

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](https://servicenow-prod.fluidtopics.net/y760pOA1ikbkJ_NjrNnItg#playbook-client-actions "Créez des actions du client UXF Playbook à utiliser dans Générateur d'IU.").

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 {#playbook-actions-components__section_kwj_tzs_1mb}

Les actions par défaut suivantes sont prises en charge dans Playbook. {#playbook-actions-components__table_sh4_n1t_1mb__entry__2}

| 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é |
[ ]

{#playbook-actions-components__table_sh4_n1t_1mb}

## Personnaliser les actions du Playbook {#ariaid-title2}

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.
{#set-up-custom-actions-playbook__ul_q12_qv3_bmb}

### Procédure

1. Créez l'action et spécifiez les détails.
   1. Accédez à la Expérience de playbookActions 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](https://servicenow-prod.fluidtopics.net/k61f79tvV0IO1KB_z1GLRA#playbook-actions-components "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.").
   3. Renseignez les champs du formulaire.  
      {#set-up-custom-actions-playbook__table_xhl_bhh_bmb__entry__2}

      | 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. 1. Lorsqu'une activité contient un formulaire trop grand pour tenir sur une carte, le formulaire est masqué dans une fenêtre modale. 2. 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. {#set-up-custom-actions-playbook__ol_uhp_yxl_cmb}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. |
      [Tableau 1. Formulaire Affectation d'action]

      {#set-up-custom-actions-playbook__table_xhl_bhh_bmb}
   {#set-up-custom-actions-playbook__substeps_kmf_wgh_bmb}
2. Définissez les conditions de l'action.
   1. Cliquez sur l'onglet Conditions .
   2. Renseignez les champs du formulaire.  
      {#set-up-custom-actions-playbook__table_gss_d3h_bmb__entry__2}

      | Champ | Description |
      |-|-|
      | Condition de script | Condition de script pour l'affectation d'action. Saisissez <kbd class="ph userinput">sn_playbook. PlaybookExperience.parentRecordContainsPlaybook(actuel).</kbd> 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. |
      [Tableau 2. Formulaire de conditions]

      {#set-up-custom-actions-playbook__table_gss_d3h_bmb}
   {#set-up-custom-actions-playbook__substeps_t12_b3h_bmb}
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.
   {#set-up-custom-actions-playbook__ul_rbs_dkn_dmb}
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 {#ariaid-title3}

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 ToutExpérience de playbookExpé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.  
   {#apply-playbook-actions__table_mwc_w33_knb__entry__2}

   | 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 |
   [Tableau 3. Carte d'affectation de l'action Expérience de playbook]

   {#apply-playbook-actions__table_mwc_w33_knb}
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](https://servicenow-prod.fluidtopics.net/_eV~SrOIx~pFebPZjBoFhQ "Intégrer Playbook dans l’onglet Éléments connexes ou le panneau latéral contextuel dans Espace de travail") à Espace de travail.