Configurer Slack les modaux dans ServiceNow l’instance

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 6 minutes de lecture

    • Créez un modal et spécifiez les champs qui doivent s’afficher dans votre Slack fenêtre modale. 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 de charge utile 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 de ces composants interactifs Slack :
    • Commander
    • Bloquer l’action,
    • Raccourci global, et
    • Raccourci de 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 sur le formulaire Configuration du modal de 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 permettant de configurer une fenêtre modale personnalisée.
        Champs d'entrée Champs d’entrée qui doivent être affichés sur Slack. Par exemple, sélectionnez Priorité, Catégorie et Description courte. Assurez-vous que ces champs modaux correspondent à la table sélectionnée ServiceNow . Par exemple, vous ne pouvez pas afficher les champs liés à une tâche 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 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 extraites du modal et analysez la réponse à partir de Slack.
        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 est la suivante :
        {"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 qu’il renvoie un objet keys, status et errorObject. 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 d’état et de statusMessage en l’absence 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 une interface utilisateur générée 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. 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 permettant de configurer une fenêtre modale personnalisée. 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 modale. Pour plus d’informations, reportez-vous aux rubriques Kit de blocs et Construire avec un 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 extraites du modal et analysez la réponse à partir de Slack.
        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 est la suivante :
        {"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 qu’il renvoie un objet keys, status et errorObject. 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 d’état et de statusMessage en l’absence 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. Renseignez ces valeurs dans le formulaire Décision.
        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 à 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 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 dans l’application Slack par leurs caractères URI codés au format JSON.

          {

          « ~ » : « %7E »,

          « \( » : « %28 »,

          }
          Pour afficher des fenêtres modales pour le raccourci requis, indiquez dans Condition le sys_id de l’enregistrement de politique entrante de la fenêtre modale.
          Afficher les modaux des raccourcis Slack.
        • Pour afficher des fenêtres modales pour les commandes requises Slack , indiquez, dans Condition, la commande requise pour laquelle la fenêtre modale doit être affichée.
          Afficher les modaux pour les commandes Slack.
        • Pour afficher les modaux pour l’action de bloc requise Slack , indiquez dans Condition 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 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 mis en garde contre la mise à jour ou la modification directe des 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 dans 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 Document.
          Remarque :
          Assurez-vous que le nom de la table est Flux [sys_hub_flow].
        Assurez-vous d’avoir configuré le flux secondaire à partir duquel traiter la charge utile de la réponse afin d’automatiser Slack les tâches.
        Condition Conditions à remplir pour exécuter des tâches dans l’instance ServiceNow .
        Spécifiez l’enregistrement du modal dans la condition.
        Condition permettant de 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.