Gatilhos da Web do SharePoint
- Última atualização2025/10/16
Gatilhos da Web do SharePoint
Os gatilhos da Web do SharePoint permitem monitorar um site do SharePoint em busca de eventos. Você pode configurar ações que são ativadas quando o evento monitorado ocorre no site do SharePoint.
Visão geral
Os gatilhos da Web do SharePoint permitem iniciar um fluxo de automação com base nos eventos assinados. Configure o gatilho da Web SharePoint para monitorar os eventos assinados. Quando o evento ocorre no site do SharePoint, o gatilho ativa o fluxo de trabalho de automação subsequente. Os gatilhos da Web do SharePoint permitem criar automações sem qualquer intervenção manual, com troca de dados em tempo real.
Eventos compatíveis
Você pode configurar os gatilhos da Web do SharePoint para monitorar eventos em arquivos, pastas e listas. Os gatilhos da Web do SharePoint são compatíveis com os eventos a seguir.
| Eventos | Descrição |
|---|---|
| Arquivo criado | Quando um arquivo é criado no site do SharePoint monitorado. |
| Arquivo atualizado | Quando um arquivo é atualizado no site do SharePoint monitorado. |
| Pasta criada | Quando uma pasta é criada no site do SharePoint monitorado. |
| Pasta atualizada | Quando uma pasta é criada no site do SharePoint monitorado. |
| Item de lista criado | Quando um item é adicionado a uma lista no site do SharePoint monitorado. |
| Item da lista atualizado | Quando um item de lista existente é atualizado no site do SharePoint monitorado. |
Pré-requisitos
Certifique-se de que os seguintes pré-requisitos sejam atendidos:
- Uma licença de Bot Creator ou desenvolvedor cidadão.
- Permissões de ACIONADORES DE EVENTOS e Exibir meus bots.
- Permissão de Fazer checkin e Fazer checkout nas pastas onde a automação está localizada.
- Uma conexão OAuth ativa para o site do SharePoint.
Configurações
- SharePoint OAuth
- A opção SharePoint OAuth permite que você selecione a conexão OAuth configurada. Certifique-se de adicionar a permissão do Microsoft Graph ao escopo de conexão OAuth. O escopo do Microsoft Graph permite que o gatilho leia a biblioteca de documentos do SharePoint para eventos relacionados a arquivos e pastas e leia as listas do SharePoint para eventos relacionados a listas.
- Site
- A opção Site permite que você configure o site do SharePoint monitorado para eventos. Você pode digitar o link diretamente ou usar a opção Selecionar site para selecionar o site na lista suspensa Sites. A lista suspensa Sites é conectada ao site do SharePoint e lista todos os sites dentro do subdomínio.
- Tipo de evento
- A opção Tipo de evento permite que você configure os eventos nos quais o gatilho ativa as ações de automação subsequentes. Você pode configurar o gatilho com base em Arquivo e pasta ou Lista.
- Resposta
- A opção Resposta permite capturar os dados da resposta do gatilho em uma variável de registro. Você pode criar uma variável de registro ou selecionar uma existente para capturar os dados de resposta. A variável de registro captura as informações do corpo da resposta da API no formato de pares de chave-valor.
Leitura de dados de resposta de gatilho no log de auditoria
Os dados de resposta do gatilho contêm todas as informações dos eventos nos quais a alteração ocorreu. Os dados de carga útil do evento são gerados usando as propriedades de recurso das APIs SharePoint no Microsoft Graph. Os dados. Você pode visualizar os dados, armazenados em um par de chave-valor, na página Log de auditoria. Para obter mais informações sobre os dados de carga útil do evento do SharePoint, consulte Working with SharePoint sites in Microsoft Graph.
Você pode usar os atributos de dados da carga útil do evento capturados no Log de auditoria como entradas para quaisquer ações subsequentes dentro da sessão. Você também pode criar os argumentos para os atributos a partir das propriedades do tipo de recurso API das APIs do SharePoint no Microsoft Graph. Por exemplo, para visualizar o caminho da pasta em que um arquivo é criado, você pode usar parentReference.path, onde parentReference é das propriedades de recurso BaseItem e path é das propriedades de recurso itemReference.