83. Заявка: Събиране на контекст на платформата

При голям брой (стотици или хиляди) обработвани набори от данни (като „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ и др.) винаги има необходимост да се разбере статусът на обработката на всеки набор и да се събере обобщение на обработката. Тези подробности се предоставят чрез getPlatformContext заявка.

Честите случаи:

• Проследяване на напредъка на обработката

• Събиране на обобщение и статистика за обработката

• Наблюдение на грешки и предупреждения по време на обработката за по-нататъшно по-задълбочено разследване на засегнатите набори от данни

query CollectPlatformContext {
 getPlatformContext(input: {
   userUuids: ["<placeholder_of_user_uuid>"],
   statuses: [Start, Done, Warning, Error, Ignored],
   dateFrom: "2023-05-25T12:49:00.000Z", 
   dateTo: "2023-05-30T06:35:00.000Z", 
 }) {
   events {
     fieldUuid
     subFieldUuid
     subFieldType
     operationId
     status 
     executionDate
     messageKey
     optional
   }
 }
}

Поддържани входни филтри:

• dateFrom като дата и час в ISO 8601 формат (напр.: "2023-05-25T12:49:00.000Z")

• dateTo като дата и час в ISO 8601 формат (напр.: "2023-05-30T06:35:00.000Z")

• operationIds като масив от идентификатори на операции (Низове)

• statuses като масив съдържащ стойности от ContextEventStatus изброим тип с всички статуси на обработка, включително междинни; препоръчва се да се използват основните ключови [Start, Done, Warning, Error, Ignored]

• subFieldTypes като масив съдържал стойности на TreeNodeEntity изброим тип с всички GeoPard ентити

• subFieldUuids като масив с UUID-та свързани с избраните ентити в subFieldTypes

• userUuids като масив от UUID-та на „User“ за търсене

Трябва да е инициализиран поне един от следните филтри: userUuids, fieldUuids, subFieldUuids, или operationIds.

Ако dateFrom и dateTo не са зададени, по подразбиране периодът за заявката е 12 часа. Максималният препоръчителен времеви интервал за извличане на данни е 24 часа.

Има ограничение от максимум 10 000 върнати реда.

За да се видят всички налични най-нови стойности на изброими типове (като: TreeNodeEntity, ContextEventStatus, ContextMessageKey), се препоръчва да се използва Altair.

Изходният обект включва следните атрибути:

• fieldUuid представлява UUID на свързаното поле

• subFieldUuid означава UUID на свързания обработен набор от данни (като „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ и др.)

• subFieldType като изброим тип свързан с TreeNodeEntity

• operationId като низ, който съдържа идентификатора на операцията; той остава постоянен във всички свързани вериги на обработка, препоръчително е да се групира по този идентификатор, за да се проследят всички етапи на обработка

• status като изброим тип свързан с ContextEventStatus

• executionDate като низ в ISO 8601 формат, който указва момента на изпълнение

• messageKey като изброим тип свързан с ContextMessageKey който описва резултата от изпълнението

• optional като низ, който предоставя техническо описание (ако е релевантно); основно се използва за отстраняване на грешки и докладване на бъгове