Interrogation HTTP

Le type de flux Interrogation HTTP dans ArcGIS Velocity envoie une demande HTTP à l’URL spécifiée. Cette demande collecte toutes les données pouvant être extraites dans un navigateur Web, en accédant à la même URL.

Exemple

Les valeurs de capteur mises à jour sont chargées à partir d’un flux API toutes les minutes.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez le flux Interrogation HTTP :

  • Le flux interroge l’extrémité HTTP pour charger les données selon la fréquence définie à l’étape Feed Polling Interval (Intervalle d’interrogation de flux) de l’assistant de configuration.
  • Lorsqu’un intervalle d’interrogation est défini, les interrogations ont lieu à intervalles réguliers à partir de l’heure de démarrage du flux. Par exemple, si un flux est configuré pour interroger les données toutes les cinq minutes, et qu’il démarre à 8:03, la première demande de données intervient à 8:05, la suivante à 8:10, et ainsi de suite.
  • Faites attention lorsque vous spécifiez la valeur Feed Polling Interval (lntervalle d’interrogation de flux). Vous devez vous assurer que l’extrémité HTTP interrogée est en mesure de renvoyer des réponses dans l’intervalle d’interrogation spécifié. Il est recommandé de tester le temps de réponse d’une demande adressée au site Web, en utilisant la même demande que celle appliquée lors de la configuration du flux. La durée de l’intervalle d’interrogation ne doit pas être inférieure au temps de réponse moyen à cette demande adressée au site Web. Pour plus d’informations, voir Planifier un intervalle d’interrogation de flux.
  • Les paramètres POST body (Corps POST), URL parameters (Paramètres URL) et Custom headers (En-têtes personnalisés) prennent en charge les variables globales de flux. Par défaut, les variables globales de flux sont converties en temps epoch (millisecondes depuis le 1er janvier 1970 UTC). Si vous le souhaitez, vous pouvez convertir les variables globales de flux en secondes epoch (secondes depuis le 1er janvier 1970) et en chaîne de date et heure. À la première exécution du flux après le démarrage ou le redémarrage, l’heure $feed.FeedLastScheduledStart est l’heure de début actuelle moins cinq minutes. Vous trouverez ci-après les variables d’analyse de flux et leur signification :
    • $feed.FeedStartTime : heure à laquelle le flux a démarré.
    • $feed.FeedScheduledStartTime : heure à laquelle la prochaine récurrence du flux est planifiée.
    • $feed.FeedLastScheduledStartTime : heure à laquelle la dernière récurrence du flux était planifiée.
    Variables d’analyse de flux et leur signification
  • Les niveaux de licence d’abonnement ArcGIS Velocity présentent des limites quant au volume de données qu’un flux peut consommer, comme l’indique le résumé ci-dessous. Si des flux excèdent la limite de consommation de votre niveau de licence, un message est écrit dans les journaux et un e-mail est envoyé pour vous informer que la limite a été atteinte. Si la consommation des données demeure supérieure à la limite pendant plus d’une heure, le flux s’arrête. Pour plus d’informations sur les licences ArcGIS Velocity, reportez-vous à la rubrique Licences. Contactez votre représentant Esri ou le support technique Esri, si nécessaire, pour identifier les niveaux de licence Velocity prenant en charge vos processus. Les niveaux de licence sont les suivants :
    • Standard : consommation et traitement des données à 25 Ko/seconde (environ 100 événements par seconde).
    • Advanced : consommation et traitement des données à 250 Ko/seconde (environ 1 000 événements par seconde).
    • Dedicated : consommation et traitement des données à 2 500 Ko/seconde (environ 10 000 événements par seconde).
  • Après avoir configuré les paramètres de connexion du flux, reportez-vous à la rubrique Configurer les données en entrée pour savoir comment définir la structure et les paramètres clés.

Authentification OAuth

Le type de flux 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 et, éventuellement, la configuration d’une demande pour utiliser un jeton d’actualisation afin d’extraire de nouveaux jetons d’accès. Ces demandes s’ajoutent à la demande de données qui est normalement configurée dans le cadre de tout type de flux Interrogation HTTP.

Lors de la configuration de la demande de jeton d’accès, vous êtes invité à identifier le jeton d’accès et les champs facultatifs de jeton d’actualisation et de clé JSON d’expiration dans la réponse du serveur d’autorisation OAuth. Si une expiration est sélectionnée, vous devez en définir le type (durée ou horodatage) et les unités.

Si un jeton d’actualisation a été identifié dans la demande de jeton d’accès, vous devez utiliser la variable globale $refreshToken pour définir où le jeton d’actualisation sera utilisé dans la configuration de la demande de jeton d’actualisation.

Enfin, 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 et les paramètres URL, ainsi que dans l’URL (par exemple, https://<<company.domain>>/$accessToken/<<method>>?<<url params>>).

Pendant le traitement, un flux pour lequel l’authentification OAuth est configurée gère le jeton d’accès et traite en conséquence les erreurs survenant lors de l’extraction des données. Par exemple, si une demande de jeton d’actualisation et une expiration sont définies, le flux utilise le jeton d’actualisation qui a été extrait initialement avec la demande de jeton d’accès pour récupérer un nouveau jeton, si le premier est arrivé à expiration.

Tenez compte des points suivants lorsque vous créez un flux 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é, les corps POST des demandes de jeton d’accès et d’actualisation doivent être reconfigurés lors de la modification des paramètres d’authentification.

Paramètres

Les paramètres du flux 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 (POST).

Ce paramètre prend en charge les variables globales $accessToken et de flux.

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é HTTP 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 de flux.

Paire clé-valeur

Paramètres URL

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

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 de flux.

Paire clé-valeur

Interrogation longue

Indique si le serveur Web est interrogé et si une connexion ouverte est maintenue jusqu’à l’envoi de nouvelles données par le serveur. Lorsque des nouvelles données sont reçues, une nouvelle demande est immédiatement envoyée.

Remarque :

Cette configuration de serveur Web est unique et n’est pas utilisée par la plupart des serveurs Web.

Booléen

Variables globales

Convertit les variables globales de flux dans un format de date/heure personnalisé. Ce paramètre est facultatif.

Ce paramètre prend en charge les variables globales $accessToken et de flux.

Pour obtenir plus d’informations sur la définition d’un format de date (millisecondes epoch, secondes epoch et format de type chaîne), reportez-vous à la rubrique Paramètres de date et d’heure.

Chaîne

Journalisation supplémentaire

Indique si la journalisation des requêtes et réponses HTTP au format brut envoyées par Velocity est activée. Ce paramètre est facultatif.

Remarque :

Activez ce paramètre dans le cadre d’un dépannage uniquement, puis désactivez-le à l’issue du dépannage. Une fois le paramètre activé, démarrez le flux. Les journaux de niveau débogage sont disponibles sur la page des journaux du flux. Contactez le support technique Esri pour obtenir de l’aide dans le cadre du dépannage, le cas échéant.

Booléen

Considérations et limitations

Voici les considérations et limitations lors de l’utilisation du flux Interrogation HTTP :

  • L’extrémité HTTP doit être accessible en externe sur Internet.
  • La taille de la réponse HTTP ou du fichier interrogé ne doit pas être supérieure à 16 Mo. Si la taille des données interrogées dépasse 16 Mo, les entités ne sont pas consommées.
  • Il est recommandé d’utiliser ce type de flux pour les données en temps réel avec une vitesse d’environ 3 000 entités ponctuelles par seconde ou moins. Les vitesses prises en charge varient selon le nombre d’attributs de données, le format des données entrantes et la complexité des entités polylignes ou surfaciques.