Configurer Slack les modaux dans ServiceNow l’instance

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • Créez un modal et spécifiez les champs qui doivent être affichés dans votre Slack modal. L’interface utilisateur modale peut être générée de deux manières ; automatiquement à l’aide d’une table ServiceNow et manuellement à l’aide d’une vue personnalisée de la charge utile.

    Avant de commencer

    Rôle requis : admin.

    Pourquoi et quand exécuter cette tâche

    Par exemple, si vous souhaitez créer un incident à l’aide du modal dans Slack, le modal Créer un incident nécessite les champs Priorité, Catégorie et Description brève .
    Remarque :
    Des modaux peuvent être déclenchés à partir de ces composants interactifs Slack :
    • Commander
    • Bloquer l’action,
    • Raccourci global, et
    • Raccourci de message.

    Procédure

    1. Pour créer un modal avec interface utilisateur qui est généré automatiquement à l’aide d’une ServiceNow table :
      1. Accédez à la Slack > Configuration du modal de Slack.
      2. Cliquez sur Nouveau.
      3. Renseignez ces valeurs sur le formulaire Configuration du modal de Slack.
        Tableau 1. Modal Slack Formulaire de configuration
        Champ Description
        Nom Nom permettant d'identifier l'enregistrement. Par exemple, Modal pour créer un incident.
        Titre modal Titre modal qui s’affiche sur .Slack Par exemple, Créer un incident.
        Table ServiceNow Table correspondant aux champs modaux. Par exemple, Incident [incident].
        Modal personnalisé Option permettant de configurer un modal personnalisé.
        Champs d'entrée Champs d’entrée qui doivent être affichés sur .Slack Par exemple, sélectionnez Priorité, Catégorie et Description brève. Assurez-vous que ces champs modaux correspondent à la table sélectionnée ServiceNow . Par exemple, vous ne pouvez pas afficher les champs liés aux tâches sur un modal qui crée un incident.
        Remarque :
        Seuls les types de champs chaîne, date et choix sont pris en charge.
        Actif Option permettant d’utiliser activement l’enregistrement.
        Validation du script Script permettant de valider les entrées fournies par l’utilisateur dans le modal. Pour valider les entrées fournies par l’utilisateur, assurez-vous de connaître le format dans lequel les valeurs sont récupérées à partir du modal et analysez la réponse à partir de Slack.
        Exemple de charge utile lorsque l’utilisateur fournit des valeurs pour les champs Priorité, Catégorie et Description brève dans le modal Créer un incident est le suivant :
        {"priority":{"4gk":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"1 - Critical","emoji":true},"value":"1"}}},"category":{"iV7":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"Software","emoji":true},"value":"software"}}},"short_description":{"XS/Q=":{"type":"plain_text_input","value":"hemanth"}}}

        Pour afficher les erreurs de validation dans le modal, configurez le script pour renvoyer un objet keys, status et errorObject. errorObject doit avoir une valeur objet qui s’affiche sur Slack. L’objet doit comporter response_action et une erreur.

        Configurez également le script pour renvoyer un objet avec les clés status et statusMessage lorsqu’il n’y a pas d’erreurs de validation. statusMessage est facultatif et vous pouvez le configurer selon vos besoins.

        Validation du script.
      4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
        Le modal Créer un incident est créé dans Slack.
        Modal Slack.
    2. Pour créer un modal avec interface utilisateur généré manuellement à l’aide d’une charge utile de vue personnalisée :
      1. Accédez à la Slack > Configuration du modal de Slack.
      2. Cliquez sur Nouveau.
      3. Renseignez ces valeurs sur le formulaire Configuration du modal de Slack.
        Tableau 2. Modal Slack Formulaire de configuration
        Champ Description
        Nom Nom permettant d'identifier l'enregistrement. Par exemple, Modal pour créer un incident.
        Modal personnalisé Option permettant de configurer un modal personnalisé. Cochez cette case.
        Afficher la charge utile Charge utile générée par Slack le générateur de kits de blocs qui définit l’interface utilisateur du modal. Pour plus d’informations, consultez Kit de blocs et Génération avec Kit de blocs.
        Actif Option permettant d’utiliser activement l’enregistrement.
        Validation du script Script permettant de valider les entrées fournies par l’utilisateur dans le modal. Pour valider les entrées fournies par l’utilisateur, assurez-vous de connaître le format dans lequel les valeurs sont récupérées à partir du modal et analysez la réponse à partir de Slack.
        Exemple de charge utile lorsque l’utilisateur fournit des valeurs pour les champs Priorité, Catégorie et Description brève dans le modal Créer un incident est le suivant :
        {"priority":{"4gk":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"1 - Critical","emoji":true},"value":"1"}}},"category":{"iV7":{"type":"static_select","selected_option":{"text":{"type":"plain_text","text":"Software","emoji":true},"value":"software"}}},"short_description":{"XS/Q=":{"type":"plain_text_input","value":"hemanth"}}}

        Pour afficher les erreurs de validation dans le modal, configurez le script pour renvoyer un objet keys, status et errorObject. errorObject doit avoir une valeur objet qui s’affiche sur Slack. L’objet doit comporter response_action et une erreur.

        Configurez également le script pour renvoyer un objet avec les clés status et statusMessage lorsqu’il n’y a pas d’erreurs de validation. statusMessage est facultatif et vous pouvez le configurer selon vos besoins.

        Validation du script.
      4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
        Le modal Créer un incident est créé dans Slack.
    3. Spécifiez les conditions pour définir quand les fenêtres modales doivent être affichées :
      1. Accédez à la Slack > Décisions entrantes pour les modaux .
      2. Renseignez ces valeurs sur le formulaire Décision.
        Tableau 3. Formulaire Décision
        Champ Description
        Étiquette Nom permettant d’identifier la décision du modal entrant.
        Réponse Fenêtre modale qui doit être affichée lorsque les conditions spécifiées sont remplies. Assurez-vous de sélectionner l’enregistrement requis dans la table Configuration du modal de Slack [sn_slack_ah_v2_slack_modal_configuration].
        Réponse par défaut Option permettant de spécifier s’il s’agit du modal par défaut. La fenêtre modale par défaut s’applique lorsque les conditions ne sont pas remplies.
        Condition Conditions à remplir dans votre application Slack pour afficher le modal.
        Remarque :
        • Copiez et enregistrez la valeur de sys_id. Vous pouvez utiliser cette sys_id comme valeur unique dans l’ID de rappel lors de la configuration du raccourci ou du raccourci de message dans votre application Slack.
          sys_id de l’enregistrement de politique entrante du modal.
          Remarque :
          Deux propriétés système sont ajoutées pour gérer les communications entrantes :
          Tableau 4. Propriétés système
          Catégorie Nom de la propriété Description Exemple
          Commandes à barre oblique sn_slack_ah_v2.command.special_characters Les caractères codés à l’aide de la méthode encodeURIComponent sont traités en interne. Pour remplacer tous les caractères spéciaux supplémentaires utilisés dans les commandes Slack dans l’application Slack par leurs caractères URI codés, ajoutez les caractères au format JSON.

          {

          « ~ » : « %7E »,

          « \( » : « %28 »,

          }
          Interactivité et raccourcis : sn_slack_ah_v2.interactivité.caractères_spéciaux

          Les caractères codés à l’aide de la méthode encodeURIComponent et les caractères suivants sont traités en interne : !, ', (, ), *, ~

          Remplissez la propriété pour remplacer tous les caractères spéciaux supplémentaires utilisés dans l’interactivité et les raccourcis Slack dans l’application Slack par leurs caractères URI codés au format JSON.

          {

          « ~ » : « %7E »,

          « \( » : « %28 »,

          }
          Pour afficher les modaux pour le raccourci requis, dans Condition, fournissez la sys_id de l’enregistrement de politique entrante du modal.
          Affichez des modaux pour les raccourcis Slack.
        • Pour afficher les fenêtres modales des commandes requises Slack , dans Condition, fournissez la commande requise pour laquelle la fenêtre modale doit être affichée.
          Affichez des modaux pour les commandes Slack.
        • Pour afficher les modaux pour l’action de bloc requise Slack , dans Condition, fournissez l’ID d’action requis de l’action de bloc requise pour laquelle le modal doit être affiché.
          Affichez des modaux pour les actions de bloc Slack.
      3. Cliquez sur Envoyer.
        Lorsque les événements rencontrent Slack les conditions spécifiées dans la politique, le modal associé s’affiche.
        Remarque :
        Ces décisions entrantes sont enregistrées dans les tables de décision. Les utilisateurs sont avertis de ne pas mettre à jour ou modifier directement les données de ces tables.
    4. Spécifiez les tâches à effectuer lorsque l’utilisateur fournit des valeurs dans les modaux en créant une politique entrante :
      1. Accédez à la Slack > Décisions entrantes.
      2. Cliquez sur Nouveau.
      3. Renseignez ces valeurs sur le formulaire Décision.
        Tableau 5. Formulaire Décision
        Champ Description
        Étiquette Nom permettant d’identifier la décision entrante.
        Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies
        Réponse par défaut Option permettant de spécifier s’il s’agit de la réponse par défaut. La réponse par défaut s’applique lorsque les conditions ne sont pas remplies.
        1. Cliquez sur l'icône de recherche ( icône de recherche).
        2. Sélectionnez le flux secondaire requis dans la liste Documents.
          Remarque :
          Assurez-vous que le nom de la table est Flux [sys_hub_flow].
        Assurez-vous d’avoir configuré le flux secondaire pour traiter la charge utile de la réponse à partir de Slack pour automatiser les tâches.
        Condition Conditions à remplir pour effectuer des tâches dans l’instance ServiceNow .
        Spécifier l’enregistrement modal dans la condition.
        Condition permettant de déclencher le flux secondaire.
        Remarque :
        La condition doit avoir une condition spécifique à l’enregistrement du modal uniquement.
      4. Cliquez sur Envoyer.
        Lorsque l’utilisateur Slack fournit des entrées dans le modal, le flux secondaire associé est déclenché après validation des entrées. Selon les automatisations configurées dans votre flux secondaire, des tâches sont effectuées.