كيفية توليد تقييم باستخدام AssessmentCreation API

في بعض السيناريوهات، نحتاج إلى توليد تقييمات عند الطلب — سواء من Service Portal أو من UI Action أو Business Rule.

توفر ServiceNow AssessmentCreation API طريقة لتوليد التقييمات برمجياً. في هذا المقال، أستخدم التابع createAssessments لتوليد التقييمات عبر ودجت في Service Portal.

توقيع التابع

AssessmentCreation.createAssessments(
  String typeID,         // معرّف نوع مقياس التقييم
  String sourceRecordID, // السجل المصدر للتقييم
  String userID          // معرّف المستخدم الذي سيُرسل إليه التقييم
)

الإعداد

قبل كتابة السكريبت، جهّزت أمرين:

1. أنشأت خدمة ServiceNow Portal في جدول cmdb_ci_service لتكون السجل المصدر. Sys ID الخاصة بها: 4baec2fe07d3f0101263f19d7c1ed0a6.
2. أنشأت نوع تقييم باسم "ServiceNow Portal Assessment" مضبوطاً للتشغيل عند الطلب. Sys ID لنوع المقياس: d902e09a075730101263f19d7c1ed03a.

تشغيل التقييم من ودجت

قررت تشغيل التقييم عشوائياً لكل من يزور صفحة البوابة الرئيسية في اليوم الثالث والعشرين من أي شهر. أنشأت ودجتاً وأضفتها إلى صفحة البوابة الرئيسية بالسكريبت التالي على جانب الخادم:

(function() {

    var gdtSurvey = new GlideDateTime();
    if (gdtSurvey.getDayOfMonthUTC() == 23) {
        (new SNC.AssessmentCreation()).createAssessments(
            'd902e09a075730101263f19d7c1ed03a',
            '4baec2fe07d3f0101263f19d7c1ed0a6',
            gs.getUserID()
        );
        data.uSelected = 'لقد تم اختيارك لأداء تقييم بوابة الخدمة';
    }

})();

عند تحقق الشرط، يُنشأ نموذج تقييم ويُعين للمستخدم الزائر. هذا النمط مرن — يمكنك تغيير شرط التشغيل لأي منطق عمل، مثل إغلاق حالة دعم أو إنهاء تفاعل.