Actions Playbook personnalisées

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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 et de terminer 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 du 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 des clients déclenchent des événements dans , reportez-vous à Générateur d'IUla section Configurer les actions du client UXF pour le playbook.

    Les enregistrements de données de flux (sys_flow_data) sont souvent utilisés comme 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 au sein d’un flux.

    Les enregistrements de données de flux peuvent également collecter des données utilisateur auprès d’un agent afin de 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 accomplir la logique de workflow de processus business que vous souhaitez.

    Vous pouvez activer la fonctionnalité d’enregistrement et puis sur toutes les actions de script hors serveur en cochant la case Champs de formulaire requis . Une action dotée de la fonctionnalité « enregistrer et puis » soumet un formulaire, effectue des scripts clients et des validations de règles métier, puis exécute l’action une fois l’enregistrement enregistré avec succès. L’action ne s’exécute pas si une validation ou une règle métier empêche la sauvegarde de l’enregistrement. Par défaut, cela déclenchera l’action d’interface utilisateur sysverb_ws_save pour soumettre le formulaire, 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 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 connaissances
    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 formulaire de nouvel enregistrement
    Envoyer un e-mail

    send_email

    		 Informe l’automatisation des processus pour envoyer un e-mail
    Redémarrer

    restart_activity

    		 Redémarre l’activité
    Ignorer

    skip_activity

    		 Marquez les activités utilisant un enregistrement d’é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 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 du processus de liste comme terminée
    Marquer comme terminé

    mark_complete

    		 Marque le processus en cours 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 et de scripts, de composants ou d’actions du client. Cette personnalisation permet aux utilisateurs de soumettre des formulaires, d’ouvrir des enregistrements et de terminer et 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 s’affichent en lecture seule.
    • Les actions ne peuvent opérer que sur 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 de 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’action. Une affectation d’action remplace les 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 sur 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 du 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 continuer.
        Ce champ est utilisé dans l’interface utilisateur de l’expérience de playbook de la manière suivante.
        1. Lorsqu’une activité contient un formulaire trop volumineux pour tenir sur une carte, le formulaire est masqué dans une fenêtre modale.
        2. Lorsqu’une activité contient un formulaire, mais n’a pas d’actions qui nécessitent des champs de formulaire, le formulaire n’est pas affiché. 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 rendu d’activité personnalisé.
        Description Description de l’action affichée dans la liste Affectations d’action.
        Demande 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.
        Commande 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 a de chances 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 des conditions pour l’action.
      1. Cliquez sur l’onglet Conditions .
      2. Renseignez les champs du formulaire.
        Tableau 2. Formulaire Conditions
        Champ Description
        Condition de script Condition de script pour l’affectation de l’action. Entrez sn_playbook. ExpériencePlaybook.parentRecordContainsPlaybook(actuel). 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 nuire aux performances.
        Conditions du client Choisissez les conditions pour limiter les collisions en fonction de votre cas d’utilisation.
        Conditions d'enregistrement Choisissez les conditions pour limiter les collisions en fonction de votre cas d’utilisation.
        Rôles requis Rôles permettant de limiter l’accès au Playbook.
        Nécessite la création de l'accès Options pour exiger la création d’un 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 un accès en écriture.
        Nécessite la suppression de l'accès Options pour exiger la suppression de l’accès.
    3. Si le 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 que l’utilisateur fournit à partir de 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 la 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 Prévisualiser 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 defaultTab pour ce faire.

    5. Si Composant de l’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

    Appliquez 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 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 d’action déclarative
      Expérience de playbook Choisir l’expérience de playbook à laquelle appliquer l’action
      Demande Application dans laquelle l’action est appliquée
      Définition d'activité Sélectionner la définition d’activité à 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 de playbook à Espace de travail.