Configurer Slack les modaux dans ServiceNow l’instance

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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 charge utile de vue personnalisée.

    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 des champs Priorité, Catégorie et Description brève .
    Remarque :
    Les modaux peuvent être déclenchés à partir des composants interactifs Slack suivants :
    • Commande
    • Bloquer l’action,
    • Raccourci global, et
    • Raccourci du message.

    Procédure

    1. Pour créer un modal avec une interface utilisateur qui est générée 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 dans le formulaire Configuration du modal Slack.
        Tableau 1. Formulaire Configuration du modal de Slack
        Champ Description
        Nom Nom permettant d'identifier l'enregistrement. Par exemple, Modal pour créer un incident.
        Titre modal Titre modal affiché sur Slack. Par exemple, Créer un incident.
        Table ServiceNow Table correspondant aux champs modaux. Par exemple, Incident [incident].
        Modal personnalisé Option pour 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 Brève description. Assurez-vous que ces champs modaux correspondent à la table sélectionnée ServiceNow . Par exemple, vous ne pouvez pas afficher les champs associés à une tâche sur un modal qui crée un incident.
        Remarque :
        Seuls les champs Chaîne, Date et Choix sont pris en charge.
        Actif Option permettant d’utiliser activement l’enregistrement.
        Validation du script Script pour 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.
        Voici l’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 :
        {"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 de façon à ce qu’il renvoie les clés, l’état et l’objet d’erreur d’un objet. errorObject doit avoir une valeur d’objet qui sera affichée sur Slack. L’objet doit comporter response_action et une erreur.

        Configurez également le script pour qu’il renvoie 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 l’interface utilisateur qui est 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 dans le formulaire Configuration du modal Slack.
        Tableau 2. Formulaire Configuration du modal de Slack
        Champ Description
        Nom Nom permettant d'identifier l'enregistrement. Par exemple, Modal pour créer un incident.
        Modal personnalisé Option pour configurer un modal personnalisé. Cochez cette case.
        Afficher la charge utile Charge utile générée par Slack le générateur de kit de bloc qui définit l’interface utilisateur modale. Pour plus d’informations, reportez-vous aux rubriques Kit de blocs et Construction avec kit de blocs.
        Actif Option permettant d’utiliser activement l’enregistrement.
        Validation du script Script pour 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.
        Voici l’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 :
        {"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 de façon à ce qu’il renvoie les clés, l’état et l’objet d’erreur d’un objet. errorObject doit avoir une valeur d’objet qui sera affichée sur Slack. L’objet doit comporter response_action et une erreur.

        Configurez également le script pour qu’il renvoie 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 fenêtres modales .
      2. Dans le formulaire Décision, renseignez ces valeurs.
        Tableau 3. Formulaire Décision
        Champ Description
        Étiquette Nom permettant d’identifier la décision modale entrante.
        Réponse Modal qui doit être affiché lorsque les conditions spécifiées sont remplies. Veillez à 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. Le modal par défaut s’applique lorsque les conditions ne sont pas remplies.
        Condition Conditions à respecter 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.commande.caractères_spéciaux 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 Slash dans l’application Slack par leurs caractères URI codés, ajoutez les caractères dans un 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 : !, ', (, ), *, ~

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

          {

          « ~ » : « %7E »,

          « \( » : « %28 »,

          }
          Pour afficher les fenêtres modales pour le raccourci requis, dans Condition, indiquez le sys_id de l’enregistrement de politique entrante du modal.
          Affichez des fenêtres modales pour les raccourcis Slack.
        • Pour afficher les fenêtres modales pour les 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, indiquez l’ID 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 Slack respectent 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 mis en garde contre la mise à jour ou la modification directe des données dans 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. Dans le formulaire Décision, renseignez ces valeurs.
        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 des documents.
          Remarque :
          Assurez-vous que le nom de la table est Flux [sys_hub_flow].
        Assurez-vous d’avoir configuré le flux secondaire à partir duquel Slack traiter la charge utile de la réponse afin d’automatiser les tâches.
        Condition Conditions à remplir pour effectuer des tâches dans l’instance ServiceNow .
        Spécifiez l’enregistrement modal dans la condition.
        Condition pour déclencher le flux secondaire.
        Remarque :
        La condition doit avoir une condition spécifique à l’enregistrement 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 la validation des entrées. Des tâches sont exécutées en fonction des automatisations configurées dans votre flux secondaire.