Chia sẻ qua

getEnabledProcesses (Tài liệu tham khảo về API máy khách)

Truy xuất một cách không đồng bộ dòng quy trình kinh doanh được bật cho bảng mà người dùng hiện tại có thể chuyển sang.

Cú pháp

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

Tham số

Tên Loại Bắt buộc Mô tả
callbackFunction Hàm Có Hàm gọi lại phải chấp nhận tham số chứa một đối tượng với thuộc tính từ điển, trong đó tên của thuộc tính là Id của dòng quy trình kinh doanh và giá trị của thuộc tính là tên của dòng quy trình kinh doanh.

Các quy trình được kích hoạt được lọc theo đặc quyền của người dùng. Danh sách các quy trình được bật cũng giống như danh sách mà người dùng có thể nhìn thấy trong giao diện người dùng nếu họ muốn thay đổi quy trình theo cách thủ công.

Ví dụ:

Hàm Sdk.formOnLoad trong ví dụ sử dụng phương pháp formContext.data.process.getEnabledProcesses để truy xuất không đồng bộ thông tin về dòng quy trình kinh doanh được bật cho bảng. Mẫu truyền hàm ẩn danh làm tham số đầu tiên. Hàm này được thực hiện không đồng bộ khi dữ liệu được trả về và dữ liệu được truyền làm tham số cho hàm ẩn danh.

Thông tin về dòng quy trình kinh doanh đã bật được cung cấp dưới dạng đối tượng từ điển, trong đó Id của quy trình là tên của thuộc tính và tên dòng quy trình kinh doanh là giá trị của thuộc tính. Mã mẫu xử lý thông tin này và đặt giá trị trong mảng Sdk.enabledProcesses toàn cầu để truy nhập bằng lô-gic thực thi sau này. Mẫu cũng tạo vòng lặp qua các giá trị trong mảng Sdk.enabledProcesses và sử dụng hàm Sdk.writeToConsole để ghi thông tin về quy trình kinh doanh được truy xuất vào bảng điều khiển.

Lưu ý

Hàm Sdk.formOnLoad trong thư viện JavaScript mẫu phải được đặt làm bộ xử lý sự kiện OnLoad cho biểu mẫu và hộp kiểm Truyền ngữ cảnh thực thi là tham số đầu tiên phải được chọn trong hộp thoại Thuộc tính Bộ xử lý.
Ngoài ra, mẫu này chỉ minh họa việc sử dụng một số phương pháp trong API formContext.data.process . Nó không đại diện cho việc sử dụng API này để đáp ứng yêu cầu kinh doanh; mục đích của nó là để minh họa cách các giá trị thuộc tính khóa có thể được truy cập trong mã.

//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);

Khi bạn chạy mẫu này với các công cụ dành cho nhà phát triển trình duyệt đang mở, sau đây là ví dụ về đầu ra được viết vào bảng điều khiển cho bảng có nhiều dòng quy trình kinh doanh được bật.

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

  • Last updated on