Interrogation HTTP

La source de données Interrogation HTTP dans ArcGIS Velocity envoie une demande HTTP à l’URL spécifiée. Cette demande ingère les données pouvant être extraites dans un navigateur Web, en accédant à la même URL.

Exemple

Un analyste SIG souhaite charger les polygones de secteurs stockés dans un fichier .csv sur un serveur Web dans Velocity.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez la source de données HTTP Poller (Interrogation HTTP) :

  • Après avoir configuré les paramètres de connexion à la source, configurez les données en entrée pour définir la structure et les paramètres clés.
  • Les paramètres URL parameters (Paramètres URL) et Custom headers (En-têtes personnalisés) prennent en charge des variables globales d’analyse pour planifier des analyses de Big Data récurrentes. Par défaut, ces variables globales sont converties en heure epoch (millisecondes depuis le 1er janvier 1970 UTC). Vous trouverez ci-après les variables d’analyse disponibles et leur signification.
    • $analytic.AnalyticLastScheduledStartTime : heure de début planifiée pour la dernière exécution de l’analyse.
    • $analytic.AnalyticScheduledStartTime : heure de début planifiée pour l’exécution actuelle de l’analyse.
    • $analytic.AnalyticLastEndTime : heure de fin de la dernière exécution de l’analyse.
    • $analytic.AnalyticStartTime : heure à laquelle l’exécution actuelle de l’analyse a commencé. La différence entre cette variable et la variable $analytic.AnalyticScheduledStartTime correspond au retard de démarrage.
  • En cas d’utilisation de l’authentification OAuth, ce qui suit s’applique :
    • La source Interrogation HTTP prend en charge l’authentification à l’aide d’OAuth 2.0 pour les points d’extrémité HTTP utilisant les types d’autorisation de serveur à serveur ou via un mot de passe. Ces types d’autorisation OAuth appliquent un schéma qui comprend la configuration d’une demande HTTP pour récupérer un jeton d’accès. Ces demandes s’ajoutent à la demande de données qui est normalement configurée dans le cadre de toute source Interrogation HTTP.
    • Lors de la configuration de la demande de jeton d’accès, vous êtes invité à identifier le jeton d’accès dans la réponse du serveur d’autorisation OAuth.
    • Lorsque vous revenez à la configuration de la demande de données, vous devez utiliser la variable globale $accessToken pour définir l’endroit où le jeton d’accès sera utilisé Souvent dans un en-tête Authorization personnalisé avec la valeur Bearer $accessToken. $accessToken peut également être utilisé dans le corps POST, les paramètres URL et l’URL (par exemple, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).

Paramètres

Les paramètres de la source HTTP Poller (Interrogation HTTP) sont présentés ci-après :

ParamètreDescriptionType de données

URL

URL complète de l’extrémité HTTP accessible en externe.

Ce paramètre prend en charge la variable globale $accessToken.

Chaîne

Méthode HTTP

Spécifie la méthode HTTP utilisée pour l’extrémité HTTP, à savoir GET ou POST.

Si vous sélectionnez POST, vous pouvez spécifier un corps de message.

Chaîne

Corps POST

Corps de message à inclure lors de l’envoi d’une demande HTTP POST.

Permet de choisir entre x-www-form-urlencoded et d’autres types de contenu textuel générique. Définit également l’en-tête Content-type.

Ce paramètre s’applique uniquement si le paramètre HTTP method (Méthode HTTP) est défini sur POST.

Ce paramètre prend en charge les variables globales $accessToken et d’analyse.

Chaîne

Authentification

Spécifie le type d’authentification utilisé pour accéder à l’extrémité HTTP. Les options sont None (Aucune), Basic (De base), Certificate (Certificat) et OAuth.

Chaîne

Nom d\\’utilisateur

Nom d’utilisateur pour l’accès à l’extrémité HTTP.

Ce paramètre ne s’applique que si le paramètre Authentication (Authentification) est défini sur Basic (De base).

Chaîne

Mot de passe

Mot de passe pour l’accès à l’extrémité HTTP.

Ce paramètre ne s’applique que si le paramètre Authentication (Authentification) est défini sur Basic (De base).

Mot de passe

URL de certificat

Emplacement de l’URL du certificat client pour l’accès à l’extrémité HTTP.

Ce paramètre ne s’applique que si le paramètre Authentication (Authentification) est défini sur Certificate (Certificat).

Chaîne

Mot de passe

Mot de passe du certificat client, s’il est défini.

Ce paramètre ne s’applique que si le paramètre Authentication (Authentification) est défini sur Certificate (Certificat).

Mot de passe

Custom headers (En-têtes personnalisés)

En-têtes personnalisés facultatifs à inclure dans la demande HTTP envoyée à l’extrémité spécifiée.

Par exemple, des en-têtes personnalisés peuvent être utilisés pour spécifier une clé d’API tierce ou un en-tête d’autorisation.

Ce paramètre prend en charge les variables globales $accessToken et d’analyse.

Paire clé-valeur

Paramètres URL

Paramètres URL facultatifs à inclure dans l’URL de la demande HTTP envoyée à l’extrémité HTTP spécifiée.

Les paramètres peuvent également être définis dans le paramètre URL, mais les paramètres URL saisis ici écrasent tout paramètre correspondant spécifié pour le paramètre URL.

Les paramètres définis ici seront toujours codés par URL.

Ce paramètre prend en charge les variables globales $accessToken et d’analyse.

Paire clé-valeur

Considérations et limitations

Voici les considérations et limitations lors de l’utilisation de la source HTTP Poller (Interrogation HTTP) :

  • L’extrémité HTTP doit être accessible en externe sur Internet.
  • La taille de la réponse ou du fichier HTTP interrogé ne peut pas être supérieure à 16 Mo. Si la taille des données ou du fichier interrogé dépasse 16 Mo, les entités ne sont pas utilisées.
  • Si l’authentification OAuth est utilisée, ce qui suit s’applique :
    • Lors de la création, plusieurs demandes sont envoyées à un serveur d’autorisation et au point d’extrémité associé. Certaines API limitent le débit de certaines requêtes, ce qui peut affecter la création du flux.
    • Pour des raisons de sécurité, le corps POST du jeton d’accès doit être reconfiguré lors de la modification des paramètres d’authentification.