Konfigurieren Sie Slack modale Elemente in der Instanz ServiceNow.

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 5 Minuten Lesedauer

    • Erstellen Sie ein Modal, und geben Sie Felder an, die im Modal Slack angezeigt werden sollen. Die modale Benutzeroberfläche kann auf zwei Arten generiert werden. automatisch mithilfe einer ServiceNow-Tabelle und manuell mithilfe einer benutzerdefinierten Payload anzeigen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie beispielsweise einen Incident mit dem Modal in Slackerstellen möchten, erfordert das Modal „Incident erstellen“ die Felder Priorität, Kategorieund Kurzbeschreibung.
    Hinweis:
    Modale Elemente können über die folgenden interaktiven Slack Komponenten ausgelöst werden:
    • Befehl,
    • Blockaktion,
    • Globale Verknüpfung, und
    • Nachrichtenverknüpfung.

    Prozedur

    1. So erstellen Sie ein Modal mit einer Benutzeroberfläche, die automatisch mithilfe einer Tabelle ServiceNow generiert wird:
      1. Navigieren zu Slack > Konfiguration des modalen Slack-Elements.
      2. Klicken Sie auf Neu.
      3. Füllen Sie diese Werte im Formular „Slack-Modal-Konfiguration“ aus.
        Tabelle : 1. Formular „Slack-Modal-Konfiguration“.
        Feld Beschreibung
        Name Name zur Identifizierung des Datensatzes. Beispiel: Modal, um einen Incident zu erstellen.
        Modal-Titel Modaler Titel, der in Slackangezeigt wird. Beispiel: Incident erstellen.
        Tabelle ServiceNow Tabelle, die den modalen Feldern entspricht. Zum Beispiel, Incident [incident].
        Benutzerdefiniertes modales Element Option zum Konfigurieren eines benutzerdefinierten Modals.
        Eingabefelder Eingabefelder, die in Slackangezeigt werden sollen. Wählen Sie beispielsweise Priorität, Kategorieund Kurzbeschreibungaus. Stellen Sie sicher, dass diese modalen Felder der ausgewählten Tabelle ServiceNow entsprechen. Beispielsweise können Sie keine aufgabenbezogenen Felder in einem Modal anzeigen, das einen Incident erstellt.
        Hinweis:
        Es werden nur die Feldtypen „Zeichenfolge“, „Datum“ und „Auswahl“ unterstützt.
        Aktiv Option zur aktiven Verwendung des Datensatzes.
        Skriptvalidierung Skript zum Validieren der vom Benutzer im modalen Fenster bereitgestellten Eingaben. Um die vom Benutzer bereitgestellten Eingaben zu validieren, stellen Sie sicher, dass Sie das Format kennen, in dem Werte aus dem Modal abgerufen werden, und analysieren Sie die Antwort von Slack.
        Beispiel für eine Nutzlast, wenn der Benutzer Werte für die Felder „ Priorität“, „Kategorie“und „Kurzbeschreibung“ im modalen Fenster „Incident erstellen“ angibt:
        {"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"}}}

        Um Validierungsfehler im Modal anzuzeigen, konfigurieren Sie das Skript so, dass ein Objekt Schlüssel, Status und Fehlerobjekt zurückgegeben wird. „errorObject“ muss den Wert „object“ haben, der in Slack angezeigt wird. Das Objekt muss „response_action“ und „error“ aufweisen.

        Konfigurieren Sie das Skript außerdem so, dass ein Objekt mit den Schlüsseln status und statusMessage zurückgegeben wird, wenn keine Validierungsfehler vorliegen. statusMessage ist optional und kann nach Ihren Anforderungen konfiguriert werden.

        Skriptvalidierung
      4. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
        Das Modal „Incident erstellen“ wird in Slackerstellt.
        Slack-Modal.
    2. So erstellen Sie ein Modal mit einer Benutzeroberfläche, die manuell mit einer benutzerdefinierten Ansichtsnutzlastgeneriert wird:
      1. Navigieren zu Slack > Konfiguration des modalen Slack-Elements.
      2. Klicken Sie auf Neu.
      3. Füllen Sie diese Werte im Formular „Slack-Modal-Konfiguration“ aus.
        Tabelle : 2. Formular „Slack-Modal-Konfiguration“.
        Feld Beschreibung
        Name Name zur Identifizierung des Datensatzes. Beispiel: Modal, um einen Incident zu erstellen.
        Benutzerdefiniertes modales Element Option zum Konfigurieren eines benutzerdefinierten Modals. Aktivieren Sie das Kontrollkästchen.
        Nutzlast anzeigen Von Slack Block Kit Builder generierte Nutzlast, die die modale UI definiert. Weitere Informationen finden Sie unter Block Kit und Erstellen mit Block Kit.
        Aktiv Option zur aktiven Verwendung des Datensatzes.
        Skriptvalidierung Skript zum Validieren der vom Benutzer im modalen Fenster bereitgestellten Eingaben. Um die vom Benutzer bereitgestellten Eingaben zu validieren, stellen Sie sicher, dass Sie das Format kennen, in dem Werte aus dem Modal abgerufen werden, und analysieren Sie die Antwort von Slack.
        Beispiel für eine Nutzlast, wenn der Benutzer Werte für die Felder „ Priorität“, „Kategorie“und „Kurzbeschreibung“ im modalen Fenster „Incident erstellen“ angibt:
        {"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"}}}

        Um Validierungsfehler im Modal anzuzeigen, konfigurieren Sie das Skript so, dass ein Objekt Schlüssel, Status und Fehlerobjekt zurückgegeben wird. „errorObject“ muss den Wert „object“ haben, der in Slack angezeigt wird. Das Objekt muss „response_action“ und „error“ aufweisen.

        Konfigurieren Sie das Skript außerdem so, dass ein Objekt mit den Schlüsseln status und statusMessage zurückgegeben wird, wenn keine Validierungsfehler vorliegen. statusMessage ist optional und kann nach Ihren Anforderungen konfiguriert werden.

        Skriptvalidierung
      4. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
        Das Modal „Incident erstellen“ wird in Slackerstellt.
    3. Geben Sie Bedingungen an, um zu definieren, wann die modalen Elemente angezeigt werden sollen:
      1. Navigieren zu Slack > Eingehende Entscheidungen für modale Elemente .
      2. Füllen Sie diese Werte im Formular „Entscheidung“ aus.
        Tabelle : 3. Formular „Entscheidung“
        Feld Beschreibung
        Bezeichnung Name zur Identifizierung der eingehenden modalen Entscheidung.
        Antwort Modal, das angezeigt werden muss, wenn die angegebenen Bedingungen erfüllt sind. Stellen Sie sicher, dass Sie den erforderlichen Datensatz aus der Tabelle „Slack-Modal-Konfiguration“ [sn_slack_ah_v2_slack_modal_configuration] auswählen.
        Standardantwort Option zum Angeben, ob dies das Standardmodal ist. Das Standardmodal ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
        Bedingung Bedingungen, die in Ihrer Slack-Anwendung erfüllt sein müssen, um das Modal anzuzeigen.
        Hinweis:
        • Kopieren Sie den Wert von sys_id, und notieren Sie ihn. Sie können diese sys_id als eindeutigen Wert in der Rückruf- ID verwenden, während Sie die Verknüpfung oder Nachrichtenverknüpfung in Ihrer Slack-App konfigurieren.
          sys_id des eingehenden Richtliniendatensatzes des Modals.
          Hinweis:
          Zwei Systemeigenschaften werden hinzugefügt, um die eingehende Kommunikation zu verarbeiten:
          Tabelle : 4. Systemeigenschaften
          Kategorie Name der Eigenschaft Beschreibung Beispiel
          Schrägstrichbefehle sn_slack_ah_v2.command.special_characters Die mit der encodeURIComponent-Methode codierten Zeichen werden intern behandelt. Um zusätzliche Sonderzeichen, die in Schrägstrichbefehlen in der Slack-Anwendung verwendet werden, durch ihre codierten URI-Zeichen zu ersetzen, fügen Sie die Zeichen in einem JSON-Format hinzu.

          {

          „~“ : „%7E“,

          „\(“ : „%28“,

          }
          Interaktivität und Kurzbefehle: sn_slack_ah_v2.interaktivität.special_characters

          Die mit der Methode encodeURIComponent codierten Zeichen und die folgenden Zeichen werden intern verarbeitet: !, ', (, ), *, ~

          Füllen Sie die Eigenschaft aus, um zusätzliche Sonderzeichen, die in Slack-Interaktivität und -Kurzbefehlen in der Slack-Anwendung verwendet werden, durch ihre codierten URI-Zeichen in einem JSON-Format zu ersetzen.

          {

          „~“ : „%7E“,

          „\(“ : „%28“,

          }
          Um modale Elemente für die erforderliche Verknüpfung anzuzeigen, geben Sie in Bedingungdie sys_id des eingehenden Richtliniendatensatzes des modalen Elements an.
          Zeigen Sie modale Elemente für Slack-Verknüpfungen an.
        • Um modale Elemente für die erforderlichen Slack -Befehle anzuzeigen, geben Sie in Bedingungden erforderlichen Befehl an, für den das modale Element angezeigt werden soll.
          Zeigen Sie modale Elemente für Slack-Befehle an.
        • Um modale Elemente für die erforderliche Blockaktion Slack anzuzeigen, geben Sie in Bedingungdie erforderliche Aktions-ID der erforderlichen Blockaktion an, für die das modale Element angezeigt werden soll.
          Zeigen Sie modale Elemente für Slack-Blockaktionen an.
      3. Klicken Sie auf Absenden.
        Wenn Events in Slack die in der Richtlinie angegebenen Bedingungen erfüllen, wird das zugehörige Modal angezeigt.
        Hinweis:
        Diese eingehenden Entscheidungen werden in den Entscheidungstabellen gespeichert. Benutzer werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.
    4. Geben Sie Aufgaben an, die ausgeführt werden sollen, wenn der Benutzer Werte in den modalen Feldern bereitstellt, indem Sie eine eingehende Richtlinie erstellen:
      1. Navigieren zu Slack > Eingehende Entscheidungen.
      2. Klicken Sie auf Neu.
      3. Füllen Sie diese Werte im Formular „Entscheidung“ aus.
        Tabelle : 5. Formular „Entscheidung“
        Feld Beschreibung
        Bezeichnung Name zur Identifizierung der eingehenden Entscheidung.
        Antwort Subflow, der ausgelöst werden muss, wenn die angegebenen Bedingungen erfüllt sind.
        Standardantwort Option, um anzugeben, ob dies die Standardantwort ist. Die Standardantwort gilt, wenn die Bedingungen nicht erfüllt sind.
        1. Klicken Sie auf das Suchsymbol ( Suchsymbol).
        2. Wählen Sie den erforderlichen Subflow aus der Dokumentliste aus.
          Hinweis:
          Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow] lautet.
        Stellen Sie sicher, dass Sie den Subflow für die Verarbeitung der Antwortnutzlast von Slack konfiguriert haben, um Aufgaben zu automatisieren.
        Bedingung Bedingungen, die erfüllt sein müssen, um Aufgaben in der Instanz ServiceNow auszuführen.
        Geben Sie den modalen Datensatz in der Bedingung an.
        Bedingung zum Auslösen des Subflows.
        Hinweis:
        Die Bedingung darf nur für den modalen Datensatz spezifische Bedingung aufweisen.
      4. Klicken Sie auf Absenden.
        Wenn der Slack-Benutzer Eingaben im modalen Fenster bereitstellt, wird der zugehörige Subflow nach der Validierung der Eingaben ausgelöst. Abhängig von den in Ihrem Subflow konfigurierten Automatisierungen werden Aufgaben ausgeführt.