getEnabledProcesses (مرجع واجهة برمجة تطبيقات العميل)

يسترد بشكل غير متزامن تدفقات عملية العمل الممكنة لجدول يمكن للمستخدم الحالي التبديل إليه.

بناء الجملة

formContext.data.process.getEnabledProcesses(callbackFunction(enabledProcesses));

المعلمة

Name	نوع	المطلوب	‏‏الوصف
callbackFunction	الدالة	‏‏نعم‬	يجب أن تقبل دالة رد الاتصال معلمة تحتوي على كائن بخصائص القاموس حيث يكون اسم الخاصية هو معرف تدفق عملية العمل وقيمة الخاصية هي اسم تدفق عملية الأعمال. تتم تصفية العمليات الممكنة وفقا لامتيازات المستخدم. قائمة العمليات الممكنة هي نفس العمليات التي يمكن للمستخدم رؤيتها في واجهة المستخدم إذا كان يريد تغيير العملية يدويا.

مثال

تستخدم الدالة Sdk.formOnLoad في المثال طريقة formContext.data.process.getEnabledProcesses لاسترداد معلومات حول تدفقات عمليات الأعمال التي تم تمكينها للجدول بشكل غير متزامن. تمرر العينة دالة مجهولة كمعلمة أولى. يتم تنفيذ هذه الدالة بشكل غير متزامن عند إرجاع البيانات وتم تمرير البيانات كمعلمة إلى الدالة المجهولة.

يتم توفير المعلومات حول تدفق عملية الأعمال الممكنة ككائن قاموس حيث معرف العملية هو اسم الخاصية واسم تدفق عملية العمل هو قيمة الخاصية. يعالج نموذج التعليمات البرمجية هذه المعلومات ويعين القيم في صفيف Sdk.enabledProcesses العمومي ليتم الوصول إليه بواسطة المنطق الذي يتم تنفيذه لاحقا. تتكرر العينة أيضا عبر القيم في صفيف Sdk.enabledProcesses ، وتستخدم الدالة Sdk.writeToConsole لكتابة معلومات حول تدفقات عملية الأعمال المستردة إلى وحدة التحكم.

إشعار

يجب تعيين الدالة Sdk.formOnLoad في مكتبة JavaScript النموذجية كمعالج أحداث OnLoad لنموذج، ويجب تحديد خانة الاختيار تمرير التنفيذ كمعلمة أولى في مربع الحوار خصائص المعالج .
أيضا، يوضح هذا النموذج فقط استخدام بعض الأساليب في formContext.data.process API. لا يمثل استخدام واجهة برمجة التطبيقات هذه لتلبية متطلبات العمل؛ يهدف فقط إلى توضيح كيفية الوصول إلى قيم خاصية المفتاح في التعليمات البرمجية.

//A namespace defined for SDK sample code
//You should define a unique namespace for your libraries
var Sdk = window.Sdk || {};
(function () {
    //A global variable to store information about enabled business processes after they are retrieved asynchronously
    this.enabledProcesses = [];

    // A function to log messages while debugging only
    this.writeToConsole = function (message) {
        if (typeof console != 'undefined')
        { console.log(message); }
    };

    // Code to run in the OnLoad event 
    this.formOnLoad = function (executionContext) {
        // Retrieve the formContext
        var formContext = executionContext.getFormContext();

        // Retrieve Enabled processes
        formContext.data.process.getEnabledProcesses(function (processes) {
            //Move processes to the global Sdk.enabledProcesses array;
            for (var processId in processes) {
                Sdk.enabledProcesses.push({ id: processId, name: processes[processId] })
            }
            Sdk.writeToConsole("Enabled business processes flows retrieved and added to Sdk.enabledProcesses array.");

            //Write the values of the Sdk.enabledProcesses array to the console
            if (Sdk.enabledProcesses.length < 0) {
                Sdk.writeToConsole("There are no enabled business process flows for this table.");
            }
            else {
                Sdk.writeToConsole("These are the enabled business process flows for this table:");
                for (var i = 0; i < Sdk.enabledProcesses.length; i++) {
                    var enabledProcess = Sdk.enabledProcesses[i];
                    Sdk.writeToConsole("id: " + enabledProcess.id + " name: " + enabledProcess.name)
                }
            }

            //Any code that depends on the Sdk.enabledProcesses array needs to be initiated here

        });
    };

}).call(Sdk);

عند تشغيل هذه العينة مع فتح أدوات مطور المستعرض، ما يلي مثال على الإخراج المكتوب إلى وحدة التحكم لجدول مع تمكين تدفقات عمليات الأعمال المتعددة.

Enabled business processes flows retrieved and added to Sdk.enabledProcesses array.
These are the enabled business process flows for this table:
id: 7994be68-899e-4a40-8d18-f5c3b6940188 name: Sample Lead Process
id: 919e14d1-6489-4852-abd0-a63a6ecaac5d name: Lead to Opportunity Sales Process

المقالات ذات الصلة

setActiveProcessInstance
formContext.data.process