Erstellen Sie eine Aktion, um einen Benutzer zu entfernen

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

    • Erstellen Sie eine Aktion zum Deaktivieren oder Löschen eines Benutzeraccounts in der SaaS-Anwendung.

    Vorbereitungen

    Wenn Sie eine vorhandene Spoke ServiceNow® IntegrationHub verwenden, prüfen Sie, ob sie eine Aktion zum Entfernen eines Benutzers enthält, die Sie verwenden können, anstatt einen zu erstellen.

    Erforderliche Rolle: flow_designer oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Diese Aktion wird verwendet, um nicht verwendete Abonnements zurückzufordern, um die Softwareausgaben Ihres Unternehmens zu reduzieren.

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Neu, und wählen Sie dann Aktionaus.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular „Aktionseigenschaften“
      Feld Wert
      Name Name Ihrer Wahl. Beispiel: Benutzer entfernen.
      Zugänglich von Alle Anwendungsbereiche.
      Kategorie Lassen Sie dieses Feld leer.
      Schutz Keine.
      Anwendung Spoke-App zur Integration in die SaaS-Anwendung. Dies kann eine vorhandene Spoke IntegrationHub oder eine neue Spoke sein, die Sie erstellt haben.
      In-Flow-Anmerkung Lassen Sie dieses Feld leer.
      Beschreibung Beschreibung Ihrer Wahl.
    4. Klicken Sie auf Absenden.
    5. Klicken Sie im Abschnitt Eingaben der Aktionsgliederung auf Eingabe erstellen.
    6. Fügen Sie eine Benutzer-ID-Eingabe hinzu.

      Auf diese Weise erhält die Aktion die Benutzer-ID des zu löschenden Benutzers.

      Tabelle : 2. Eingaben
      Bezeichnung Name Typ Obligatorisch
      Anwender-ID userID Zeichenfolge Ja
    7. Wenn die API, mit der Sie arbeiten, eine Benutzerauthentifizierung für Anforderungen erfordert, fügen Sie Eingaben für die Authentifizierung hinzu.
      Beispiele für allgemeine Eingaben für die Benutzerauthentifizierung sind die Administrator-Benutzer-ID und der Site-Name. In der Dokumentation für die von Ihnen gewählte API erfahren Sie mehr über die Anforderungen für die Benutzerauthentifizierung in Ihrem speziellen Fall. Wenn die API ein Zugriffstoken erfordert, wird später automatisch eine Variable „Anmeldeinformationswert“ erstellt, sodass Sie sie nicht als Eingabe hinzufügen müssen.

      Wenn Sie Ihre abgeschlossene Aktion in einem Subflow verwenden, definieren Sie, welche Werte als diese Eingaben übergeben werden sollen.

    8. Fügen Sie der Aktionsgliederung einen SOAP- oder REST-Schritt hinzu.
      Ihre Auswahl hängt von der API für die SaaS-Anwendung ab, die Sie integrieren.
    9. Wenn Sie SOAPausgewählt haben, füllen Sie das Formular wie gezeigt aus.
      Tabelle : 3. SOAP-Schrittformular
      Feld Wert
      Verbindungsdetails
      Verbindung Verbindungs-Alias verwenden.
      Verbindungsalias Verbindungsalias, den Sie beim Erstellen des Integrationsprofils erstellt haben. Wenn Sie noch kein Integrationsprofil erstellt haben, führen Sie die Schritte aus, um ein benutzerdefiniertes Integrationsprofil mit einem Verbindungsalias zu erstellen.
      Endpunkt Dieser Wert wird automatisch ausgefüllt, wenn Sie den Verbindungsalias auswählen. Er wird auf die Verbindungs-URL aus dem HTTP(S)-Verbindungsdatensatz festgelegt, der mit dem Alias verknüpft ist.
      Details anfordern
      Umschlag erstellen Manuell.
      SOAP-Aktion API-Anforderung zum Löschen oder Deaktivieren eines Benutzers. Informationen zur Auswahl der entsprechenden Anforderung finden Sie in der Dokumentation für die von Ihnen gewählte API.
      SOAP-Umschlag XML-Anforderungsnachricht zum Löschen eines Benutzers. In der Dokumentation für die von Ihnen gewählte API erfahren Sie, wie Sie eine XML-Anforderungsnachricht schreiben. Im Allgemeinen sollte der Header Ihre Eingabevariablen für die Benutzerauthentifizierung sowie die Variable Credential Value (Anmeldeinformationswert) als Zugriffstoken enthalten. Der Text sollte die Anforderung zum Löschen eines Benutzers und die Eingabe der Benutzer-ID enthalten.
      Hinweis:
      Ein Beispiel für einen SOAP-Umschlag finden Sie in der Aktion Benutzer entfernen, die im Subflow Webex Abonnement zurückfordern verwendet wird.
    10. Wenn Sie REST ausgewählt haben, füllen Sie das Formular wie gezeigt aus.
      Tabelle : 4. REST-Schrittformular
      Feld Wert
      Verbindungsdetails
      Verbindung Verbindungs-Alias verwenden.
      Verbindungsalias Verbindungsalias, den Sie beim Erstellen des Integrationsprofils erstellt haben. Wenn Sie noch kein Integrationsprofil erstellt haben, führen Sie die Schritte aus, um ein benutzerdefiniertes Integrationsprofil mit einem Verbindungsalias zu erstellen.
      Basis-URL Dieser Wert wird automatisch ausgefüllt, wenn Sie den Verbindungsalias auswählen. Er wird auf die Verbindungs-URL aus dem HTTP(S)-Verbindungsdatensatz festgelegt, der mit dem Alias verknüpft ist.
      Details anfordern
      Build-Anforderung Manuell.
      Ressourcenpfad Pfad zur Ressource. Dieser Wert wird an die Basis-URL angehängt. In der Dokumentation für die API, mit der Sie arbeiten, erfahren Sie, wie Sie den Ressourcenpfad erstellen.
      HTTP-Methode LÖSCHEN.
      Abfrageparameter Fügen Sie einen Parameter für die Benutzer-ID hinzu. Legen Sie den Wert als Eingabe für die Benutzer-ID fest.
    11. Fügen Sie der Aktionsgliederung einen Skriptschritt für die Fehlerbehandlung hinzu.
      1. Wählen Sie für Erforderliche Laufzeitdie Option Instanzaus.
      2. Erstellen Sie Eingabevariablen.
        Tabelle : 5. Eingabevariablen
        Name Wert
        response Antworttextausgabe des SOAP- oder REST-Schritts
        status_code Statuscodeausgabe des SOAP- oder REST-Schritts
      3. Erstellen Sie Ausgabevariablen.
        Tabelle : 6. Ausgabevariablen
        Bezeichnung Name Typ Obligatorisch
        Status Status Auswahl Ja
        error_message error_message Zeichenfolge Ja
      4. Schreiben Sie im Feld Skript ein Skript, um den Status- und Fehlermeldungsausgaben Werte zuzuweisen.
        • Verwenden Sie die Eingabe status_code, um zu überprüfen, ob ein Fehler vorliegt. Legen Sie die Statusausgabe auf Fehler fest, wenn ein Fehler vorliegt, und auf Erfolg, wenn kein Fehler vorliegt.
        • Verwenden Sie in Fällen, in denen ein Fehler vorliegt, die Antworteingabe, um Informationen zur Art des Fehlers zu erhalten. Legen Sie die Fehlermeldungsausgabe auf eine Beschreibung des Fehlers fest, damit ein Benutzer verstehen kann, was schief gelaufen ist.
    12. Klicken Sie in der Aktionsgliederung auf Ausgaben.
    13. Erstellen Sie Ausgabevariablen.
      Tabelle : 7. Ausgabevariablen
      Bezeichnung Name Typ Obligatorisch
      Status Status Auswahl Nein
      Fehlermeldung error_message Zeichenfolge Nein
    14. Weisen Sie den Ausgabevariablen Werte zu.
      Tabelle : 8. Ausgabevariablen
      Bezeichnung Wert
      Status Statusausgabevariable aus dem Skriptschritt
      Fehlermeldung Ausgabevariable error_message aus dem Skriptschritt
    15. Um Ihre Aktion zu testen, klicken Sie auf Test.
      1. Zeigen Sie die Testergebnisse und Systemprotokolle an, um Details zu Fehlern zu erhalten.
        Um Systemprotokolle anzuzeigen, navigieren Sie zu Systemprotokolle > Systemprotokoll > Alle.
      2. Wenn Ihre Aktion Fehler aufweist, stellen Sie sicher, dass Sie die richtigen Endpunkte verwenden und die API-Anforderung wie erwartet strukturiert ist.
      Hinweis:
      Denken Sie beim Testen daran, dass diese Aktion einen Benutzer deaktiviert. Testen Sie diese Aktion in einer Test- und Entwicklungsumgebung. Wenn nur eine Produktionsumgebung verfügbar ist, können Sie falsche Benutzer zum Testen erstellen.
    16. Nachdem Sie sich vergewissert haben, dass die Aktion wie erwartet funktioniert, klicken Sie auf Veröffentlichen.