---
sourceDocument: Xanadu – IT Asset Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/it-asset-management

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu – IT Asset Management

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Erstellen Sie eine Aktion zum Entfernen eines Anwenders

# Erstellen Sie eine Aktion zum Entfernen eines Anwenders {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 AlleFlow DesignerDesigner.
2. Klicken Sie auf Neu, und wählen Sie Aktionaus.
3. Füllen Sie die Felder des Formulars aus.  
   {#create-data-stream-remove-user__table_j2c_w4j_rjb__entry__2}

   | 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. |
   [Tabelle : 1. Formular „Aktionseigenschaften".]

   {#create-data-stream-remove-user__table_j2c_w4j_rjb}
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.  
   {#create-data-stream-remove-user__table_vjm_pqb_njb__entry__4}

   | Bezeichnung | Name | Typ | Obligatorisch |
   |-|-|-|-|
   | Anwender-ID | userID | Zeichenfolge | Ja |
   [Tabelle : 2. Eingaben]

   {#create-data-stream-remove-user__table_vjm_pqb_njb}
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 <var class="keyword varname">Wert der Anmeldeinformationen</var> 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.  
   {#create-data-stream-remove-user__table_o2c_w4j_rjb__entry__2}

   | 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.](https://servicenow-prod.fluidtopics.net/oMLePxit3AJSwj6Wx177zA "Erstellen Sie ein anwenderdefiniertes Integrationsprofil, um Softwareabonnements nachzuverfolgen und veraltete Lizenzen für SaaS-Anwendungen zu optimieren.") |
   | 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 <var class="keyword varname">„Anmeldeinformationswert“</var> 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. |
   [Tabelle : 3. SOAP-Schrittformular]

   {#create-data-stream-remove-user__table_o2c_w4j_rjb}
10. Wenn Sie REST ausgewählt haben, füllen Sie das Formular wie gezeigt aus.  
    {#create-data-stream-remove-user__table_p2c_w4j_rjb__entry__2}

    | 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.](https://servicenow-prod.fluidtopics.net/oMLePxit3AJSwj6Wx177zA "Erstellen Sie ein anwenderdefiniertes Integrationsprofil, um Softwareabonnements nachzuverfolgen und veraltete Lizenzen für SaaS-Anwendungen zu optimieren.") |
    | 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. |
    [Tabelle : 4. REST-Schrittformular]

    {#create-data-stream-remove-user__table_p2c_w4j_rjb}
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.  
       {#create-data-stream-remove-user__table_h2c_zm1_tjb__entry__2}

       | Name | Wert |
       |-|-|
       | response | Antworttextausgabe vom SOAP- oder REST-Schritt |
       | status_code | Statuscode-Ausgabe vom SOAP- oder REST-Schritt |
       [Tabelle : 5. Eingabevariablen]

       {#create-data-stream-remove-user__table_h2c_zm1_tjb}
    3. Erstellen Sie Ausgabevariablen.  
       {#create-data-stream-remove-user__table_bvx_mn1_tjb__entry__4}

       | Bezeichnung | Name | Typ | Obligatorisch |
       |-|-|-|-|
       | Status | Status | Auswahl | Ja |
       | error_message | error_message | Zeichenfolge | Ja |
       [Tabelle : 6. Ausgabevariablen]

       {#create-data-stream-remove-user__table_bvx_mn1_tjb}
    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.
       {#create-data-stream-remove-user__ul_ldz_tp1_tjb}
    {#create-data-stream-remove-user__substeps_kdl_pm1_tjb}
12. Klicken Sie in der Aktionsgliederung auf Ausgaben.
13. Erstellen Sie Ausgabevariablen.  
    {#create-data-stream-remove-user__table_spq_pq1_tjb__entry__4}

    | Bezeichnung | Name | Typ | Obligatorisch |
    |-|-|-|-|
    | Status | Status | Auswahl | Nein |
    | Fehlermeldung | error_message | Zeichenfolge | Nein |
    [Tabelle : 7. Ausgabevariablen]

    {#create-data-stream-remove-user__table_spq_pq1_tjb}
14. Weisen Sie den Ausgabevariablen Werte zu.  
    {#create-data-stream-remove-user__table_yvv_s5b_tjb__entry__2}

    | Bezeichnung | Wert |
    |-|-|
    | Status | Statusausgabevariable aus dem Skriptschritt |
    | Fehlermeldung | Ausgabevariable „error_message" aus dem Skriptschritt |
    [Tabelle : 8. Ausgabevariablen]

    {#create-data-stream-remove-user__table_yvv_s5b_tjb}
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 SystemprotokolleSystemprotokollAlle.
    2. Wenn Ihre Aktion Fehler aufweist, stellen Sie sicher, dass Sie die richtigen Endpunkte verwenden und dass die API-Anforderung wie erwartet strukturiert ist.

    {#create-data-stream-remove-user__substeps_ebk_42r_zjb}  
    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.
**Vorheriges Thema:** [Erstellen Sie einen Subflow, um die Anwenderaktivität abzurufen](https://servicenow-prod.fluidtopics.net/IpD_bt5r0zuSg7wQfiP1cQ "Erstellen Sie einen Subflow, um die Tabelle „Software-Abonnement“ mit der letzten Aktivität jedes Benutzers in der Anwendung SaaS zu aktualisieren.")  
**Nächstes Thema:** [Erstellen Sie einen Subflow, um einen Anwender zurückzufordern](https://servicenow-prod.fluidtopics.net/WIRgezi1q4CZgKTwyKZ24A "Erstellen Sie einen Subflow, um ein Anwenderabonnement zurückzufordern.")