Configurer Slack les modaux dans ServiceNow l’instance
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 de charge utile personnalisée.
Avant de commencer
Rôle requis : admin.
Pourquoi et quand exécuter cette tâche
- Commande,
- Bloquer l’action,
- Raccourci global, et
- Raccourci de message.
Procédure
-
Pour créer un modal avec interface utilisateur qui est généré automatiquement à l’aide d’une ServiceNow table :
- Accédez à la Slack > Slack Modal Configuration.
- Cliquez sur Nouveau.
-
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 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ées 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 associés à une tâche sur un modal qui crée un incident. Remarque :Seuls les types de champ Chaîne, Date et Choix sont pris en charge.Actives Option permettant d’utiliser activement l’enregistrement. Script Validation 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. 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 :{"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 d’objet qui s’affichera sur Slack. L’objet doit avoir response_action et une erreur.
Configurez également le script pour renvoyer un objet avec les clés de statut et de statusMessage lorsqu’il n’y a pas d’erreur de validation. statusMessage est facultatif et vous pouvez le configurer selon vos besoins.
-
Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
Le modal Create Incident (Créer un incident) est créé dans Slack.
-
Pour créer un modal avec une interface utilisateur qui est généré manuellement à l’aide d’une charge utile de vue personnalisée :
- Accédez à la Slack > Slack Modal Configuration.
- Cliquez sur Nouveau.
-
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 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 modale. Pour plus d’informations, consultez Kit de blocs et Création avec Kit de blocs. Actives Option permettant d’utiliser activement l’enregistrement. Script Validation 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. 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 :{"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 d’objet qui s’affichera sur Slack. L’objet doit avoir response_action et une erreur.
Configurez également le script pour renvoyer un objet avec les clés de statut et de statusMessage lorsqu’il n’y a pas d’erreur de validation. statusMessage est facultatif et vous pouvez le configurer selon vos besoins.
-
Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
Le modal Create Incident (Créer un incident) est créé dans Slack.
-
Spécifiez les conditions pour définir quand les modaux doivent être affichés :
- Accédez à la Slack > Décisions entrantes pour les modaux .
-
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.Pour afficher les modaux pour le raccourci requis, dans Condition, fournissez le 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 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 les modaux des commandes requises Slack , dans Condition, fournissez la commande requise pour laquelle le modal doit être affiché.
- Pour afficher les modaux pour l’action de bloc requise Slack , dans Condition, fournissez l’ID d’action requise de l’action de bloc requise pour laquelle le modal doit être affiché.
- 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.
-
Cliquez sur Envoyer.
Lorsque les événements remplissent 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.
-
Spécifiez les tâches à effectuer lorsque l’utilisateur fournit des valeurs dans les modaux en créant une politique entrante :
- Accédez à la Slack > Décisions entrantes.
- Cliquez sur Nouveau.
-
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. - Cliquez sur l'icône de recherche (
).
- Sélectionnez le flux secondaire requis dans la liste Documents .Remarque :Assurez-vous que le nom de la table est Flux [sys_hub_flow].
Condition Conditions à remplir pour effectuer des tâches dans l’instance ServiceNow . Spécifiez l’enregistrement modal dans la condition.Remarque :La condition doit avoir une condition spécifique à l’enregistrement modal uniquement. - Cliquez sur l'icône de recherche (
-
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. En fonction des automatisations configurées dans votre flux secondaire, des tâches sont effectuées.