Erstellen Sie einen Subflow, um Benutzer abzurufen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

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

    Vorbereitungen

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

    Erforderliche Rolle: flow_designer oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Hinweis:
    Beispiele für Subflows zum Abrufen von Benutzern finden Sie in den Subflows Jira Abonnements herunterladen und Webex Abonnements herunterladen.

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Neu, und wählen Sie dann Subflow aus.
    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-Lizenzverwaltung
      Hinweis:
      Wenn Sie den Subflow in der Anwendung Software Asset Management - SaaS-Lizenzmanagement speichern, ist er in Ihrem Software Asset Management -Abonnement enthalten. Wenn Sie den Subflow in einer anderen Anwendung speichern, werden Ihnen möglicherweise ServiceNow® IntegrationHub Transaktionen in Rechnung gestellt. Wenn Sie Ihre benutzerdefinierte Spoke-Anwendung auf ServiceNow Storeveröffentlichen, wählen Sie stattdessen Ihre benutzerdefinierte App aus.
      Zugänglich von Alle Anwendungsbereiche.
      Kategorie Lassen Sie dieses Feld leer.
      Schutz Keine.
      In-Flow-Anmerkung Lassen Sie dieses Feld leer.
      Beschreibung Beschreibung Ihrer Wahl.
      Ausführen als Benutzer, der die Sitzung initiiert.
    4. Klicken Sie auf Absenden.
    5. Fügen Sie eine Integrationsprofileingabe hinzu.
      Tabelle : 2. Eingaben
      Bezeichnung Name Typ Obligatorisch
      Integrationsprofil integration_profile Referenz.Integrationsprofil Ja
    6. Klicken Sie im Abschnitt „Aktionen“ auf das Plus-Symbol und dann auf 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:
      Um Ihrer Liste der installierten Spokes zusätzliche Spokes hinzuzufügen, fordern Sie sie im ServiceNow Storean. Eine vollständige Liste der verfügbaren Spokes finden Sie unter Verfügbare Spokes für IntegrationHub. Wenn für die SaaS-Anwendung, die Sie integrieren möchten, keine vorhandene -Spoke vorhanden ist, können Sie eine neue -Spoke erstellen.
    8. Wählen Sie eine Datenstromaktion aus, um Benutzer abzurufen.
    9. Definieren Sie die Werte, die für alle Benutzerauthentifizierungseingaben für die Datenstromaktion übergeben werden sollen.

      Die Datenstromaktion gibt möglicherweise Benutzer zurück, die Sie nicht in Ihre Liste der Benutzerabonnements aufnehmen möchten. Wenn Sie eine Filterung durchführen, um einige Benutzer auszuschließen, fügen Sie eine If-Flow-Logik als untergeordnetes Element der Stream-Aktion „Benutzerdaten abrufen“ hinzu.

      Der Umfang der erforderlichen Filterung hängt von der Anwendung ab, die Sie integrieren. Beispiel: Wenn der Benutzer targetObject die Eigenschaft active hat, können Sie eine Bedingung hinzufügen, um sicherzustellen, dass der Wert „ true “ ist, um sicherzustellen, dass der Subflow keine deaktivierten Benutzer herunterlädt. Ein Beispiel für die vom Subflow Jira Abonnements herunterladen verwendete Filterung ist, dass der Kontotyp nicht App sein kann, um zu verhindern, dass der Subflow Konten 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 Benutzer filtern, fügen Sie die Aktion Upsert user subscription using subscription identifier als untergeordnetes Element der Stream-Aktion zum Abrufen von Benutzerdaten hinzu.

      Mit dieser Aktion wird das Anwendungsbenutzerabonnement SaaS der Tabelle „Softwareabonnement“ [samp_sw_subscription] hinzugefügt. Wenn sich das Abonnement bereits in der Tabelle befindet, 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 Anforderung an die API SaaS gibt möglicherweise keine Daten für alle Eingaben zurück.

      Tabelle : 3. Aktion „Upsert-Benutzerabonnement“.
      Feld Wert
      Externe Anwender-ID Anwender-ID oder Account-ID aus dem Anwender targetObject. Dies ist im Allgemeinen ein numerischer, nicht für Menschen lesbarer Wert. Dieser Wert muss eindeutig sein.
      Benutzerprinzipalname E-Mail-Adresse aus dem Benutzer targetObject. Wenn eine E-Mail-Adresse nicht verfügbar ist, verwenden Sie einen anderen Wert, z. B. Benutzername und Benutzer-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 des Benutzers targetObject. Zum Beispiel die Zeit der letzten Anmeldung.
      Extern erstellt

      Account-Erstellungsdatum aus dem Benutzer targetObject.

      Dieser Wert hilft bei der Erstellung besserer Reklamationskandidaten. Ein neuer Benutzer hat möglicherweise noch keine Aktivität. Wenn aus dem Datensatz hervorgeht, dass der Benutzeraccount erstellt wurde, wird für diesen Benutzer kein Reklamationskandidat erstellt, da es sich um einen neuen Account und nicht um einen nicht verwendeten Account handelt.
      Bezeichner Ein eindeutiger Bezeichner zum Identifizieren der Integration. Softwaremodelle werden automatisch für Abonnements 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 „samp_sw_subscription“ zu aktualisieren, das oben nicht erwähnt wurde.
    11. Um Ihren Subflow 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.
      Hinweis:
      Die Datenstromaktion zum Abrufen von Benutzern sollte mehrere Seiten mit Benutzern erfolgreich abrufen. Schreiben Sie erst in die Softwareabonnementtabelle [samp_sw_subscription], wenn Sie sich vergewissert haben, dass die Datenstromaktion alle Benutzer abruft. Zur Überprüfung können Sie einen Subflow erstellen, der den Datenstrom verarbeitet, und die Ergebnisse protokollieren.
    12. Nachdem Sie sich vergewissert haben, dass der Subflow wie erwartet funktioniert, klicken Sie auf Veröffentlichen.
      Tipp:
      Sie können den Subflow auch nach der Veröffentlichung noch bearbeiten.

    Konfigurieren Sie einen Bezeichner

    Konfigurieren Sie einen Bezeichner, falls dieser nicht vorhanden ist, um eine Integration zu identifizieren.

    Vorbereitungen

    Erforderliche Rolle: sam_admin

    Prozedur

    1. Erstellen Sie ein benutzerdefiniertes Produkt, wenn Ihr Produkt in der Tabelle „Softwareprodukt“ [samp_sw_product] nicht vorhanden ist.
      1. Wählen Sie Neu.
      2. Füllen Sie die Felder im Formular aus.
        Feld Beschreibung
        Herausgeber Herausgeber des benutzerdefinierten Produkts.
        Produkt Name des benutzerdefinierten Produkts.
        Produkttyp Produkttyp des benutzerdefinierten 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.

        Diese Checkbox wird nur angezeigt, wenn Sie als Produkttyp die Option Lizenzierbar auswählen und Abonnementsoftware auf true festgelegt ist.
        Aus Content-Service ausschließen Option, die angibt, dass das Produkt vom Content Service 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 aus.
    2. Erstellen Sie eine benutzerdefinierte Discovery-Zuordnung, indem Sie eine benutzerdefinierte Berechtigungsdefinition aus der Tabelle „Discovery-Zuordnungen“ [samp_custom_sw_entitlement_definition] erstellen.
      1. Wählen Sie Neu.
      2. Füllen Sie die Felder im Formular aus.
        Feld Beschreibung
        Produkt Aktueller Name des Softwareprodukts. Benutzerdefiniertes 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 aus.
    3. Erstellen Sie eine benutzerdefinierte Abonnementproduktdefinition, indem Sie eine benutzerdefinierte Berechtigungsdefinition aus der Tabelle „Benutzerdefinierte Abonnementproduktdefinitionen“ [samp_sw_custom_subscription_product_definition] erstellen.
      1. Wählen Sie Neu.
      2. Füllen Sie die Felder im Formular aus.
        Feld Beschreibung
        Bezeichner Abonnementbezeichner, der sich auf das benutzerdefinierte Produkt bezieht.
        Abonnementintegration Liste der SaaS- und SSO-Anbieter, die Abonnementprodukten in der Tabelle „Abonnementproduktdefinition“ [samp_sw_subscription_product_definition] zugeordnet sind.

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