Substituir receptores de eventos em soluções de área restrita

A abordagem que você adota para lidar com eventos no SharePoint é ligeiramente diferente no modelo de Suplemento do SharePoint do que era com Código de Confiança Total ou em soluções de área restrita codificada. Em soluções anteriores típicas, os receptores de eventos foram criados usando o Modelo de Objeto Server-Side do SharePoint e implantados por meio de pacotes de soluções, que executaram o código nos servidores do SharePoint.

No modelo de Suplemento do SharePoint, no entanto, a implementação do receptor de eventos é executada no servidor Web que está hospedando o receptor de eventos; são chamados de RERs (receptores de eventos remotos). Os receptores de eventos podem, em muitos casos, ser substituídos por uma implementação remota do receptor de eventos.

Este artigo descreve várias opções e considerações de design.

Observação

As soluções de área restrita baseadas em código foram preteridas em 2014, e o SharePoint Online iniciou o processo para remover completamente esse recurso. As soluções de área restrita baseadas em código também foram preteridas no SharePoint 2013 e no SharePoint 2016.

Opções para substituir receptores de eventos

Abordagem	Considerações de design e mais informações
Receptor de eventos remoto	Requer infraestrutura de hospedagem. A infraestrutura de hospedagem deve estar altamente disponível. O ponto de extremidade de serviço que hospeda o receptor de eventos remoto deve ser configurado para autenticação anônima. Requer um certificado confiável de terceiros se você estiver usando o SharePoint Online. Não se destina a operações de execução longa. Os receptores de eventos remotos anexados fora do contexto de suplementos, anexados usando um aplicativo de console ou PowerShell, não receberão um token de contexto do SharePoint quando invocados e você deve adiar para permissões de suplemento ou usar a classe SharePointOnlineCredentials. Não há mecanismo de repetição. Usar receptores de eventos remotos no SharePoint Como usar receptores de eventos remotos para seus suplementos do SharePoint Receptores de eventos e receptores de lista de eventos no modelo de suplemento do SharePoint Exemplo de suplemento do SharePoint de marcação automática Lidar com eventos nos suplementos do SharePoint
Webhooks	Exigir infraestrutura de hospedagem. A infraestrutura de hospedagem deve estar altamente disponível. Não dê suporte a eventos síncronos. Processar alterações após o evento. Não está disponível em builds locais do SharePoint neste momento. Visão geral de webhooks do SharePoint Introdução ao SharePoint Webhooks
Trabalho de temporizador remoto para monitorar alterações	Usa o objeto ChangeQuery para monitorar um site ou lista para modificações. Esse padrão é uma alternativa aos receptores de eventos remotos. Requer uma infraestrutura de hospedagem. Processa alterações após o evento. Usa um mecanismo de sondagem para processar alterações. Monitor de Alterações de Item da Lista do SharePoint (GitHub) Padrão de trabalho de temporizador remoto (GitHub)

Removendo o código de área restrita do seu site

Quando você desativa sua solução de área restrita existente de seus sites, todos os ativos ou arquivos implantados usando opções declarativas não são removidos. No entanto, os recursos na solução de área restrita são desativados automaticamente e o receptor de eventos é removido.

Confira também

• Transformar soluções de área restrita para o modelo de suplemento do SharePoint