Häufig werden Daten von Geräten in der IoT-Infrastruktur einer Organisation gesendet, statt durch das IoT-System Abfragen externer Daten ausführen zu lassen. Eine Möglichkeit hierfür sind HTTP-POST-Anforderungen an einen Webserver. Der Feed "HTTP-Empfänger" in ArcGIS Velocity erstellt einen integrierten HTTP-Endpunkt, mit dem Daten von IoT-Geräten und Anwendungen programmgesteuert per HTTP-POST-Anforderungen an Velocity gesendet werden können.
Beispiele
Im Folgenden sehen Sie Beispiele für die Verwendung des Feeds "HTTP-Empfänger":
- In einer Organisation sind Geräte zum Senden von Daten per POST-Anforderung an einen angegebenen Velocity-HTTP-Endpunkt konfiguriert.
- Ein GIS-Analyst schreibt ein Python-Skript, das bei jeder Ausführung des Skripts Features verarbeitet und Daten per POST-Anforderung an einen angegebenenVelocity-HTTP-Endpunkt sendet.
Verwendungshinweise
Beachten Sie beim Arbeiten mit dem Feed "HTTP-Empfänger" Folgendes:
- HTTP-POST-Anforderungen sollten im Nur-Text-Format gesendet werden.
- Der Feed "HTTP-Empfänger", einschließlich der Angabe des Schemas und der Schlüsselfelder, wird vom Benutzer konfiguriert. Sobald der Feed erstellt wurde, ist die URL auf der Detailseite für den Feed der Pfad des HTTP-Endpunktes verfügbar. Dies ist die URL, an die Daten per HTTP-POST-Anforderung gesendet werden können.
- Setzen Sie den Parameter Authentifizierungstyp auf ArcGIS, um die OAuth 2.0-Authentifizierung zu verwenden. Jede eingehende Nachricht muss ein gültiges Token für den Besitzer des Feeds enthalten. Nachrichten ohne gültiges Token werden zurückgewiesen.
- Nachdem Sie die Feed-Verbindungsparameter konfiguriert haben, lesen Sie Konfigurieren von Eingabedaten, um zu erfahren, wie Sie das Schema und die Schlüsselfelder definieren.
Parameter
Nachfolgend werden die Parameter für den Feed "HTTP-Empfänger" beschrieben:
| Parameter | Erläuterung | Datentyp |
|---|---|---|
Pfad des HTTP-Endpunktes | Die vollständige URL, an die Nachrichten gesendet werden. Die URL wird von Velocity generiert und ausgefüllt, nachdem der Feed gestartet wurde. | Zeichenfolge |
Authentifizierungstyp | Legt den Authentifizierungstyp für eingehende Nachrichten fest. Die Optionen lauten Keine und ArcGIS. Wenn Keine angegeben ist, erfolgt keine Authentifizierung. Wenn ArcGIS angegeben ist, muss jede eingehende Nachricht ein gültiges Token für den Besitzer des Feeds enthalten. Nachrichten ohne gültiges Token werden zurückgewiesen. Das Token muss in den Anforderungsheadern als Authorization: Bearer <your token> angegeben werden. | Zeichenfolge |
Zusätzliche Protokollierung | Gibt an, ob die Protokollierung von unverarbeiteten HTTP-Anforderungen und -Antworten, die von Velocity ausgegeben werden, aktiviert ist. Hinweis:Aktivieren Sie diesen Parameter nur zur Problembehebung. Deaktivieren Sie ihn wieder nach Beendigung der Problembehebung. Nach der Aktivierung starten Sie den Feed. Die Debug-Protokolle sind anschließend auf der Seite "Feed-Protokolle" verfügbar. Wenden Sie sich an den technischen Support von Esri, falls Sie Unterstützung bei der Fehlerbehebung benötigen. | Boolesch |
Überlegungen und Beschränkungen
HTTP-Empfänger-Feeds, die die ArcGIS-Authentifizierung verwenden, können mit der Schreibberechtigung für andere Benutzer und Gruppen freigegeben werden. Wenn ein HTTP-Empfänger-Feed mit Schreibberechtigungen freigegeben wird, können die Benutzer und Gruppen, für die er freigegeben ist, Daten in den Feed schreiben. Geben Sie einen Feed nicht mit Schreibberechtigungen frei, wenn andere Benutzer und Gruppen keine Daten darin speichern sollen. Sie können Schreibberechtigungen auf der Seite mit den Feed-Details in Velocity aktivieren und deaktivieren. Weitere Informationen finden Sie unter Freigeben von Feeds.