Arbeta med servergruppsaktiviteter och aktivitetsdata i Azure Data Manager for Agriculture
Användare kan skapa ett datainmatningsjobb för servergruppsåtgärder för att hämta associerade aktivitetsdata för servergruppsaktiviteter från en angiven dataprovider till din Azure Data Manager for Agriculture-instans som är associerad med en viss part. Jobbet hanterar alla nödvändiga autentiseringsuppdateringar och identifierar och synkroniserar som standard alla ändringar varje dag. I vissa fall hämtar jobbet även servergrupps- och fältinformation som är associerad med det angivna kontot till parten.
Kommentar
Innan du skapar ett servergruppsaktivitetsjobb är det obligatoriskt att integrera med servergruppsaktivitetsdataleverantörens oAuth-flöde
Skapa FarmOperations-jobb
Skapa ett servergruppsåtgärdsjobb för att mata in servergruppsaktivitetsdata med valfritt ID. Det här jobb-ID:t används för att övervaka status för jobbet med hjälp av GET Farm Operations-jobbet.
API-dokumentation:FarmOperations_CreateDataIngestionJob
Kommentar
shapeType och shapeResolution är providerspecifika attribut. Om de inte är tillämpliga för din provider anger du värdet till "Ingen".
Baserat på listan startYear och operations som tillhandahålls hämtar Azure Data Manager for Agriculture data från startåret till det aktuella datumet.
Tillsammans med specifika data (geometri) ger dataprovidern Servergruppsaktiviteter även DAT-filen för aktiviteten som utförs på din servergrupp eller ditt fält. DAT-filen, formfilen osv. innehåller en geometri som återspeglar var aktiviteten utfördes.
Jobbstatus och information kan hämtas med: FarmOperations_GetDataIngestionJobDetails
Hitta och hämta servergruppsaktivitetsdata
Nu när data matas in i Azure Data Manager for Agriculture kan de frågas eller anges med följande metoder:
Metod 1: Sök efter aktivitetsdata för servergruppen med hjälp av geometri som korsar varandra
För att ta hänsyn till den höga grad av förändring som finns i fältdefinitioner stöder Azure Data Manager for Agriculture en sökning efter intersect-funktion som gör att du kan organisera data efter utrymme och tid mellan parter, utan att först behöva känna till hierarkin eller associationen för servergrupp/fält. Om du har partyId kan du använda det i indata och det ger dig listan över dataobjekt för servergruppsaktivitet för den angivna parten.
Du kan också använda ID:t som plantingId för att hämta ovanstående data i samma API. Om du tar bort ID:t kan du se andra data som korsar samma geometri mellan olika parter. Så den visar data för samma geometri mellan olika parter.
Metod 2: Lista data efter typ
Hämtade data sorteras efter aktivitetstyp under parten. Dessa kan visas med standardfilter. Enskilda dataobjekt kan hämtas för att visa egenskaper och metadata, inklusive sourceActivityId, providerFieldId och Geometry.
Lista och ladda ned bifogade filer
Meddelandeattributet i svaret FarmOperations_GetDataIngestionJobDetails för API:et visar hur mycket data som bearbetades och hur många bifogade filer som skapades. Om du vill kontrollera de bifogade filer som är associerade med partyId går du till API för bifogade filer. Svaret ger dig alla bifogade filer som skapats under partyId.
API-dokumentation: Bifogade filer
Nästa steg
- Förstå våra API:er här.