Intégrer aux activités de batterie de serveurs Fournisseur de données
Azure Data Manager for Agriculture prend en charge les connecteurs pour synchroniser facilement les données de vos utilisateurs finaux à partir d’une gamme de sources de données de machines agricoles. La configuration implique la configuration du flux oAuth en tant que prérequis pour l’intégration à n’importe quel fournisseur de données Farm Activities, ainsi qu’une étape de consentement transparente et transparente qui gère la synchronisation initiale et incrémentielle des données pour maintenir le patrimoine de données ADMA à jour.
Remarque
Les étapes 1 à 3 font partie de la configuration initiale unique par fournisseur. Une fois intégré, vous pourrez permettre à tous vos utilisateurs finaux d’utiliser le flux de travail oAuth existant et d’appeler l’API de configuration (étape 4) par utilisateur (PartyID) pour récupérer le jeton d’accès.
Configuration du fournisseur
L’exemple de flux ici utilise Climate FieldView
Étape 1 : Création d’applications
Si votre application n’est pas déjà inscrite auprès de Climate Fieldview, accédez au portail FieldView et envoyez le formulaire. Une fois Que FieldView traite votre demande, ils envoient votre client_id requête et client_secret que vous utiliserez une fois par instance ADMA pour FieldView.
Étape 2 : Configuration du fournisseur
Utilisez l’API oAuthProvider pour créer ou mettre à jour le fournisseur oAuth (ex : FIELDVIEW) avec les informations d’identification appropriées de l’application nouvellement créée.
Documentation de l’API : oAuthProviders - Créer ou mettre à jour
Étape facultative : une fois l’opération terminée, vous pouvez exécuter le oAuthProviders_Get pour vérifier si l’application est inscrite. À présent, toutes les parties créées dans votre instance Azure Data Manager for Agriculture peuvent utiliser FieldView en tant que fournisseur pour extraire les données d’activités de batterie de serveurs.
Étape 3 : Configuration du point de terminaison
Point de terminaison de redirection de l’utilisateur : ce point de terminaison est l’endroit où vous souhaitez que vos utilisateurs soient redirigés une fois le flux oAuth terminé. Ce point de terminaison est généré par vous et fourni à ADMA comme userRedirectLink dans l’API oauth/tokens/ :connect.
Inscrivez le point de terminaison de rappel oAuth auprès de votre application sur le portail Climate FieldView.
Configuration du compte d’utilisateur final
Étape 4 : Intégration de tiers (utilisateur final)
Lorsqu’un tiers (utilisateur final) atterrit sur votre page web où l’action de l’utilisateur est attendue (par exemple, Connecter au bouton FieldView), effectuez un appel à oauth/tokens/:connect l’API de la manière ci-dessous pour obtenir l’URI de connexion du fournisseur oAuth (Ex : Climate FieldView) de nouveau pour démarrer le flux oAuth de l’utilisateur final.
Documentation de l’API : oAuthTokens - Get OAuth Connecter ion Link
Une fois l’API oauth/tokens/:connect retournée oauthAuthorizationLink, l’utilisateur final clique sur ce lien pour terminer le flux oAuth (par exemple, Pour Climate FieldView, l’utilisateur reçoit un consentement d’accès FieldView et une page de connexion). Une fois la connexion terminée, ADMA redirige l’utilisateur vers le point de terminaison fourni par le client (userRedirectLink) avec les paramètres de requête suivants dans l’URL
- état (réussite/échec)
- état (chaîne facultative pour identifier de manière unique l’utilisateur à la fin du client)
- message (chaîne facultative)
- errorCode (chaîne facultative envoyée pour Échec/erreur) dans les paramètres.
Remarque
Si l’API retourne 404, elle implique que le flux oAuth a échoué et qu’ADMA n’a pas pu acquérir le jeton d’accès.
Étape 5 : Vérifier les informations du jeton d’accès (facultatif)
Cette étape est facultative, uniquement pour confirmer si pour un utilisateur ou une liste d’utilisateurs donné, le jeton d’accès valide requis a été acquis ou non. Pour ce faire, vous pouvez effectuer un appel à l’API oauth/tokens pour case activée pour l’entrée isValid: true dans le corps de la réponse.
Documentation de l’API : oAuthTokens - Liste
Cette étape marque la réussite du flux oAuth pour un utilisateur. À présent, l’utilisateur est tout défini pour déclencher une nouvelle farmOperationsDataJob pour commencer à extraire les données des activités de batterie de serveurs à partir de Climate FieldView.