Analyse approfondie dans Obtenir des éléments et Obtenir des fichiers SharePoint actions pour les flux Power Automate

Les actions Obtenir des éléments et Obtenir des SharePoint pour les flux dans Power Automate vous permet d’obtenir des éléments à partir d’une liste et d’une bibliothèque, respectivement. Bien qu’il s’agisse d’actions différentes, les fonctionnalités des deux actions sont identiques. Cet article explique comment travailler avec ces actions.

Déterminer si vous travaillez avec des listes ou des bibliothèques

Tout d’abord, et à prendre en compte, l’action Obtenir des éléments fonctionne uniquement avec les listes, tandis que l’action Obtenir des fichiers fonctionne uniquement avec les bibliothèques.

Limitations des éléments

La limite d’élément par défaut est de 100 et les éléments sont paginés par défaut également.

Si vous utilisez les options par défaut et que vous spécifiez simplement l’adresse du site et le nom de la liste ou de la bibliothèque, Power Automate renvoie 100 éléments de la liste ou de la bibliothèque.

Si vous travaillez avec des listes de grande taille, vous pouvez augmenter cette limite jusqu’à 5 000.

Pour spécifier le nombre d’éléments à retourner, développez les options avancées et spécifiez le nombre dans la propriété d’action Nombre supérieur.

Modifier le nombre d’éléments renvoyés dans l’action Obtenir des éléments

Si vous dépassez la limite de 5 000 éléments, la Power Automate échoue et génère une boîte de dialogue d’erreur.

Limiter les éléments à un dossier spécifique

Par défaut, cette action renvoie tous les éléments ou fichiers de la liste ou de la bibliothèque, de manière récursive, à partir de tous les dossiers, si disponible. Vous pouvez modifier ce comportement en suivant les conseils ci-après :

  • Pour sélectionner un dossier spécifique dans la liste ou la bibliothèque, utilisez la propriété Limit Entries to Folder.
  • Pour limiter les entrées à ce dossier spécifique ou dans tous les sous-dossiers, utilisez la propriété Include Nested Items.

Limiter les entrées au dossier dans l’action Obtenir des éléments

Limiter les colonnes renvoyées par l’affichage

Les affichages de liste sont une configuration utile dans laquelle vous pouvez personnaliser les colonnes à afficher, ainsi que d’autres conditions ou regroupements d’éléments de liste. Cela n’est pas seulement utile pour les utilisateurs, mais également pour tout autre calcul que vous souhaitez faire à l’aide de ces données d’affichage.

Pour récupérer les éléments de liste ainsi que leurs colonnes, sélectionnez les actions Obtenir des éléments et Obtenir des fichiers. Toutefois, la récupération des colonnes récupère toutes les colonnes. Bien que cela soit utile, il peut être excessif lorsque vous n’avez besoin de travailler qu’avec un ensemble spécifique de colonnes configuré dans un affichage spécifique.

Pour limiter la récupération de vos colonnes, dans les actions Obtenir des éléments et Obtenir des fichiers, développez Options avancées, sélectionnez les colonnes Limite par option d’affichage. Lors de la récupération des éléments de liste, vous pouvez désormais limiter les colonnes par affichage.

Limite les colonnes renvoyées par l’affichage dans l’action Obtenir des éléments

Cette option est utile dans les cas où vous souhaitez effectuer un ensemble d’opérations sur des données spécifiques, comme dans l’exemple précédent où vous souhaitez afficher différents événements. Dans ce cas, en travaillant avec des événements de restauration, il est optimal de limiter les colonnes par les événements de restauration.

Filtrer les requêtes

Cette action prend également en charge la spécification de requêtes de filtre afin que vous pouvez filtrer des éléments sur le serveur. L’utilisation de requêtes de filtre est aussi fonctionnelle que le filtrage des résultats renvoyés dans votre flux Power Automate.

Les requêtes de filtre OData suivantes sont SharePoint que vous pouvez utiliser :

  • Filtrer par nom de colonne :
Location eq 'Midwest'

L’emplacement est le nom de colonne utilisé avec l’opérateur égal à (eq) et Le lieu est la valeur de la colonne.

Autres exemples :

  • Emplacement eq 'And Status eq 'Approved'
  • startswith(Title, 'A')
  • startswith(Title, 'A') and Start_x0020_Date gt 'formatDateTime(utcNow(),'yyyy-MM-dd')'
    • formatDateTime(utcNow(),'yyyy-MM-dd') est une expression.
  • Pays/Titre eq 'Nouvelle-Zélande'
    • Pays est une colonne de recherche dans la liste et Titre est une colonne dans la liste référencé.

Requêtes de filtre ODATA dans l’action Obtenir des éléments

Nous phonons les opérateurs et méthodes de requête suivants.

Comparaisons numériques

  • lt
    • inférieur à
  • le
    • inférieur ou égal à
  • gt
    • supérieur à
  • ge
    • supérieur ou égal à
  • eq
    • égal à
  • ne
    • n’est pas égal

Comparaisons de chaînes

  • startsWith
  • substringOf
  • eq
  • ne

Fonctions de date et d’heure

  • day()
  • month()
  • year()
  • hour()
  • minute()
  • second()

Commande par requête

Pour commander des éléments en fonction d’une colonne par ordre croissant ou décroit, vous pouvez également spécifier un ordre par requête. Par exemple :

  • Start_x0020_Date desc
  • Title asc

Les espaces dans le nom de colonne sont remplacés _x0020_ par (0 est un nombre zéro).

Ordre ODATA par dans l’action Obtenir des éléments

Le format est le nom de colonne suivi d’asc ou de desc en fonction de l’ordre croissant ou décroît, respectivement.