Dynamics CRM 日常使用JS整理(二)

时间:2023-03-08 15:51:56
Dynamics CRM 日常使用JS整理(二)

整理了一下一些与 BPF(Business Process Flow)相关的 JS 操作:

为 Stage 添加 changed 或者 selected 事件:

function fnOnLoad() {

  Xrm.Page.data.process.addOnStageChange(fnStageChanged);//change 事件,跳转到当前 Stage 时触发

  Xrm.Page.data.process.addOnStageSelected(fnStageSelected);//select事件,选中当前 Stage 时触发

}

function fnStageChanged(execContext){

  var currentStage = execContext.getEventArgs().getStage();//获取当前Stage

  //其他操作

}

获取当前 Stage:

var activeStage = Xrm.Page.data.process.getActiveStage();

获取当前 Stage 的名称:

var sName = activeStage.getName();

获取当前 Stage 的状态:

var oStatus = activeStage.getStatus();    //active or inactive

更多相关的 api 可以参考:

https://adisys.wordpress.com/2017/01/03/dynamics-crm-scripting-for-business-process-flows/

获取 Stage 下的字段名(step):

//"header_process_sFiledName",可用F12查看,若存在同名step,系统会自动在后面累加数字,比如:"header_process_sFiledName_1"

对 Stage 中的字段加锁(设置只读):

Xrm.Page.getControl("header_process_sFiledName_1").setDisabled(true);

设置 BPF 的状态:

Xrm.Page.data.process.setStatus("finished");//set finished,BPF流程已经完成

获取 BPF 的状态:

var oStatus = Xrm.Page.data.process.getStatus();

oStatus == "active";   //BPF处于active状态,未finished

oStatus == "finished"; //BPF处于finished状态

oStatus == "aborted";  //BPF处于abandon状态,灰色不可编辑

abandon 一个 BPF,整个流程会变成灰色,不可操作:

Xrm.Page.data.process.abandonProcess();  //BPF处于finished状态时,不可以执行abandon操作,会报错

reactivate 一个 BPF,将已经 abandon 的 BPF 恢复到 active 状态,可编辑和操作:

Xrm.Page.data.process.reactivateProcess();

Note:利用 JavaScript 对 Business Process Flow 进行 abandon 或者 reactivate 需要在 Form 的 OnSave 事件执行完毕之后,可以利用回调函数(call back)来完成。