Erstellen Sie einen Subflow, um Anwender abzurufen

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

    • Erstellen Sie einen Subflow, um der Tabelle „Softwareabonnement“ eine Liste von Anwendern hinzuzufügen.

    Vorbereitungen

    Dieser Subflow erfordert eine Datenstromaktion, um Anwender abzurufen. Weitere Informationen finden Sie unter Erstellen Sie eine Datenstromaktion, um Anwender abzurufen.

    Erforderliche Rolle: flow_designer oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Hinweis:
    Beispiele für Subflows zum Abrufen von Anwendern finden Sie unter Jira Abonnements und herunterladen Webex Subflows für Abonnements herunterladen.

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designeran.
    2. Wählen Sie Aus Neu Und wählen Sie dann aus Subflow .
    3. Füllen Sie im Formular die Felder aus.
      Tabelle : 1. Formular „Subflow-Eigenschaften“
      Feld Wert
      Name Name Ihrer Wahl.

      Beispiel: Anwendung Abonnements herunterladen, wo Anwendung Ist der Name von SaaS Anwendung, in die Sie integrieren.
      Anwendung Software Asset Management – SaaS-Lizenzmanagement
      Zugänglich von Wählen Sie Alle Anwendungsbereiche aus.
      Kategorie Lassen Sie dieses Feld leer.
      Schutz Wählen Sie Keiner aus.
      In-Flow-Anmerkung Lassen Sie dieses Feld leer.
      Beschreibung Beschreibung Ihrer Auswahl.
      Ausführen als Anwender, der die Sitzung initiiert.
    4. Wählen Sie Absenden.
    5. Fügen Sie eine Integrationsprofileingabe hinzu.
      Tabelle : 2. Eingaben
      Bezeichnung Name Typ Erforderlich
      Integrationsprofil integration_profile Referenz.Integrationsprofil Ja
    6. Wählen Sie im Abschnitt Aktionen das Plus-Symbol und dann aus Aktion Zum Hinzufügen einer neuen Aktion.
    7. Wählen Sie die Spoke für aus SaaS Anwendung, in die Sie integrieren möchten, aus der Liste der installierten Spokes.
      Hinweis:
      Um Ihrer Liste der installierten Spokes zusätzliche Spokes hinzuzufügen, fordern Sie diese im an ServiceNow Store . Eine vollständige Liste der verfügbaren Spokes finden Sie unter IntegrationHub – Verfügbare Spokes . Wenn keine Spoke für vorhanden ist SaaS Anwendung, in die Sie integrieren möchten, können Sie Erstellen Sie eine neue Spoke .
    8. Wählen Sie eine Datenstromaktion aus, um Anwender abzurufen.
    9. Definieren Sie die Werte, die für alle Eingaben der Anwenderauthentifizierung für die Datenstromaktion übergeben werden sollen.

      Die Datenstromaktion gibt möglicherweise Anwender zurück, die Sie nicht in Ihre Liste der Anwenderabonnements aufnehmen möchten. Wenn Sie Filtern durchführen, um einige Anwender auszuschließen, fügen Sie eine IF-Flow-Logik als untergeordnetes Element der Datenstromaktion „Anwender abrufen“ hinzu.

      Die erforderliche Filtermenge hängt gegebenenfalls von der Anwendung ab, in die Sie integrieren. Beispiel: Wenn das Anwender-targetObject über einen verfügt activeEigenschaft können Sie eine Bedingung hinzufügen, um zu überprüfen, ob der Wert ist Wahr Um zu bestätigen, dass der Subflow keine deaktivierten Anwender herunterlädt. Ein Beispiel für die von verwendete Filterung Jira Subflow „Abonnements herunterladen“ lautet, dass der Account-Typ nicht sein darf App Um zu verhindern, dass der Subflow Accounts zurückgibt, die keine tatsächlichen Anwender sind.

      Fügen Sie der IF-Flow-Logik Bedingungen für erforderliche Filterung hinzu.
      • Wenn Sie eine IF-Flow-Logik zum Filtern von Anwendern verwenden, fügen Sie hinzu Upsert user subscription using subscription identifierAktion von Software Asset Management Spoke als untergeordnetes Element der Flow-Logik.
      • Wenn Sie Anwender nicht filtern, fügen Sie hinzu Upsert user subscription using subscription identifierAktion als untergeordnetes Element der Datenstromaktion „Anwender abrufen“. Mit dieser Aktion wird hinzugefügt SaaS Anwendungsanwenderabonnement für die Tabelle „Softwareabonnement“ [samp_SW_Subscription]. Wenn sich das Abonnement bereits in der Tabelle befindet, aktualisiert die Aktion den Abonnementdatensatz.
    10. Geben Sie die Eingaben ein, die für Ihre Integration gelten.

      Verwenden Sie Werte aus dem Datenbereich, um die Aktionseingaben auszufüllen. Ihre Frage an SaaS API gibt möglicherweise nicht Daten für alle Eingaben zurück.

      Tabelle : 3. Upsert-Aktion für Anwenderabonnement
      Feld Wert
      Externe Anwender-ID Anwender-ID oder Account-ID aus dem Anwender-targetObject.

      Dies ist im Allgemeinen ein numerischer, nicht visuell lesbarer Wert. Dieser Wert muss eindeutig sein.
      Anwenderprinzipalname E-Mail-Adresse aus dem Anwender targetObject.

      Wenn keine E-Mail-Adresse verfügbar ist, verwenden Sie einen anderen Wert, z. B. Anwendername und Anwender-ID Dieser Wert muss visuell lesbar sein.
      Integrationsprofil Integrationsprofileingabe, die Sie für den Subflow erstellt haben.
      Letzte Aktivität Datum der letzten Aktivität aus dem Anwender targetObject. Zum Beispiel die Zeit der letzten Anmeldung.
      Extern erstellt

      Account-Erstellungsdatum aus dem Anwender targetObject.

      Dieser Wert hilft, bessere Reklamationskandidaten zu erstellen. Ein neuer Anwender hat möglicherweise noch keine Aktivität. Wenn der Datensatz zeigt, dass der Anwenderaccount erstellt wurde, wird für diesen Anwender kein Reklamationskandidat erstellt, da es sich um einen neuen Account und nicht um einen nicht verwendeten Account handelt.
      Identifier Ein eindeutiger Bezeichner zur Identifizierung der Integration.

      Softwaremodelle werden für das Abonnement automatisch mit einem Bezeichner erstellt, der einem Bezeichner in der Tabelle „Abonnementproduktdefinitionen“ [samp_SW_Subscription_Product_Definition] entspricht.

      Wenn kein Bezeichner vorhanden ist, konfigurieren Sie einen Bezeichner. Weitere Informationen finden Sie unter Konfigurieren Sie einen Bezeichner.
      Zusätzliche Attribute Dies wird verwendet, um ein anderes Feld in der Tabelle „Softwareabonnements“ [samp_SW_Subscription] zu aktualisieren, das zuvor nicht erwähnt wurde.
    11. Um Ihren Subflow zu testen, wählen Sie aus Testen .
      1. Zeigen Sie die Testergebnisse und Systemprotokolle an, um Details zu Fehlern zu erhalten.
        Um Systemprotokolle anzuzeigen, navigieren Sie zu Systemprotokolle > Systemprotokoll > Allean.
      Hinweis:
      Die Datenstromaktion zum Abrufen von Anwendern muss mehrere Seiten von Anwendern erfolgreich abrufen. Schreiben Sie erst in die Tabelle „Softwareabonnements“ [samp_SW_Subscription], wenn Sie verifiziert haben, dass die Datenstromaktion alle Anwender abruft. Zur Verifizierung können Sie einen Subflow erstellen, der den Datenstrom verbraucht, und die Ergebnisse protokollieren.
    12. Nachdem Sie überprüft haben, ob der Subflow wie erwartet funktioniert, wählen Sie aus Veröffentlichen .
      Tipp:
      Sie können den Subflow nach der Veröffentlichung weiterhin bearbeiten.

    Konfigurieren Sie einen Bezeichner

    Konfigurieren Sie einen Bezeichner, wenn er nicht vorhanden ist, um eine Integration zu identifizieren.

    Vorbereitungen

    Erforderliche Rolle: sam_admin

    Prozedur

    1. Erstellen Sie ein anwenderdefiniertes Produkt, wenn Ihr Produkt nicht in der Tabelle „Softwareprodukt“ [samp_SW_Product] vorhanden ist.
      1. Wählen Sie Neu.
      2. Auf der Formular , Füllen Sie die Felder aus.
        Feld Beschreibung
        Herausgeber Herausgeber des anwenderdefinierten Produkts.
        Produkt Name des anwenderdefinierten Produkts.
        Produkttyp Produkttyp des anwenderdefinierten Softwareprodukts.
        Produktklassifizierung Offizielle UNSPSC-Klassifizierung.
        Abonnementsoftware Option, die angibt, dass Ihr Produkt ein abonnementbasiertes Produkt ist.
        Installationen ignorieren Option, die angibt, dass der Produkttyp lizenzierbar ist.

        Dieses Kontrollkästchen wird nur angezeigt, wenn Sie Produkttyp als lizenzierbar auswählen und Abonnementsoftware auf „wahr“ festgelegt ist.
        Aus Content-Service ausschließen Option, die angibt, dass das Produkt aus dem Inhaltsservice ausgeschlossen wird.

        Sie dürfen dieses Kontrollkästchen nicht aktivieren.
        Aktiv Option, die angibt, dass dieses Produkt verwendet wird oder nicht.
      3. Wählen Sie Absenden.
    2. Erstellen Sie eine anwenderdefinierte Discovery-Zuordnung, indem Sie eine anwenderdefinierte Berechtigungsdefinition aus der Tabelle „Discovery-Zuordnungen“ [samp_custom_SW_entitlement_Definition] erstellen.
      1. Wählen Sie Neu.
      2. Auf der Formular , Füllen Sie die Felder aus.
        Feld Beschreibung
        Produkt Name des aktuellen Softwareprodukts. Anwenderdefiniertes Produkt, das Sie in erstellt haben Schritt 1 .
        Versionsbedingung Bedingungsqualifizierer für das Feld Version:
        • beginnt mit
        • ist
        • ist irgendetwas

        Standard ist ist irgendetwas.
        Version Version des Softwareprodukts.

        Erforderlich, wenn der Versionsbedingungswert beginnt mit oder ist ist.
        Editionsbedingung Bedingungsqualifizierer für das Editionsfeld:
        • beginnt mit
        • ist
        • ist irgendetwas

        Standard ist ist irgendetwas.
        Edition Plattform des Softwareprodukts für die Suche nach dem normalisierten Discovery-Modell.
        Plattform Plattform des Softwareprodukts für die Suche nach dem normalisierten Discovery-Modell.
        Sprache Sprache des Softwareprodukts, das bei der Suche nach dem normalisierten Discovery-Modell verwendet werden soll. Es wird ausgefüllt, sobald es normalisiert oder manuell hinzugefügt wurde.
      3. Wählen Sie Absenden.
    3. Erstellen Sie eine anwenderdefinierte Abonnementproduktdefinition, indem Sie eine anwenderdefinierte Berechtigungsdefinition aus der Tabelle „Anwenderdefinierte Abonnementproduktdefinitionen“ [samp_SW_custom_Subscription_Product_Definition] erstellen.
      1. Wählen Sie Neu.
      2. Auf der Formular , Füllen Sie die Felder aus.
        Feld Beschreibung
        Identifier Abonnementbezeichner, der sich auf das anwenderdefinierte Produkt bezieht.
        Abonnementintegration Liste von SaaS Und SSO-Anbieter, die Abonnementprodukten in der Tabelle „Abonnementproduktdefinition“ [samp_SW_Subscription_Product_Definition] zugeordnet sind.

        Wählen Sie für dieses Szenario aus Anwenderdefinierte Integration .
        Berechtigungsdefinition Anwenderdefinierte Discovery-Zuordnung, die Sie in erstellt haben Schritt 2 .
        Aktiv Kontrollkästchen, das angibt, dass der Bezeichner verwendet wird oder nicht.
      3. Wählen Sie Absenden.