Skip To Content

Perguntas mais frequentes sobre webhooks

Este tópico lista as perguntas ou problemas que você pode encontrar ao trabalhar com webhooks e sugere as possíveis soluções.

O ArcGIS Enterprise é desenvolvido em um ambiente desconectado atrás do Firewall da minha organização. Posso ainda configurar webhooks?

Sim. Para configurar webhooks, você deve usar uma URL de carga que pode ser acessada por seu portal. ArcGIS Enterprise. Para fazer isso, você pode construir um aplicativo personalizado e desenvolvê-lo em seu servidor interno.

O que constitui uma atualização de um item, usuário ou grupo?

Se você se inscreveu para receber atualizações de itens, usuários e grupos do portal, o webhook será acionado sempre que suas propriedades forem atualizadas. Por exemplo, se você se inscreveu para atualizações de um item específico em seu portal, seu webhook será acionado se uma atualização for feita no título, tags ou miniatura do item. Uma maneira de determinar se uma ação constitui uma atualização em seu portal é examinar o tráfego da rede. Sempre que uma ação resulta na chamada da operação Atualizar, essa mesma ação também pode acionar um webhook que está escutando atualizações.

Estou usando a Autenticação Integrada do Windows em meu portal do ArcGIS Enterprise. Posso ainda inscrever no usuário que está entrando e saindo do portal (user/<username>/signIn)?

A partir da versão 10.9, você pode usar o evento de ativador /signin para capturar eventos de entrada para autenticação do portal, autenticação de camada da web e logins enterprise.

O que acontece se minha URL de carga útil não funcionar ou se estar indisponível? Há uma forma para recuperar uma carga útil que não foi entregue?

Ao configurar webhooks de organização para seus usuários, grupos e itens, você tem a opção de configurar parâmetros avançados que determinam como e quando o portal tenta outra entrega quando uma carga falha no envio e uma política de desativação que desativará o webhook se as tentativas de entregar uma carga útil continuam a falhar. Se o portal realizar a tentativa de entregar uma carga útil para uma URL de carga inacessível ou não responsiva, ou receptor de webhook, os parâmetros avançados que você definir determinarão quantas tentativas adicionais o portal fará para entregar a carga útil. Se essas tentativas adicionais também falharem, isso contará como uma falha na política de desativação.

Você também pode visualizar o status de notificação do webhook para visualizar todas as tentativas de entregas de carga útil e determinar se eles foram entregues com sucesso ou não.

Anotação:

No momento, os webhooks de serviço não oferecem suporte para rastreamento de carga útil ou políticas de desativação.

Meus webhooks de serviço serão afetados se eu fizer alterações na configuração do meu site Enterprise?

Já que eles funcionam em todos os principais componentes de uma implantação de base doArcGIS Enterprise (ArcGIS Data Store, ArcGIS Server e Portal for ArcGIS), os webhooks de serviço herdaram muitos dos padrões de resiliência dos componentes relacionados à alta disponibilidade e à recuperação de desastres. Algumas alterações realizadas em sua implantação Enterprise, como remover uma máquina de um site de servidor GIS, podem resultar em alguns minutos de inatividade antes que seus webhooks de serviço retomem sua funcionalidade. Você pode reduzir a quantidade de tempo de inatividade que ocorre revalidando seus servidores federados após realizar alterações no site. Em casos raros, pode ser necessário reiniciar o serviço GIS relacionado para retomar a funcionalidade de um webhook. Se esta etapa for necessária, uma mensagem do log de nível AVISO indicando a necessidade de reiniciar o serviço será registrada nos logs do site.


Neste tópico