Trabajo con actividades de granja de servidores y datos de actividad en Azure Data Manager for Agriculture

Los usuarios pueden crear un trabajo de ingesta de datos de operación de granja para extraer datos de actividad de actividades de granja de servidores asociados de un proveedor de datos especificado en la instancia de Azure Data Manager for Agriculture, asociada a una entidad específica. El trabajo controla cualquier actualización de autenticación necesaria y, de forma predeterminada, detecta y sincroniza todos los cambios diarios. En algunos casos, el trabajo también extraerá información de granja de servidores y campos asociada a la cuenta especificada en la entidad.

Nota:

Antes de crear el trabajo de actividades de granja de servidores, es obligatorio realizar correctamente la integración con el flujo de oAuth del proveedor de datos de actividades de granja de servidores.

Crear trabajo farmOperations

Cree un trabajo de operaciones de granja de servidores para ingerir datos de actividad de granja de servidores con un identificador de su elección. Este identificador de trabajo se usa para supervisar el estado del trabajo mediante el trabajo GET Farm Operations.

Documentación de api:FarmOperations_CreateDataIngestionJob

Nota:

shapeType y shapeResolution son atributos específicos del proveedor. Si no son aplicables al proveedor, establezca el valor en "None".

En función de la startYear lista y operations proporcionada, Azure Data Manager for Agriculture captura los datos del año inicial a la fecha actual.

Junto con datos específicos (geometría), el proveedor de datos de actividades de granja de servidores también nos proporciona el archivo DAT para la actividad realizada en la granja o el campo. El archivo DAT, el archivo de formas, etc. contienen una geometría que refleja dónde se realizó la actividad.

El estado y los detalles del trabajo se pueden recuperar con: FarmOperations_GetDataIngestionJobDetails

Búsqueda y recuperación de datos de actividades de granja de servidores

Ahora que los datos se ingieren en Azure Data Manager para Agricultura, se pueden consultar o enumerar con los métodos siguientes:

Método 1: buscar datos de actividades de granja de servidores mediante la intersección de geometría

Para tener en cuenta el alto grado de cambio que se encuentra en las definiciones de campo, Azure Data Manager para Agricultura admite una característica de búsqueda por intersección que le permite organizar los datos por espacio y tiempo entre partes, sin necesidad de conocer primero la jerarquía o asociación de granjas o campos. Si tiene el partyId, puede usarlo en la entrada y le proporciona la lista de elementos de datos de actividad de la granja de servidores para la entidad especificada.

Documentación de la API

También puede usar el identificador como plantingId para capturar los datos anteriores en la misma API. Si quita el identificador, podrá ver cualquier otro dato que se intersece con la misma geometría entre partes. Por lo tanto, muestra los datos de la misma geometría en diferentes partes.

Método 2: Enumerar datos por tipo

Los datos recuperados se ordenan por tipo de actividad en la entidad. Se pueden enumerar, con filtros estándar aplicados. Los elementos de datos individuales se pueden recuperar para ver las propiedades y los metadatos, incluidos , sourceActivityIdproviderFieldId y Geometry.

Documentación de la API

Enumerar y descargar datos adjuntos

El atributo message en la respuesta de la API muestra la cantidad de FarmOperations_GetDataIngestionJobDetails datos procesados y cuántos datos adjuntos se crearon. Para comprobar los datos adjuntos asociados a partyId, vaya a la API de datos adjuntos. La respuesta proporciona todos los datos adjuntos creados en partyId.

Documentación de api: Datos adjuntos

Pasos siguientes

  • Conozca nuestras API aquí.