In diesem Thema sind Fragen oder Probleme, die bei der Arbeit mit Webhooks auftreten können, und mögliche Lösungen aufgeführt.
ArcGIS Enterprise wird in einer nicht verbundenen Umgebung hinter der Firewall meiner Organisation bereitgestellt. Kann ich trotzdem Webhooks konfigurieren?
Ja. Um Webhooks zu konfigurieren, müssen Sie eine Payload-URL verwenden, die über Ihr ArcGIS Enterprise-Portal erreichbar ist. Dazu können Sie eine benutzerdefinierte Anwendung und auf Ihrem internen Server bereitstellen.
Wenn Sie Aktualisierungen für Ihre Portal-Elemente, Benutzer und Gruppen abonniert haben, wird Ihr Webhook ausgelöst, wenn deren Eigenschaften aktualisiert wurden. Wenn Sie beispielsweise Aktualisierungen für ein bestimmtes Element in Ihrem Portal abonniert haben, wird Ihr Webhook ausgelöst, sobald der Titel, die Tags oder die Miniaturansicht des Elements aktualisiert wurden. Der Netzwerkverkehr bietet Aufschluss darüber, ob eine Aktion eine Aktualisierung im Portal bewirkt. Jedes Mal, wenn eine Aktion zu einer Aktualisierung führt, kann diese Aktion auch einen Webhook auslösen, der auf Aktualisierungen wartet.
Was passiert, wenn meine Payload-URL ausfällt oder nicht mehr verfügbar ist? Gibt es eine Möglichkeit, eine Payload wiederherzustellen, die nicht übermittelt wurde?
Beim Einrichten von Organisations-Webhooks für Benutzer, Gruppen und Elemente haben Sie die Möglichkeit, erweiterte Parameter zu konfigurieren. Damit wird festgelegt, wie und wann das Portal einen weiteren Übermittlungsversuch unternimmt, wenn eine Payload nicht gesendet werden kann, und wie die Deaktivierungsrichtlinie lautet, mit der der Webhook deaktiviert wird, wenn das Senden einer Payload weiterhin fehlschlägt. Wenn das Portal versucht, eine Payload an einen nicht erreichbaren oder nicht reagierenden Payload-URL- oder Webhook-Empfänger zu übermitteln, bestimmen die von Ihnen festgelegten erweiterten Parameter, wie viele weitere Übermittlungsversuche das Portal für die Payload unternimmt. Wenn auch die weiteren Versuche fehlschlagen, zählen sie im Hinblick auf die Deaktivierungsrichtlinie als ein einzelner Fehler.
Sie können auch den Benachrichtigungsstatus eines Webhooks aufrufen, um alle Payload-Übermittlungsversuche anzuzeigen und herauszufinden, ob diese erfolgreich waren.
Hinweis:
Service-Webhooks unterstützen derzeit weder das Nachverfolgen von Payloads noch Deaktivierungsrichtlinien.
Hat es Auswirkungen auf meine Service-Webhooks, wenn ich Änderungen an meiner Enterprise-Site-Konfiguration vornehme?
Da Service-Webhooks in allen Hauptkomponenten einer ArcGIS Enterprise-Basisbereitstellung (ArcGIS Data Store, ArcGIS Server und Portal for ArcGIS) funktionieren und in Zusammenhang mit Hochverfügbarkeit und Notfallwiederherstellung stehen, weisen sie viele der Resilienzmuster der Komponenten auf. Einige Änderungen an der Enterprise-Bereitstellung, z. B. das Entfernen eines Computers aus der GIS Server-Site, kann zu einer Ausfallzeit von einigen Minuten führen, bevor die Service-Webhooks wieder ordnungsgemäß funktionieren. Um möglichst kurze Ausfallzeiten sicherzustellen, sollten Sie nach Änderungen an der Site Ihre Verbundserver neu validieren. In seltenen Fällen kann es erforderlich sein, den zugehörigen GIS-Service neu zu starten, damit ein Webhook wieder ordnungsgemäß funktioniert. Falls dieser Schritt erforderlich wird, wird in den Site-Protokollen eine Protokollmeldung der Ebene WARNUNG erfasst, um die Notwendigkeit eines Neustarts zu protokollieren.