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 folgenden Fehler fehl, wenn sie mit dem optionalen OData-Filter auf einer Liste dieser Größe verwendet werden:

"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 Indexes finden Sie in der Microsoft- Dokumentation.

Sie haben z. B. eine SharePoint-Liste mit drei Spalten: Title, FirstName und LastName. Sie möchten die Aktivität For Each List Item verwenden, um nach allen LastName- Werten zu filtern, die „Smith“ entsprechen.

1. Erstellen Sie einen Index für die Spalte „LastName“ in SharePoint. Dies ermöglicht der Microsoft Graph-API, eine performante Abfrage zu erstellen und zu vermeiden, dass ein Fehler zurückgegeben wird.
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: Zurückgeben von mehr als 5.000 Werten bei Verwendung eines OData-Filters. Problemumgehung: Entfernen Sie den OData-Filter, um eine Rückgabe von mehr als 5.000 Werten zu ermöglichen, und filtern Sie dann in Studio (z. B. mit einer Filter Data Table- Aktivität).

Hinweis: Diese API-Einschrä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.