Erstellen Sie einen Subflow, um Anwender abzurufen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer

    • Erstellen Sie einen Subflow, um der Tabelle „Software-Abonnement“ 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 den Subflows Jira Abonnements herunterladen und Webex Abonnements herunterladen.

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Wählen Sie Neu und dann Subflowaus.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular „Subflow-Eigenschaften“.
      Feld Wert
      Name Name Ihrer Wahl.

      Beispiel: Anwendungsdownload -Abonnements, wobei Anwendung der Name der Anwendung SaaS ist, 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 Wahl.
      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 Aktion, um eine neue Aktion hinzuzufügen.
    7. Wählen Sie aus der Liste der installierten Spokes die Spoke für die Anwendung SaaS aus, die Sie integrieren möchten.
      Hinweis:
      Wenn Sie Ihrer Liste der installierten Spokes weitere Spokes hinzufügen möchten, fordern Sie diese im ServiceNow Storean. Eine vollständige Liste der verfügbaren Spokes finden Sie unter Verfügbare IntegrationHub-Spokes. Wenn für die Anwendung SaaS, mit der Sie integrieren möchten, keine vorhandene Spoke vorhanden ist, können Sie eine neue Spoke erstellen.
    8. Wählen Sie eine Datenstromaktion aus, um Anwender abzurufen.
    9. Definieren Sie die Werte, die für alle Anwenderauthentifizierungseingaben 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, um einige Benutzer auszuschließen, fügen Sie eine If-Flow-Logik als untergeordnetes Element der Datenstromaktion zum Abrufen von Benutzern hinzu.

      Der Umfang der erforderlichen Filterung hängt von der Anwendung ab, die Sie integrieren möchten. Wenn beispielsweise das Anwenderzielobjekt eine Eigenschaft active besitzt, können Sie eine Bedingung hinzufügen, um zu überprüfen, ob der Wert auf „true“ festgelegt ist, um sicherzustellen, dass der Subflow keine deaktivierten Anwender herunterlädt. Ein Beispiel für die vom Subflow Jira „ Abonnements herunterladen verwendete Filterung ist, dass der Accounttyp nicht „app“ sein kann, um zu verhindern, dass der Subflow Accounts zurückgibt, die keine tatsächlichen Benutzer sind.

      Fügen Sie der If-Flow-Logik Bedingungen für die erforderliche Filterung hinzu.
      • Wenn Sie eine If-Flow-Logik zum Filtern von Benutzern verwenden, fügen Sie die Aktion Upsert user subscription using subscription identifier aus der Spoke Software Asset Management als untergeordnetes Element der Flow-Logik hinzu.
      • Wenn Sie keine Anwender filtern, fügen Sie die Aktion Upsert user subscription using subscription identifier als untergeordnetes Element der Datenstromaktion zum Abrufen von Anwenderdaten hinzu. Diese Aktion fügt das Abonnement des Anwendungsbenutzers SaaS der Tabelle „Software-Abonnement“ [samp_sw_subscription] hinzu. Wenn das Abonnement bereits in der Tabelle enthalten ist, aktualisiert die Aktion den Abonnementdatensatz.
    10. Füllen Sie die Eingaben aus, die für Ihre Integration gelten.

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

      Tabelle : 3. Upsert-Aktion „Anwenderabonnement“
      Feld Wert
      Externe Anwender-ID Anwender-ID oder Account-ID aus dem Zielobjekt des Anwenders.

      Dies ist im Allgemeinen ein numerischer, nicht lesbarer Wert. Dieser Wert muss eindeutig sein.
      Anwenderprinzipalname E-Mail-Adresse des Anwenders targetObject.

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

      Account-Erstellungsdatum aus dem Anwenderzielobjekt

      Dieser Wert hilft beim Erstellen besserer Reklamationskandidaten. Ein neuer Anwender hat möglicherweise noch keine Aktivität. Wenn aus dem Datensatz hervorgeht, dass der Account des Anwenders 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.
      Bezeichner Ein eindeutiger Bezeichner zur Identifizierung der Integration.

      Softwaremodelle werden automatisch für Abonnements mit einem Bezeichner erstellt, der einem Bezeichner in der Tabelle „Produktdefinitionen für Abonnement“ [samp_sw_subscription_product_definition] entspricht.

      Wenn kein Bezeichner vorhanden ist, konfigurieren Sie einen Bezeichner. Weitere Informationen finden Sie unter Konfigurieren Sie einen Identifier.
      Zusätzliche Attribute Dies wird verwendet, um ein anderes Feld in der Tabelle „Software-Abonnements“ [samp_sw_subscription] zu aktualisieren, das zuvor nicht erwähnt wurde.
    11. Um Ihren Subflow zu testen, wählen Sie Testenaus.
      1. Zeigen Sie die Testergebnisse und Systemprotokolle an, um Details zu Fehlern zu erhalten.
        Um Systemprotokolle anzuzeigen, navigieren Sie zu Systemprotokolle > Systemprotokoll > Alle.
      Hinweis:
      Die Datenstromaktion zum Abrufen von Anwendern sollte mehrere Seiten mit Anwendern erfolgreich abrufen. Schreiben Sie nicht in die Tabelle „Software-Abonnements“ [samp_sw_subscription], bis Sie überprüft haben, ob die Datenstromaktion alle Benutzer abruft. Zur Überprüfung können Sie einen Subflow erstellen, der den Datenstrom verbraucht, und die Ergebnisse protokollieren.
    12. Nachdem Sie sich vergewissert haben, dass der Subflow wie erwartet funktioniert, wählen Sie Veröffentlichenaus.
      Tipp:
      Sie können den Subflow auch nach der Veröffentlichung noch bearbeiten.

    Konfigurieren Sie einen Identifier

    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. Füllen Sie im Formular 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 für Produkttyp die Option Lizenzierbar auswählen und für Abonnementsoftware der Wert „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, ob 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. Füllen Sie im Formular die Felder aus.
        Feld Beschreibung
        Produkt Name des aktuellen Softwareprodukts. Anwenderdefiniertes Produkt, das Sie in Schritt 1erstellt haben.
        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 Feld Edition:
        • 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. Füllen Sie im Formular die Felder aus.
        Feld Beschreibung
        Bezeichner Abonnementbezeichner, der mit dem anwenderdefinierten Produkt verknüpft ist.
        Abonnementintegration Liste von SaaS und SSO-Anbietern, die Abonnementprodukten in der Tabelle „Abonnementproduktdefinition“ [samp_sw_subscription_product_definition] zugeordnet sind.

        Wählen Sie für dieses Szenario Anwenderdefinierte Integrationaus.
        Berechtigungsdefinition Anwenderdefinierte Discovery-Zuordnung, die Sie in Schritt 2erstellt haben.
        Aktiv Checkbox, die angibt, ob der Bezeichner verwendet wird oder nicht.
      3. Wählen Sie Absenden.