Déclencheurs Web SharePoint

Les déclencheurs Web SharePoint vous permettent de surveiller les événements d\'un site SharePoint. Vous pouvez configurer des actions qui s\'activent lorsque l\'événement surveillé se produit sur le site SharePoint.

Présentation

Les déclencheurs Web SharePoint vous permettent de démarrer un flux de travail d\'automatisation basé sur les événements auxquels vous êtes abonné. Configurez le déclencheur Web SharePoint pour écouter les événements auxquels vous êtes abonné. Une fois que l\'événement se produit sur le site SharePoint, le déclencheur active le flux de travail d\'automatisation suivant. Les déclencheurs Web SharePoint vous permettent de créer des automatisations sans aucune intervention manuelle grâce à un échange de données en temps réel.

Les déclencheurs Web SharePoint utilisent la connexion OAuth pour authentifier les données entrantes. Pour plus d\'informations sur la connexion OAuth pour SharePoint, voir Créer OAuth connexion.
Remarque : Une latence importante se produit entre l\'événement survenant sur un site SharePoint et le moment où la Control Room reçoit la notification du site SharePoint. Pour plus d\'informations, consultez le tableau des latences dans Microsoft Graph REST API Subscription latency.

Événements pris en charge

Vous pouvez configurer les déclencheurs Web SharePoint pour surveiller des événements dans des fichiers, des dossiers et des listes. Les déclencheurs Web SharePoint prennent en charge les événements suivants.

Événements Description
Fichier créé Lorsqu\'un fichier est créé sur le site SharePoint surveillé.
Fichier mis à jour Lorsqu\'un fichier est mis à jour sur le site SharePoint surveillé.
Dossier créé Lorsqu\'un dossier est créé sur le site SharePoint surveillé.
Dossier mis à jour Lorsqu\'un dossier est créé sur le site SharePoint surveillé.
Élément de liste créé Lorsqu\'un élément est ajouté à une liste sur le site SharePoint surveillé.
Élément de liste mis à jour Lorsqu\'un élément de liste existant est mis à jour sur le site SharePoint surveillé.

Prérequis

Assurez-vous que les prérequis suivants sont satisfaits :

  • Une licence Bot Creator ou Développeur citoyen.
  • Autorisations DÉCLENCHEURS D\'ÉVÉNEMENTS et Afficher mes robots.
  • Autorisation Archiver et Extraire sur les dossiers dans lesquels se trouve l\'automatisation.
  • Une connexion OAuth active pour le site SharePoint.

Paramètres

Les paramètres suivants sont disponibles pour le déclencheur Web SharePoint.
OAuth SharePoint
L\'option OAuth SharePoint vous permet de sélectionner la connexion OAuth configurée. Assurez-vous d\'ajouter l\'autorisation Microsoft Graph à la portée de la connexion OAuth. L\'étendue Microsoft Graph permet au déclencheur de lire la bibliothèque de documents SharePoint pour les événements liés aux fichiers et dossiers, et de lire les listes SharePoint pour les événements liés aux listes.
Site
L\'option Site vous permet de configurer le site SharePoint que vous surveillez pour les événements. Vous pouvez soit saisir le lien directement, soit utiliser l\'option Sélectionner un site pour sélectionner le site dans la liste déroulante Sites. La liste déroulante Sites se connecte au site SharePoint et affiche tous les sites du sous-domaine.
Type d\'événement
L\'option Type d\'événement vous permet de configurer les événements sur lesquels le déclencheur active les actions d\'automatisation suivantes. Vous pouvez configurer le déclencheur sur la base de Fichier et dossier ou de Liste.
Dans l\'option Fichier et dossier, sélectionnez les événements dans la liste déroulante Écouter l\'événement et saisissez le chemin du fichier pour les événements de fichier et le chemin du dossier pour les événements de dossier. Assurez-vous de saisir le dossier parent pour les événements de dossier. Par exemple, pour surveiller les événements de dossier pour un dossier nommé XYZ, qui se trouve à l\'intérieur d\'un autre dossier ABC dans le dossier de documents SharePoint, saisissez Documents/ABC.
Réponse
L\'option Réponse vous permet de capturer les données de réponse du déclencheur dans une variable d\'enregistrement. Vous pouvez soit créer une variable d\'enregistrement, soit sélectionner une variable d\'enregistrement existante pour capturer les données de réponse. La variable d\'enregistrement capture les informations du corps de la réponse de l\'API sous forme de paire clé-valeur.

Lecture des données de réponse du déclencheur dans le journal d\'audit

Les données de réponse du déclencheur contiennent toutes les informations des événements dans lesquels le changement s\'est produit. Les données de la charge utile de l\'événement sont générées à l\'aide des propriétés de ressource des API SharePoint dans Microsoft Graph. Les données. Vous pouvez consulter les données, stockées sous forme de paire clé-valeur, sur la page Journal d\'audit. Pour plus d\'informations sur les données de la charge utile de l\'événement SharePoint, voir Working with SharePoint sites in Microsoft Graph.

Vous pouvez utiliser les attributs de données de la charge utile de l\'événement capturés dans le Journal d\'audit comme entrées pour toute action ultérieure au sein de la session. Vous pouvez également construire les arguments pour les attributs à partir des propriétés de type de ressource API des API SharePoint dans Microsoft Graph. Par exemple, pour afficher le chemin du dossier dans lequel un fichier est créé, vous pouvez utiliser parentReference.path, où parentReference provient des propriétés de ressource BaseItem et path provient des propriétés de ressource itemReference.