Connecteur Microsoft SharePoint dans Power Automate
Dans Power Automate, Microsoft SharePoint Connector prend en charge les actions et déclencheurs de flux suivants.
Déclencheurs SharePoint
Les déclencheurs SharePoint vous permettent de créer des flux qui surveillent les modifications apportées à une liste ou une bibliothèque SharePoint. Si une ou plusieurs modifications se produisent dans une liste abonnée, ce flux est déclenché pour s’exécuter.
Lors de la création d’un élément
Déclenche le flux lorsque vous créez un élément dans une liste SharePoint.
Lorsqu’un élément est créé ou modifié
Déclenche le flux lorsque vous créez un élément et chaque fois que vous le modifiez dans une liste SharePoint.
Lorsqu’un élément ou un fichier est modifié
Déclenche le flux lorsque vous modifiez un élément ou un fichier dans une liste SharePoint ou une bibliothèque de documents.
Pour plus d’informations sur l’utilisation de ce déclencheur, consultez cette vidéo de tutoriel : Présentation du déclencheur « quand un élément ou un fichier a été modifié » et de l’action « Obtenir des modifications »
Lorsqu’un élément est supprimé
Déclenche le flux lorsque vous supprimez un élément dans une liste. Pour obtenir les propriétés d’un élément supprimé, vous devez connecter ce déclencheur au site SharePoint associé sur lequel il est censé s’exécuter, à l’aide d’un compte d’administrateur de collection de sites.
Pour un élément sélectionné
Permet aux utilisateurs de listes de déclencher un flux après avoir sélectionné un élément dans une liste.
Remarque
Seuls les flux au sein de l’environnement par défaut peuvent être exécutés manuellement à partir d’une liste SharePoint.
Lorsqu’un fichier est classé par un modèle de compréhension du contenu
Déclenche le flux lorsqu’un modèle de compréhension de contenu Microsoft Syntex classifie un fichier, indiqué dans la propriété date de classification du fichier.
Pour plus d’informations sur le moment où Microsoft Syntex et comment il classifie les fichiers, consultez : Introduction à Microsoft Microsoft Syntex
Lorsqu’un fichier est créé (propriétés uniquement)
Déclenche le flux lorsque vous créez un fichier dans une bibliothèque de documents et retourne uniquement les propriétés de fichier personnalisées associées à ce fichier.
Lorsqu’un fichier est créé dans un dossier [déconseillé]
Remarque
Ce déclencheur est déconseillé et peut ne pas fonctionner comme prévu.
Déclenche le flux lorsque vous créez un fichier dans un dossier SharePoint. Ce déclencheur ne s’exécute pas si vous ajoutez ou mettez à jour un fichier dans un sous-dossier à l’intérieur du dossier sur lequel ce déclencheur fonctionne. Si le flux est requis pour se déclencher sur des sous-dossiers, créez des flux différents pour un ou plusieurs sous-dossiers.
Lorsqu’un fichier est créé ou modifié (propriétés uniquement)
Déclenche le flux lorsque vous créez un fichier et chaque fois que vous modifiez les propriétés du fichier dans une bibliothèque. Spécifiez une valeur dans la propriété « Folder » pour cibler un dossier spécifique ; sinon, le déclencheur s’applique à l’ensemble de la bibliothèque. Retourne uniquement les propriétés de fichier personnalisées associées à ce fichier.
Lorsqu’un fichier est créé ou modifié dans un dossier [déconseillé]
Remarque
Ce déclencheur est déconseillé et peut ne pas fonctionner comme prévu.
Se déclenche lorsqu’un fichier est créé, ainsi que chaque fois qu’il est modifié dans un dossier SharePoint. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Lorsqu’un fichier est supprimé
Déclenche le flux lorsque vous supprimez un fichier dans une bibliothèque de documents. Vous pouvez éventuellement spécifier un dossier à watch. Lorsque vous supprimez un dossier, le déclencheur ne s’active qu’une seule fois pour le dossier supprimé, y compris ses sous-dossiers. Pour obtenir les propriétés du fichier supprimé, vous devez connecter ce déclencheur au site SharePoint associé sur lequel le déclencheur est censé s’exécuter, à l’aide d’un compte d’administrateur de collection de sites.
Pour un fichier sélectionné
Permet aux utilisateurs de bibliothèques de documents de déclencher un flux après avoir sélectionné un fichier.
Remarque
Seuls les flux dans l’environnement par défaut peuvent être exécutés manuellement à partir d’une bibliothèque SharePoint.
Lorsqu’un site a demandé à rejoindre un site hub
Déclenche un flux lors de la demande d’approbation de jonction de site hub.
Actions SharePoint
Ajouter une pièce jointe
Ajoute une nouvelle pièce jointe à l’élément de liste spécifié.
Approuver la demande de jonction de site hub
Approuve la demande de jonction de site hub. Cette action retourne un jeton d’approbation pour terminer la demande de jointure, à l’aide de l’action de site hub de jointure.
Annuler la demande de jointure de site hub
Annule la demande de jointure au hub. Le cas échéant, spécifiez le même ID de corrélation d’approbation que celui utilisé dans l’action Définir la jointure de site hub status en attente.
Archiver le fichier
Archive un fichier extrait dans une bibliothèque de documents, ce qui rend la version du document accessible à d’autres personnes.
Extraire le fichier
Extrait un fichier dans une bibliothèque de documents pour empêcher d’autres personnes de modifier le document et vos modifications d’être visibles tant que vous n’avez pas case activée dans le document.
Copier le fichier
Copie un fichier. Fonctionne de la même façon que la commande Copier dans dans les bibliothèques SharePoint. Après la copie, retourne des informations sur le nouveau fichier.
Copier le fichier [déconseillé]
Remarque
Cette action est déconseillée et peut ne pas fonctionner comme prévu.
Copie un fichier vers un site SharePoint.
Copier le dossier
Copie un dossier. Fonctionne de la même façon que la commande Copier dans dans les bibliothèques SharePoint. Après la copie, retourne des informations sur le nouveau dossier.
Créer un fichier
Charge un fichier sur un site SharePoint. Veillez à sélectionner une bibliothèque existante.
Créer un élément
Crée un élément dans une liste SharePoint.
Créer un dossier
Crée un dossier ou un chemin d’accès au dossier.
Créer un lien de partage pour un fichier ou un dossier
Crée un lien de partage pour un fichier ou un dossier.
Supprimer une pièce jointe
Supprime la pièce jointe spécifiée.
Supprimer le fichier
Supprime le fichier spécifié par l’identificateur de fichier.
Supprimer un élément
Supprime un élément d’une liste SharePoint.
Ignorer l’extraction
Ignore l’extraction, plutôt que d’enregistrer le fichier, si vous case activée un fichier et n’y apportez pas de modifications, ou si vous apportez des modifications que vous ne souhaitez pas conserver. Si votre organization effectue le suivi des versions, une nouvelle version est créée chaque fois que vous case activée dans un fichier dans la bibliothèque. En ignorant l’extraction, vous pouvez éviter d’effectuer de nouvelles versions lorsque vous n’avez apporté aucune modification au fichier.
Extraire le dossier
Extrait un fichier d’archive dans un dossier SharePoint (par exemple, .zip).
Obtenir toutes les listes et bibliothèques
Obtient toutes les listes et bibliothèques.
Obtenir le contenu de la pièce jointe
Retourne le contenu du fichier, à l’aide de l’identificateur de fichier. Le contenu peut être copié ailleurs ou être utilisé comme pièce jointe.
Obtention de pièces jointes
Retourne la liste des pièces jointes pour l’élément de liste spécifié. Pour accéder au contenu du fichier, ajoutez une étape Obtenir le contenu de la pièce jointe et utilisez la propriété Identificateur de fichier retournée par cette action.
Obtenir les modifications d’un élément ou d’un fichier (propriétés uniquement)
Obtient toutes les colonnes ou propriétés de fichier modifiées depuis et jusqu’à un intervalle de temps spécifié. Pour obtenir toutes les colonnes modifiées lorsqu’un élément ou un fichier est modifié :
- Utilisez le déclencheur lorsqu’un élément ou un fichier est modifié , et,
- Utilisez le déclencheur Trigger Window Start Token & Trigger Window End Token sorties à partir du déclencheur lorsqu’un élément ou un fichier est modifié pour déduire les colonnes modifiées depuis la dernière vérification des mises à jour d’élément ou de fichier.
Pour plus d’informations sur l’utilisation de cette action, consultez cette vidéo de tutoriel : Présentation du déclencheur « quand un élément ou un fichier a été modifié » et de l’action « Obtenir des modifications »
Remarque
- Le contrôle de version doit être configuré pour la liste ou la bibliothèque afin de déduire les colonnes ou propriétés qui ont été modifiées depuis la dernière modification.
- Seules les modifications de colonne sont prises en charge pour les listes et les bibliothèques.
- Les modifications de contenu de fichier ne sont pas prises en charge.
- Les modifications apportées aux pièces jointes ne sont pas prises en charge.
- Le jeton de début de la fenêtre déclencheur & le jeton de fin de fenêtre de déclencheur sont disponibles uniquement lorsque vous utilisez lorsqu’un élément ou un fichier est modifié déclencheur.
Obtenir le contenu du fichier
Obtient le contenu du fichier à l’aide de l’identificateur de fichier. Vous pouvez copier le contenu ailleurs ou l’utiliser comme pièce jointe.
Obtenir le contenu du fichier à l’aide du chemin d’accès
Obtient le contenu du fichier à l’aide du chemin d’accès au fichier.
Obtenir les métadonnées de fichier
Obtient des informations sur le fichier, telles que la taille, l’etag, la date de création, etc. Utilise un identificateur de fichier pour sélectionner le fichier. Pour accéder aux valeurs stockées dans les colonnes de la bibliothèque, utilisez l’action Obtenir les propriétés du fichier .
Obtenir des métadonnées de fichier à l’aide du chemin d’accès
Obtient des informations sur le fichier, telles que la taille, l’etag, la date de création, etc. Utilise un chemin d’accès pour sélectionner le fichier. Pour accéder aux valeurs stockées dans les colonnes de la bibliothèque, utilisez l’action Obtenir les propriétés du fichier .
Obtenir les propriétés du fichier
Obtient les propriétés enregistrées dans les colonnes de la bibliothèque pour l’élément spécifié par l’ID d’élément. Pour accéder au contenu du fichier, ajoutez une étape « Obtenir le contenu du fichier » et utilisez la propriété « Identificateur de fichier » retournée par cette action. Lorsque vous l’utilisez avec la passerelle de données locale, vous devrez peut-être entrer manuellement le nom de la bibliothèque à laquelle vous connecter.
Obtenir des fichiers (propriétés uniquement)
Obtient les propriétés enregistrées dans les colonnes de la bibliothèque pour tous les dossiers et fichiers stockés dans la bibliothèque. Vous pouvez également filtrer jusqu’aux éléments qui correspondent à une condition. Pour utiliser la sortie de cette action, utilisez la section Appliquer à chaque . Lorsque vous l’utilisez avec la passerelle de données locale, vous devrez peut-être entrer manuellement le nom de la bibliothèque à laquelle vous connecter. Pour plus d’informations sur cette action, consultez : Analyse approfondie dans Obtenir des éléments et Obtenir des fichiers Actions SharePoint pour les flux dans Power Automate.
Obtenir les métadonnées de dossier
Obtient des informations sur le dossier. Utilise un identificateur de fichier pour sélectionner le dossier.
Obtenir des métadonnées de dossier à l’aide du chemin d’accès
Obtient des informations sur le dossier. Utilise un chemin d’accès au dossier pour sélectionner le dossier.
Obtenir un élément
Obtient un seul élément par son ID à partir d’une liste SharePoint.
Obtenir des éléments
Obtient des éléments d’une liste SharePoint. Pour plus d’informations sur cette action, consultez : Analyse approfondie dans Obtenir des éléments et Obtenir des fichiers Actions SharePoint pour les flux dans Power Automate.
Obtenir des affichages de liste
Obtient des vues à partir d’une liste SharePoint.
Obtenir des listes
Obtient des listes SharePoint à partir d’un site.
Accorder l’accès à un élément ou à un dossier
Accorde l’accès à un élément ou à un dossier dans SharePoint à des personnes spécifiques.
Joindre un site hub
Joint le site demandé au site hub. Un jeton d’approbation est nécessaire pour terminer la jointure si ce hub nécessite une approbation. Le cas échéant, spécifiez le même ID de corrélation d’approbation que celui utilisé dans l’action Définir la jointure de site hub status en attente.
Dossier de liste
Retourne les fichiers contenus dans un dossier SharePoint.
Lister le dossier racine
Retourne des fichiers dans le dossier SharePoint racine.
Déplacer le fichier
Déplace un fichier. Fonctionne de la même façon que la commande Déplacer vers dans les bibliothèques SharePoint. Retourne des informations sur le nouveau fichier après son déplacement.
Déplacer le dossier
Déplace un dossier. Fonctionne de la même façon que la commande Déplacer vers dans les bibliothèques SharePoint. Retourne des informations sur le nouveau dossier après son déplacement.
Résoudre la personne
Retourne une valeur utilisateur correspondante unique afin qu’elle puisse être affectée à une colonne de type person. S’il n’y a aucune correspondance ou plusieurs correspondances, cette action génère une erreur.
Envoyer une requête HTTP à SharePoint
Construit une API REST SharePoint à appeler. Pour plus d’informations sur cette action, voir : Utilisation de l’action de flux d’envoi de requête HTTP SharePoint dans Power Automate.
Importante
Cette action peut exécuter n’importe quelle API REST SharePoint à laquelle vous avez accès. Procédez avec prudence.
Définir l’état d’approbation du contenu
Définit le status d’approbation de contenu pour un élément d’une liste ou d’une bibliothèque pour lequel l’approbation de contenu est activée. Vous devez fournir un ETag pour les pages et les fichiers. Vous pouvez obtenir l’ETag à l’aide de l’action Obtenir les métadonnées de fichier. Cette action est uniquement disponible pour SharePoint Online et SharePoint 2019.
Définir l’status de jonction de site hub sur En attente
Définit la demande de jointure hub du site demandé status sur en attente. L’ID de corrélation d’approbation est un paramètre facultatif qui permet à SharePoint d’identifier une demande de jointure de hub particulière. Le site demandeur ne peut avoir qu’une seule demande en attente à un moment donné.
Arrêter le partage d’un élément ou d’un fichier
Supprime tous les liens donnant accès à un élément ou à un fichier, et supprime toutes les personnes disposant d’un accès direct, à l’exception des propriétaires.
Fichier de mise à jour
Mises à jour le contenu du fichier spécifié par l’identificateur de fichier.
Mettre à jour les propriétés du fichier
Mises à jour les propriétés stockées dans les colonnes d’une bibliothèque pour l’élément spécifié par l’ID d’élément. Pour mettre à jour le contenu du fichier, utilisez l’action Mettre à jour le fichier . Lorsque vous l’utilisez avec la passerelle de données locale, vous devrez peut-être entrer manuellement le nom de la bibliothèque à laquelle vous connecter.
Mettre à jour un élément
Mises à jour un élément dans une liste SharePoint.
Prise en charge de SharePoint Server
Les tableaux suivants répertorient toutes les actions et déclencheurs pris en charge pour SharePoint En local 2013, 2016 ou 2019. Toutes les actions ou déclencheurs qui ne sont pas mentionnés ne sont pas pris en charge.
Déclencheurs pris en charge
| Déclencher | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| Lorsqu’un fichier est créé dans un dossier | Oui | Oui | Oui |
| Lorsqu’un fichier est créé ou modifié dans un dossier | Oui | Oui | Oui |
| Lors de la création d’un élément | Oui1 | Oui1 | Oui1 |
| Lorsqu’un élément est créé ou modifié | Oui1 | Oui1 | Oui1 |
| Lorsqu’un fichier est créé (propriétés uniquement) | Non | Non | Oui1 |
| Lorsqu’un fichier est créé ou modifié (propriétés uniquement) | Non | Non | Oui1 |
| Lorsqu’un élément est supprimé | Non | Non | Oui2 |
| Lorsqu’un fichier est supprimé | Non | Non | Oui2 |
| Résoudre la personne | Non | Non | Oui |
| Définir l’état d’approbation du contenu | Non | Non | Oui |
Remarque
- Ne prend pas en charge « Limiter les colonnes par affichage ».
- Bien que ce déclencheur soit pris en charge pour SharePoint 2019, les flux créés à l’aide de ce déclencheur peuvent rencontrer les problèmes suivants :
- S’il n’y a pas d’activité dans la liste pendant plus de 60 jours ou s’il y a une activité mais qu’aucun élément n’est supprimé pendant plus de 60 jours, le déclencheur ne parvient pas à s’activer.
- La suppression d’éléments de liste par l’utilisateur système active le déclencheur.
Actions prises en charge
| Opération | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| Obtenir les métadonnées de fichier | Oui | Oui | Oui |
| Obtenir des métadonnées de fichier à l’aide du chemin d’accès | Oui | Oui | Oui |
| Obtenir les métadonnées de dossier | Oui | Oui | Oui |
| Obtenir des métadonnées de dossier à l’aide du chemin d’accès | Oui | Oui | Oui |
| Obtenir le contenu du fichier | Oui | Oui | Oui |
| Créer un fichier | Oui1 | Oui1 | Oui1 |
| Fichier de mise à jour | Oui | Oui | Oui |
| Copier le fichier [déconseillé]2 | Oui | Oui | Oui |
| Dossier de liste | Oui | Oui | Oui |
| Extraire le dossier | Oui | Oui | Oui |
| Obtention de pièces jointes | Oui | Oui | Oui |
| Ajouter une pièce jointe | Oui | Oui | Oui |
| Supprimer une pièce jointe | Oui | Oui | Oui |
| Obtenir des éléments | Oui3 | Oui3 | Oui3 |
| Obtenir un élément | Oui4 | Oui4 | Oui4 |
| Créer un élément | Oui4 | Oui4 | Oui4 |
| Mettre à jour un élément | Oui4 | Oui4 | Oui4 |
| Supprimer un élément | Oui | Oui | Oui |
| Envoyer une requête HTTP à SharePoint | Oui | Oui | Oui |
Remarque
- Ne prend pas en charge la création d’un fichier volumineux en le chargeant sous la forme d’un ensemble de blocs.
- Cette action inclut « [déprécié] » dans son nom d’affichage. L’action « Copier le fichier » est différente de cette action.
- Cette action prend uniquement en charge les paramètres OData, qui excluent les paramètres tels que « Limiter les entrées au dossier », « Inclure les éléments imbriqués » et « Limiter les colonnes par affichage ».
- Ne prend pas en charge « Limiter les colonnes par affichage ».
Déclencheurs et actions déconseillés
Ces déclencheurs sont déconseillés et ne sont plus gérés activement. Bien qu’ils soient toujours présents dans Microsoft SharePoint Connector, nous vous recommandons de ne pas utiliser de déclencheurs ou d’actions déconseillés dans de nouvelles applications ou solutions.
| Nom | Type | Version prise en charge | Alternative suggérée |
|---|---|---|---|
| Lorsqu’un fichier est créé dans un dossier [déconseillé] | Déclencher | SharePoint 2019 | Lorsqu’un fichier est créé (propriétés uniquement) |
| Lorsqu’un fichier est créé ou modifié dans un dossier [déconseillé] | Déclencher | SharePoint 2019 | Lorsqu’un fichier est créé ou modifié (propriétés uniquement) |
| Copier le fichier [déconseillé] | Opération | SharePoint 2019 | Copier le fichier |
Limitations connues
Modèles de liste et de bibliothèque pris en charge
Les flux Power Automate pour les listes sont pris en charge uniquement dans les listes génériques (100) et les bibliothèques de documents génériques (101). Actuellement, nous ne prenons pas en charge les modèles de liste et de bibliothèque personnalisés, y compris, mais sans s’y limiter, les listes telles que les annonces, les contacts et les tâches.
Exécutions de flux
Lorsque vous générez un flux Power Automate à déclencher pour un élément, ou pour créer ou modifier un fichier, Power Automate recherche régulièrement les modifications apportées à la liste ou à la bibliothèque, configurées dans le déclencheur du flux. Dans la plupart des cas, s’il y a une seule modification dans la liste ou la bibliothèque, l’exécution du flux peut se produire dans les minutes qui suivent cette modification. Toutefois, attendez-vous à ce que le flux puisse collecter plusieurs modifications dans les exécutions de flux suivantes en raison du délai entre l’intervalle de flux depuis sa dernière modification valide ou des modifications ultérieures apportées à un élément ou à un fichier.
Déplacer des fichiers et des exécutions de flux
Lorsque vous déplacez un ou plusieurs fichiers d’une bibliothèque de documents vers une autre, le fichier d’origine est déplacé de la bibliothèque source vers la bibliothèque de destination. Le déplacement du fichier ne modifie pas les métadonnées personnalisées, y compris le moment où le fichier a été créé et modifié. Par conséquent, cette action ne déclenche aucun flux pour les mises à jour de fichiers associées à la bibliothèque où elle a été déplacée.
Synchronisation de fichiers avec vos bibliothèques de documents OneDrive Entreprise et SharePoint
Lorsque les utilisateurs synchronisent un ou plusieurs fichiers d’une bibliothèque de documents vers une autre, le fichier d’origine est déplacé (synchronisé) de votre client vers la bibliothèque de destination. La synchronisation du fichier ne modifie pas les métadonnées personnalisées, y compris le moment où le fichier a été créé et modifié. Par conséquent, cette action ne déclenche aucun flux pour ces synchronisations de fichiers dans cette bibliothèque ou dans votre OneDrive Entreprise.
Colonnes de recherche prises en charge
Si votre liste/bibliothèque comporte des colonnes de recherche, les actions Obtenir des éléments et Obtenir des fichiers prennent en charge le renvoi d’éléments avec un maximum de 12 colonnes de recherche. Si votre liste ou bibliothèque dépasse ce seuil, le flux dans Power Automate échoue.