Modale ServiceNow in Instanz Slack konfigurieren

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer

    • Modal „Erstellen“, und geben Sie Felder an, die im Modal Slack angezeigt werden sollen. Modale UI kann auf zwei Arten generiert werden; automatisch mithilfe einer ServiceNow-Tabelle und manuell mithilfe einer anwenderdefinierten Ansichtsnutzlast.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie beispielsweise im modalen Element Slackeinen Incident mithilfe des Dialogfelds erstellen möchten, erfordert das modale Element Incident erstellen die Felder Priorität, Kategorieund Kurzbeschreibung.
    Hinweis:
    Modale Elemente können über die folgenden interaktiven Slack Komponenten ausgelöst werden:
    • Befehl,
    • Aktion blockieren,
    • Globale Verknüpfung, und
    • Nachrichtenverknüpfung.

    Prozedur

    1. So erstellen Sie ein Modal mit einer UI, die automatisch mithilfe einer ServiceNow -Tabelle generiert wird:
      1. Navigieren zu Slack > Konfiguration des modalen Slack-Elements.
      2. Klicken Sie auf Neu.
      3. Füllen Sie diese Werte im Formular „Konfiguration des modalen Elements von Slack“ aus.
        Tabelle : 1. Formular „Konfigurationen des modalen Elements von Slack“
        Feld Beschreibung
        Name Name zur Identifizierung des Datensatzes. Beispiel: Modal zum Erstellen eines Incidents.
        Modal-Titel Modaler Titel, der unter Slackangezeigt wird. Beispiel: Incident erstellen.
        Tabelle ServiceNow Tabelle, die den modalen Feldern entspricht. Zum Beispiel, Incident [incident].
        Anwenderdefiniertes modales Element Option zum Konfigurieren eines anwenderdefinierten modalen Elements.
        Eingabefelder Eingabefelder, die auf 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:
        Nur die Feldtypen „Zeichenfolge“, „Datum“ und „Auswahl“ werden unterstützt.
        Aktiv Option zur aktiven Verwendung des Datensatzes.
        Skriptvalidierung Skript zum Validieren von Eingaben, die vom Anwender im Modal angegeben wurden. Um die vom Anwender 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.
        Beispielnutzlast, wenn der Benutzer im Modal „Incident erstellen“ Werte für die Felder „ Priorität“, „Kategorie“und „Kurzbeschreibung “ 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 Objektschlüssel, Status und Fehlerobjekt zurückgegeben werden. errorObject muss den Wert „Objekt“ haben, der in Slack angezeigt wird. Das Objekt muss „response_action“ und „Fehler“ 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 entsprechend Ihren Anforderungen konfiguriert werden.

        Skriptvalidierung
      4. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
        Das Modal „Incident erstellen“ wird in Slackerstellt.
        Slack-Modal.
    2. So erstellen Sie ein Dialogfeld mit einer manuell erstellten Benutzeroberfläche mit einer anwenderdefinierten Ansichtsnutzlast:
      1. Navigieren zu Slack > Konfiguration des modalen Slack-Elements.
      2. Klicken Sie auf Neu.
      3. Füllen Sie diese Werte im Formular „Konfiguration des modalen Elements von Slack“ aus.
        Tabelle : 2. Formular „Konfigurationen des modalen Elements von Slack“
        Feld Beschreibung
        Name Name zur Identifizierung des Datensatzes. Beispiel: Modal zum Erstellen eines Incidents.
        Anwenderdefiniertes modales Element Option zum Konfigurieren eines anwenderdefinierten modalen Elements. Aktivieren Sie das Kontrollkästchen.
        Nutzlast anzeigen Von Slack Block Kit Builder generierte Nutzlast, die die modale UI definiert. Weitere Informationen finden Sie unter Blockkit und Erstellen mit Blockkit.
        Aktiv Option zur aktiven Verwendung des Datensatzes.
        Skriptvalidierung Skript zum Validieren von Eingaben, die vom Anwender im Modal angegeben wurden. Um die vom Anwender 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.
        Beispielnutzlast, wenn der Benutzer im Modal „Incident erstellen“ Werte für die Felder „ Priorität“, „Kategorie“und „Kurzbeschreibung “ 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 Objektschlüssel, Status und Fehlerobjekt zurückgegeben werden. errorObject muss den Wert „Objekt“ haben, der in Slack angezeigt wird. Das Objekt muss „response_action“ und „Fehler“ 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 entsprechend Ihren Anforderungen konfiguriert werden.

        Skriptvalidierung
      4. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile 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. Achten Sie darauf, den erforderlichen Datensatz aus der Tabelle „Konfiguration des modalen Elements von Slack“ [sn_slack_ah_v2_slack_modal_configuration] auszuwählen.
        Standardantwort Option zum Festlegen, ob dies das Standardmodal ist. Das Standardmodal ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
        Bedingung Bedingungen, die in Ihrer Slack-Anwendung zum Anzeigen des Modals erfüllt werden müssen.
        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 Eigenschaftsname Beschreibung Beispiel
          Schrägstrichbefehle sn_slack_ah_v2.command.sonderzeichen Die mit der Methode „encodeURIComponent“ codierten Zeichen werden intern verarbeitet. 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 Verknüpfungen: sn_slack_ah_v2.interactivity.sonderzeichen_zeichen

          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 der Slack-Interaktivität und in den Verknüpfungen in der Slack-Anwendung verwendet werden, durch ihre codierten URI-Zeichen in einem JSON-Format zu ersetzen.

          {

          „~“ : „%7E“,

          „\(“ : „%28“,

          }
          Um Dialogfelder für die erforderliche Verknüpfung anzuzeigen, geben Sie unter Bedingungdie sys_id des eingehenden Richtliniendatensatzes des Dialogfelds an.
          Zeigen Sie modale Elemente für Slack-Verknüpfungen an.
        • Um modale Elemente für die erforderlichen Slack -Befehle anzuzeigen, geben Sie unter 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 unter Bedingungdie erforderliche Aktions-ID der erforderlichen Blockaktion an, für die das modale Element angezeigt werden soll.
          Zeigen Sie modale Fenster für Slack-Blockaktionen an.
      3. Klicken Sie auf Absenden.
        Wenn Ereignisse 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 Anwender Werte in den modalen Elementen angibt, 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 zum Angeben, ob dies die Standardantwort ist. Die Standardantwort ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
        1. Klicken Sie auf das Suchsymbol ( Suchsymbol).
        2. Wählen Sie den gewünschten 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 Nutzlast der Antwort von Slack zur Automatisierung von Aufgaben konfiguriert haben.
        Bedingung Bedingungen, die zum Ausführen von Aufgaben in Instanz ServiceNow erfüllt werden müssen.
        Geben Sie den modalen Datensatz in der Bedingung an.
        Bedingung zum Auslösen eines Subflows.
        Hinweis:
        Die Bedingung darf nur eine für den modalen Datensatz spezifische Bedingung aufweisen.
      4. Klicken Sie auf Absenden.
        Wenn der Slack-Benutzer im Modal Eingaben macht, wird der zugehörige Subflow nach dem Validieren der Eingaben ausgelöst. Abhängig von den in Ihrem Subflow konfigurierten Automatisierungen werden Aufgaben ausgeführt.