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

Voici un exemple de cas d’utilisation de la source de données :

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 :

• 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, n’oubliez pas d’utiliser la variable globale $accessToken pour spécifier l’utilisation du jeton d’accès. 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 de données sont présentés ci-après :

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	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 la variable globale $accessToken.
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 sont toujours codés par URL. Ce paramètre prend en charge les variables globales $accessToken et d’analyse.	Paire clé-valeur
Journalisation supplémentaire (facultatif)	Activez le paramètre Additional logging (Journalisation supplémentaire) pour indiquer si vous pouvez activer la journalisation des requêtes et réponses HTTP au format brut envoyées par Velocity. Remarque : Activez ce paramètre à des fins de dépannage et désactivez-le à l’issue du dépannage. Une fois le paramètre activé, démarrez le flux. Les journaux de niveau Debug (Débogage) sont disponibles sur la page des journaux du flux. Contactez le SupportEsri pour obtenir de l’aide dans le cadre du dépannage.	Booléen

Considérations et limitations

Considérez ce qui suit lorsque vous utilisez la source de données :

• 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.
• Si une URL est spécifiée pour la source HTTP Poller (Interrogation HTTP) et que la tentative de connexion échoue, il est recommandé de vérifier la section Additional Details (Détails supplémentaires) du message d’erreur. Ces informations peuvent inclure les données de demande et de réponse brutes, qui peuvent permettre de diagnostiquer et comprendre l’origine de l’échec.