Conector do Microsoft SharePoint no Power Automate
No Power Automate, o Microsoft SharePoint Connector suporta os seguintes acionadores e ações de fluxo.
Acionadores do SharePoint
Os acionadores do SharePoint permitem-lhe criar fluxos que monitorizam as alterações numa lista ou biblioteca do SharePoint. Se uma ou mais alterações ocorrerem numa lista subscrita, esse fluxo é acionado para ser executado.
Quando um item é criado
Aciona o fluxo quando cria um item numa lista do SharePoint.
Quando um item é criado ou modificado
Aciona o fluxo quando cria um item e cada vez que o modifica numa lista do SharePoint.
Quando um item ou um ficheiro é modificado
Aciona o fluxo quando modifica um item ou um ficheiro numa lista do SharePoint ou numa biblioteca de documentos.
Para obter mais informações sobre como utilizar este acionador, veja este vídeo de tutorial: Introdução ao acionador "quando um item ou ficheiro modificado" e a ação "Obter alterações"
Quando um item é eliminado
Aciona o fluxo quando elimina um item numa lista. Para obter as propriedades de um item eliminado, tem de ligar este acionador ao site do SharePoint associado no qual se espera que seja executado, utilizando uma conta de administrador da coleção de sites.
Para um item selecionado
Permite que os utilizadores de listas acionem um fluxo depois de selecionar um item numa lista.
Observação
Apenas os fluxos no ambiente predefinido podem ser executados manualmente a partir de uma lista do SharePoint.
Quando um ficheiro é classificado por um modelo de compreensão de conteúdos
Aciona o fluxo quando um Microsoft Syntex modelo de compreensão de conteúdos classifica um ficheiro, mostrado na propriedade de data de classificação do ficheiro.
Para obter mais informações sobre quando Microsoft Syntex e como classifica ficheiros, consulte: Introdução ao Microsoft Microsoft Syntex
Quando um ficheiro é criado (apenas propriedades)
Aciona o fluxo quando cria um ficheiro numa biblioteca de documentos e devolve apenas as propriedades de ficheiro personalizadas associadas a esse ficheiro.
Quando um ficheiro é criado numa pasta [preterido]
Observação
Este acionador foi preterido e pode não funcionar conforme esperado.
Aciona o fluxo quando cria um ficheiro numa pasta do SharePoint. Este acionador não é executado se adicionar ou atualizar um ficheiro numa subpasta dentro da pasta em que este acionador está a funcionar. Se o fluxo for necessário para acionar em subpastas, crie fluxos diferentes para uma ou mais subpastas.
Quando um ficheiro é criado ou modificado (apenas propriedades)
Aciona o fluxo quando cria um ficheiro e, sempre que modificar as propriedades do ficheiro numa biblioteca. Especifique um valor na propriedade "Pasta" para direcionar uma pasta específica; caso contrário, o acionador aplica-se a toda a biblioteca. Devolve apenas as propriedades de ficheiro personalizadas associadas a esse ficheiro.
Quando um ficheiro é criado ou modificado numa pasta [preterido]
Observação
Este acionador foi preterido e pode não funcionar conforme esperado.
Aciona quando um ficheiro é criado e também sempre que é modificado numa pasta do SharePoint. O acionador não é acionado se um ficheiro for adicionado/atualizado numa subpasta. Se for necessário acionar em subpastas, devem ser criados vários acionadores.
Quando um ficheiro é eliminado
Aciona o fluxo quando elimina um ficheiro numa biblioteca de documentos. Opcionalmente, pode especificar uma pasta para watch. Quando elimina uma pasta, o acionador é ativado apenas uma vez para a pasta eliminada, incluindo as respetivas subpastas. Para obter as propriedades do ficheiro eliminado, tem de ligar este acionador ao site do SharePoint associado no qual se espera que o acionador seja executado, utilizando uma conta de administrador da coleção de sites.
Para um ficheiro selecionado
Permite que os utilizadores de bibliotecas de documentos acionem um fluxo depois de selecionar um ficheiro.
Observação
Apenas os fluxos no ambiente predefinido podem ser executados manualmente a partir de uma biblioteca do SharePoint.
Quando um site tiver pedido para aderir a um site hub
Aciona um fluxo no pedido de aprovação de associação ao site do hub.
Ações do SharePoint
Adicionar anexo
Adiciona um novo anexo ao item de lista especificado.
Aprovar pedido de associação ao site hub
Aprova o pedido de associação ao site do hub. Esta ação devolve um token de aprovação para concluir o pedido de associação com a ação do site do hub de associação.
Cancelar pedido de associação ao site do hub
Cancela o pedido de associação ao hub. Se aplicável, especifique o mesmo ID de Correlação de Aprovação utilizado na ação Definir associação ao site do hub status a ação pendente.
Dar entrada do ficheiro
Dá entrada de um ficheiro com saída dada numa biblioteca de documentos, o que torna a versão do documento disponível para outras pessoas.
Dar saída do ficheiro
Dá saída de um ficheiro numa biblioteca de documentos para impedir que outras pessoas editem o documento e as suas alterações fiquem visíveis até marcar no documento.
Copiar ficheiro
Copia um ficheiro. Funciona de forma semelhante ao comando Copiar para nas bibliotecas do SharePoint. Depois de copiar, devolve informações sobre o novo ficheiro.
Copiar ficheiro [preterido]
Observação
Esta ação foi preterida e poderá não funcionar conforme esperado.
Copia um ficheiro para um site do SharePoint.
Copiar pasta
Copia uma pasta. Funciona de forma semelhante ao comando Copiar para nas bibliotecas do SharePoint. Depois de copiar, devolve informações sobre a nova pasta.
Criar ficheiro
Carrega um ficheiro para um site do SharePoint. Certifique-se de que escolhe uma biblioteca existente.
Criar item
Cria um novo item numa lista do SharePoint.
Criar nova pasta
Cria um novo caminho de pasta ou pasta.
Criar ligação de partilha para um ficheiro ou pasta
Cria uma ligação de partilha para um ficheiro ou pasta.
Excluir anexo
Elimina o anexo especificado.
Eliminar ficheiro
Elimina o ficheiro especificado pelo identificador de ficheiro.
Excluir item
Elimina um item de uma lista do SharePoint.
Eliminar finalização da compra
Elimina a finalização da compra, em vez de guardar o ficheiro, se marcar um ficheiro e não fizer alterações ao mesmo ou efetuar alterações que não pretende manter. Se a sua organização controlar as versões, é criada uma nova versão sempre que marcar num ficheiro para a biblioteca. Ao eliminar a finalização da compra, pode evitar criar novas versões quando não tiver efetuado alterações ao ficheiro.
Extrair pasta
Extrai um ficheiro de arquivo para 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
Devolve o conteúdo do ficheiro com o identificador de ficheiro. Os conteúdos podem ser copiados noutro local ou utilizados como anexo.
Obter anexos
Devolve a lista de anexos do item de lista especificado. Para aceder ao conteúdo do ficheiro, adicione um passo Obter conteúdo de anexo e utilize a propriedade Identificador de ficheiro devolvida por esta ação.
Obter alterações para um item ou ficheiro (apenas propriedades)
Obtém todas as colunas ou propriedades do ficheiro alteradas desde e até um intervalo de tempo especificado. Para alterar todas as colunas quando um item ou um ficheiro é modificado:
- Utilize o acionador quando um item ou ficheiro é modificado e,
- Utilize o Token de Início da Janela de Acionador & acionar saídas do Token de Fim da Janela do acionador quando um item ou ficheiro é modificado para inferir as colunas alteradas desde a última vez que o fluxo foi verificado relativamente a atualizações de itens ou ficheiros.
Para obter mais informações sobre como utilizar esta ação, veja este vídeo de tutorial: Introdução ao acionador "quando um item ou ficheiro modificado" e a ação "Obter alterações"
Observação
- A lista ou biblioteca deve ter o controlo de versões configurado para inferir que colunas ou propriedades foram modificadas desde a última alteração.
- Apenas as alterações de colunas são suportadas para listas e bibliotecas.
- As alterações ao conteúdo do ficheiro não são suportadas.
- As alterações de anexo não são suportadas.
- O Token de Início da Janela de Acionador & o Token de Fim da Janela do Acionador só estão disponíveis quando utiliza quando um item ou ficheiro é modificado .
Obter conteúdo do ficheiro
Obtém o conteúdo do ficheiro com o identificador de ficheiro. Pode copiar os conteúdos noutro local ou utilizá-lo como anexo.
Obter conteúdo de ficheiro com o caminho
Obtém o conteúdo do ficheiro através do caminho do ficheiro.
Obter metadados de ficheiro
Obtém informações sobre o ficheiro, como tamanho, etag, data de criação, etc. Utiliza um identificador de ficheiro para selecionar o ficheiro. Para aceder aos valores armazenados nas colunas na biblioteca, utilize a ação Obter propriedades do ficheiro .
Obter metadados de ficheiro com o caminho
Obtém informações sobre o ficheiro, como tamanho, etag, data de criação, etc. Utiliza um caminho de ficheiro para selecionar o ficheiro. Para aceder aos valores armazenados nas colunas na biblioteca, utilize a ação Obter propriedades do ficheiro .
Obter propriedades do ficheiro
Obtém as propriedades guardadas nas colunas na biblioteca do item especificado pelo ID do item. Para aceder ao conteúdo do ficheiro, adicione um passo "Obter conteúdo de ficheiro" e utilize a propriedade "Identificador de ficheiro" devolvida por esta ação. Ao utilizar esta opção com o Gateway de Dados no Local, poderá ter de introduzir manualmente o nome da biblioteca à qual se ligar.
Obter ficheiros (apenas propriedades)
Obtém as propriedades guardadas nas colunas na biblioteca para todas as pastas e ficheiros armazenados na biblioteca. Também pode filtrar os itens que correspondem a uma condição. Para trabalhar com o resultado desta ação, utilize a secção Aplicar a cada . Ao utilizar esta opção com o Gateway de Dados no Local, poderá ter de introduzir manualmente o nome da biblioteca à qual se ligar. Para obter mais informações sobre esta ação, consulte: Análise aprofundada em Obter itens e Obter ficheiros Ações do SharePoint para fluxos no Power Automate.
Obter metadados de pastas
Obtém informações sobre a pasta. Utiliza um identificador de ficheiro para selecionar a pasta.
Obter metadados de pastas com o caminho
Obtém informações sobre a pasta. Utiliza um caminho de pasta para selecionar a pasta.
Obter item
Obtém um único item pelo respetivo ID a partir de uma lista do SharePoint.
Obter itens
Obtém itens de uma lista do SharePoint. Para obter mais informações sobre esta ação, consulte: Análise aprofundada em Obter itens e Obter ficheiros Ações do SharePoint para fluxos no Power Automate.
Obter vistas de lista
Obtém vistas de uma lista do SharePoint.
Obter listas
Obtém listas do SharePoint a partir de um site.
Conceder acesso a um item ou pasta
Concede acesso a um item ou pasta no SharePoint a pessoas específicas.
Aderir ao site hub
Associa o site pedido ao site do hub. É necessário um Token de Aprovação para concluir a associação com êxito se esse hub necessitar de aprovação. Se aplicável, especifique o mesmo ID de Correlação de Aprovação utilizado na ação Definir associação ao site do hub status a ação pendente.
Listar pasta
Devolve ficheiros contidos numa pasta do SharePoint.
Listar pasta raiz
Devolve ficheiros na pasta raiz do SharePoint.
Mover ficheiro
Move um ficheiro. Funciona de forma semelhante ao comando Mover para nas bibliotecas do SharePoint. Devolve informações sobre o novo ficheiro após a respetiva movimentação.
Mover pasta
Move uma pasta. Funciona de forma semelhante ao comando Mover para nas bibliotecas do SharePoint. Devolve informações sobre a nova pasta após a respetiva movimentação.
Resolver pessoa
Devolve um único valor de utilizador correspondente para que possa ser atribuído a uma coluna do tipo person. Se não existirem correspondências ou múltiplas correspondências, esta ação é efetuar erros.
Enviar um pedido HTTP para o SharePoint
Constrói uma API REST do SharePoint para invocar. Para obter mais informações sobre esta ação, consulte: Trabalhar com a ação de fluxo Enviar Pedido HTTP do SharePoint no Power Automate.
Importante
Esta ação pode executar qualquer API REST do SharePoint à qual tenha acesso. Continue com cuidado.
Set content approval status
Define a status de aprovação de conteúdo para um item numa lista ou biblioteca que tenha a aprovação de conteúdo ativada. Tem de fornecer uma ETag para páginas e ficheiros. Pode obter a ETag com a ação Obter Metadados de Ficheiro. Esta ação só está disponível para o SharePoint Online e o SharePoint 2019.
Definir status de associação ao site do hub como pendente
Define o pedido de associação ao hub do site pedido status pendente. O ID de Correlação de Aprovação é um parâmetro opcional que ajuda o SharePoint a identificar um pedido de associação a um hub específico. O site requerente só pode ter um pedido pendente num determinado momento.
Parar de partilhar um item ou um ficheiro
Elimina todas as ligações que dão acesso a um item ou ficheiro e remove todas as pessoas com acesso direto, exceto os proprietários.
Atualizar ficheiro
Atualizações o conteúdo do ficheiro especificado pelo identificador de ficheiro.
Atualizar propriedades do ficheiro
Atualizações as propriedades armazenadas em colunas numa biblioteca para o item especificado pelo ID do item. Para atualizar o conteúdo do ficheiro, utilize a ação Atualizar ficheiro . Ao utilizar esta opção com o Gateway de Dados no Local, poderá ter de introduzir manualmente o nome da biblioteca à qual se ligar.
Atualizar item
Atualizações um item numa lista do SharePoint.
Suporte para o SharePoint Server
As tabelas seguintes listam todas as ações e acionadores suportados no SharePoint On-Premises 2013, 2016 ou 2019. Quaisquer ações ou acionadores que não sejam mencionados não são suportados.
Acionadores suportados
| Gatilho | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| Quando um ficheiro é criado numa pasta | Sim | Sim | Sim |
| Quando um ficheiro é criado ou modificado numa pasta | Sim | Sim | Sim |
| Quando um item é criado | Sim1 | Sim1 | Sim1 |
| Quando um item é criado ou modificado | Sim1 | Sim1 | Sim1 |
| Quando um ficheiro é criado (apenas propriedades) | Não | Não | Sim1 |
| Quando um ficheiro é criado ou modificado (apenas propriedades) | Não | Não | Sim1 |
| Quando um item é eliminado | Não | Não | Sim2 |
| Quando um ficheiro é eliminado | 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 suporta "Limitar Colunas por Vista".
- Embora este acionador seja suportado para o SharePoint 2019, os fluxos criados com este acionador podem encontrar os seguintes problemas:
- Se não existir atividade na lista durante mais de 60 dias ou se existir alguma atividade, mas não forem eliminados itens durante mais de 60 dias, o acionador não será ativado.
- A eliminação de itens de lista pelo Utilizador de Sistema ativará o acionador.
Ações suportadas
| Ação | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| Obter metadados de ficheiro | Sim | Sim | Sim |
| Obter metadados de ficheiro com o caminho | Sim | Sim | Sim |
| Obter metadados de pastas | Sim | Sim | Sim |
| Obter metadados de pastas com o caminho | Sim | Sim | Sim |
| Obter conteúdo do ficheiro | Sim | Sim | Sim |
| Criar ficheiro | Sim1 | Sim1 | Sim1 |
| Atualizar ficheiro | Sim | Sim | Sim |
| Copiar ficheiro [preterido]2 | Sim | Sim | Sim |
| Listar pasta | 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 um pedido HTTP para o SharePoint | Sim | Sim | Sim |
Observação
- Não suporta a criação de um ficheiro grande ao carregá-lo como um conjunto de segmentos.
- Esta ação inclui "[preterido]" no respetivo nome a apresentar. A ação "Copiar ficheiro" é diferente desta ação.
- Esta ação só suporta parâmetros OData, que excluem parâmetros como "Limitar Entradas a Pasta", "Incluir Itens Aninhados" e "Limitar Colunas por Vista".
- Não suporta "Limitar Colunas por Vista".
Acionadores e ações preteridos
Estes acionadores são preteridos e já não são mantidos ativamente. Embora ainda estejam presentes no Conector do Microsoft SharePoint, recomendamos que não utilize acionadores ou ações preteridos em novas aplicações ou soluções.
| Nome | Tipo | Versão Suportada | Alternativa Sugerida |
|---|---|---|---|
| Quando um ficheiro é criado numa pasta [preterido] | Gatilho | SharePoint 2019 | Quando um ficheiro é criado (apenas propriedades) |
| Quando um ficheiro é criado ou modificado numa pasta [preterido] | Gatilho | SharePoint 2019 | Quando um ficheiro é criado ou modificado (apenas propriedades) |
| Copiar ficheiro [preterido] | Ação | SharePoint 2019 | Copiar ficheiro |
Limitações conhecidas
Modelos de lista e biblioteca suportados
Os fluxos do Power Automate para listas só são suportados em listas genéricas (100) e bibliotecas de documentos genéricas (101). Atualmente, não suportamos listas personalizadas e modelos de biblioteca, incluindo, entre outros, listas como Anúncios, Contactos e Tarefas.
Execuções de fluxo
Quando cria um fluxo do Power Automate para ser acionado para um item ou para criar ou modificar um ficheiro, o Power Automate verifica periodicamente a existência de alterações na lista ou biblioteca, configuradas no acionador do fluxo. Na maioria dos casos, se existir uma única alteração na lista ou biblioteca, a execução do fluxo poderá ocorrer poucos minutos depois dessa alteração. No entanto, espere que o fluxo possa recolher mais do que uma alteração nas execuções de fluxo subsequentes devido ao tempo entre o intervalo de fluxo desde a última alteração válida ou às edições subsequentes a um item ou ficheiro.
Mover ficheiros e execuções de fluxos
Quando move um ou mais ficheiros de uma biblioteca de documentos para outra, o ficheiro original é movido da biblioteca de origem para a biblioteca de destino. Mover o ficheiro não altera metadados personalizados, incluindo quando o ficheiro foi criado e modificado. Por conseguinte, esta ação não aciona fluxos para essas atualizações de ficheiros associadas à biblioteca para onde foi movida.
Sincronizar ficheiros com a sua OneDrive for Business e bibliotecas de documentos do SharePoint
Quando os utilizadores sincronizam um ou mais ficheiros de uma biblioteca de documentos para outra, o ficheiro original é movido (sincronizado) do cliente para a biblioteca de destino. Sincronizar o ficheiro não alterará quaisquer metadados personalizados, incluindo quando o ficheiro foi criado e modificado. Por conseguinte, esta ação não acionará fluxos para essas sincronizações de ficheiros nessa biblioteca ou no seu OneDrive para empresas.
Colunas de pesquisa suportadas
Se a sua lista/biblioteca tiver colunas de pesquisa, as ações Obter itens e Obter ficheiros suportam a devolução de itens com um máximo de 12 colunas de pesquisa. Se a sua lista ou biblioteca exceder este limiar, o fluxo no Power Automate falhará.