Créer un flux secondaire pour obtenir des utilisateurs
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
Pourquoi et quand exécuter cette tâche
Procédure
- Accédez à la Tous > Concepteur de flux > Concepteur.
- Sélectionnez Nouveau , puis Flux secondaire.
-
Remplissez 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 à laquelle vous intégrez.
Application 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. - Sélectionnez Envoyer.
-
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 - Dans la section Actions, sélectionnez l’icône plus, puis sélectionnez Action pour ajouter une nouvelle action.
-
Sélectionnez le spoke de l’application SaaS que vous souhaitez intégrer dans la liste des spokes installés.
Remarque :Pour ajouter d’autres spokes à 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 à intégrer, vous pouvez créer un nouveau spoke.
- Sélectionnez une action de flux de données pour obtenir des utilisateurs.
-
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 Si en tant qu’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 targetObject de l’utilisateur a 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 afin d’éviter que le flux secondaire ne renvoie 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 Si 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 SaaS utilisateur à 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.
-
Renseignez les entrées qui s’appliquent à 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 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 aucune adresse e-mail n’est disponible, utilisez une autre valeur, par exemple nom d’utilisateur ou 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 la dernière activité de l’utilisateur targetObject. Par exemple, l’heure de la dernière connexion. Création externe Date de création du compte à partir du targetObject de l’utilisateur.
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 indique 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 Un identificateur unique pour identifier l’intégration. Des modèles logiciels sont automatiquement créés pour l’abonnement avec un identificateur qui correspond à un identificateur dans 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. -
Pour tester votre flux secondaire, sélectionnez Test.
-
Consultez 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 > Tous.
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. -
Consultez les résultats des tests et les journaux système pour plus de détails sur les erreurs.
-
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
Procédure
-
Créez un produit personnalisé lorsque votre produit n’existe pas dans la table Produit logiciel [samp_sw_product].
- Sélectionnez Nouveau.
-
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 sur abonnement Option indiquant que votre produit est un produit basé sur un abonnement. Ignorer les installations Option indiquant que le type de produit est disponible sous licence. Cette case à cocher s’affiche uniquement si vous sélectionnez Type de produit comme étant sous licence et que le logiciel sur 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.
Actives Option indiquant si ce produit est utilisé ou non. - Sélectionnez Envoyer.
-
Créez une carte de détection 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].
- Sélectionnez Nouveau.
-
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. - Sélectionnez Envoyer.
-
Créez une définition de produit d’abonnement personnalisée en créant une définition de droit personnalisée à partir de la table Définitions de produits d’abonnement personnalisées [samp_sw_custom_subscription_product_definition].
- Sélectionnez Nouveau.
-
Renseignez les champs du formulaire.
Champ Description Identificateur Identificateur d’abonnement associé au produit personnalisé. Intégration de l'abonnement Liste des fournisseurs SSO et SSO mappés aux produits d’abonnement dans la table Définition de 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. Actives Case à cocher indiquant si l’identificateur est utilisé ou non. - Sélectionnez Envoyer.