Uso delle attività della farm e dei dati sulle attività in Azure Data Manager per l'agricoltura
Gli utenti possono creare un processo di inserimento dati dell'operazione farm per eseguire il pull dei dati delle attività farm associate da un provider di dati specificato nell'istanza di Azure Data Manager for Agriculture, associata a una determinata parte. Il processo gestisce qualsiasi aggiornamento di autenticazione necessario e per impostazione predefinita rileva e sincronizza ogni giorno le modifiche. In alcuni casi, il processo eseguirà anche il pull delle informazioni relative a farm e campi associate all'account specificato nell'entità.
Nota
Prima di creare un processo attività farm, è obbligatorio integrarsi correttamente con il provider di dati oAuth delle attività farm
Creare un processo FarmOperations
Creare un processo di operazioni farm per inserire i dati dell'attività farm con un ID di propria scelta. Questo ID processo viene usato per monitorare lo stato del processo usando il processo Operazioni farm GET.
Documentazione dell'API:FarmOperations_CreateDataIngestionJob
Nota
shapeType e shapeResolution sono attributi specifici del provider. Se non sono applicabili al provider, impostare il valore su "Nessuno".
In base all'elenco startYear e operations fornito, Azure Data Manager per l'agricoltura recupera i dati dall'anno di inizio alla data corrente.
Insieme a dati specifici (geometria), il provider di dati Attività farm fornisce anche il file DAT per l'attività eseguita nella farm o nel campo. Il file DAT, il file shape e così via contengono una geometria che riflette la posizione in cui è stata eseguita l'attività.
È possibile recuperare i dettagli e lo stato del processo con: FarmOperations_GetDataIngestionJobDetails
Ricerca e recupero dei dati delle attività farm
Ora che i dati vengono inseriti in Azure Data Manager per l'agricoltura, è possibile eseguire query o elencarli con i metodi seguenti:
Metodo 1: cercare i dati delle attività farm usando l'intersezione geometrica
Per tenere conto dell'elevato grado di modifica trovato nelle definizioni dei campi, Azure Data Manager for Agriculture supporta una ricerca tramite funzionalità di intersecamento che consente di organizzare i dati in base allo spazio e al tempo tra le parti, senza dover prima conoscere la gerarchia o l'associazione farm/campo. Se si dispone di partyId, è possibile usarlo nell'input e fornisce l'elenco di elementi di dati dell'attività della farm per l'entità specificata.
È anche possibile usare l'ID come plantingId per recuperare i dati precedenti nella stessa API. Se si rimuove l'ID, è possibile visualizzare tutti gli altri dati che si intersecano con la stessa geometria all'interno dell'entità. Mostra quindi i dati per la stessa geometria tra parti diverse.
Metodo 2: Elencare i dati per tipo
I dati recuperati vengono ordinati in base al tipo di attività nell'entità. Questi elementi possono essere elencati, con i filtri standard applicati. È possibile recuperare singoli elementi di dati per visualizzare le proprietà e i metadati, inclusi sourceActivityId, providerFieldId e Geometry.
Elencare e scaricare allegati
L'attributo message nella risposta dell'API FarmOperations_GetDataIngestionJobDetails mostra la quantità di dati elaborati e il numero di allegati creati. Per controllare gli allegati associati al partyId, passare all'API allegati. La risposta fornisce tutti gli allegati creati con partyId.
Documentazione dell'API: Allegati
Passaggi successivi
- Informazioni sulle API disponibili qui.