Arbeiten mit SharePoint-Listen

Über

Dieser Abschnitt beschreibt die Arbeit, das Filtern und die Iteration durch SharePoint-Listen.

So arbeiten Sie mit großen SharePoint-Listen

Szenario: Sie haben eine SharePoint-Liste, die mehr als 5.000 Elemente enthält, und möchten die Aktivitäten For Each List Item und Get List Items verwenden.

Aufgrund von Einschränkungen in der zugrunde liegenden Microsoft Graph-API schlagen diese Aktivitäten mit dem optionalen OData-Filter auf einer Liste dieser Größe mit dem folgenden Fehler fehl:

"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"
    }
 }

Lösung

Fügen Sie Spaltenindizes in der SharePoint-Liste für die Spalten hinzu, die Sie im optionalen OData-Filter verwenden möchten. Informationen zum Hinzufügen eines Index finden Sie in der Microsoft- Dokumentation.

Beispielsweise haben Sie eine SharePoint-Liste mit drei Spalten: Title, FirstName, und LastName. Sie möchten die Aktivität For Each List Item verwenden, um alle LastName- Werte gleich „Smith“ zu filtern.

1. Erstellen Sie einen Index für die Spalte Nachname in SharePoint. Dadurch kann die Microsoft Graph-API eine performante Abfrage durchführen und das Zurückgeben eines Fehlers vermeiden.
2. Legen Sie den OData-Filter in den UiPath-Aktivitäten auf "fields/LastName eq 'Smith'" fest, um die beschriebene Funktion auszuführen. So tritt kein Fehler auf, auch wenn die Liste größer als 5.000 Elemente ist.

Einschränkungen

Selbst bei Indizierung gibt die Graph-API nicht erfolgreich zurück, wenn die Anzahl der zurückzugebenden Ergebnisse größer als 5.000 ist.

• Szenario 1: Rückgabe von weniger als 5.000 Werten bei der Verwendung eines OData-Filters. Problemumgehung: Fügen Sie einen Index hinzu, wie oben beschrieben.
• Szenario 2: Mehr als 5.000 Werte zurückgeben bei Verwendung eines OData-Filters. Problemumgehung: Entfernen Sie den OData-Filter, um die Rückgabe von mehr als 5.000 Werten zu ermöglichen, und filtern Sie dann in Studio (verwenden Sie z. B. eine Filter Data Table -Aktivität.

Hinweis:

Diese API-Beschränkung wirkt sich sowohl auf klassische Listenaktivitäten als auch auf die SharePoint-Listenaktivitäten aus.

Wie mit Personensuchfeldern gearbeitet wird

Ab Version 2.4.2 können Sie Personensuchfelder nach einer Komponente des Referenzwerts verwalten. Im Feld für den Personen-/Gruppentyp können Sie auch die E-Mail-Adresse der Person als String-Eingabe hinzufügen.

Beachten Sie, dass Person ein komplexer Typ mit mehreren Feldern ist. Wenn eine Zeichenfolgeneingabe empfangen wird, wird davon ausgegangen, dass sie die E-Mail-Adresse der Person und keine anderen Unterfelder oder IDs enthält.