Créer un flux secondaire pour obtenir des utilisateurs

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • Créez un flux secondaire pour ajouter une liste d’utilisateurs à la table Abonnement logiciel.

    Avant de commencer

    Ce flux secondaire nécessite une action de flux de données pour obtenir les utilisateurs. Pour plus d'informations, consultez Créer une action de flux de données pour obtenir des utilisateurs.

    Rôle requis : flow_designer ou admin

    Pourquoi et quand exécuter cette tâche

    Remarque :
    Pour obtenir des exemples de flux secondaires permettant d’obtenir des utilisateurs, consultez les Jira flux secondaires Télécharger les abonnements et Webex Télécharger les abonnements.

    Procédure

    1. Accédez à la Tout > Concepteur de flux > Concepteur.
    2. Sélectionnez Nouveau , puis sélectionnez Flux secondaire.
    3. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Propriétés du flux secondaire
      Champ Valeur
      Nom Nom de votre choix.

      Par exemple, Abonnements de téléchargement d’application , où Application est le nom de l’application SaaS avec laquelle vous intégrez.
      Demande Gestion des actifs logiciels - Gestion des licences SaaS
      Accessible depuis Sélectionnez Tous les périmètres de l'application.
      Catégorie Laissez ce champ vide.
      Protection Sélectionnez Aucun.
      Annotation dans le flux Laissez ce champ vide.
      Description Description de votre choix.
      Exécuter en tant que Utilisateur qui lance la session.
    4. Sélectionnez Soumettre.
    5. Ajouter une entrée de profil d’intégration.
      Tableau 2. Entrées
      Étiquette Nom Type Obligatoire
      Profil d'intégration integration_profile Référence.Profil d’intégration Oui
    6. Dans la section Actions, sélectionnez l’icône plus, puis Action pour ajouter une nouvelle action.
    7. Sélectionnez le spoke pour l’application SaaS que vous souhaitez intégrer dans la liste des spokes installés.
      Remarque :
      Pour ajouter des spokes supplémentaires à votre liste de spokes installés, demandez-les sur le ServiceNow Store. Pour obtenir la liste complète des spokes disponibles, consultez Spokes disponibles du Centre d’intégration. S’il n’existe aucun spoke pour l’application SaaS avec laquelle vous souhaitez vous intégrer, vous pouvez créer un nouveau spoke.
    8. Sélectionnez une action de flux de données pour obtenir des utilisateurs.
    9. Définissez les valeurs à transmettre pour toutes les entrées d’authentification utilisateur pour l’action de flux de données.

      L’action de flux de données peut renvoyer des utilisateurs que vous ne souhaitez pas inclure dans votre liste d’abonnements d’utilisateur. Si vous effectuez un filtrage pour exclure certains utilisateurs, ajoutez une logique de flux If comme enfant de l’action Obtenir le flux de données des utilisateurs.

      La quantité de filtrage requise, le cas échéant, dépend de l’application à laquelle vous intégrez. Par exemple, si l’objet cible de l’utilisateur possède une active propriété, vous pouvez ajouter une condition pour vérifier que la valeur est vraie afin de confirmer que le flux secondaire ne télécharge pas les utilisateurs désactivés. Un exemple de filtrage utilisé par le Jira flux secondaire Télécharger les abonnements est que le type de compte ne peut pas être une application pour empêcher le flux secondaire de renvoyer des comptes qui ne sont pas des utilisateurs réels.

      Ajoutez des conditions à la logique de flux If pour tout filtrage requis.
      • Si vous utilisez une logique de flux If pour filtrer les utilisateurs, ajoutez l’action Upsert user subscription using subscription identifier à partir du Gestion des actifs logiciels spoke en tant qu’enfant de la logique de flux.
      • Si vous ne filtrez pas les utilisateurs, ajoutez l’action Upsert user subscription using subscription identifier en tant qu’enfant de l’action Obtenir le flux de données des utilisateurs. Cette action ajoute l’abonnement de l’utilisateur SaaS à l’application à la table Abonnement logiciel [samp_sw_subscription]. Si l’abonnement figure déjà dans la table, l’action met à jour l’enregistrement de l’abonnement.
    10. Renseignez les entrées applicables à votre intégration.

      Utilisez les valeurs du panneau de données pour renseigner les entrées d’action. Votre demande à l’API SaaS peut ne pas renvoyer de données pour toutes les entrées.

      Tableau 3. Mettre à jour et insérer l’action d’abonnement de l’utilisateur
      Champ Valeur
      ID d'utilisateur externe ID d’utilisateur ou ID de compte à partir de l’objet cible de l’utilisateur.

      Il s’agit généralement d’une valeur numérique non lisible par l’homme. Cette valeur doit être unique.
      Nom principal de l'utilisateur Adresse e-mail de l’utilisateur targetObject.

      Si une adresse e-mail n’est pas disponible, utilisez une autre valeur telle que le nom d’utilisateur et l’ID d’utilisateur. Cette valeur doit être lisible par l’homme.
      Profil d'intégration Entrée de profil d’intégration que vous avez créée pour le flux secondaire.
      Dernière activité Date de l’activité la plus récente de l’utilisateur targetObject. Par exemple, l’heure de la dernière connexion.
      Création externe

      Date de création du compte à partir de l’utilisateur targetObject.

      Cette valeur permet de créer de meilleurs candidats à la réclamation. Un nouvel utilisateur n’a peut-être pas encore d’activité. Si l’enregistrement montre que le compte d’utilisateur a été créé, aucun candidat à la réclamation n’est créé pour cet utilisateur, car il s’agit d’un nouveau compte plutôt que d’un compte inutilisé.
      Identificateur Identificateur unique pour identifier l’intégration.

      Les modèles logiciels sont automatiquement créés pour l’abonnement avec un identificateur qui correspond à un identificateur de la table Définitions de produits d’abonnement [samp_sw_subscription_product_definition].

      Si aucun identificateur n’existe, configurez-le. Pour plus d'informations, consultez Configurer un identificateur.
      Attributs supplémentaires Cela est utilisé pour mettre à jour tout autre champ de la table Abonnements logiciels [samp_sw_subscription] qui n’est pas mentionné précédemment.
    11. Pour tester votre flux secondaire, sélectionnez Test.
      1. Consultez les résultats des tests et les journaux système pour plus de détails sur les éventuelles erreurs.
        Pour afficher les journaux système, accédez à Journaux système > Journal système > Tout.
      Remarque :
      L’action de flux de données pour obtenir des utilisateurs doit récupérer plusieurs pages d’utilisateurs avec succès. N’écrivez pas dans la table Abonnements logiciels [samp_sw_subscription] tant que vous n’avez pas vérifié que l’action de flux de données récupère tous les utilisateurs. Pour vérification, vous pouvez créer un flux secondaire qui consomme le flux de données et consigner les résultats.
    12. Après avoir vérifié que le flux secondaire fonctionne comme prévu, sélectionnez Publier.
      Conseil :
      Vous pouvez toujours modifier le flux secondaire après sa publication.

    Configurer un identificateur

    Configurez un identificateur s’il n’existe pas pour identifier une intégration.

    Avant de commencer

    Rôle requis : sam_admin

    Procédure

    1. Créez un produit personnalisé lorsque votre produit n’existe pas dans la table Produit logiciel [samp_sw_product].
      1. Sélectionnez Nouveau.
      2. Renseignez les champs du formulaire.
        Champ Description
        Éditeur Éditeur du produit personnalisé.
        Produit Nom du produit personnalisé.
        Type de produit Type de produit du produit logiciel personnalisé.
        Classification du produit Classification UNSPSC officielle.
        Logiciel d'abonnement Option indiquant que votre produit est un produit basé sur un abonnement.
        Ignorer les installations Option indiquant que le type de produit est sous licence.

        Cette case à cocher n’est affichée que si vous sélectionnez Type de produit, car Logiciel sous licence et Logiciel d’abonnement est défini sur vrai.
        Exclure du service de contenu Option qui indique que le produit sera exclu du service de contenu.

        Vous ne devez pas cocher cette case.
        Actif Option indiquant si ce produit est utilisé ou non.
      3. Sélectionnez Soumettre.
    2. Créez une carte de découverte personnalisée en créant une définition d’autorisation personnalisée à partir de la table Cartes de découverte [samp_custom_sw_entitlement_definition].
      1. Sélectionnez Nouveau.
      2. Renseignez les champs du formulaire.
        Champ Description
        Produit Nom actuel du produit logiciel. Produit personnalisé que vous avez créé à l’étape 1.
        Condition de la version Qualificateur de condition pour le champ Version :
        • commence par
        • est
        • est quelconque

        Par défaut, le champ est défini sur est quelconque.
        Version Version du produit logiciel.

        Requise si la valeur de la condition de la version est commence par ou est.
        Condition de modification Qualificateur de condition pour le champ Edition :
        • commence par
        • est
        • est quelconque

        Par défaut, le champ est défini sur est quelconque.
        Édition Plateforme du produit logiciel à utiliser lors de la recherche du modèle de détection normalisé.
        Plateforme Plateforme du produit logiciel à utiliser lors de la recherche du modèle de détection normalisé.
        Langue Langue du produit logiciel à utiliser lors de la recherche du modèle de détection normalisé, qui est renseigné une fois qu'il a été normalisé ou ajouté manuellement.
      3. Sélectionnez Soumettre.
    3. Créez une définition de produit d’abonnement personnalisée en créant une définition d’autorisation personnalisée à partir de la table Définitions de produits d’abonnement personnalisées [samp_sw_custom_subscription_product_definition].
      1. Sélectionnez Nouveau.
      2. Renseignez les champs du formulaire.
        Champ Description
        Identificateur Identificateur d’abonnement associé au produit personnalisé.
        Intégration de l'abonnement Liste des fournisseurs SSO mappés aux produits d’abonnement dans la table Définition du SaaS produit d’abonnement [samp_sw_subscription_product_definition].

        Pour ce scénario, sélectionnez Intégration personnalisée.
        Définition du droit Carte de découverte personnalisée que vous avez créée à l’étape 2.
        Actif Case à cocher indiquant si l’identificateur est utilisé ou non.
      3. Sélectionnez Soumettre.