التوثيق

تفاصيل الحساب

لحساب قيمة، يجب تحديد مهمة SKOOR واحدة على الأقل موجودة على النظام. من هذه المهمة أو المهام، يمكن استخدام جميع قيم الإرجاع للحساب.

أولاً، يجب تحديد كائن أساسي لفلاتر البحث. انقر فوق الزر "تصفح" والقائمة المنسدلة بالقرب من "بحث" أدناه لتحديد الكائن الأساسي. انقر فوق الزر "+" بالقرب من "فلتر 1" لإضافة المزيد من الفلاتر إذا لزم الأمر:

أضف أو أزل معايير التصفية باستخدام أزرار + / - الخاصة بالمرشح. في المثال أدناه، يتم البحث عن جميع مهام التنفيذ مع تعيين الخاصية المخصصة Kanton على Zurich:

بالنسبة لكل عامل تصفية، يجب الآن تحديد نوع القيم باستخدام القائمة المنسدلة "قيم البرنامج النصي". تتوفر الخيارات التالية:

أخيرًا، انقر فوق "تحديث" بجوار القائمة المنسدلة "القيم" لملء القائمة بالقيم المتاحة من المهام التي تمت تصفيتها، ثم حدد إحدى القيم من القائمة المنسدلة والتي ستصبح متاحة للحساب:

نص برمجي مضمن

هذا القسم هو الجزء الرئيسي من العمل المتعلق بحساب المهمة. الآن بعد تحديد قيم المهمة، يجب إنشاء نص برمجي Python للقيام بشيء ما بها. انقر فوق زر المعلومات في الزاوية العلوية اليمنى من قسم "معلمات المهمة" لفتح صفحة المساعدة التي تحتوي على أمثلة للنصوص البرمجية:

في تعريف المهمة، يتم توفير نموذج نص برمجي. يحتوي هذا النص البرمجي على البيانات المتغيرة مع جميع نتائج المهام التي تمت تصفيتها، بتنسيق JSON. تبدو سلسلة JSON هذه كما يلي، اعتمادًا على نوع القيمة المحددة وقيمة الإرجاع (تم تعديلها قليلاً لتسهيل القراءة):

{
    "arguments": [],
    "thisJob": {
        "type": "jobInfo",
        "jobId": 4769,
        "jobType": 10,
        "jobTypeName": "calculate",
        "jobState": 0,
        "jobStateName": "Undefined",
        "lastTs": 0,
        "values": {}
    },
    "results": [
        {
            "type": "jobAggregateValues",
            "filter": 1,
            "value": "return_value1",
            "count": 43,
            "average": -24882040.997674418,
            "max": 24648.0,
            "min": -1070000000.0
        }
    ],
    "info": [
        {
            "filter": 0,
            "warning": false
        }
    ]
}

كما هو موضح أيضًا في صفحة معلومات/مساعدة المهمة، باستخدام سطر Python التالي، يمكن إدخال القيم في قيم إرجاع SKOOR لمهمة الحساب (المثال يتوافق مع JSON أعلاه):

setErangerValues(data["results"][0]["average"],data["results"][0]["max"],data["results"][0]["min"])

الوظائف المطلوبة لتعيين قيم نتائج SKOOR متاحة في القائمة المنسدلة "العلامات". أضف الحجج والقيم المرجعة أسفل حقل البرنامج النصي المضمن في التكوين: