Créer une action de flux de données pour obtenir l’activité de l’utilisateur

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 9 minutes de lecture

    • Créez une action de flux de données pour obtenir l’activité de l’utilisateur à partir d’une application SaaS.

    Avant de commencer

    Si vous utilisez un spoke existant ServiceNow® Centre d'intégration , vérifiez s’il dispose d’une action de flux de données pour obtenir l’activité de l’utilisateur que vous pouvez utiliser au lieu d’en créer une.

    Pour plus d’informations sur les actions de flux de données, consultez Actions de flux de données.

    Rôle requis : flow_designer

    Pourquoi et quand exécuter cette tâche

    Surveillez l’activité des utilisateurs pour trouver les abonnements logiciels que votre société paie mais qui ne sont pas utilisés. Vous pouvez récupérer ces abonnements inutilisés pour réduire les dépenses logicielles de votre entreprise.

    Avant de créer l’action de flux de données, décidez comment vous souhaitez définir une activité utilisateur significative. Une activité significative peut être une combinaison d’actions de l’utilisateur. Créez une action de flux de données distincte pour chaque mesure d’activité de l’utilisateur. Par exemple, l’intégration Réunions du système Webex de base définit une activité significative comme l’hébergement d’une réunion. Il utilise une action de flux de données pour obtenir les dates des dernières réunions organisées pour tous les utilisateurs. Si vous souhaitez également que l’intégration Meetings inclue la Webex connexion en tant qu’activité significative, vous devez créer une deuxième action de flux de données pour obtenir les heures de connexion les plus récentes de tous les utilisateurs.

    Votre action de flux de données pour obtenir des utilisateurs peut renvoyer une mesure d’activité utilisateur telle que l’heure de la dernière connexion. Dans ce cas, vous n’avez pas besoin de créer une action de flux de données pour obtenir l’activité de l’utilisateur ou un flux secondaire pour obtenir l’activité de l’utilisateur, sauf si vous souhaitez définir des mesures d’activité utilisateur supplémentaires. Assurez-vous que votre flux secondaire d’obtention d’utilisateurs définit cette mesure d’activité utilisateur comme dernière entrée d’activité dans l’action Mettre à jour et insérer l’abonnement de l’utilisateur .

    Procédure

    1. Accédez à la Tous > Concepteur de flux > Concepteur.
    2. Cliquez sur Nouveau , puis sélectionnez Flux de données.
    3. Remplissez les champs du formulaire.
      Tableau 1. Formulaire Propriétés de l’action
      Champ Valeur
      Nom Nom de votre choix. Par exemple, Obtenir l’activité de l’utilisateur.
      Accessible depuis Sélectionnez Tous les périmètres de l’application.
      Catégorie Laissez ce champ vide.
      Protection Sélectionnez Aucun.
      Application Application de spoke à intégrer à l’application SaaS . Cette application de spoke peut être un spoke existant Centre d'intégration ou un nouveau spoke que vous avez créé.
      Annotation dans le flux Laissez ce champ vide.
      Description Description de votre choix.
    4. Cliquez sur Envoyer.
    5. Dans la section Entrées du Plan d’action, cliquez sur Créer une entrée.
    6. Ajoutez une entrée de temps de rétrospective.
      Tableau 2. Entrées
      Étiquette Nom Type Obligatoire
      Heure de la rétrospective look_back_time Date/Heure Oui
    7. Si l’API que vous utilisez nécessite une authentification utilisateur pour les demandes, ajoutez des entrées pour l’authentification.
      L’ID d’utilisateur administrateur et le nom du site sont des exemples d’entrées d’authentification utilisateur courantes. Consultez la documentation relative à l’API que vous avez choisie pour en savoir plus sur les exigences relatives à l’authentification utilisateur dans votre cas spécifique. Si l’API nécessite un jeton d’accès, une variable Credential Value (Valeur d’informations d’identification ) est automatiquement créée ultérieurement. Vous n’avez pas besoin d’ajouter un jeton d’accès comme entrée.

      Lorsque vous utilisez votre action de flux de données terminée dans un flux secondaire, vous définissez les valeurs à transmettre en tant qu’entrées.

    8. Cliquez sur Demande dans le plan d’action.
    9. Remplissez les champs du formulaire.
      Tableau 3. Formulaire de demande
      Champ Valeur
      Comment obtiendrez-vous des données ? Choisissez l’étape REST ou l’étape SOAP. Votre choix dépend de l’API de l’application SaaS à laquelle vous intégrez.
      Activer la pagination Sélectionné.
      Exécuter un script avant chaque demande Non sélectionné.
    10. Cliquez sur l’étape Configuration de la pagination dans le Plan d’action.
    11. Définissez des variables de pagination en fonction des paramètres de requête utilisés par l’API SaaS.

      Si vous utilisez la pagination basée sur le décalage, utilisez le modèle de pagination Limite/Décalage pour précharger la configuration de pagination.

      Remarque :
      La valeur de la variable getNextPage réservée détermine s’il faut demander une autre page de résultats. Tant que la variable getNextPage est vraie, l’action continue d’envoyer des demandes pour la page suivante.
    12. Écrivez un script de variables de pagination pour mettre à jour les variables de pagination.

      Le script s’exécute sur chaque demande. Si vous utilisez un modèle de pagination, ajustez le script préchargé selon vos besoins.

      L’image suivante montre un exemple terminé de l’étape de configuration de la pagination. Cet exemple provient de l’action Obtenir le flux de données des utilisateurs utilisée dans le flux secondaire Télécharger les Webex abonnements.

      Étape de configuration de la pagination
      Remarque :
      Les variables de pagination ne prennent en charge que le type de données chaîne. Pour effectuer des opérations mathématiques, convertissez la valeur en nombre entier, effectuez toutes les opérations requises, puis reconvertissez-la en chaîne.
    13. Cliquez sur l’étape SOAP ou l’étape REST dans le plan d’action en fonction de l’option que vous avez sélectionnée pour la façon dont vous allez obtenir des données.
    14. Si vous avez sélectionné SOAP, renseignez les détails.
      Tableau 4. Formulaire Étape SOAP
      Champ Valeur
      Détails de la connexion
      Connexion Utilisez un alias de connexion.
      Alias de connexion Alias de connexion que vous avez créé lors de la création du profil d’intégration. Si vous n’avez pas encore créé de profil d’intégration, suivez les étapes pour créer un profil d’intégration personnalisé avec un alias de connexion.
      Point de terminaison Cette valeur est automatiquement renseignée lorsque vous sélectionnez l’alias de connexion. Elle est définie sur l’URL de connexion à partir de l’enregistrement de connexion HTTP(s) lié à l’alias.
      Détails de la demande
      Enveloppe de version Manuellement.
      SOAP Action Demande d’API pour obtenir une liste d’activités utilisateur significatives. Par exemple, l’intégration Réunions du système Webex de base définit une activité utilisateur significative comme l’hébergement d’une réunion afin qu’elle utilise la demande LstsummaryMeeting pour obtenir une liste de toutes les réunions. Consultez la documentation relative à l’API que vous avez choisie pour sélectionner la demande appropriée.
      Enveloppe SOAP Message de demande XML pour obtenir une liste de tous les utilisateurs. Consultez la documentation de l’API que vous avez choisie pour savoir comment écrire un message de demande XML. En général, l’en-tête doit contenir vos variables d’entrée pour l’authentification utilisateur ainsi que la variable Valeur d’informations d’identification comme jeton d’accès. Le corps doit inclure la demande d’obtention d’une liste d’activités utilisateur significatives, une date de début définie comme entrée Heure de la rétrospective et vos variables de l’étape de configuration de la pagination.
      Remarque :
      Pour obtenir un exemple d’enveloppe SOAP, consultez l’action Obtenir le flux de données de l’activité de l’utilisateur utilisée dans le flux secondaire Mettre à jour l’activité de l’utilisateur Webex .
    15. Si vous avez sélectionné REST, renseignez les détails.
      Tableau 5. Formulaire Étape REST
      Champ Valeur
      Détails de la connexion
      Connexion Utilisez un alias de connexion.
      Alias de connexion Alias de connexion que vous avez créé lors de la création du profil d’intégration.

      Si vous n’avez pas encore créé de profil d’intégration, suivez les étapes pour créer un profil d’intégration personnalisé avec un alias de connexion.
      URL de base Cette valeur est automatiquement renseignée lorsque vous sélectionnez l’alias de connexion. Elle est définie sur l’URL de connexion à partir de l’enregistrement de connexion HTTP(s) lié à l’alias.
      Détails de la demande
      Demande de version Manuellement.
      Chemin d'accès à la ressource Chemin d’accès à la ressource. Cette valeur est ajoutée à l’URL de base. Consultez la documentation de l’API que vous utilisez pour apprendre à construire le chemin d’accès de la ressource.
      Méthode HTTP GET.
      Paramètres de requêtes Ajoutez des paramètres pour la pagination. Définissez les valeurs en tant que variables que vous avez créées à l’étape Configuration de la pagination.
      Ajoutez un autre paramètre pour la date de début afin que la demande renvoie les résultats de la date de début à la date actuelle. Définissez la valeur comme entrée Heure de la rétrospective .
      Remarque :
      Assurez-vous que la variable date/heure d’entrée de l’heure de la rétrospective est correctement formatée pour l’API que vous utilisez. Si vous avez besoin de reformater ou de convertir vers un autre type de données tel qu’une chaîne, vous pouvez le faire dans l’étape Script de prétraitement de l’action.

      L’image suivante montre un exemple terminé de l’étape REST. Cet exemple provient de l’action Obtenir le flux de données du journal d’audit utilisée dans le flux secondaire Mettre à jour l’activité de l’utilisateur Jira .

      Étape REST
    16. Cliquez sur Analyse dans le plan d’action.
    17. Remplissez les champs du formulaire.
      Tableau 6. Analyse du formulaire
      Champ Valeur
      Comment identifierez-vous chaque enregistrement Séparateur JSON/XML
      Comment analyserez-vous chaque élément en un objet Analyseur de script
    18. Cliquez sur l’étape Séparateur dans le Plan d’action.
    19. Remplissez les champs du formulaire.
      Tableau 7. Formulaire Étape de séparation
      Champ Valeur
      Source Format Sélectionnez XML ou JSON en fonction du format renvoyé par la réponse API.
      Chemin de l’élément Chemin d’accès absolu à un élément d’activité significatif dans le message de réponse. Consultez la documentation de l’API que vous utilisez pour plus d’informations sur le format du message de réponse.
      • Exemple de chemin d’accès de l’élément XML : /message/corps/réunion
      • Exemple de chemin d’accès de l’élément JSON : $.data.meeting
    20. Cliquez sur Sorties dans le plan d’action.
    21. Cliquez sur Créer une sortie et modifiez la variable comme indiqué.
      Tableau 8. Résultat de l'action
      Étiquette Nom Type Obligatoire
      targetObject targetObject Objet Non
    22. Ajoutez des éléments enfants pour targetObject afin de stocker l’e-mail de l’utilisateur et la date de l’activité significative.
      Par exemple, une réponse XML peut ressembler à ceci.
      <message>​
  <body>​
    <meeting>
      <meetingID>​12345</meetingID>​
      <startDate>​08/13/2019 20:08:16</startDate>​
      <hostEmail>​email@email.com</hostEmail>​
    </meeting>​
    <meeting>
      ...
    </meeting>
  </body>​
</message>
      Pour cette réponse, ajoutez les éléments enfants comme indiqué.
      Tableau 9. Éléments enfants pour targetObject
      Étiquette Nom Type Obligatoire
      e-mail e-mail Chaîne Non
      last_activity last_activity Chaîne Non
    23. Dans le Plan d’action, cliquez sur l’étape Analyseur de script.
    24. Créez un objet de sortie targetObject pour chaque élément d’activité significative dans la réponse, puis mappez la date de l’activité et l’e-mail de l’utilisateur aux éléments enfants targetObject .

      Le script de l’analyseur est exécuté pour chaque élément utilisateur.

      Remarque :
      Ces exemples montrent les types d’éléments qui pourraient être contenus dans une réponse. Ne copiez pas directement ces scripts. Utilisez des noms d’éléments provenant de la documentation de l’API que vous utilisez.
      Exemple de script qui analyse une réponse XML. 
      (function parse(inputs, outputs) {
    var xmlDoc = new XMLDocument(inputs.sourceItem, false);
    outputs.targetObject.email = xmlDoc.getNodeText('/meeting/hostEmail');
    outputs.targetObject.last_activity = xmlDoc.getNodeText('/meeting/startDate');
})(inputs, outputs)
      Exemple de script qui analyse une réponse JSON. 
      (function parse(inputs, outputs) {
    var record = JSON.parse(inputs.sourceItem);
    outputs.targetObject.email = record.hostEmail;
    outputs.targetObject.last_activity = record.startDate;
})(inputs, outputs)
    25. Pour tester votre action de flux de données, cliquez sur Tester.
      1. 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.
      2. Si votre action de flux de données comporte des erreurs, assurez-vous d’utiliser les bons points de terminaison et que les demandes et réponses d’API sont structurées comme prévu.
    26. Après avoir vérifié que l’action de flux de données fonctionne comme prévu, cliquez sur Publier.