Condividi tramite

Integrazione con le attività farm provider di dati

  • Articolo

Azure Data Manager for Agriculture supporta i connettori per sincronizzare facilmente i dati degli utenti finali da un'ampia gamma di origini dati dei macchinari agricoli. La configurazione prevede la configurazione del flusso oAuth come prerequisito per l'integrazione con qualsiasi provider di dati delle attività farm, insieme a un passaggio di consenso trasparente per account che gestisce la sincronizzazione dei dati iniziale e incrementale per mantenere aggiornato il patrimonio di dati ADMA.

Nota

I passaggi da 1 a 3 fanno parte della configurazione iniziale monouso per provider. Dopo l'integrazione, sarà possibile consentire a tutti gli utenti finali di usare il flusso di lavoro oAuth esistente e chiamare l'API di configurazione (passaggio 4) per utente (PartyID) per recuperare il token di accesso.

Configurazione del provider

Il flusso di esempio qui usa Climate FieldView

Passaggio 1: Creazione di app

Se l'applicazione non è già registrata con Climate Fieldview, passare al portale FieldView e inviare il modulo. Dopo che client_id FieldView elabora la richiesta, invia e client_secret che verrà usata una volta per ogni istanza di ADMA per FieldView.

Passaggio 2: Configurazione del provider

Usare l'API oAuthProvider per creare o aggiornare il provider oAuth (ad esempio FIELDVIEW) con le credenziali appropriate dell'app appena creata.

Documentazione dell'API: oAuthProviders - Creare o aggiornare

Passaggio facoltativo: al termine dell'operazione, è possibile eseguire il oAuthProviders_Get per verificare se l'applicazione è registrata. Ora, tutte le parti create nell'istanza di Azure Data Manager per l'agricoltura possono usare FieldView come provider per recuperare i dati delle attività farm.

Passaggio 3: Configurazione endpoint

Endpoint di reindirizzamento utente: questo endpoint è il punto in cui si vuole che gli utenti vengano reindirizzati a una volta completato il flusso oAuth. Questo endpoint verrà generato dall'utente e fornito ad ADMA come userRedirectLink nell'API oauth/:connect. Registrare l'endpoint di callback oAuth con l'app nel portale Climate FieldView.

Configurazione dell'account utente finale

Passaggio 4: Integrazione dell'entità (utente finale)

Quando un'entità (utente finale) raggiunge la pagina Web in cui è prevista l'azione dell'utente (ad esempio, Connessione al pulsante FieldView), effettuare una chiamata all'API oauth/tokens/:connect nel modo seguente per ottenere l'URI di accesso del provider oAuth (ad esempio: Climate FieldView) per avviare il flusso oAuth dell'utente finale.

Documentazione dell'API: oAuthTokens - Get OAuth Connessione ion Link

Dopo che l'API oauth/tokens/:connect restituisce correttamente , l'utente oauthAuthorizationLinkfinale fa clic su questo collegamento per completare il flusso oAuth (ad esempio: Per Climate FieldView, l'utente viene servito un consenso di accesso e una pagina di accesso a FieldView). Al termine dell'accesso, ADMA reindirizzerà l'utente all'endpoint fornito dal cliente (userRedirectLink) con i parametri di query seguenti nell'URL

  1. stato (esito positivo/negativo)
  2. state (stringa facoltativa per identificare in modo univoco l'utente alla fine del cliente)
  3. message (stringa facoltativa)
  4. errorCode (stringa facoltativa inviata per Failure/error) nei parametri.

Nota

Se l'API restituisce 404, implica che il flusso oAuth non è riuscito e ADMA non è riuscito ad acquisire il token di accesso.

Passaggio 5: Controllare le informazioni sul token di accesso (facoltativo)

Questo passaggio è facoltativo, solo per confermare se per un determinato utente o elenco di utenti, il token di accesso valido richiesto è stato acquisito o meno. Questa operazione può essere eseguita tramite l'esecuzione di una chiamata all'API oauth/tokens per verificare la voce isValid: true nel corpo della risposta.

Documentazione dell'API: oAuthTokens - Elenco

Questo passaggio contrassegna il completamento corretto del flusso oAuth per un utente. A questo punto, l'utente è tutto impostato per attivare un nuovo farmOperationsDataJob per iniziare a estrarre i dati delle attività farm da Climate FieldView.