Trabalhando com a ação de fluxo enviar solicitação HTTP do SharePoint no Power Automate

No Power Automate, a ação de fluxo enviar solicitação HTTP do SharePoint permite que você construa e execute consultas de API REST do SharePoint. Essa ação é particularmente útil nos casos em que as ações de fluxo existentes do SharePoint não lidam com seus requisitos ou a ação que você está procurando ainda não está disponível no conector do SharePoint.

Para trabalhar efetivamente com a ação Enviar solicitação HTTP do SharePoint, confira as dicas a seguir.

Observação

Essa é uma ação focada no desenvolvedor. Você deve entender como funciona a API REST do SharePoint e também como analisar cadeias de caracteres JSON no Power Automate.

Conheça 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, você possa usar as APIs REST do SharePoint 2010 (_vti_bin/listdata.svc), recomendamos usar APIs REST/OData.

Usar a luz JSON

As APIs REST/OData do SharePoint dão suporte à luz JSON. Isso significa que você pode definir cabeçalhos em sua solicitação de API que informam ao SharePoint se devem incluir quaisquer metadados na resposta. Em muitos casos, você não requer os metadados. Metadados tornam as coisas mais simples para analisar a saída da ação.

Para fazer isso, basta adicionar o seguinte cabeçalho:

Accept: application/json; odata=nometadata

Analisar a resposta

Se você executar uma solicitação GET, geralmente deseja analisar a resposta. A resposta padrão é JSON, tornando a execução mais simples.

Analise a resposta consultando o corpo da ação e analisando a matriz JSON ou o objeto, dependendo da resposta.

Para fazer isso, crie uma expressão:

body('Send_an_HTTP_request_to_SharePoint' )['Id']

Nos casos em que você tem uma matriz, você tem um objeto de matriz JSON. Você pode usar a expressão anterior e, em seguida, construir um aplicar a cada ação e usar a seguinte expressão para inserir a variável para trabalhar com:

body('Send_an_HTTP_request_to_SharePoint' )['value']

Dentro do aplicar a cada ação, você pode acessar os elementos individuais com a seguinte expressão:

items('Apply_to_each')['Title']