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

Scenario: you have a SharePoint list that contains more than 5,000 items and want to use the For Each List Item and Get List Items activities.

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.

For example, you have a SharePoint list with three columns: Title, FirstName, and LastName. You want to use the For Each List Item activity to filter on all LastName values equal to "Smith".

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).

Note: This API limitation impacts both classic List activities and the SharePoint Lists activities.

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.