83. Sorgu: Platform Bağlamını Topla

Büyük sayıda (yüzlerce veya binlerce) işlenmiş veri kümesinde (ör. "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" vb.) her veri kümesinin işlenme durumunu anlamaya ve işleme özetini toplamaya yönelik sürekli bir talep vardır. Bu ayrıntılar şu şekilde sağlanır getPlatformContext sorgu.

Yaygın durumlar:

• İşleme ilerlemesini izlemek

• İşleme özeti ve istatistikleri toplamak

• Etkilenen veri kümelerinin daha derin incelenmesi için işleme sırasında oluşan hata ve uyarıları gözlemlemek

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

Desteklenen giriş filtreleri:

• dateFrom ISO 8601 biçiminde tarih-zaman olarak (örn: "2023-05-25T12:49:00.000Z")

• dateTo ISO 8601 biçiminde tarih-zaman olarak (örn: "2023-05-30T06:35:00.000Z")

• operationIds işlem tanımlayıcılarının dizisi olarak (Dizeler)

• statuses içerik değeri ContextEventStatus olan bir dizi olarak ContextEventStatus ara durumlar dahil tüm işleme durumlarını içeren enum; anahtar durumları kullanmanız tavsiye edilir [Start, Done, Warning, Error, Ignored]

• subFieldTypes içerdiği değerler olarak dizi halinde TreeNodeEntity tüm GeoPard varlıklarını içeren enum

• subFieldUuids seçili varlıklara bağlı UUID'lerden oluşan bir dizi olarak subFieldTypes

• userUuids aranacak "User" UUID'lerinin dizisi olarak

Aşağıdaki filtrelerden en az birinin başlatılmış olması gerekir: userUuids, fieldUuids, subFieldUuids, veya operationIds.

Eğer dateFrom ve dateTo belirtilmemişse, varsayılan sorgu süresi 12 saat olarak ayarlanır. Veri alma için önerilen maksimum zaman aralığı 24 saattir.

Teslim edilen maksimum satır sayısı 10.000 ile sınırlıdır.

Enumların (ör. mevcut en son değerleri) tüm kullanılabilir en son değerlerini gözlemlemek için (örn: TreeNodeEntity, ContextEventStatus, ContextMessageKey), kullanmanız tavsiye edilir Altair.

Çıktı nesnesi aşağıdaki öznitelikleri içerir:

• fieldUuid ilişkili Tarlanın UUID'sini temsil eder

• subFieldUuid bağlı işlenmiş veri kümesinin UUID'sini belirtir (ör. "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" vb.)

• subFieldType ile bağlantılı bir enum olarak TreeNodeEntity

• operationId işlemin tanımlayıcısını tutan bir dize olarak; tüm ilgili işleme zincirleri boyunca tutarlıdır, tüm işleme aşamalarını izlemek için bu tanımlayıcıya göre gruplayabilirsiniz

• status ile ilişkili bir enum olarak ContextEventStatus

• executionDate uygulamanın gerçekleşme anını gösteren ISO 8601 biçiminde bir dize olarak

• messageKey ile ilişkili bir enum olarak ContextMessageKey uygulamanın sonucunu tanımlar

• optional teknik bir açıklama sağlayan bir dize olarak (varsa); öncelikle hata ayıklama ve hata raporlama için kullanılır