Microsoft SharePoint Connector no Power Automate
No Power Automate, o Microsoft SharePoint Connector dá suporte aos gatilhos e ações de fluxo a seguir.
Gatilhos do SharePoint
Os gatilhos do SharePoint permitem criar fluxos que monitoram alterações em uma lista ou biblioteca do SharePoint. Se ocorrer uma ou mais alterações em uma lista inscrita, esse fluxo será disparado para ser executado.
Quando um item é criado
Dispara o fluxo quando você cria um item em uma lista do SharePoint.
Quando um item é criado ou modificado
Dispara o fluxo quando você cria um item e cada vez que o modifica em uma lista do SharePoint.
Quando um item ou um arquivo é modificado
Dispara o fluxo quando você modifica um item ou um arquivo em uma lista do SharePoint ou em uma biblioteca de documentos.
Para obter mais informações sobre como usar esse gatilho, confira este vídeo tutorial: Introdução a ação "quando um item ou arquivo modificado" e a ação "Obter alterações"
Quando um item é excluído
Dispara o fluxo quando você exclui um item em uma lista. Para obter as propriedades de um item excluído, você deve conectar esse gatilho ao site associado do SharePoint no qual ele deverá ser executado, usando uma conta de usuário de coleção de sites.
Para um item selecionado
Permite que usuários de listas acionem um fluxo depois de selecionar um item em uma lista.
Observação
Somente fluxos dentro do ambiente padrão podem ser executados manualmente a partir de uma lista do SharePoint.
Quando um arquivo é classificado por um modelo de compreensão de conteúdo
Dispara o fluxo quando um modelo de compreensão de conteúdo Microsoft Syntex classifica um arquivo, mostrado na propriedade data de classificação do arquivo.
Para obter mais informações sobre quando Microsoft Syntex e como classifica os arquivos, confira: Introdução à Microsoft Microsoft Syntex
Quando um arquivo é criado (somente propriedades)
Dispara o fluxo quando você cria um arquivo em uma biblioteca de documentos e retorna apenas as propriedades de arquivo personalizadas associadas a esse arquivo.
Quando um arquivo é criado em uma pasta [preterido]
Observação
Esse gatilho está preterido e pode não funcionar conforme o esperado.
Dispara o fluxo quando você cria um arquivo em uma pasta do SharePoint. Esse gatilho não será executado se você adicionar ou atualizar um arquivo em uma subpasta dentro da pasta em que esse gatilho está operando. Se o fluxo for necessário para disparar em subpastas, crie fluxos diferentes para uma ou mais subpastas.
Quando um arquivo é criado ou modificado (somente propriedades)
Dispara o fluxo quando você cria um arquivo e sempre que modifica as propriedades do arquivo em uma biblioteca. Especifique um valor na propriedade "Pasta" para direcionar uma pasta específica; caso contrário, o gatilho se aplica a toda a biblioteca. Retorna apenas as propriedades de arquivo personalizadas associadas a esse arquivo.
Quando um arquivo é criado ou modificado em uma pasta [preterido]
Observação
Esse gatilho está preterido e pode não funcionar conforme o esperado.
Dispara quando um arquivo é criado e também sempre que ele é modificado em uma pasta do SharePoint. O gatilho não será disparado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário disparar em subpastas, vários gatilhos devem ser criados.
Quando um arquivo é excluído
Dispara o fluxo quando você exclui um arquivo em uma biblioteca de documentos. Opcionalmente, você pode especificar uma pasta para watch. Quando você exclui uma pasta, o gatilho é ativado apenas uma vez para a pasta excluída, incluindo suas subpastas. Para obter as propriedades do arquivo excluído, você deve conectar esse gatilho ao site associado do SharePoint no qual o gatilho deverá ser executado, usando uma conta de usuário da coleção de sites.
Para um arquivo selecionado
Permite que usuários de bibliotecas de documentos acionem um fluxo depois de selecionar um arquivo.
Observação
Somente fluxos dentro do ambiente padrão podem ser executados manualmente a partir de uma biblioteca do SharePoint.
Quando um site tiver solicitado ingressar em um site do hub
Dispara um fluxo após a solicitação de aprovação de junção do site do hub.
Ações do SharePoint
Adicionar anexo
Adiciona um novo anexo ao item de lista especificado.
Aprovar solicitação de junção do site do hub
Aprova a solicitação de junção do site do hub. Essa ação retorna um token de aprovação para concluir a solicitação de junção, usando a ação do site do hub de junção.
Cancelar solicitação de ingressamento do site do hub
Cancela a solicitação de junção do hub. Se aplicável, especifique a mesma ID de Correlação de Aprovação usada na junção do site set do hub status à ação pendente.
Arquivo check-in
Verifica um arquivo de check-out em uma biblioteca de documentos, o que disponibiliza a versão do documento para outras pessoas.
Arquivo de check-out
Verifica um arquivo em uma biblioteca de documentos para impedir que outras pessoas editem o documento e suas alterações fiquem visíveis até que você marcar no documento.
Copiar arquivo
Copia um arquivo. Funciona de forma semelhante ao comando Copiar para em bibliotecas do SharePoint. Depois de copiar, retorna informações sobre o novo arquivo.
Copiar arquivo [preterido]
Observação
Essa ação está preterida e pode não funcionar conforme o esperado.
Copia um arquivo para um site do SharePoint.
Copiar pasta
Copia uma pasta. Funciona de forma semelhante ao comando Copiar para em bibliotecas do SharePoint. Depois de copiar, retorna informações sobre a nova pasta.
Criar arquivo
Carrega um arquivo em um site do SharePoint. Escolha uma biblioteca existente.
Criar item
Cria um novo item em uma lista do SharePoint.
Criar nova pasta
Cria uma nova pasta ou caminho de pasta.
Criar um link de compartilhamento para um arquivo ou pasta
Cria um link de compartilhamento para um arquivo ou pasta.
Excluir anexo
Exclui o anexo especificado.
Excluir arquivo
Exclui o arquivo especificado pelo identificador de arquivo.
Excluir item
Exclui um item de uma lista do SharePoint.
Descartar check-out
Descarta o checkout, em vez de salvar o arquivo, se você marcar um arquivo e não fizer alterações nele ou fizer alterações que não deseja manter. Se sua organização rastrear versões, uma nova versão será criada sempre que você marcar em um arquivo para a biblioteca. Ao descartar o check-out, você pode evitar fazer novas versões quando não tiver feito nenhuma alteração no arquivo.
Extrair pasta
Extrai um arquivo de arquivo em uma pasta do SharePoint (por exemplo, .zip).
Obter todas as listas e bibliotecas
Obtém todas as listas e bibliotecas.
Obter conteúdo de anexo
Retorna o conteúdo do arquivo, usando o identificador de arquivo. O conteúdo pode ser copiado em outro lugar ou ser usado como um anexo.
Obter anexos
Retorna a lista de anexos para o item de lista especificado. Para acessar o conteúdo do arquivo, adicione uma etapa Obter conteúdo de anexo e use a propriedade identificador de arquivo retornada por essa ação.
Obter alterações para um item ou um arquivo (somente propriedades)
Obtém todas as colunas ou propriedades do arquivo alteradas desde e até um intervalo de tempo especificado. Para alterar todas as colunas quando um item ou um arquivo é modificado:
- Use o quando um item ou arquivo é modificado gatilho e,
- Use o Token de Início da Janela de Gatilho & Disparar Saídas de Token de Extremidade da Janela do quando um item ou arquivo é modificado gatilho para inferir quais colunas foram alteradas desde a última vez que o fluxo foi verificado para atualizações de item ou arquivo.
Para obter mais informações sobre como usar essa ação, confira este vídeo tutorial: Introdução a ação 'quando um item ou arquivo modificado' dispara e 'Obter alterações'
Observação
- A lista ou biblioteca deve ter a versão configurada para inferir quais colunas ou propriedades foram modificadas desde a última alteração.
- Há suporte apenas para alterações de coluna para listas e bibliotecas.
- Não há suporte para alterações de conteúdo do arquivo.
- Não há suporte para alterações de anexo.
- O Token de Início da Janela de Gatilho & Token de Extremidade da Janela de Gatilho só está disponível quando você usa quando um item ou arquivo é modificado gatilho.
Obter conteúdo do arquivo
Obtém conteúdo de arquivo usando o identificador de arquivo. Você pode copiar o conteúdo em outro lugar ou usá-lo como um anexo.
Obter conteúdo do arquivo usando o caminho
Obtém o conteúdo do arquivo, usando o caminho do arquivo.
Obter metadados de arquivo
Obtém informações sobre o arquivo, como tamanho, etag, data criada e assim por diante. Usa um identificador de arquivo para selecionar o arquivo. Para acessar os valores armazenados nas colunas na biblioteca, use a ação Obter propriedades do arquivo .
Obter metadados de arquivo usando o caminho
Obtém informações sobre o arquivo, como tamanho, etag, data criada e assim por diante. Usa um caminho de arquivo para selecionar o arquivo. Para acessar os valores armazenados nas colunas na biblioteca, use a ação Obter propriedades do arquivo .
Obter propriedades de arquivo
Obtém as propriedades salvas nas colunas na biblioteca para o item especificado pela ID do item. Para acessar o conteúdo do arquivo, adicione uma etapa "Obter conteúdo de arquivo" e use a propriedade "Identificador de arquivo" retornada por essa ação. Ao usar isso com o Gateway de Dados Local, talvez seja necessário inserir manualmente o nome da biblioteca para se conectar.
Obter arquivos (somente propriedades)
Obtém as propriedades salvas nas colunas na biblioteca para todas as pastas e arquivos armazenados na biblioteca. Você também pode filtrar para baixo para os itens que correspondem a uma condição. Para trabalhar com a saída dessa ação, use a seção Aplicar a cada seção. Ao usar isso com o Gateway de Dados Local, talvez seja necessário inserir manualmente o nome da biblioteca para se conectar. Para obter mais informações sobre essa ação, confira: Análise detalhada em Obter itens e Obter arquivos ações do SharePoint para fluxos no Power Automate.
Obter metadados de pasta
Obtém informações sobre a pasta. Usa um identificador de arquivo para selecionar a pasta.
Obter metadados de pasta usando o caminho
Obtém informações sobre a pasta. Usa um caminho de pasta para selecionar a pasta.
Obter item
Obtém um único item por sua ID de uma lista do SharePoint.
Obter itens
Obtém itens de uma lista do SharePoint. Para obter mais informações sobre essa ação, confira: Análise detalhada em Obter itens e Obter arquivos ações do SharePoint para fluxos no Power Automate.
Obter exibições de lista
Obtém exibições de uma lista do SharePoint.
Obter listas
Obtém listas do SharePoint de um site.
Conceder acesso a um item ou a uma pasta
Concede acesso a um item ou uma pasta no SharePoint a pessoas específicas.
Site do hub de junção
Ingressa o site solicitado ao site do hub. Um Token de Aprovação é necessário para concluir a junção com êxito se esse hub exigir aprovação. Se aplicável, especifique a mesma ID de Correlação de Aprovação usada na junção do site set do hub status à ação pendente.
Pasta Lista
Retorna arquivos contidos em uma pasta do SharePoint.
Listar pasta raiz
Retorna arquivos na pasta raiz do SharePoint.
Mover arquivo
Move um arquivo. Funciona de forma semelhante ao comando Mover para em bibliotecas do SharePoint. Retorna informações sobre o novo arquivo após sua movimentação.
Mover pasta
Move uma pasta. Funciona de forma semelhante ao comando Mover para em bibliotecas do SharePoint. Retorna informações sobre a nova pasta após sua movimentação.
Resolver pessoa
Retorna um único valor de usuário correspondente para que ele possa ser atribuído a uma coluna de pessoa do tipo. Se não houver correspondências ou várias correspondências, essa ação será desaparecida.
Enviar uma solicitação HTTP para o SharePoint
Constrói uma API REST do SharePoint para invocar. Para obter mais informações sobre essa ação, consulte: Trabalhando com a ação de fluxo Enviar solicitação HTTP do SharePoint no Power Automate.
Importante
Essa ação pode executar qualquer API REST do SharePoint à qual você tenha acesso. Prossiga com cautela.
Set content approval status
Define o status de aprovação de conteúdo para um item em uma lista ou biblioteca com aprovação de conteúdo ativada. Você deve fornecer uma ETag para páginas e arquivos. Você pode obter o ETag usando a ação Obter metadados de arquivo. Essa ação só está disponível para SharePoint Online e SharePoint 2019.
Definir a junção do site do hub status à pendência
Define a solicitação de junção do hub solicitada status como pendente. A ID de Correlação de Aprovação é um parâmetro opcional que ajuda o SharePoint a identificar uma solicitação de junção de hub específica. O site de solicitação só pode ter uma solicitação pendente em um determinado momento.
Parar de compartilhar um item ou um arquivo
Exclui todos os links que dão acesso a um item ou arquivo e remove todas as pessoas com acesso direto, exceto os proprietários.
Atualizar arquivo
Atualizações o conteúdo do arquivo especificado pelo identificador de arquivo.
Atualizar propriedades do arquivo
Atualizações as propriedades armazenadas em colunas em uma biblioteca para o item especificado pela ID do item. Para atualizar o conteúdo do arquivo, use a ação Atualizar arquivo . Ao usar isso com o Gateway de Dados Local, talvez seja necessário inserir manualmente o nome da biblioteca para se conectar.
Atualizar item
Atualizações um item em uma lista do SharePoint.
Suporte para o SharePoint Server
As tabelas a seguir listam todas as ações e gatilhos com suporte para o SharePoint On-Premises 2013, 2016 ou 2019. Todas as ações ou gatilhos que não são mencionados não têm suporte.
Gatilhos com suporte
| Gatilho | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| Quando um arquivo é criado em uma pasta | Sim | Sim | Sim |
| Quando um arquivo é criado ou modificado em uma pasta | Sim | Sim | Sim |
| Quando um item é criado | Sim1 | Sim1 | Sim1 |
| Quando um item é criado ou modificado | Sim1 | Sim1 | Sim1 |
| Quando um arquivo é criado (somente propriedades) | Não | Não | Sim1 |
| Quando um arquivo é criado ou modificado (somente propriedades) | Não | Não | Sim1 |
| Quando um item é excluído | Não | Não | Sim2 |
| Quando um arquivo é excluído | Não | Não | Sim2 |
| Resolver Pessoa | Não | Não | Sim |
| Set content approval status | Não | Não | Sim |
Observação
- Não dá suporte a "Limitar colunas por exibição".
- Embora esse gatilho tenha suporte para o SharePoint 2019, os fluxos criados usando esse gatilho podem encontrar os seguintes problemas:
- Se não houver nenhuma atividade na lista por mais de 60 dias ou se houver alguma atividade, mas nenhum item for excluído por mais de 60 dias, o gatilho não será ativado.
- A exclusão de itens de lista pelo Usuário do Sistema ativará o gatilho.
Ações com suporte
| Ação | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| Obter metadados de arquivo | Sim | Sim | Sim |
| Obter metadados de arquivo usando o caminho | Sim | Sim | Sim |
| Obter metadados de pasta | Sim | Sim | Sim |
| Obter metadados de pasta usando o caminho | Sim | Sim | Sim |
| Obter conteúdo do arquivo | Sim | Sim | Sim |
| Criar arquivo | Sim1 | Sim1 | Sim1 |
| Atualizar arquivo | Sim | Sim | Sim |
| Copiar arquivo [preterido]2 | Sim | Sim | Sim |
| Pasta Lista | Sim | Sim | Sim |
| Extrair pasta | Sim | Sim | Sim |
| Obter anexos | Sim | Sim | Sim |
| Adicionar anexo | Sim | Sim | Sim |
| Excluir anexo | Sim | Sim | Sim |
| Obter itens | Sim3 | Sim3 | Sim3 |
| Obter item | Sim4 | Sim4 | Sim4 |
| Criar item | Sim4 | Sim4 | Sim4 |
| Atualizar item | Sim4 | Sim4 | Sim4 |
| Excluir item | Sim | Sim | Sim |
| Enviar uma solicitação HTTP para o SharePoint | Sim | Sim | Sim |
Observação
- Não dá suporte à criação de um arquivo grande carregando-o como um conjunto de partes.
- Esta ação inclui "[preterido]" em seu nome de exibição. A ação "Copiar arquivo" é diferente dessa ação.
- Essa ação só dá suporte a parâmetros OData, que exclui parâmetros como "Limitar entradas à pasta", "Incluir itens aninhados" e "Limitar colunas por exibição".
- Não dá suporte a "Limitar colunas por exibição".
Gatilhos e ações preteridos
Esses gatilhos são preteridos e não são mais mantidos ativamente. Embora ainda estejam presentes no Microsoft SharePoint Connector, recomendamos não utilizar gatilhos ou ações preteridos em novos aplicativos ou soluções.
| Nome | Tipo | Versão com suporte | Alternativa Sugerida |
|---|---|---|---|
| Quando um arquivo é criado em uma pasta [preterido] | Gatilho | SharePoint 2019 | Quando um arquivo é criado (somente propriedades) |
| Quando um arquivo é criado ou modificado em uma pasta [preterido] | Gatilho | SharePoint 2019 | Quando um arquivo é criado ou modificado (somente propriedades) |
| Copiar arquivo [preterido] | Ação | SharePoint 2019 | Copiar arquivo |
Limitações conhecidas
Modelos de biblioteca e lista com suporte
Os fluxos do Power Automate para listas só têm suporte em listas genéricas (100) e bibliotecas de documentos genéricas (101). Atualmente, não oferecemos suporte a modelos personalizados de lista e biblioteca, incluindo, mas não se limitando a, listas como Anúncios, Contatos e Tarefas.
Execuções de fluxo
Quando você cria um fluxo do Power Automate a ser disparado para um item ou para criar ou modificar um arquivo, o Power Automate verifica periodicamente se há alterações na lista ou biblioteca, configuradas no gatilho do fluxo. Na maioria dos casos, se houver uma única alteração na lista ou biblioteca, a execução de fluxo poderá ocorrer em poucos minutos após essa alteração. No entanto, espere que o fluxo possa reunir mais de uma alteração em execuções de fluxo subsequentes devido ao tempo entre o intervalo de fluxo desde sua última alteração válida ou edições subsequentes em um item ou um arquivo.
Mover arquivos e execuções de fluxo
Quando você move um ou mais arquivos de uma biblioteca de documentos para outra, o arquivo original é movido da biblioteca de origem para a biblioteca de destino. Mover o arquivo não altera nenhum metadado personalizado, inclusive quando o arquivo foi criado e modificado. Portanto, essa ação não dispara nenhum fluxo para essas atualizações de arquivo associadas à biblioteca para onde ela foi movida.
Sincronizando arquivos com suas bibliotecas de documentos do OneDrive for Business e do SharePoint
Quando os usuários sincronizam um ou mais arquivos de uma biblioteca de documentos para outro, o arquivo original é movido (sincronizado) do cliente para a biblioteca de destino. A sincronização do arquivo não alterará nenhum metadado personalizado, incluindo quando o arquivo foi criado e modificado. Portanto, essa ação não disparará nenhum fluxo para essas sincronizações de arquivo nessa biblioteca ou no OneDrive para empresas.
Colunas de pesquisa com suporte
Se sua lista/biblioteca tiver colunas de pesquisa, Obter itens e Obter ações de arquivos darão suporte ao retorno de itens com um máximo de 12 colunas de pesquisa. Se sua lista ou biblioteca exceder esse limite, o fluxo no Power Automate falhará.