Trabalho com listas do SharePoint

Sobre

Esta seção descreve como trabalhar, filtrar e iterar por meio de listas do SharePoint.

Como trabalhar com listas grandes do SharePoint

Cenário: você tem uma lista do SharePoint com mais de 5.000 itens e deseja usar as atividades For Each List Item e Get List Items .

Devido a limitações na API subjacente do Microsoft Graph, se essas atividades forem usadas com o filtro OData opcional em uma lista desse tamanho, elas falharão, com o seguinte erro:

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

Solução

Adicione índices de coluna na lista do SharePoint para as colunas que você planeja usar no filtro OData opcional. Para obter informações sobre como adicionar um índice, consulte a documentação da Microsoft.

Por exemplo, você tem uma lista do SharePoint com três colunas: Título, Nome e Sobrenome. Você deseja usar a atividade For Each List Item para filtrar em todos os valores de Sobrenome iguais a "Smith".

1. Crie um índice na coluna Sobrenome no SharePoint. Isso permite que a API do Microsoft Graph faça uma consulta com bom desempenho e evite retornar um erro.
2. Defina o filtro OData nas atividades UiPath como "fields/LastName eq 'Smith'", para executar a função descrita. Dessa forma, não ocorre erro, mesmo que a lista seja maior que 5.000 itens.

Limitações

Mesmo com a indexação, a API do Graph não retornará com sucesso se o número de resultados a serem retornados for maior que 5.000.

• Cenário 1: retornar menos de 5.000 valores durante o uso de um filtro OData. Solução alternativa: adicione um índice, conforme descrito acima.
• Cenário 2: retornar mais de 5.000 valores, enquanto usa um filtro OData. Solução alternativa: remova o filtro OData para permitir o retorno de mais de 5.000 valores e, em seguida, filtre no Studio (por exemplo, use uma atividade Filter Data Table ).

Observação: essa limitação da API afeta tanto as atividades de lista clássicas quanto as atividades de listas do SharePoint.

Como trabalhar com campos de pesquisa de pessoa

A partir da versão 2.4.2, você pode gerenciar campos de pesquisa pessoal por um componente do valor de referência. No campo Tipo de pessoa/grupo, você também pode adicionar o e-mail da pessoa como entrada de string.

Observe que Pessoa é um tipo complexo com vários campos. Se uma entrada de string for recebida, assume-se que contém o endereço de e-mail da pessoa e nenhum outro subcampo ou ID.