Trabalhar com a ação de fluxo Enviar Pedido HTTP do SharePoint no Power Automate

No Power Automate, a ação de fluxo Enviar Pedido HTTP do SharePoint permite-lhe construir e executar consultas da API REST do SharePoint. Esta ação é particularmente útil nos casos em que as ações de fluxo do SharePoint existentes não processam os seus requisitos ou a ação que procura ainda não está disponível no conector do SharePoint.

Para trabalhar eficazmente com a ação Enviar Pedido HTTP do SharePoint, veja as seguintes sugestões.

Observação

Esta é uma ação focada no programador. Tem de compreender como funciona a API REST do SharePoint e também como analisar cadeias JSON no Power Automate.

Além disso, esta ação só suporta APIs REST do SharePoint (excluindo quaisquer APIs preteridas), se precisar de aceder a outro serviço Microsoft, terá de tirar partido do conector "HTTP com Microsoft Entra ID".

Conhecer as APIs REST/OData do SharePoint

O SharePoint tem muitas APIs. O foco aqui são as APIs REST/OData. Para obter o conjunto completo de APIs REST/OData, consulte Conhecer o serviço REST do SharePoint.

Embora, em alguns casos, possa utilizar as APIs REST do SharePoint 2010 (_vti_bin/listdata.svc), recomendamos que utilize as APIs REST/OData.

Utilizar luz JSON

As APIs REST/OData do SharePoint suportam luz JSON. Isto significa que pode definir cabeçalhos no pedido da API que informam o SharePoint se pretende incluir metadados na resposta. Em muitos casos, não precisa dos metadados. Os metadados simplificam a análise da saída da ação.

Para tal, basta adicionar o seguinte cabeçalho:

Accept: application/json; odata=nometadata

Analisar a resposta

Se executar um pedido GET, geralmente pretende analisar a resposta. A resposta predefinida é JSON, o que simplifica a execução.

Analise a resposta ao consultar o corpo da ação e, em seguida, analisar a matriz ou objeto JSON consoante a sua resposta.

Para tal, crie uma expressão:

body('Send_an_HTTP_request_to_SharePoint' )['Id']

Nos casos em que tem uma matriz, tem um objeto de matriz JSON. Pode utilizar a expressão anterior e, em seguida, construir uma aplicação a cada ação e utilizar a seguinte expressão para introduzir a variável para trabalhar com:

body('Send_an_HTTP_request_to_SharePoint' )['value']

Dentro da ação aplicar a cada ação, pode aceder aos elementos individuais com a seguinte expressão:

items('Apply_to_each')['Title']