Travailler avec des listes SharePoint

À propos

Cette section explique comment travailler, filtrer et parcourir les listes SharePoint.

Comment travailler avec de grandes listes SharePoint

Scénario : vous avez une liste SharePoint contenant plus de 5 000 éléments et vous souhaitez utiliser les activités For Each List Item et Get List Items .

En raison de limitations de l'API Microsoft Graph sous-jacente, si ces activités sont utilisées avec le filtre OData facultatif sur une liste de cette taille, elles échoueront avec l'erreur suivante :

"error": {
    "code": "notSupported",
    "message": "The request is unprocessable because it uses too many resources",
    "innerError": {
        "code": "tooManyResources",
        "date": "2023-05-01T04:27:00",
        "request-id": "93c12b1f-6bc5-4466-ae9f-2bfd2ca0ef6a",
        "client-request-id": "02996ac5-b700-8a1e-3c6d-7e6f0624fabe"
    }
 }

Solution

Ajoutez des index de colonne dans la liste SharePoint pour les colonnes que vous prévoyez d'utiliser dans le filtre OData facultatif. Pour plus d'informations sur l'ajout d'un index, consultez la documentation Microsoft .

Par exemple, vous avez une liste SharePoint avec trois colonnes : Titre, Prénom et Nom. Vous souhaitez utiliser l'activité Pour chaque élément de liste ( For Each List Item ) pour filtrer toutes les valeurs Nom égales à « Smith ».

1. Créez un index sur la colonne LastName dans SharePoint. Cela permet à l'API Microsoft Graph d'effectuer une requête performante et d'éviter de renvoyer une erreur.
2. Définissez le filtre OData des activités UiPath sur "fields/LastName eq 'Smith'" pour exécuter la fonction décrite. De cette façon, aucune erreur ne se produit, même si la liste contient plus de 5 000 éléments.

Limitations

Même avec l'indexation, l'API Graph ne renverra pas correctement si le nombre de résultats à renvoyer est supérieur à 5 000.

• Scénario 1 : renvoyer moins de 5 000 valeurs lors de l’utilisation d’un filtre OData. Solution de contournement : ajoutez un index, comme décrit ci-dessus.
• Scénario 2 : renvoyer plus de 5 000 valeurs, tout en utilisant un filtre OData. Solution de contournement : supprimez le filtre OData pour autoriser un renvoi de plus de 5 000 valeurs, puis filtrez dans Studio (par exemple, utilisez une activité Filter Data Table ).

Remarque : Cette limitation de l'API a un impact à la fois sur les activités de liste classiques et les activités de listes SharePoint.

Comment travailler avec les champs de recherche de personne

À partir de la version 2.4.2, vous pouvez gérer les champs de recherche Person par un composant de la valeur de référence. Dans le champ Type de personne/groupe (Person/Group type), vous pouvez également ajouter l'e-mail de la personne en tant qu'entrée de chaîne.

Notez que Person est un type complexe avec plusieurs champs. Si une entrée de chaîne est reçue, il est supposé qu'elle contient l'adresse e-mail de la personne, et aucun autre sous-champ ou ID.