Erstellen Sie eine Aktion, um einen Anwender zu entfernen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

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

    Vorbereitungen

    Wenn Sie eine vorhandene verwenden ServiceNow® IntegrationHub Spoke: Finden Sie heraus, ob eine Aktion zum Entfernen eines Anwenders vorhanden ist, 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 > Designeran.
    2. Klicken Sie Auf Neu Und wählen Sie dann aus Aktion .
    3. Füllen Sie im Formular die Felder aus.
      Tabelle : 1. Formular „Aktionseigenschaften“
      Feld Wert
      Name Name Ihrer Wahl. Beispiel: Entfernen Sie Den Anwender .
      Zugänglich von Alle Anwendungsbereiche .
      Kategorie Lassen Sie dieses Feld leer.
      Schutz Keine .
      Anwendung Spoke-App zur Integration in die SaaS-Anwendung. Dies kann ein vorhandenes sein IntegrationHub Spoke oder eine neue Spoke, die Sie erstellt haben.
      In-Flow-Anmerkung Lassen Sie dieses Feld leer.
      Beschreibung Beschreibung Ihrer Auswahl.
    4. Klicken Sie auf Absenden.
    5. Klicken Sie im Abschnitt „Eingaben“ der Aktionsstruktur auf Eingabe Erstellen .
    6. Fügen Sie eine Anwender-ID-Eingabe hinzu.

      So ruft die Aktion die Anwender-ID des zu löschenden Anwenders ab.

      Tabelle : 2. Eingaben
      Bezeichnung Name Typ Obligatorisch
      Anwender-ID userID Zeichenfolge Ja
    7. Wenn die API, mit der Sie arbeiten, eine Anwenderauthentifizierung für Anforderungen erfordert, fügen Sie Eingaben für die Authentifizierung hinzu.
      Beispiele für allgemeine Eingaben zur Anwenderauthentifizierung sind Administratoranwender-ID und Sitename. In der Dokumentation für die ausgewählte API finden Sie Informationen zu den Anforderungen für die Anwenderauthentifizierung in Ihrem spezifischen Fall. Wenn die API ein Zugriffstoken erfordert, ist Wert Der Anmeldeinformationen Variable wird später automatisch 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 ein hinzu SOAP-Schritt Oder REST-Schritt Zur Aktionsgliederung.
      Ihre Auswahl hängt von der API für die SaaS-Anwendung ab, in die Sie integrieren.
    9. Wenn Sie ausgewählt haben SOAP , Füllen Sie das Formular wie gezeigt aus.
      Tabelle : 3. SOAP-Schritt-Formular
      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 bis aus Erstellen Sie ein anwenderdefiniertes Integrationsprofil mit einem Verbindungsalias.
      Endpunkt Dieser Wert wird automatisch ausgefüllt, wenn Sie den Verbindungsalias auswählen. Sie ist auf die Verbindungs-URL aus dem HTTP(s)-Verbindungsdatensatz festgelegt, der mit dem Alias verknüpft ist.
      Anforderungsdetails
      Umschlag erstellen Manuell .
      SOAP-Aktion API-Anforderung zum Löschen oder Deaktivieren eines Anwenders. Informationen zur Auswahl der entsprechenden Anforderung finden Sie in der Dokumentation der ausgewählten API.
      SOAP-Umschlag XML-Anforderungsnachricht zum Löschen eines Anwenders. In der Dokumentation für die ausgewählte API erfahren Sie, wie Sie eine XML-Anforderungsnachricht schreiben. Im Allgemeinen sollte der Header Ihre Eingabevariablen für die Anwenderauthentifizierung sowie für enthalten Wert Der Anmeldeinformationen Variable als Zugriffstoken. Der Textkörper muss die Anforderung zum Löschen eines Anwenders und die Eingabe „Anwender-ID“ enthalten.
      Hinweis:
      Ein Beispiel für einen SOAP-Umschlag finden Sie in der Aktion Anwender entfernen Webex Subflow „Abonnement zurückfordern“.
    10. Wenn Sie ausgewählt haben REST, Füllen Sie das Formular wie gezeigt aus.
      Tabelle : 4. REST-Schritt-Formular
      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 bis aus Erstellen Sie ein anwenderdefiniertes Integrationsprofil mit einem Verbindungsalias.
      Basis-URL Dieser Wert wird automatisch ausgefüllt, wenn Sie den Verbindungsalias auswählen. Sie ist auf die Verbindungs-URL aus dem HTTP(s)-Verbindungsdatensatz festgelegt, der mit dem Alias verknüpft ist.
      Anforderungsdetails
      Build-Anforderung Manuell .
      Ressourcenpfad Pfad zur Ressource. Dieser Wert wird an die Basis-URL angehängt. Informationen zum Erstellen des Ressourcenpfads finden Sie in der Dokumentation der API, mit der Sie arbeiten.
      HTTP-Methode LÖSCHEN .
      Abfrageparameter Fügen Sie einen Parameter für die Anwender-ID hinzu. Legen Sie den Wert als Anwender-ID-Eingabe fest.
    11. Fügen Sie ein hinzu Skriptschritt Zur Aktionsstruktur für die Fehlerbehandlung.
      1. Für Erforderliche Laufzeit , Wählen Sie aus Instanz .
      2. Erstellen Sie Eingabevariablen.
        Tabelle : 5. Eingabevariablen
        Name Wert
        response Ausgabe des Antworttexts aus dem SOAP- oder REST-Schritt
        status_code Statuscode-Ausgabe aus dem SOAP- oder REST-Schritt
      3. Erstellen Sie Ausgabevariablen.
        Tabelle : 6. Ausgabevariablen
        Bezeichnung Name Typ Obligatorisch
        status status Auswahl Ja
        error_message error_message Zeichenfolge Ja
      4. In Skript Ein Skript schreiben, um den Status- und Fehlermeldungsausgaben Werte zuzuweisen.
        • Verwenden Sie Status_Code Eingabe, um zu überprüfen, ob ein Fehler vorliegt. Legen Sie die Statusausgabe auf fest Fehler Wenn ein Fehler vorliegt und Erfolg Wenn kein Fehler vorliegt.
        • In Fällen, in denen ein Fehler auftritt, verwenden Sie Antwort Eingabe, um Informationen zur Art des Fehlers abzurufen. Legen Sie fest Fehlermeldung Ausgabe in eine Beschreibung des Fehlers, damit ein Anwender 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 Status Ausgabevariable aus dem Skriptschritt
      Fehlermeldung Error_message Ausgabevariable aus dem Skriptschritt
    15. Um Ihre Aktion zu testen, klicken Sie auf Testen .
      1. Zeigen Sie die Testergebnisse und Systemprotokolle an, um Details zu Fehlern zu erhalten.
        Um Systemprotokolle anzuzeigen, navigieren Sie zu Systemprotokolle > Systemprotokoll > Allean.
      2. Wenn Ihre Aktion Fehler aufweist, stellen Sie sicher, dass Sie die richtigen Endpunkte verwenden und dass die API-Anforderung wie erwartet strukturiert ist.
      Hinweis:
      Denken Sie beim Testen daran, dass diese Aktion einen Anwender deaktiviert. Testen Sie diese Aktion in einer Unterproduktionsumgebung. Wenn nur eine Produktionsumgebung verfügbar ist, können Sie gefälschte Anwender zum Testen erstellen.
    16. Nachdem Sie überprüft haben, ob die Aktion wie erwartet funktioniert, klicken Sie auf Veröffentlichen .