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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama IT Asset Management

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Erstellen Sie eine Datenstromaktion, um die Anwenderaktivität abzurufen

# Erstellen Sie eine Datenstromaktion, um die Anwenderaktivität abzurufen {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 Minuten Lesedauer

Erstellen Sie eine Datenstromaktion, um Anwenderaktivitäten aus einer SaaS-Anwendung abzurufen.

## Vorbereitungen

Wenn Sie eine vorhandene verwenden ServiceNow® IntegrationHubSpoke: Finden Sie heraus, ob eine Datenstromaktion vorhanden ist, um Anwenderaktivitäten abzurufen, die Sie verwenden können, anstatt eine zu erstellen.

Weitere Informationen zu Datenstromaaktionen finden Sie unter [Datenstromaktionen](https://www.servicenow.com/docs/access?context=data-stream-actions&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).

Erforderliche Rolle: Flow_Designer oder admin

## Warum und wann dieser Vorgang ausgeführt wird

Überwachen Sie die Anwenderaktivität, um Softwareabonnements zu finden, die Ihr Unternehmen bezahlt, aber nicht verwendet wird. Sie können diese nicht verwendeten Abonnements zurückfordern, um die Softwareausgaben Ihres Unternehmens zu reduzieren.

Entscheiden Sie vor dem Erstellen der Datenstromaktion, wie Sie eine aussagekräftige Anwenderaktivität definieren möchten. Eine aussagekräftige Aktivität kann eine Kombination von Anwenderaktionen sein. Erstellen Sie eine separate Datenstromaktion für jede Anwenderaktivitätsmetrik. Beispiel: Das Basissystem WebexDie Integration von Besprechungen definiert sinnvolle Aktivitäten als Hosting einer Besprechung. Es verwendet eine Datenstromaktion, um die Daten der zuletzt gehosteten Besprechungen für alle Anwender abzurufen. Wenn Sie auch gewünscht haben WebexIntegration von Meetings um die Anmeldung als aussagekräftige Aktivität einzubeziehen, erstellen Sie eine zweite Datenstromaktion, um die neuesten Anmeldezeiten für alle Anwender abzurufen.

Ihre Datenstromaktion zum Abrufen von Anwendern kann eine Anwenderaktivitätsmetrik zurückgeben, z. B. Zeitpunkt der letzten Anmeldung. In diesem Fall müssen Sie keine Datenstromaktion erstellen, um Anwenderaktivität abzurufen, oder einen Subflow zum Abrufen der Anwenderaktivität, es sei denn, Sie möchten zusätzliche Anwenderaktivitätsmetriken definieren. Stellen Sie sicher, dass Ihr Subflow zum Abrufen von Anwendern diese Anwenderaktivitätsmetrik auf festgelegt hat Letzte Aktivität Geben Sie in ein Aktualisieren Sie Das Anwenderabonnement Aktion.

## Prozedur

1. Navigieren zu AlleFlow DesignerDesigneran.
2. Klicken Sie Auf Neu Und wählen Sie dann aus Datenstrom .
3. Füllen Sie im Formular die Felder aus.  
   {#create-data-stream-get-activity__table_j2c_w4j_rjb__entry__2}

   | Feld | Wert |
   |-|-|
   | Name | Name Ihrer Wahl. Beispiel: <kbd class="ph userinput">Anwenderaktivität Abrufen </kbd>. |
   | Zugänglich von | Wählen Sie Aus Alle Anwendungsbereiche . |
   | Kategorie | Lassen Sie dieses Feld leer. |
   | Schutz | Wählen Sie Aus Keine . |
   | Anwendung | Spoke-App, die in integriert werden soll SaaSAnwendung. Diese Spoke-App kann bereits vorhanden sein IntegrationHubSpoke oder eine neue Spoke, die Sie erstellt haben. |
   | In-Flow-Anmerkung | Lassen Sie dieses Feld leer. |
   | Beschreibung | Beschreibung Ihrer Auswahl. |
   [Tabelle : 1. Formular „Aktionseigenschaften"]

   {#create-data-stream-get-activity__table_j2c_w4j_rjb}
4. Klicken Sie auf Absenden.
5. Klicken Sie im Abschnitt „Eingaben" der Aktionsstruktur auf Eingabe Erstellen .
6. Fügen Sie eine Rückblickzeiteingabe hinzu.  
   {#create-data-stream-get-activity__table_vjm_pqb_njb__entry__4}

   | Bezeichnung | Name | Typ | Obligatorisch |
   |-|-|-|-|
   | Rückblickzeit | Look_back_time | Datum/Uhrzeit | Ja |
   [Tabelle : 2. Eingaben]

   {#create-data-stream-get-activity__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 Anwenderauthentifizierungseingaben sind Administrator-Anwender-ID und Sitename. Weitere Informationen finden Sie in der Dokumentation Für Ihre ausgewählte API, um mehr über die Anforderungen für die Anwenderauthentifizierung in Ihrem spezifischen Fall zu erfahren. Wenn die API ein Zugriffstoken erfordert, ein <var class="keyword varname">Anmeldeinformationswert </var>Variable wird später automatisch erstellt. Sie müssen kein Zugriffstoken als Eingabe hinzufügen.

   Wenn Sie Ihre abgeschlossene Datenstromaktion in einem Subflow verwenden, definieren Sie, welche Werte als diese Eingaben übergeben werden sollen.
8. Klicken Sie Auf Anforderung In der Aktionsstruktur.
9. Füllen Sie im Formular die Felder aus.  
   {#create-data-stream-get-activity__table_k2c_w4j_rjb__entry__2}

   | Feld | Wert |
   |-|-|
   | So rufen Sie Daten ab | Wählen Sie eine der beiden aus REST-Schritt Oder SOAP-Schritt . Ihre Auswahl hängt von der API für die SaaS-Anwendung ab, in die Sie integrieren. |
   | Paginierung aktivieren | Ausgewählt. |
   | Vor jeder Anforderung ein Skript ausführen | Nicht ausgewählt. |
   [Tabelle : 3. Anforderungsformular]

   {#create-data-stream-get-activity__table_k2c_w4j_rjb}
10. Klicken Sie Auf Schritt „Paginierung einrichten" In der Aktionsstruktur.
11. Definieren Sie Paginierungsvariablen basierend auf den Abfrageparametern, die von der SaaS-API verwendet werden.  
    Wenn Sie eine Offset-basierte Paginierung verwenden, verwenden Sie die Vorlage für Limit/Offset-Paginierung, um die Paginierungskonfiguration vorab zu laden.  
    Hinweis:  
    Der Wert der reservierten `GetNextPage `Variable bestimmt, ob eine weitere Seite mit Ergebnissen angefordert werden soll. So lang wie `GetNextPage `Variable ist Wahr , Die Aktion sendet weiterhin Anforderungen für die nächste Seite.
12. Schreiben Sie ein Paginierungsvariablen Skript zum Aktualisieren der Paginierungsvariablen.  
    Das Skript wird für jede Anforderung ausgeführt. Wenn Sie eine Paginierungsvorlage verwenden, passen Sie das vorinstallierte Skript nach Bedarf an.

    Das folgende Bild zeigt ein abgeschlossenes Beispiel für den Schritt „Paginierung einrichten". Dieses Beispiel stammt aus der Datenstromaktion „Anwender abrufen", die in verwendet wird WebexSubflow „Abonnements" herunterladen.  
    Hinweis:  
    Paginierungsvariablen unterstützen nur den Datentyp „Zeichenfolge". Um mathematische Vorgänge auszuführen, konvertieren Sie den Wert in eine Ganzzahl, führen Sie alle erforderlichen Vorgänge aus, und konvertieren Sie ihn dann wieder in eine Zeichenfolge.
13. Klicken Sie Auf SOAP-Schritt Oder REST-Schritt In der Aktionsstruktur abhängig von der Option, die Sie für den Datenabruf ausgewählt haben.
14. Wenn Sie ausgewählt haben SOAP , Geben Sie die Details ein.  
    {#create-data-stream-get-activity__table_o2c_w4j_rjb__entry__2}

    | Feld | Wert |
    |-|-|
    | Verbindungsdetails ||
    | Verbindung | Verwenden Sie Den Verbindungsalias . |
    | 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.](https://servicenow-prod.fluidtopics.net/PbDR9b8yqw4lpLp7o49A5A "Erstellen Sie ein anwenderdefiniertes Integrationsprofil, um Softwareabonnements nachzuverfolgen und veraltete Lizenzen für alle zu optimieren SaaSAnwendung.") |
    | 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. |
    | Details anfordern ||
    | Umschlag erstellen | Manuell . |
    | SOAP-Aktion | API-Anforderung zum Abrufen einer Liste aussagekräftiger Anwenderaktivitäten. Beispiel: Das Basissystem WebexDie Integration von Besprechungen definiert eine sinnvolle Anwenderaktivität als Hosting einer Besprechung, sodass sie verwendet `LstsummaryMeeting `Anforderung zum Abrufen einer Liste aller Besprechungen. Informationen zur Auswahl der entsprechenden Anforderung finden Sie in der Dokumentation der ausgewählten API. |
    | SOAP-Umschlag | XML-Anforderungsnachricht zum Abrufen einer Liste aller Anwender. In der Dokumentation der ausgewählten API erfahren Sie, wie Sie eine XML-Anforderungsnachricht schreiben. Im Allgemeinen sollte der Header Ihre Eingabevariablen für die Anwenderauthentifizierung sowie für enthalten <var class="keyword varname">Anmeldeinformationswert </var>Variable als Zugriffstoken. Der Text sollte die Anforderung enthalten, um eine Liste aussagekräftiger Anwenderaktivitäten abzurufen, ein Startdatum, das als festgelegt ist Rückblickzeit Geben Sie und Ihre Variablen aus dem Schritt „Paginierung einrichten" ein. Hinweis: Ein Beispiel für einen SOAP-Umschlag finden Sie in der Aktion „Anwenderaktivitäts-Datenstrom abrufen", die in verwendet wird WebexAktualisieren Sie den Subflow „Anwenderaktivität". |
    [Tabelle : 4. SOAP-Schrittformular]

    {#create-data-stream-get-activity__table_o2c_w4j_rjb}
15. Wenn Sie ausgewählt haben REST , Geben Sie die Details ein.  
    {#create-data-stream-get-activity__table_p2c_w4j_rjb__entry__2}

    | Feld | Wert |
    |-|-|
    | Verbindungsdetails ||
    | Verbindung | Verwenden Sie Den Verbindungsalias . |
    | 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.](https://servicenow-prod.fluidtopics.net/PbDR9b8yqw4lpLp7o49A5A "Erstellen Sie ein anwenderdefiniertes Integrationsprofil, um Softwareabonnements nachzuverfolgen und veraltete Lizenzen für alle zu optimieren SaaSAnwendung.") |
    | 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. |
    | Details anfordern ||
    | Build-Anforderung | Manuell . |
    | Ressourcenpfad | Pfad zur Ressource. Dieser Wert wird an die Basis-URL angehängt. Siehe Dokumentation Für die API, mit der Sie arbeiten, um zu erfahren, wie Sie den Ressourcenpfad erstellen. |
    | HTTP-Methode | ABRUFEN . |
    | Abfrageparameter | Fügen Sie Parameter für die Paginierung hinzu. Legen Sie die Werte als die Variablen fest, die Sie im Schritt „Paginierungseinrichtung" erstellt haben. Fügen Sie einen weiteren Parameter für das Startdatum hinzu, damit die Anforderung Ergebnisse vom Startdatum bis zum aktuellen Datum zurückgibt. Legen Sie den Wert auf fest Rückblickzeit Eingabe. Hinweis: Stellen Sie sicher, dass Rückblickzeit Die Eingabedatums-/Uhrzeitvariable ist für die API, mit der Sie arbeiten, korrekt formatiert. Wenn Sie einen anderen Datentyp, z. B. eine Zeichenfolge, neu formatieren oder in einen anderen Datentyp konvertieren müssen, können Sie dies im Schritt „Aktionsvorverarbeitungsskript" tun. |
    [Tabelle : 5. REST-Schrittformular]

    {#create-data-stream-get-activity__table_p2c_w4j_rjb}

    Das folgende Bild zeigt ein abgeschlossenes Beispiel für den REST-Schritt. Dieses Beispiel stammt aus der Datenstromaktion „Auditprotokoll abrufen", die in verwendet wird JiraAktualisieren Sie den Subflow „Anwenderaktivität".
16. Klicken Sie Auf Wird Analysiert In der Aktionsstruktur.
17. Füllen Sie im Formular die Felder aus.  
    {#create-data-stream-get-activity__table_tpt_jmr_sjb__entry__2}

    | Feld | Wert |
    |-|-|
    | So werden die einzelnen Datensätze identifiziert | JSON/XML-Splitter |
    | So werden die einzelnen Elemente in einem Objekt analysiert | Skriptparser |
    [Tabelle : 6. Formular wird analysiert]

    {#create-data-stream-get-activity__table_tpt_jmr_sjb}
18. Klicken Sie Auf Splitter-Schritt In der Aktionsstruktur.
19. Füllen Sie im Formular die Felder aus.  
    {#create-data-stream-get-activity__table_r2c_w4j_rjb__entry__2}

    | Feld | Wert |
    |-|-|
    | Quellformat | Wählen Sie Aus XML Oder JSON Abhängig vom Format, das von der API-Antwort zurückgegeben wird. |
    | Elementpfad | Absoluter Pfad zu einem aussagekräftigen Aktivitätselement in der Antwortnachricht. Informationen zum Format der Antwortnachricht finden Sie in der Dokumentation der API, mit der Sie arbeiten. * Beispiel-XML-Elementpfad: `/Message/body/Meeting ` * Beispiel-JSON-Elementpfad: `$.Daten.Besprechung ` {#create-data-stream-get-activity__ul_s2c_w4j_rjb} |
    [Tabelle : 7. Splitter-Schritt-Formular]

    {#create-data-stream-get-activity__table_r2c_w4j_rjb}
20. Klicken Sie Auf Ausgaben In der Aktionsstruktur.
21. Klicken Sie Auf Ausgabe Erstellen Und bearbeiten Sie die Variable wie gezeigt.  
    {#create-data-stream-get-activity__table_t2c_w4j_rjb__entry__4}

    | Bezeichnung | Name | Typ | Obligatorisch |
    |-|-|-|-|
    | targetObject | targetObject | Objekt | Nein |
    [Tabelle : 8. Aktionsausgabe]

    {#create-data-stream-get-activity__table_t2c_w4j_rjb}
22. Fügen Sie untergeordnete Elemente für hinzu <var class="keyword varname">TargetObject </var>Dient zum Speichern der Anwender-E-Mail-Adresse und des Datums der aussagekräftigen Aktivität.  
    Beispielsweise könnte eine XML-Antwort so aussehen.

        <message>​
          <body>​
            <meeting>
              <meetingID>​12345</meetingID>​
              <startDate>​08/13/2019 20:08:16</startDate>​
              <hostEmail>​email@email.com</hostEmail>​
            </meeting>​
            <meeting>
              ...
            </meeting>
          </body>​
        </message>

    Fügen Sie für diese Antwort die untergeordneten Elemente wie gezeigt hinzu.{#create-data-stream-get-activity__table_u2c_w4j_rjb__entry__4}

    | Bezeichnung | Name | Typ | Obligatorisch |
    |-|-|-|-|
    | E-Mail | E-Mail | Zeichenfolge | Nein |
    | Last_activity | Last_activity | Zeichenfolge | Nein |
    [Tabelle : 9. Untergeordnete Elemente für targetObject]

    {#create-data-stream-get-activity__table_u2c_w4j_rjb}
23. Klicken Sie in der Aktionsstruktur auf Skriptparser-Schritt .
24. Erstellen Sie ein <var class="keyword varname">TargetObject </var>Ausgabeobjekt für jedes aussagekräftige Aktivitätselement in der Antwort, und ordnen Sie dann jedes Aktivitätsdatum und die Anwender-E-Mail-Adresse zu <var class="keyword varname">TargetObject </var>Untergeordnete Elemente.  
    Das Parser-Skript wird für jedes Anwenderelement ausgeführt.  
    Hinweis:  
    Diese Beispiele zeigen die Arten von Elementen, die in einer Antwort enthalten sein könnten. Kopieren Sie diese Skripts nicht direkt. Verwenden Sie Elementnamen aus der Dokumentation für die API, mit der Sie arbeiten.  
    Beispielskript, das eine XML-Antwort analysiert.

        (function parse(inputs, outputs) {
            var xmlDoc = new XMLDocument(inputs.sourceItem, false);
            outputs.targetObject.email = xmlDoc.getNodeText('/meeting/hostEmail');
            outputs.targetObject.last_activity = xmlDoc.getNodeText('/meeting/startDate');
        })(inputs, outputs)

    Beispielskript, das eine JSON-Antwort analysiert.

        (function parse(inputs, outputs) {
            var record = JSON.parse(inputs.sourceItem);
            outputs.targetObject.email = record.hostEmail;
            outputs.targetObject.last_activity = record.startDate;
        })(inputs, outputs)

25. Klicken Sie auf, um Ihre Datenstromaktion zu testen Testen .
    1. Zeigen Sie die Testergebnisse und Systemprotokolle an, um Details zu Fehlern zu erhalten.  
       Navigieren Sie zu , um Systemprotokolle anzuzeigen SystemprotokolleSystemprotokollAllean.
    2. Wenn Ihre Datenstromaktion Fehler aufweist, stellen Sie sicher, dass Sie die richtigen Endpunkte verwenden und dass die API-Anforderungen und -Antworten wie erwartet strukturiert sind.
    {#create-data-stream-get-activity__substeps_tnl_zxq_zjb}
26. Nachdem Sie überprüft haben, ob die Datenstromaktion wie erwartet funktioniert, klicken Sie auf Veröffentlichen .