HTTP

La sortie HTTP dans ArcGIS Velocity permet d’envoyer des entités et tout autre texte vers une extrémité HTTP via des requêtes POST, PUT ou DELETE. Une requête est envoyée pour chaque entité en sortie envoyée à la sortie.

Exemple

Un analyste configure une sortie HTTP pour envoyer des entités dans un format JSON personnalisé à un webhook désigné.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez la sortie HTTP :

  • Lorsque vous envoyez le code JSON en tant que corps de requête, entourez-le code avec l’expression Text() Arcade pour le présenter correctement.
  • Lorsque vous utilisez la sortie HTTP, il est important de comprendre la vitesse des données. Chaque enregistrement envoyé à la sortie génère une requête séparée. Cela peut rapidement dépasser les paramètres de capacité ou de limite de débit d’un serveur Web. Utilisez la sortie HTTP pour les incidents qui ne devraient pas se produire très souvent.
  • En cas d’utilisation de l’authentification OAuth :
    • Le type de sortie 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. Lors de la configuration de la demande de jeton d’accès, vous êtes invité à identifier le jeton d’accès et les champs 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.
    • 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é (généralement, dans un en-tête Authorization personnalisé avec la valeur Bearer $accessToken).

Paramètres

Les paramètres de la sortie HTTP sont les suivants :

ParamètreDescriptionType de données

URL

URL sur laquelle les requêtes en sortie sont envoyées.

Chaîne

Méthode HTTP

Méthode HTTP utilisée pour la requête. Les choix sont les suivants : POST, PUT et DELETE

Chaîne

Corps POST

L'expression Arcade JSON.

Expression Arcade

Content-Type

En-tête content-type pour les requêtes sortantes.

  • Texte brut : text/plain
  • JSON : application/json
  • CSV : text/csv
  • XML : text/xml

Chaîne

Type d’authentification

Optez pour aucune authentification, l’authentification de base ou l’authentification OAuth.

Si l’authentification de base est configurée, des champs supplémentaires sont proposés pour y indiquer le nom d’utilisateur et le mot de passe.

Si l’authentification OAuth est configurée, une fenêtre contextuelle va s’afficher pour configurer les éléments suivants :

  • Point de terminaison du jeton d’accès
  • Méthode HTTP
  • Paramètres URL
  • Custom headers (En-têtes personnalisés)

Une fois que les éléments ci-dessus sont spécifiés, la connexion est testée, et vous devez cliquer sur le jeton d’accès dans la réponse JSON.

Divers paramètres

Paramètres URL

Paramètres URL facultatifs inclus dans l’URL de la demande HTTP envoyée au site Web spécifié.

Bien que les paramètres puissent également être définis dans le paramètre URL plus haut, les paramètres URL saisis ici comme paramètres distincts remplacent tout paramètre correspondant présent dans le paramètre URL.

Les paramètres définis dans ce paramètre seront toujours codés par URL.

Paire clé-valeur

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

En-têtes personnalisés facultatifs inclus dans la demande HTTP envoyée au site Web spécifié. 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.

Paire clé-valeur

Journalisation supplémentaire

Si besoin, activez la journalisation des requêtes et réponses HTTP au format brut émises par Velocity.

Remarque :

Ce paramètre ne doit être activé qu’à des fins de dépannage et doit être désactivé une fois le dépannage terminé. Une fois activé, lancez l’analyse. Les journaux de niveau débogage sont disponibles sur la page Journaux d’analyse. Si nécessaire, contactez le support technique Esri pour obtenir de l’aide dans le cadre du dépannage.

Booléen

Considérations et limitations

Voici les considérations et limitations lors de l’utilisation de la sortie HTTP :

  • En cas d’utilisation de l’authentification OAuth :
    • Lors de la création d’une sortie, plusieurs demandes sont envoyées à un serveur d’autorisation et au point d’extrémité associé. Certaines API limitent le débit de certaines demandes, ce qui peut affecter la création de la sortie.
    • Pour des raisons de sécurité, le corps POST de la demande du jeton d’accès doit être reconfiguré lors de la modification des paramètres d’authentification.
  • Le serveur Web doit être accessible en externe sur Internet.