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

  • 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 dépasse 16 Mo, les entités ne sont pas ingérées.
  • 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 URL parameters (Paramètres URL) et Custom headers (En-têtes personnalisés) peuvent tous deux utiliser des variables globales d’analyse pour planifier des analyses de Big Data récurrentes. Lors de l’exécution de l’analyse, 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 à laquelle la dernière exécution de l’analyse s’est terminée.
    • $analytic.AnalyticStartTime : heure a 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 :
    • 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.

Paramètres

ParamètreDescriptionType de données

URL

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

Chaîne

Méthode HTTP

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 lorsque le paramètre HTTP Method (Méthode HTTP) a la valeur POST.

Chaîne

Authentification

Type d’authentification utilisé pour l’accès à l’extrémité HTTP. Les options d’authentification 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 lorsque la valeur de Authentication (Authentification) est Basic (De base).

Chaîne

Mot de passe

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

Cette propriété ne s’applique que lorsque la valeur de Authentication (Authentification) est 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 lorsque la valeur de Authentication (Authentification) est 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 lorsque la valeur de Authentication (Authentification) est 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 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.

Bien que les paramètres puissent également être définis dans le paramètre URL, les paramètres URL saisis ici comme propriété distincte écrasent tout paramètre correspondant présent dans 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 d’analyse.

Paire clé-valeur

Considérations et limitations

  • Tenez compte des points suivants lorsque vous créez une source avec OAuth :
    • 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.
  • L’extrémité HTTP doit être accessible en externe sur Internet.