getEnabledProcesses (Αναφορά API προγράμματος-πελάτη)

Ανακτά ασύγχρονα τις ροές επιχειρηματικής διαδικασίας που είναι ενεργοποιημένες για έναν πίνακα στον οποίο μπορεί να μεταβεί ο τρέχων χρήστης.

Σύνταξη

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

Παράμετρος

Όνομα	Δακτυλογραφώ	Απαραίτητο	Περιγραφή
callbackFunction	Function	Ναι	Η συνάρτηση επιστροφής κλήσης πρέπει να αποδεχτεί μια παράμετρο που περιέχει ένα αντικείμενο με ιδιότητες λεξικού όπου το όνομα της ιδιότητας είναι το αναγνωριστικό της ροής επιχειρηματικής διαδικασίας και η τιμή της ιδιότητας είναι το όνομα της ροής επιχειρηματικής διαδικασίας. Οι ενεργοποιημένες διαδικασίες φιλτράρονται σύμφωνα με τα δικαιώματα του χρήστη. Η λίστα των ενεργοποιημένων διαδικασιών είναι η ίδια με αυτές που μπορεί να δει ένας χρήστης στο περιβάλλον εργασίας χρήστη εάν θέλει να αλλάξει τη διαδικασία με μη αυτόματο τρόπο.

Παράδειγμα

Η συνάρτηση Sdk.formOnLoad στο παράδειγμα χρησιμοποιεί τη μέθοδο formContext.data.process.getEnabledProcesses για την ασύγχρονη ανάκτηση πληροφοριών σχετικά με τις ροές επιχειρηματικής διαδικασίας που είναι ενεργοποιημένες για τον πίνακα. Το δείγμα διαβιβάζει μια ανώνυμη συνάρτηση ως την πρώτη παράμετρο. Αυτή η συνάρτηση εκτελείται ασύγχρονα όταν επιστρέφονται τα δεδομένα και τα δεδομένα διαβιβάζονται ως παράμετρος στην ανώνυμη συνάρτηση.

Οι πληροφορίες σχετικά με την ενεργοποιημένη ροή επιχειρηματικής διαδικασίας παρέχονται ως αντικείμενο λεξικού όπου το αναγνωριστικό της διαδικασίας είναι το όνομα της ιδιότητας και το όνομα της ροής επιχειρηματικής διαδικασίας είναι η τιμή της ιδιότητας. Το δείγμα κώδικα επεξεργάζεται αυτές τις πληροφορίες και ορίζει τις τιμές σε έναν καθολικό πίνακα Sdk.enabledProcesses για πρόσβαση από λογική που εκτελείται αργότερα. Το δείγμα επίσης επαναλαμβάνει τις τιμές στον πίνακα Sdk.enabledProcesses και χρησιμοποιεί τη συνάρτηση Sdk.writeToConsole για να γράψει πληροφορίες σχετικά με τις ροές επιχειρηματικής διαδικασίας που ανακτώνται στην κονσόλα.

Σημείωμα

Η συνάρτηση Sdk.formOnLoad στο δείγμα βιβλιοθήκης JavaScript πρέπει να οριστεί ως χειρισμός συμβάντων OnLoad για μια φόρμα και το περιβάλλον εκτέλεσης διαβίβασης ως το πρώτο πλαίσιο ελέγχου παραμέτρου πρέπει να επιλεγεί στο παράθυρο διαλόγου Ιδιότητες χειρισμού .
Επίσης, αυτό το δείγμα απλώς απεικονίζει τη χρήση ορισμένων από τις μεθόδους στο API 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