Die Datenquelle "HTTP-Poller" in ArcGIS Velocity sendet eine HTTP-Anforderung an die angegebene URL. Hierdurch werden Daten erfasst, die in einem Webbrowser durch Aufrufen dieser URL abgerufen werden können.
Beispiel
Im Folgenden finden Sie einen beispielhaften Anwendungsfall für die Datenquelle:
Ein GIS-Analyst möchte in einer .csv-Datei auf einem Webserver gespeicherte Bezirks-Polygone in Velocity laden.
Verwendungshinweise
Beachten Sie beim Arbeiten mit der Datenquelle Folgendes:
- Nachdem Sie die Quellverbindungsparameter konfiguriert haben, konfigurieren Sie die Eingabedaten, um das Schema und die Schlüsselparameter zu definieren.
- Sowohl der Parameter URL-Parameter als auch der Parameter Benutzerdefinierte Header unterstützen globale Analysevariablen zum Planen von wiederkehrenden Big-Data-Analysen. Standardmäßig werden diese globalen Feed-Variablen in Epoch-Zeit konvertiert (Millisekunden seit 01. Januar 1970 UTC). In der folgenden Aufstellung sind die verfügbaren Analysevariablen mit der Angabe, welche Zeit sie darstellen, aufgeführt.
- $analytic.AnalyticLastScheduledStartTime: Der Zeitpunkt des planmäßigen Starts der letzten Ausführung der Analyse
- $analytic.AnalyticScheduledStartTime: Der Zeitpunkt des planmäßigen Starts der aktuellen Ausführung der Analyse
- $analytic.AnalyticLastEndTime: Der Zeitpunkt, an dem die letzte Ausführung der Analyse beendet wurde
- $analytic.AnalyticStartTime: Der Zeitpunkt, an dem die aktuelle Ausführung der Analyse gestartet wurde (der Unterschied zwischen dieser Variablen und $analytic.AnalyticScheduledStartTime ist die Startverzögerung.)
- Bei Verwendung der OAuth-Authentifizierung gilt Folgendes:
- Die Quelle "HTTP-Poller" unterstützt die Authentifizierung mit OAuth 2.0 für HTTP-Endpunkte, die mit den Gewährungstypen "Clientanmeldeinformationen" oder "Kennwort" arbeiten. Diese OAuth-Gewährungstypen folgen einem Muster, das die Konfiguration einer HTTP-Anforderung zum Abrufen eines Zugriffstoken beinhaltet. Dies erfolgt zusätzlich zu der Datenanforderung, die üblicherweise als Teil einer Quelle des Typs "HTTP-Poller" konfiguriert wird.
- Während der Konfiguration der Zugriffstokenanforderung werden Sie zur Angabe des Zugriffstoken aus der Antwort des OAuth-Autorisierungsservers aufgefordert.
- Wenn Sie zur Konfiguration der Datenanforderung zurückkehren, denken Sie daran, die globale $accessToken-Variable zur Angabe der Verwendung des Zugriffstokens zu verwenden. Dies erfolgt häufig in einem benutzerdefinierten Authorization-Header mit dem Wert Bearer $accessToken. $accessToken kann auch im POST-Text, in den URL-Parametern und der URL selbst (z. B. https://<<company.domain>>/$accessToken/<<method>>?<<url params>>) verwendet werden.
Parameter
Nachfolgend werden die Parameter für die Datenquelle beschrieben:
| Parameter | Beschreibung | Datentyp |
|---|---|---|
| URL | Die vollständige URL des extern zugänglichen HTTP-Endpunktes. Dieser Parameter unterstützt die globale Variable $accessToken. | Zeichenfolge |
| HTTP-Methode | Gibt die für den HTTP-Endpunkt verwendete HTTP-Methode an, entweder GET oder POST. Wenn POST ausgewählt ist, können Sie einen Nachrichtentext angeben. | Zeichenfolge |
| POST-Textkörper | Der beim Senden von POST-HTTP-Anforderungen aufzunehmende Nachrichtentext. Dies ermöglicht eine Auswahl zwischen x-www-form-urlencoded und sonstigen generischen Textinhaltstypen. Darüber hinaus wird mit ihm die Content-type-Kopfzeile festgelegt. Dieser Parameter trifft nur dann zu, wenn der Parameter HTTP-Methode auf POST festgelegt wurde. Dieser Parameter unterstützt die globale Variable $accessToken. | |
| Authentifizierung | Gibt den Typ der Authentifizierung an, die für den Zugriff auf den HTTP-Endpunkt verwendet wird. Die Optionen lauten Keine, Standard, Zertifikat und OAuth. | Zeichenfolge |
| Benutzername | Der Benutzername für den Zugriff auf den HTTP-Endpunkt. Dieser Parameter trifft nur dann zu, wenn der Parameter Authentifizierung auf Standard festgelegt ist. | Zeichenfolge |
| Kennwort | Das Kennwort für den Zugriff auf den HTTP-Endpunkt. Dieser Parameter trifft nur dann zu, wenn der Parameter Authentifizierung auf Standard festgelegt ist. | Kennwort |
| Zertifikat-URL | Die URL-Adresse des Clientzertifikats für den Zugriff auf den HTTP-Endpunkt. Dieser Parameter trifft nur dann zu, wenn der Parameter Authentifizierung auf Zertifikat festgelegt ist. | Zeichenfolge |
| Kennwort | Das Kennwort für das Clientzertifikat, sofern festgelegt. Dieser Parameter trifft nur dann zu, wenn der Parameter Authentifizierung auf Zertifikat festgelegt ist. | Kennwort |
| Benutzerdefinierte Header | Optionale benutzerdefinierte Header, die in die HTTP-Anforderung aufgenommen werden können, die an den angegebenen HTTP-Endpunkt gesendet wird. Mit benutzerdefinierten Headern kann beispielsweise ein API-Schlüssel oder Autorisierungsheader eines Drittanbieters angegeben werden. Dieser Parameter unterstützt globale Analyse- und $accessToken-Variablen. | Schlüssel/Wert-Paar |
| URL-Parameter | Optionale URL-Parameter, die in die URL der HTTP-Anforderung, die an den angegebenen HTTP-Endpunkt gesendet wird, aufgenommen werden sollen. Parameter können auch im Parameter URL festgelegt werden. Die hier eingegebenen URL-Parameter setzen aber alle entsprechenden Parameter, die für den Parameter URL angegeben wurden, außer Kraft. Hier definierte Parameter sind stets als URL codiert. Dieser Parameter unterstützt globale Analyse- und $accessToken-Variablen. | Schlüssel/Wert-Paar |
| Zusätzliche Protokollierung (optional) | Aktivieren Sie den Parameter Zusätzliche Protokollierung, um anzugeben, ob Sie unverarbeitete HTTP-Anforderungen und -Antworten protokollieren möchten, die von Velocity gesendet wird. Hinweis:Aktivieren Sie diesen Parameter zur Problembehebung. Deaktivieren Sie ihn wieder nach Beendigung der Problembehebung. Nach der Aktivierung starten Sie den Feed. Die Debug-Protokolle sind dann 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
Berücksichtigen Sie bei der Verwendung der Datenquelle Folgendes:
- Auf den HTTP-Endpunkt muss extern im Internet zugegriffen werden können.
- Die abgefragte HTTP-Antwort oder Datei darf nicht größer als 16 MB sein. Wenn die Größe der abgefragten Daten oder Datei 16 MB überschreitet, werden keine Features verbraucht.
- Bei Verwendung der OAuth-Authentifizierung gilt Folgendes:
- Beim Autorisieren gibt es mehrere Anforderungen an einen Autorisierungsserver und den zugehörigen Datenendpunkt. Einige APIs implementieren eine Ratenbegrenzung für bestimmte Anforderungen, was sich auf das Autorisieren des Feeds auswirken kann.
- Aus Sicherheitsgründen muss nach dem Bearbeiten der Authentifizierungsparameter der POST-Text des Zugriffstoken neu konfiguriert werden.
- Wenn eine URL für die Quelle "HTTP-Poller" angegeben ist und der Verbindungsversuch fehlschlägt, wird empfohlen, den Abschnitt Weitere Details in der Fehlermeldung zu überprüfen. Diese Informationen enthalten möglicherweise die unverarbeiteten Anforderungs- und Antwortdaten, die bei der Diagnose helfen und Aufschluss über die Ursache des Fehlers geben können.