在自动化中执行脚本

使用说明

自动化将使用脚本引擎执行步骤中的JS代码

使用说明

在自动化中运行的代码片段可使用脚本中所有函数，在此基础上额外扩展了自动化独有的automatic上下文对象

getVar

获取自动化的上下文变量

参数	类型	说明
varName	String	上下文变量名称

automatic.getVar(varName);

注意事项

若获取的变量名在上下文中不存在则会返回null值

setVar

设置自动化的上下文变量

参数	类型	说明
varName	String	上下文变量名称
value	Object	变量值

automatic.setVar(varName, value);

注意事项

若获取的变量名在上下文中存在则会覆盖已有变量值

setProgress

设置当前自动化的执行进度

参数	类型	说明
progress	Double	执行进度,范围0~100之间
message	String	进度描述文字

automatic.setProgress(50.56, '正在处理文件');

setReturnValue

设置当前自动化的返回值，该函数和设置自动化返回值步骤具有相同能力

参数	类型	说明
returnValue	Object	自动化返回值

automatic.setReturnValue(1);
automatic.setReturnValue(true);
automatic.setReturnValue(new Date());
automatic.setReturnValue({
    name: '张三'
});
automatic.setReturnValue([1, 2, 3, 4, 5, 6]);

注意事项

当使用多个automatic.setReturnValue时，仅最后一个调用会生效；所以对于如果需要返回多个值时，需要在代码片段中构建一个数据结构，整体返回

使用示例

• 普通示例

  

  Script.varList: [1, 2] 
  Script.varList1: null
  Automatic.varList:[3, 4, 5]
  Automatic.varList3:[7, 8, 9]

  const varList = automatic.getVar('varList');
  const varList1 = automatic.getVar('varList1');
  console.log('Script.varList:', varList);
  console.log('Script.varList1:', varList1);
  const varList3 = [7, 8, 9];
  automatic.setVar('varList', [3, 4, 5]);
  automatic.setVar('varList3', varList3);
  for (let i = 0; i < 10; i++) {
      automatic.setProgress((i + 1) * 10, `正在执行${i + 1}/10`);
  }
  automatic.setReturnValue(varList3);
  automatic.setReturnValue({
      name: '张三'
  });

  变量	表达式
  varList	${[1,2]}
  输出内容	Automatic.varList:${varList} Automatic.varList3:${varList3}

• 代码片段调用应用脚本

  export function automaticCall(data) {
      return {
          data,
          code: 0,
          message: "success"
      }
  }

  

  {code=0, data={date=Tue Jun 04 18:53:57 CST 2024, varList=[1, 2]}, message=success}

  import { automaticCall } from "automatic/automaticCall.js";
  const varList = automatic.getVar('varList');
  const result = automaticCall({
      date: new Date(),
      varList
  });
  
  automatic.setVar('result', result)

  变量	表达式
  varList	${[1,2]}
  输出内容	${result}