Partager via

Utiliser des API externes dans des flux de travail

  • Article

Importante

Cette fonctionnalité est actuellement en préversion. Les conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure incluent des conditions juridiques supplémentaires qui s’appliquent aux fonctionnalités Azure qui sont en version bêta, en préversion ou qui ne sont pas encore publiées en disponibilité générale.

Vous pouvez utiliser des flux de travail pour automatiser certains processus métier via Microsoft Purview, et le connecteur HTTP et l’action d’analyse JSON vous permettent d’intégrer vos workflows à des applications externes.

Connecteur HTTP

Les connecteurs HTTP utilisent l’architecture REST (Representational State Transfer), qui permet aux workflows Microsoft Purview d’interagir directement avec des applications non-Microsoft à l’aide de requêtes web.

Le connecteur HTTP est disponible dans tous les modèles de flux de travail.

Remarque

Pour créer ou modifier un flux de travail, vous avez besoin du rôle d’administrateur de flux de travail dans Microsoft Purview. Vous pouvez également contacter l’administrateur de flux de travail dans votre collection, ou contacter l’administrateur de votre collection pour obtenir des autorisations.

  1. Pour ajouter un connecteur HTTP, sélectionnez l’icône + dans le modèle dans lequel vous souhaitez ajouter, puis sélectionnez Connecteur HTTP.

    Capture d’écran montrant comment ajouter un connecteur HTTP.

  2. Une fois que vous avez sélectionné connecteur HTTP, renseignez les paramètres suivants :

    1. Hôte : URL de demande que vous souhaitez appeler lors de l’exécution de ce connecteur.
    2. Méthode : sélectionnez l’une des méthodes suivantes. GET, PUT, PATCH, POST et DELETE. Ces méthodes correspondent aux opérations de création, de lecture, de mise à jour et de suppression.
    3. Chemin : si vous le souhaitez, vous pouvez entrer le chemin de l’URL de la demande. Vous pouvez utiliser du contenu dynamique pour ce paramètre.
    4. En-têtes : si vous le souhaitez, vous pouvez entrer des en-têtes HTTP. Les en-têtes HTTP permettent au client et au serveur de transmettre des informations supplémentaires avec une requête ou une réponse HTTP
    5. Requêtes : si vous le souhaitez, vous pouvez passer des requêtes.
    6. Corps : si vous le souhaitez, vous pouvez transmettre le corps HTTP lors de l’appel de l’URL
    7. Authentification : le connecteur HTTP est intégré à vos informations d’identification Microsoft Purview. Selon l’URL, vous pouvez appeler l’un de ces trois types :
      1. Aucun (aucune authentification)
      2. Authentification de base : à l’aide d’informations d’identification d’authentification de base que vous avez déjà créées.
      3. Principal de service : à l’aide d’informations d’identification de principal de service que vous avez déjà créées et d’une audience. L’audience sera le consommateur prévu du jeton d’accès. L’audience Microsoft Purview par exemple : https://purview.azure.net/.default assurez-vous que votre principal de service est autorisé à appeler les services correspondants, tels qu’ARM.

    Capture d’écran montrant comment ajouter des propriétés de connecteur HTTP.

  3. Par défaut, les paramètres sécurisés sont activés pour les connecteurs HTTP. Pour désactiver les entrées et sorties sécurisées, sélectionnez l’icône de points de suspension (...) pour accéder aux paramètres.

    Capture d’écran montrant comment ajouter des paramètres de connecteur HTTP.

  4. Les paramètres du connecteur HTTP vous sont maintenant présentés et vous pouvez désactiver les entrées et sorties sécurisées.

    Capture d’écran montrant comment ajouter une entrée et des sorties sécurisées du connecteur HTTP.

Analyser l’action JSON

L’action d’analyse JSON dans les flux de travail vous permet d’effectuer un json entrant à partir de HTTP (ou de toute autre action/connecteur) et d’analyser le json pour extraire des valeurs à utiliser dans votre flux de travail.

L’action analyser JSON est disponible dans tous les workflows.

Capture d’écran de l’action JSON d’analyse des workflows, montrant ses paramètres remplis avec des exemples de données.

L’action analyser JSON a deux paramètres :

  • Content : variable qui doit contenir le JSON que vous souhaitez analyser.
  • Schéma : schéma du JSON entrant, qui permet au flux de travail d’analyser les informations entrantes. Vous pouvez fournir votre propre ou utiliser le bouton Générer à partir de l’exemple . Si vous générez à partir d’un exemple, vous entrez un exemple de charge utile JSON et un schéma est automatiquement généré pour vous.

Les actions et les connecteurs dans le flux de travail après l’action d’analyse JSON pourront utiliser les valeurs extraites du json en sélectionnant Ajouter du contenu dynamique pour tous les paramètres.

Capture d’écran d’un autre connecteur avec des valeurs de l’action Analyser JSON ajoutées.

Étapes suivantes

Pour plus d’informations sur les flux de travail, consultez les articles suivants :