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
- 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 erfasst.
- Nachdem Sie die Quellverbindungsparameter konfiguriert haben, konfigurieren Sie die Eingabedaten, um das Schema und die Schlüsselparameter zu definieren.
- Sowohl die URL-Parameter als auch die Parameter Benutzerdefinierte Header können globale Analysevariablen zum Planen von wiederkehrenden Big-Data-Analysen verwenden. Bei der Ausführung einer Analyse werden diese globalen Variablen in Unixzeit (Millisekunden seit dem 01. Januar 1970 UTC) konvertiert. 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 (Achtung: Die Differenz zwischen dieser Variablen und $analytic.AnalyticScheduledStartTime ist die Startverzögerung.)
- Bei Verwendung der OAuth-Authentifizierung:
- 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
| 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 | Die für den HTTP-Endpunkt verwendete HTTP-Methode, 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 | Der für den Zugriff auf den HTTP-Endpunkt verwendete Typ der Authentifizierung. Die Authentifizierungsoptionen 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 |
Password | Das Kennwort für den Zugriff auf den HTTP-Endpunkt. Diese Eigenschaft trifft nur dann zu, wenn der Parameter Authentifizierung auf Standard festgelegt ist. | Password |
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 |
Password | Das Kennwort für das Clientzertifikat, sofern festgelegt. Dieser Parameter trifft nur dann zu, wenn der Parameter Authentifizierung auf Zertifikat festgelegt ist. | Password |
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
- Auf den HTTP-Endpunkt muss extern im Internet zugegriffen werden können.
- Berücksichtigen Sie Folgendes, wenn Sie eine Quelle mit OAuth erstellen:
- 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 von Zugriffstoken neu konfiguriert werden.