Créer un flux secondaire pour récupérer un utilisateur

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture

    • Créez un flux secondaire pour récupérer l’abonnement d’un utilisateur.

    Avant de commencer

    Ce flux secondaire nécessite une action pour supprimer un utilisateur. Pour plus d'informations, consultez Créer une action pour supprimer un utilisateur.

    Rôle requis : flow_designer ou admin

    Pourquoi et quand exécuter cette tâche

    Remarque :
    Pour obtenir des exemples de flux secondaires permettant de récupérer un utilisateur, consultez les flux secondaires Récupérer l’abonnement et Webex Récupérer l’abonnementJira.

    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, Abonnement de récupération d’application, où Application est le nom de l’application SaaS avec laquelle vous effectuez l’intégration.
      Application Gestion des actifs logiciels : intégrations de gestion des licences SaaS.
      Remarque :
      Si vous enregistrez le flux secondaire dans l’application Gestion des actifs logiciels SaaS License Management Integrations, 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. Ajoutez une entrée de profil d’intégration et une entrée d’abonnement d’utilisateur.
      Tableau 2. Entrées
      Étiquette Nom Type Obligatoire
      Profil d'intégration integration_profile Référence.Profil d’intégration Oui
      Abonnement de l'utilisateur user_subscription Référence.Abonnement logiciel Oui
    5. Ajoutez une sortie de message d’erreur et une sortie d’état.
      Tableau 3. Sorties
      Étiquette Nom Type
      Message d'erreur error_message Chaîne
      Statut statut Chaîne
    6. Dans la section Actions, cliquez sur l’icône Plus, puis sur Action pour ajouter une nouvelle action.
    7. Dans la liste des spokes installés, sélectionnez le spoke de l’application SaaS avec laquelle vous effectuez l’intégration.
      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. Pour supprimer un utilisateur, sélectionnez une action.
      1. Définissez la valeur à transmettre comme entrée d’ID d’utilisateur .
        La valeur que vous utilisez dépend de l’API avec laquelle vous travaillez, mais il s’agit généralement du champ ID d’utilisateur externe ou Nom principal de l’utilisateur de l’entrée Abonnement de l’utilisateur pour ce flux secondaire.
      2. Définissez les valeurs à transmettre pour toutes les entrées d’authentification utilisateur de l’action.
    9. Pour vérifier si l’action Supprimer l’utilisateur renvoie une erreur, ajoutez une logique de flux Si.
    10. Ajoutez une logique de flux enfant pour affecter des sorties de flux secondaire.
      Tableau 4. Affecter des sorties de flux secondaire
      Nom Données
      Message d'erreur Sortie du message d’erreur de l’action Supprimer un utilisateur
      Statut échec
    11. Ajoutez une logique de flux Sinon au même niveau que la logique Si pour les tickets lorsque l’action Supprimer l’utilisateur ne renvoie pas d’erreur.
    12. Ajoutez une logique de flux enfant pour affecter des sorties de flux secondaire.
      Tableau 5. Affecter des sorties de flux secondaire
      Nom Données
      Statut réussite

      L’image suivante montre un exemple terminé de flux secondaire permettant de récupérer un abonnement utilisateur. L’exemple affiché est le flux secondaire Récupérer l’abonnement Webex .

      Exemple de flux secondaire pour récupérer un abonnement utilisateur
    13. 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 :
      Lors du test, n’oubliez pas que ce flux secondaire désactive un utilisateur. Tester ce flux secondaire dans un environnement de sous-production. Si seul un environnement de production est disponible, vous pouvez créer de faux utilisateurs pour les tester.
    14. 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.