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
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 HTTP-Poller-Datenausgabe 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.
- In der Konfiguration der Datenanforderung müssen Sie die globale Variable $accessToken verwenden, um zu definieren, wo das Zugriffstoken verwendet werden soll. 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 HTTP-Poller-Ausgabe 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 globale Analyse- und $accessToken-Variablen. | Zeichenfolge |
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. Parameter, die hier definiert werden, sind stets als URL codiert. Dieser Parameter unterstützt globale Analyse- und $accessToken-Variablen. | Schlüssel/Wert-Paar |
Überlegungen und Beschränkungen
Nachfolgend finden Sie Überlegungen und Einschränkungen zum Verwenden der HTTP-Poller-Quelle:
- 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.