Erstellen Sie einen Subflow, um Anwender abzurufen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 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. 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 Abonnement Software Asset Management enthalten. Wenn Sie den Subflow in einer anderen Anwendung speichern, werden Ihnen möglicherweise ServiceNow® IntegrationHub Transaktionen in Rechnung gestellt. Wenn Sie Ihre anwenderdefinierte Spoke-Anwendung unter ServiceNow Storeveröffentlichen, wählen Sie stattdessen Ihre anwenderdefinierte 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 Anwender, 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:
      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 SaaS-Anwendung, mit der Sie integrieren möchten, keine 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 (falls zutreffend) 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 „ wahr “ 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.
      Benutzerprinzipalname 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 darf noch keine Aktivität haben. Wenn aus dem Datensatz hervorgeht, 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.
      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 beliebiges 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 Anwendern sollte mehrere Seiten mit Anwendern erfolgreich abrufen. Schreiben Sie erst in die Tabelle „-Software-Abonnement“ [samp_sw_subscription], wenn Sie sicher sind, dass 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, klicken Sie auf Veröffentlichen.
      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 die Felder im Formular aus.
        Feld Beschreibung
        Herausgeber Herausgeber des anwenderdefinierten Produkts.
        Produkt Name des anwenderdefinierten 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.

        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 aus.
    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 die Felder im Formular 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 aus.
    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 die Felder im Formular aus.
        Feld Beschreibung
        Bezeichner Abonnementbezeichner, der mit dem anwenderdefinierten Produkt verknüpft ist.
        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 Anwenderdefinierte Integration aus.
        Berechtigungsdefinition Anwenderdefinierte Discovery-Zuordnung, die Sie in Schritt 2erstellt haben.
        Aktiv Kontrollkästchen, das angibt, ob der Bezeichner verwendet wird oder nicht.
      3. Wählen Sie Absenden aus.