83. استعلام: جمع سياق المنصة

عند وجود عدد كبير (مئات أو آلاف) من مجموعات البيانات المعالجة (مثل "SatelliteImage"، "AsAppliedDataset"، "YieldDataset"، "SoilDataset"، إلخ) هناك دائمًا حاجة لفهم حالة معالجة كل مجموعة بيانات وجمع ملخص المعالجة. يتم توفير هذه التفاصيل باستخدام getPlatformContext query.

الحالات الشائعة:

• تتبع تقدم المعالجة

• جمع ملخص وإحصاءات المعالجة

• مراقبة الأخطاء والتحذيرات أثناء المعالجة لإجراء تحقيق أعمق لاحقًا في مجموعات البيانات المتأثرة

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 {
     معرف_الحقل
     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 قيمة تعداد (enum) تحتوي على جميع حالات المعالجة بما في ذلك الوسيطة، يوصى باستخدام الحالات الرئيسية [Start, Done, Warning, Error, Ignored]

• subFieldTypes كمصفوفة تحوي قيمًا من TreeNodeEntity قيمة تعداد (enum) تحتوي على جميع كائنات GeoPard

• subFieldUuids كمصفوفة من UUIDs المرتبطة بالكيانات المحددة في subFieldTypes

• userUuids كمصفوفة من UUIDs للمستخدمين للبحث

يجب تهيئة واحد على الأقل من المرشحات التالية: userUuids, fieldUuids, subFieldUuids، أو operationIds.

إذا dateFrom و dateTo لم يتم تحديدها، يتم تعيين مدة الاستعلام الافتراضية إلى 12 ساعة. النطاق الزمني الموصى به الأقصى لاسترجاع البيانات هو 24 ساعة.

هناك حد أقصى لعدد الصفوف المسموح بتسليمها يبلغ 10,000 صف.

لمشاهدة جميع القيم المتاحة الأحدث للأنواع المعدودة (مثل: TreeNodeEntity, ContextEventStatus, ContextMessageKey)، يُنصح باستخدام Altair.

كائن الإخراج يتضمن السمات التالية:

• معرف_الحقل يمثل UUID الحقل المرتبط

• subFieldUuid يدل على UUID مجموعة البيانات المعالجة المرتبطة (مثل "SatelliteImage"، "AsAppliedDataset"، "YieldDataset"، "SoilDataset"، إلخ)

• subFieldType كقيمة تعداد (enum) مرتبطة بـ TreeNodeEntity

• operationId كسلسلة تحتوي على معرف العملية، يبقى ثابتًا عبر جميع سلاسل المعالجة ذات الصلة، ويُنصح بتجميع النتائج حسب هذا المعرف لتتبع جميع مراحل المعالجة

• status كقيمة تعداد (enum) مرتبطة بـ ContextEventStatus

• executionDate كسلسلة بتنسيق ISO 8601 تشير إلى لحظة التنفيذ

• messageKey كقيمة تعداد (enum) مرتبطة بـ ContextMessageKey التي تصف نتيجة التنفيذ

• optional كسلسلة توفر وصفًا تقنيًا (إذا كان ذا صلة)، تُستخدم أساسًا لأغراض تصحيح الأخطاء والإبلاغ عن العيوب