SDK 规范

方法和属性

您可以在自定义应用程序或网页中包含以下方法和属性。

初始化

该init方法是可选的。 它返回 IRobotSDK 实例，您可以将其存储为变量以供以后使用。

const robot = UiPathRobot.init();

设置

“设置”类型的 settings 属性让您可以更改默认端口号、轮询间隔时间（以毫秒为单位），或禁用发送遥测数据。

const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000;
robot.settings.disableTelemetry = true;

启动

on方法用于将事件处理程序附加到 SDK。

可用的 SDK 事件为 consent-prompt、missing-components 和 open-uipath-protocol。

同意提示

每次您的自定义应用程序或网页需要连接到机器人时，UiPath JavaScript SDK 都会显示内置的同意叠加层。

可以使用自定义处理程序覆盖此同意覆盖。

const robot = UiPathRobot.init();
robot.on('consent-prompt', consentCode => console.log(consentCode));

缺少组件

当机器人 JS 服务未运行时，将引发missing-components事件。 在这种情况下，SDK 会显示一个错误，可以使用自定义处理程序覆盖该错误。

const robot = UiPathRobot.init();
robot.on('missing-components', () => console.log('Missing Components'));

open-uipath-protocol

在显示同意提示之前，系统可能会要求您允许浏览器在关联应用程序中打开 uipath-web URL。

默认情况下，RobotJS 会自动尝试打开此 URL，但用户可以通过提供自定义事件处理程序来覆盖此行为。

const robot = UiPathRobot.init();
robot.on('open-uipath-protocol', (protocolUrl) => console.log('RobotJS protocol URL: ' + protocolUrl));

获取进程

该getProcesses方法检索可用流程的列表。 将 Promise 返回至 RobotProcess 对象数组。如果机器人已连接到 Orchestrator，则它将从机器人所属的环境和文件夹中检索流程。 否则，系统将检索本地流程。

const robot = UiPathRobot.init();
const processes = await robot.getProcesses();
for(let i=0; i<processes.length; i++){
    console.log(processes[i].name + " (" + processes[i].description + ") - Id=" + processes[i].id);
}

获取输入参数架构

通过使用已安装流程的 inputArgumentsSchema 属性，您可以检索流程的输入参数。 使用 inputArgumentsSchema 属性前，您需要先安装流程。

该installProcess方法安装流程，并向类型为 InstallProcessResult 的对象返回 Promise，该对象包含 InputArgumentSchema 对象数组。

const robot = UiPathRobot.init();
const processes = await robot.getProcesses();
const installedProcess = await robot.installProcess(processes[0].id);
for(let i=0; i<installedProcess.inputArgumentsSchema.length; i++){
    console.log("Argument " + i + ":");
    console.log("  name: " + installedProcess.inputArgumentsSchema[i].name)
    console.log("  type: " + installedProcess.inputArgumentsSchema[i].type)
    console.log("  isRequired: " + installedProcess.inputArgumentsSchema[i].isRequired)
    console.log("  hasDefault: " + installedProcess.inputArgumentsSchema[i].hasDefault)
}

备注：

在 TypeScript 中，RobotProcess Object 的方法可用于安装流程。install

const robot = UiPathRobot.init();
const processes = await robot.getProcesses();
const myProcess = processes.find(p => p.name === "MyProcess");
const installedProcess = await myProcess.install();

开始作业

startJob 方法会收到已创建的 Job 并将其启动。它向 JobResult 类型的 Object 返回 Promise，该 Object 包含输出参数。

该createJob方法使用流程 ID 创建机器人作业。 它可以选择接收作业输入参数。 它会返回一个 Job 对象。

备注：

从 v2022.10 开始，流程列表会在流程执行的同时刷新，在此之前，流程列表会在流程启动之前刷新。这意味着，在运行有可用更新的流程时，作业可能会使用该流程的旧版本运行。

robot = UiPathRobot.init();
processes = await robot.getProcesses();
const calculatorProcess = processes.find(p => p.name.includes('Calculator'));
const arguments = {
    "input1" : 23,
    "input2" : 42,
    "operation" : "add"
};
const job = robot.createJob(calculatorProcess.id, arguments);
const result = await robot.startJob(job);
console.log(result.Sum);

备注：

在 TypeScript 中，可以使用作业类构造函数创建作业。

robot = UiPathRobot.init();
processes = await robot.getProcesses();
const calculatorProcess = processes.find(p => p.name.includes('Calculator'));
const arguments = {
    "input1" : 23,
    "input2" : 42,
    "operation" : "add"
};
const job = new Job(calculatorProcess.id, arguments);
const result = await robot.startJob(job);
console.log(result.Sum);

启动作业

Job对象的on方法用于将事件处理程序附加到作业。 可用的事件为status和workflow-event 。

状态

每次作业状态发生更改时，都会在作业执行期间引发status事件。

每次执行“报告状态”活动时，也会引发此事件。

const robot = UiPathRobot.init();
const job = robot.createJob('processId');
job.on('status', robotStatus => console.log(robotStatus));
await robot.startJob(job);

工作流事件

每次执行发送工作流事件的活动时，workflow-event都会在作业执行期间引发该事件。 它支持在“发送临时结果”活动的帮助下实现部分结果。 事件处理程序具有 WorkflowEventData 类型的参数。

const robot = UiPathRobot.init();
const job = robot.createJob('processId');
job.on('workflow-event', e => console.log(e.name));
await robot.startJob(job);

启动进程

对象 RobotProcess 的 start 方法用于通过向流程传递输入参数（如果可用）来启动流程。

它返回 JobPromise 类型的对象。

const robot = UiPathRobot.init();
const processes = await robot.getProcesses();
const myProcess = processes.find(p => p.name === "MyProcess");
const arguments = {
    "a" : 41,
    "b" " 27
};
const result = await myProcess.start(arguments);

流程开启状态

onStatus方法用于将事件处理程序附加到作业的“状态”事件。

const robot = UiPathRobot.init();
const processes = await robot.getProcesses();
const myProcess = processes.find(p => p.name === "MyProcess");
const result = await myProcess.start().onStatus(status => console.log(status));

处理工作流事件

onWorkflowEvent方法用于将事件处理程序附加到作业的“workflow-event”事件。

const robot = UiPathRobot.init();
const processes = await robot.getProcesses();
const myProcess = processes.find(p => p.name === "MyProcess");
const result = await myProcess.start().onWorkflowEvent(e => console.log(e.name));

停止流程

stopProcess方法用于停止正在执行的机器人流程。

它返回一个承诺，该承诺在成功取消正在运行的机器人流程后得到解决。

const robot = UiPathRobot.init();
const processes = await robot.getProcesses();
const myProcess = processes.find(p => p.name === "MyProcess");
const result = await myProcess.start();
await robot.stopProcess(myProcess);

模型定义

IRobotSDK

interface IRobotSDK {
    settings: Settings;
    getProcesses(): Promise<Array<RobotProcess>>;
    init(): IRobotSDK;
    on(eventName: string, callback: (argument?: any) => void): void;
    startJob(job: Job): Promise<JobResult>;
    stopProcess(process: RobotProcess): Promise<void>;
    installProcess(processId: string): Promise<InstallProcessResult>;
}

设置

class Settings {
    portNumber: number;
    pollTimeInterval: number;
    disableTelemetry: boolean;
}

机器人流程

class RobotProcess {
    id: string;
    name: string;
    description?: string;
    start: (inArguments?: any) => JobPromise;
    install: () => Promise<InstallProcessResult>;
}

安装流程结果

class InstallProcessResult {
    inputArgumentsSchema: InputArgumentSchema[]
}

输入参数架构

class InputArgumentSchema {
    name: string;
    type: string;
    isRequired: boolean;
    hasDefault: boolean;
}

工作承诺

class JobPromise {
    onStatus(eventHanlder: (argument?: any) => void): JobPromise;
    onWorkflowEvent(eventHanlder: (argument?: any) => void): JobPromise;
}

作业

class Job {
    processId: string;
    argument?: any;
    jobId: string;
    on(eventName: string, eventHanlder: (argument?: any) => void): void;
}

作业结果

class JobResult {
    [Key: string]: any;
}

工作流事件数据

class WorkflowEventData {
    name: string;
    payload: string;
}