83. Zapytanie: Zbierz kontekst platformy

Przy dużej liczbie (setkach lub tysiącach) przetwarzanych zestawów danych (takich jak "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" itp.) zawsze istnieje potrzeba zrozumienia statusu przetwarzania każdego zestawu danych i zebrania podsumowania przetwarzania. Te informacje są dostarczane za pomocą getPlatformContext zapytania.

Typowe przypadki:

• Śledzenie postępu przetwarzania

• Zbieranie podsumowań i statystyk przetwarzania

• Obserwacja błędów i ostrzeżeń podczas przetwarzania w celu dalszego, głębszego zbadania dotkniętych zestawów danych

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
   }
 }
}

Obsługiwane filtry wejściowe:

• dateFrom jako data i godzina w formacie ISO 8601 (np.: "2023-05-25T12:49:00.000Z")

• dateTo jako data i godzina w formacie ISO 8601 (np.: "2023-05-30T06:35:00.000Z")

• operationIds jako tablica identyfikatorów operacji (Ciagi znaków)

• statuses jako tablica zawierająca wartości z ContextEventStatus wyliczenia (enum) ze wszystkimi statusami przetwarzania, w tym pośrednimi; zaleca się używać kluczowych [Start, Done, Warning, Error, Ignored]

• subFieldTypes jako tablica zawierająca wartości TreeNodeEntity wyliczenia (enum) ze wszystkimi encjami GeoPard

• subFieldUuids jako tablica UUID powiązanych z wybranymi encjami w subFieldTypes

• userUuids jako tablica UUID użytkowników ("User"), po których ma być wyszukiwanie

Przynajmniej jeden z następujących filtrów musi być zainicjowany: userUuids, fieldUuids, subFieldUuids, lub operationIds.

Jeśli dateFrom i dateTo nie są określone, domyślny okres zapytania ustawiony jest na 12 godzin. Maksymalny zalecany zakres czasu dla pobierania danych to 24 godziny.

Istnieje limit maksymalnie 10 000 zwracanych wierszy.

Aby zobaczyć wszystkie dostępne, najnowsze wartości enumów (np.: TreeNodeEntity, ContextEventStatus, ContextMessageKey), zaleca się użycie Altair.

Obiekt wyjściowy zawiera następujące atrybuty:

• fieldUuid reprezentuje UUID powiązanego pola (Field)

• subFieldUuid oznacza UUID powiązanego przetworzonego zestawu danych (takiego jak "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" itp.)

• subFieldType jako enum powiązany z TreeNodeEntity

• operationId jako ciąg znaków, który zawiera identyfikator operacji; pozostaje on spójny w całych powiązanych łańcuchach przetwarzania — zaleca się grupowanie po tym identyfikatorze w celu śledzenia wszystkich etapów przetwarzania

• status jako enum powiązany z ContextEventStatus

• executionDate jako ciąg znaków w formacie ISO 8601, wskazujący moment wykonania

• messageKey jako enum powiązany z ContextMessageKey który opisuje wynik wykonania

• optional jako ciąg znaków zawierający opis techniczny (jeśli istotny); jest on wykorzystywany głównie do debugowania i zgłaszania błędów