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 disposez d’une liste SharePoint contenant plus de 5 000 éléments et souhaitez utiliser les activités Pour chaque élément de liste et Obtenir les éléments de liste .

En raison de limitations de l'API Microsoft Graph sous-jacente, si ces activités sont utilisées avec le filtre facultatif OData 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 de plus amples informations sur l'ajout d'un index, consultez la documentation Microsoft .

Par exemple, vous avez une liste SharePoint comportant trois colonnes : Titre, Prénom et Nom. Vous souhaitez utiliser l'activité Pour chaque élément de liste pour filtrer selon toutes les valeurs Nom de famille égale à « Smith ».

1. Créez un index dans la colonne Nom de famille de 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 : renvoie plus de 5 000 valeurs, tout en utilisant un filtre OData. Solution : supprimez le filtre OData pour permettre un renvoi de plus de 5 000 valeurs, puis filtrez dans Studio (par exemple, utilisez une activité Filter Data Table ).

Remarque :

Cette limitation d’API a un impact 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.