Configurer le contenu du message

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

    • Créez un message dans la table Contenu du message [messaging_content] que vous pouvez utiliser dans plusieurs notifications. Les messages peuvent être informatifs ou demander une action à un utilisateur Slack ou Teams individuel. Par exemple, le message Demande d’approbation comprend des boutons Approuver et Rejeter pour effectuer l’action associée dans ServiceNow.

    Avant de commencer

    Rôle requis : admin ou messaging_admin

    Pourquoi et quand exécuter cette tâche

    Pour permettre aux utilisateurs d’effectuer des actions dans Slack ou Teams, utilisez le type de message Boutons et définissez un comportement scripté. Seuls les utilisateurs qui ont lié leur compte Slack ou Teams à leur ServiceNow compte peuvent effectuer une action à ServiceNow partir de l’application tierce.

    Procédure

    1. Accédez à la Tout > Notification système > Contenu de la messagerie.
    2. Ouvrez un enregistrement de notification existant ou cliquez sur Nouveau pour créer un enregistrement.
    3. Renseignez ou modifiez les champs selon vos besoins.
      Tableau 1. Champs de contenu de la messagerie
      Champ Description
      Nom Entrez un nom unique pour le message.
      Type Sélectionnez un type de message.
      • Simple : envoyez un message informatif à l’ensemble d’une équipe ou d’un canal Slack.
      • Boutons : envoyez un message à un utilisateur individuel dans Slack ou Teams et définissez le comportement souhaité dans le champ Script . Associer des boutons dans le message à des actions dans ServiceNow. Prenons l’exemple de la demande d’approbation.
      Table cible Pour utiliser le contenu de l’enregistrement dans votre message, sélectionnez la table appropriée.
      Remarque :
      Les notifications en cours d’exécution sur la table Tâche [task] ne sont pas prises en charge. Utilisez plutôt une table étendue à partir de la tâche.
      Champs Sélectionnez les champs de la table cible qui s’affichent dans un message simple. La modification de l’ordre des champs modifie l’ordre d’affichage dans la notification.
      En-tête de message Entrez le texte qui s’affiche en haut du message.
      Message Saisissez le contenu du message. Utilisez des variables de notification pour inclure des informations dynamiques dans votre message. Par exemple, utilisez Incident ${number} pour inclure le numéro d’incident dans le message.

      Pour connaître les variables disponibles, reportez-vous à la section Variables de notification.
      Boutons

      Sélectionnez ou créez des boutons à utiliser sur le formulaire. Après avoir sélectionné ou créé un bouton, vous devez définir son comportement dans le champ Script .

      Visible uniquement lorsque Boutons est sélectionné dans le champ Type
      Script

      Ce champ n’est visible que lorsque l’option Boutons est sélectionnée dans le champ Type .

      Entrez un script pour définir ce qui se passe dans votre instance lorsqu’un utilisateur sélectionne un bouton dans Slack ou Microsoft Teams. Utilisez la méthode actions.get pour renvoyer le nom du bouton sélectionné par l’utilisateur.

      if (actions.get('button') == 'Approve') {
		target.state = 'approved';
		target.update();
	}

      Dans cet exemple, le script s’exécute conditionnellement lorsque le bouton « Approuver » est sélectionné.

      Utilisez la méthode sn_notification. Messaging.send pour envoyer des informations à la fenêtre de messagerie.

      var content = new GlideRecord("messaging_content");
content.get("1bb10839572213007f004758ef94f9c4"));
sn_notification.Messaging.send(application, userId, content, target);

      Dans cet exemple, le script stocke un enregistrement Contenu du message dans la variable Contenu . Il publie ensuite un message à partir de cet enregistrement de contenu du message.
      Application Sélectionnez le périmètre de l’application pour cette notification.
    4. Cliquez sur Envoyer.

    Exemple

    Cet exemple montre la sortie d’un message dans Microsoft Teams. Ce message est du type boutons, qui affiche les boutons et effectue des actions scriptées en fonction de la sélection de l’utilisateur. Dans ce cas, le script utilise le sn_notification. Messaging.sendpour afficher le changement d’état de l’enregistrement.

    Message de type boutons

    Que faire ensuite

    Utilisez le message dans une notification. Pour en savoir plus sur la création de notifications, reportez-vous à la section Créer une notification de messagerie.