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
     необязательно
   }
 }
}

Поддерживаемые входные фильтры:

• dateFrom в формате datetime в ISO 8601 (напр.: "2023-05-25T12:49:00.000Z")

• dateTo в формате datetime в ISO 8601 (напр.: "2023-05-30T06:35:00.000Z")

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

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

• subFieldTypes как массив, содержащий значения TreeNodeEntity перечисление со всеми сущностями GeoPard

• subFieldUuids как массив UUID, связанных с выбранными сущностями в subFieldTypes

• userUuids как массив UUID пользователей для поиска

Должен быть инициализирован хотя бы один из следующих фильтров: userUuids, fieldUuids, subFieldUuids, или operationIds.

Если dateFrom и dateTo не указаны, по умолчанию длительность запроса устанавливается в 12 часов. Максимально рекомендуемый интервал для извлечения данных — 24 часа.

Существует ограничение: максимум 10 000 строк.

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

Выходной объект включает следующие атрибуты:

• fieldUuid представляет UUID связанного поля (Field)

• subFieldUuid обозначает UUID связанного обработанного набора данных (например "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" и т.д.)

• subFieldType как перечисление, связанное с TreeNodeEntity

• operationId как строка, содержащая идентификатор операции; он остаётся неизменным во всех связанных цепочках обработки, рекомендуется группировать по этому идентификатору для отслеживания всех стадий обработки

• status как перечисление, связанное с ContextEventStatus

• executionDate как строка в формате ISO 8601, указывающая момент выполнения

• messageKey как перечисление, связанное с ContextMessageKey которая описывает результат выполнения

• необязательно как строка, предоставляющая техническое описание (если применимо); в основном используется для отладки и составления отчетов об ошибках