Créer un flux secondaire pour obtenir des utilisateurs

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 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 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 flux secondaires Télécharger les abonnements et Webex Télécharger les Jira abonnements.

    Procédure

    1. Accédez à la Tous > 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 avec laquelle vous effectuez l’intégration SaaS .
      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, les transactions peuvent vous être facturées ServiceNow® Hub d'intégration . Si vous publiez votre application de spoke personnalisée sur le ServiceNow Store, sélectionnez votre application personnalisée à la place.
      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 une liste complète des spokes disponibles, consultez Rayons disponibles dans Centre d’intégration. S’il n’existe aucun spoke pour l’application SaaS que vous souhaitez 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 les 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 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 avec laquelle vous effectuez l’intégration. 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 et vous assurer que le flux secondaire ne télécharge pas les utilisateurs désactivés. Un exemple de filtrage utilisé par le flux secondaire Télécharger les Jira 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 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 utilisateur de l’application SaaS à 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. Action Mettre à jour et insérer l’abonnement de l’utilisateur
      Champ Valeur
      ID utilisateur externe ID d’utilisateur ou ID de compte 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, par exemple 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. 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 ne sera 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 de la table Définitions de produit d’abonnement [samp_sw_subscription_product_definition].

      Si aucun identificateur n’existe, configurez-en un. Pour plus d'informations, consultez Configurer un identificateur.

      Attributs supplémentaires Permet de 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 > 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 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é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, 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 sous licence.

        Cette case à cocher ne s’affiche que si vous sélectionnez Type de produit sur Sous licence et que l’option Logiciel de l’abonnement est définie 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 que ce produit est utilisé ou non.
      3. Sélectionnez Envoyer.
    2. Créez une carte Discovery personnalisée en créant une définition d’autorisation personnalisée à partir de la table Carte Discovery [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 produits d’abonnement personnalisés [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 qui sont mappés aux produits d’abonnement dans la table Définition de 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.