Del via

getEnabledProcesses (klient-API-referanse)

Asynkront henter forretningsprosessflytene som er aktivert for en tabell som den gjeldende brukeren kan bytte til.

Syntaks

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

Parameter

Navn Type Kreves Beskrivelse
callbackFunction Function Ja Tilbakeringingsfunksjonen må godta en parameter som inneholder et objekt med ordlisteegenskaper der navnet på egenskapen er ID-en for forretningsprosessflyten, og verdien for egenskapen er navnet på forretningsprosessflyten.

De aktiverte prosessene filtreres i henhold til brukerens rettigheter. Listen over aktiverte prosesser er de samme som en bruker kan se i brukergrensesnittet hvis de vil endre prosessen manuelt.

Eksempel

Sdk.formOnLoad-funksjonen i eksemplet bruker metoden formContext.data.process.getEnabledProcesses til å hente informasjon om forretningsprosessflyter som er aktivert for tabellen. Eksemplet sender en anonym funksjon som den første parameteren. Denne funksjonen kjøres asynkront når dataene returneres, og dataene sendes som parameter til den anonyme funksjonen.

Informasjonen om aktivert forretningsprosessflyt er angitt som et ordlisteobjekt der ID-en for prosessen er navnet på egenskapen, og navnet på forretningsprosessflyten er verdien for egenskapen. Eksempelkoden behandler denne informasjonen og angir verdiene i en global Sdk.enabledProcesses-matrise som skal åpnes av logikk som utføres senere. Eksemplet går også gjennom verdiene i matrisen Sdk.enabledProcesses , og bruker Sdk.writeToConsole-funksjonen til å skrive informasjon om de hentede forretningsprosessflytene til konsollen.

Note

Sdk.formOnLoad-funksjonen i JavaScript-eksempelbiblioteket må angis som hendelsesbehandling for OnLoad for et skjema, og passkjøringskonteksten som den første parameteren må være valgt i dialogboksen Egenskaper for behandling.
Dette eksemplet illustrerer også bare bruken av noen av metodene i formContext.data.process-API-en . Den representerer ikke bruk av denne API-en for å oppfylle et forretningskrav. det er bare ment å demonstrere hvordan nøkkelegenskapsverdiene kan åpnes i kode.

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

Når du kjører dette eksemplet med utviklerverktøyene for nettleseren åpen, er følgende et eksempel på utdataene som er skrevet til konsollen for en tabell med flere forretningsprosessflyter aktivert.

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