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ètre | Description | Type 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.
| 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 :
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.
Vous avez un commentaire à formuler concernant cette rubrique ?