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. $accessToken peut également être utilisé dans le corps POST, les paramètres URL et l’URL elle-même (par exemple, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).

Paramètres

Paramètre	Description	Type 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	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 (POST). Ce paramètre prend en charge les variables globales $accessToken et d’analyse.	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 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. Cette propriété 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 (URL), mais les paramètres URL saisis ici écrasent tout paramètre correspondant spécifié pour le paramètre URL (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

• L’extrémité HTTP doit être accessible en externe sur Internet.
• 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.