Pacote SharePoint

O pacote SharePoint inclui ações e um gatilho da Web que permite automatizar operações do SharePoint para gerenciar documentos, sites e dados.

Visão geral

As ações do SharePoint permitem que você execute operações de Criar, Ler, Atualizar e Excluir (CRUD) em sites do SharePoint. As seguintes ações de CRUD estão disponíveis no pacote SharePoint:

Para mais informações sobre os gatilhos do SharePoint, consulte Gatilhos da Web do SharePoint.

O pacote SharePoint usa conexão OAuth para autenticação. É necessário autenticar a automação utilizando a ação Autenticar antes de prosseguir com qualquer operação de CRUD. Para obter mais informações sobre como configurar a conexão OAuth, consulte Criar a conexão de OAuth.

Fluxo de trabalho do SharePoint

Nota:

A marca e o logotipo do SharePoint são marcas comerciais ou marcas registradas da Microsoft e são usados apenas para fins de identificação.


Fluxo de trabalho de pacotes do SharePoint

Permissões do aplicativo SharePoint

O pacote SharePoint se conecta a um domínio específico do SharePoint usando permissões baseadas em aplicativos. Você precisa configurar seu domínio do SharePoint e adicionar permissões de aplicativo relevantes. Para mais informações sobre as permissões do aplicativo SharePoint, consulte Configuração de domínio e sites do SharePoint.

Ações no pacote SharePoint

As seguintes ações estão disponíveis no pacote SharePoint:

Ação Descrição
Ação de autenticação do SharePoint Utilize a ação Autenticar para se conectar ao seu domínio do SharePoint. Depois que você estiver autenticado, poderá utilizar as demais ações de comando para executar diversas operações no SharePoint.
Pasta e arquivo do SharePoint Use as ações Pasta e arquivo para executar várias operações relacionadas a arquivos e pastas no site do SharePoint. Você pode criar, obter detalhes, excluir ou renomear pastas em um site específico do SharePoint. Você também pode fazer upload, excluir, baixar e obter arquivos em uma pasta específica.

O pacote SharePoint é compatível com a transmissão de arquivos. Use a ação Atribuir arquivo para criar uma variável de arquivo que armazena a transmissão de um arquivo do SharePoint. Você pode então usar essa variável de arquivo em quaisquer ações compatíveis com transmissões de arquivos. As ações Carregar arquivo, Carregar imagem da lista e Carregar anexo da lista agora aceitam uma variável de arquivo que contém uma transmissão de arquivo como entrada. Para obter mais informações sobre o suporte à transmissão de arquivos, consulte Transmissão de arquivo utilizando a variável de arquivo.

Lista e itens de lista do SharePoint Use as ações Lista e itens de lista para executar várias operações relacionadas a listas no site do SharePoint. Você pode criar, obter, excluir ou atualizar listas e itens de listas em um site específico do SharePoint.

APIs compatíveis

O pacote SharePoint oferece suporte tanto à REST v1 API do SharePoint quanto à REST API v2 do SharePoint, que é baseada na API do Microsoft Graph.

Você deve configurar o escopo de conexão OAuth com base na versão da API que deseja usar. Para a REST v1 API do SharePoint, use https://<tenant-id>/.default juntamente com outras permissões necessárias. Para a REST v2 API do SharePoint, use https://graph.microsoft.com/.default juntamente com outras permissões necessárias.

Nota: A REST API v2 do SharePoint oferece suporte apenas à versão on-line do SharePoint.

As seguintes ações não permitem operações baseadas na API do Microsoft Graph:

Nota: Essas ações estão indisponíveis devido a restrições da API do Microsoft Graph.
  • Carregar imagem da lista
  • Excluir anexo da lista
  • Baixar anexos da lista
  • Carregar anexo da lista

As seguintes ações têm restrições para operações baseadas na API do Microsoft Graph:

  • Excluir item da lista: essa ação não é compatível com a opção Excluir imagem.
  • Obter itens da lista: essa ação não é compatível com a opção Baixar colunas de imagem.
  • Criar item de lista e Atualizar item de lista: essas ações não oferecem suporte a tipos de coluna como Múltiplas linhas de texto com a opção Rich text com imagens, Pesquisa, Hiperlink, Imagem, Localização, Moeda com valor de cálculo, Pessoa ou grupo e Metadados gerenciados.

Solução de problemas

Se você encontrar problemas com quaisquer ações do SharePoint, execute as etapas de solução de problemas apropriadas:

Verificação de permissões
Verifique novamente suas permissões de usuário para garantir que você tenha o acesso necessário para trabalhar com o SharePoint na Control Room. Para mais informações sobre permissões, consulte Configuração de domínio e sites do SharePoint.
Teste de cliente API
Considere testar a operação usando um cliente API como o Postman. Isso pode ajudar a isolar o problema no ambiente da Control Room ou na sua configuração específica. Se funcionar no Postman, o problema provavelmente está na Control Room.
Detalhes do erro
Se você ainda encontrar problemas, compartilhar a mensagem de erro completa seria extremamente útil para diagnosticar melhor o problema. Detalhes adicionais como a versão do pacote do SharePoint, o tipo de implantação e o processo de criação do aplicativo também podem fornecer um contexto valioso.