Créer un flux secondaire pour obtenir des utilisateurs

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture
  • Créez un flux secondaire pour ajouter une liste d’utilisateurs à la table Abonnement au logiciel.

    Avant de commencer

    Ce flux secondaire nécessite une action de flux de données pour obtenir des 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 Abonnements de téléchargement et Webex Abonnements de téléchargement.

    Procédure

    1. Accédez à la Tout > Concepteur de flux > Concepteur.
    2. Cliquez sur Nouveau , puis sélectionnez Flux secondaire.
    3. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Propriétés de flux secondaire
      Champ Valeur
      Nom Nom de votre choix. Par exemple, Abonnements au téléchargement d’applications , où Application est le nom de l’application SaaS à laquelle vous intégrez.
      Application Gestion des actifs logiciels : gestion des licences SaaS
      Remarque :
      Si vous enregistrez le flux secondaire dans l’application Gestion des actifs logiciels - Gestion des licences SaaS , il est inclus dans votre Gestion des actifs logiciels abonnement. Si vous enregistrez le flux secondaire dans une autre application, des frais de transaction peuvent vous être facturés ServiceNow® Hub d'intégration . Si vous publiez votre application de spoke personnalisée sur , ServiceNow Storesélectionnez plutôt votre application personnalisée.
      Accessible depuis Tous les périmètres de l’application.
      Catégorie Laissez ce champ vide.
      Protection Aucune.
      Annotation dans le flux Laissez ce champ vide.
      Description Description de votre choix.
      Exécuter en tant que Utilisateur qui lance la session.
    4. Cliquez sur Envoyer.
    5. Ajoutez 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, cliquez sur l’icône plus, puis sur Action pour ajouter une nouvelle action.
    7. Sélectionnez le spoke de 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 dans IntegrationHub. S’il n’y a pas de spoke existant pour l’application SaaS à 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 utilisateur. Si vous effectuez un filtrage pour exclure certains utilisateurs, ajoutez une logique de flux If en tant qu’enfant de l’action de flux de données Obtenir les utilisateurs.

      La quantité de filtrage requise, le cas échéant, dépend de l’application à laquelle vous intégrez. Par exemple, si l’utilisateur targetObject possède une active propriété, vous pouvez ajouter une condition pour vérifier que la valeur est vraie afin de vous assurer que le flux secondaire ne télécharge pas d’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 afin d’empêcher le flux secondaire de renvoyer des comptes qui ne sont pas des utilisateurs réels.

      Ajoutez des conditions à la logique de flux Si 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 de flux de données Obtenir les utilisateurs.

      Cette action ajoute l’abonnement utilisateur de l’application SaaS à la table Abonnement logiciel [samp_sw_subscription]. Si l’abonnement se trouve 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. Il se peut que votre demande à l’API SaaS ne renvoie pas les données de toutes les entrées.

      Tableau 3. Action d’abonnement d’utilisateur de mise à jour et d’insertion
      Champ Valeur
      ID utilisateur externe ID d’utilisateur ou ID de compte de l’utilisateur targetObject. 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 nom d’utilisateur et 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éé en externe

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

      Cette valeur permet de créer de meilleurs candidats à la réclamation. Il se peut qu’un nouvel utilisateur n’ait pas encore d’activité. Si l’enregistrement montre que le compte d’utilisateur a été créé, un candidat à la réclamation ne sera pas créé pour cet utilisateur, car il s’agit d’un nouveau compte et non d’un compte inutilisé.

      Identificateur Un 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 dans la table Définitions de produit d’abonnement [samp_sw_subscription_product_definition].

      S’il n’existe aucun identificateur, 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 samp_sw_subscription qui n’est pas mentionné ci-dessus.
    11. Pour tester votre flux secondaire, cliquez sur Tester.
      1. Affichez les résultats des tests et les journaux système pour plus de détails sur les 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 à la table Abonnement logiciel [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érifier, 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, cliquez sur 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 assujetti à une licence.

        Cette case à cocher ne s’affiche que si vous sélectionnez le type de produit sur Sous licence et que le 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 Envoyer.
    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 Édition :
        • 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 Envoyer.
    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 produit 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 SaaS et SSO mappés aux produits d’abonnement dans la table Définition du produit d’abonnement [samp_sw_subscription_product_definition].

        Pour ce scénario, sélectionnez Intégration personnalisée.

        Définition de l'autorisation Carte de détection personnalisée que vous avez créée à l’étape 2.
        Actif Case à cocher indiquant que l’identificateur est utilisé ou non.
      3. Sélectionnez Envoyer.