整理了一下一些与 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)来完成。