Erstellen Sie eine Aktion zum Entfernen eines Anwenders

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

    • Erstellen Sie eine Aktion, um ein Anwenderaccount in der SaaS-Anwendung zu deaktivieren oder zu löschen.

    Vorbereitungen

    Wenn Sie eine vorhandene ServiceNow® IntegrationHub -Spoke verwenden, prüfen Sie, ob sie über eine Aktion zum Entfernen eines Benutzers verfügt, 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 und so die Softwarekosten Ihres Unternehmens zu senken.

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Neu, und wählen Sie Aktionaus.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular „Aktionseigenschaften“.
      Feld Wert
      Name Name Ihrer Wahl. Beispiel: Anwender entfernen.
      Zugänglich von Alle Anwendungsbereiche.
      Kategorie Lassen Sie dieses Feld leer.
      Schutz Keine.
      Anwendung Spoke-App zur Integration mit der SaaS-Anwendung. Dies kann eine vorhandene IntegrationHub -Spoke oder eine neue, von Ihnen erstellte Spoke sein.
      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 Anwender-ID-Eingabe hinzu.

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

      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 Site-Name. In der Dokumentation für die von Ihnen ausgewählte API erfahren Sie mehr über die Anforderungen für die Anwenderauthentifizierung in Ihrem speziellen Fall. Wenn die API ein Zugriffstoken erfordert, wird später automatisch eine Variable für den Wert der Anmeldeinformationen 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 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 möchten.
    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 folgenden Schritte aus, um ein anwenderdefiniertes Integrationsprofil mit einem Verbindungsalias zu erstellen.
      Endpunkt Dieser Wert wird automatisch ausgefüllt, wenn Sie den Verbindungsalias auswählen. Sie 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 Anwenders. Informationen zur Auswahl der entsprechenden Anforderung finden Sie in der Dokumentation zu der von Ihnen ausgewählten API.
      SOAP-Umschlag XML-Anforderungsnachricht zum Löschen eines Anwenders. In der Dokumentation für die von Ihnen ausgewählte API erfahren Sie, wie Sie eine XML-Anforderungsnachricht schreiben. Im Allgemeinen sollte der Header Ihre Eingabevariablen für die Anwenderauthentifizierung sowie die Variable „Anmeldeinformationswert“ als Zugriffstoken enthalten. Der Textkörper sollte die Anforderung zum Löschen eines Anwenders und die Eingabe „Anwender-ID“ enthalten.
      Hinweis:
      Ein Beispiel für einen SOAP-Umschlag finden Sie unter 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 folgenden Schritte aus, um ein anwenderdefiniertes Integrationsprofil mit einem Verbindungsalias zu erstellen.
      Basis-URL Dieser Wert wird automatisch ausgefüllt, wenn Sie den Verbindungsalias auswählen. Sie 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 der 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 Anwender-ID hinzu. Legen Sie den Wert als Eingabe für die Anwender-ID fest.
    11. Fügen Sie der Aktionsgliederung einen Skriptschritt zur Fehlerbehandlung hinzu.
      1. Wählen Sie für Erforderliche Laufzeitdie Option Instanzaus.
      2. Erstellen Sie Eingabevariablen.
        Tabelle : 5. Eingabevariablen
        Name Wert
        response Antworttextausgabe vom SOAP- oder REST-Schritt
        status_code Statuscode-Ausgabe vom 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. 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 auftritt, die Antworteingabe, um Informationen zur Art des Fehlers zu erhalten. Legen Sie die Ausgabe der Fehlermeldung 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 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 Test- und Entwicklungsumgebung. Wenn nur eine Produktionsumgebung verfügbar ist, können Sie zu Testzwecken Pseudobenutzer erstellen.
    16. Nachdem Sie sich vergewissert haben, dass die Aktion wie erwartet funktioniert, klicken Sie auf Veröffentlichen.