跳转到主要内容

创建和管理自定义服务

从空白创建易企办自定义服务,配置输入和输出变量,试运行后发布,并管理已接入工作流或表单的版本。

从空白创建服务

使用有应用资源创建权限的账号打开测试应用。进入「新建应用资源」,选择「自定义服务」,打开手动创建入口。也可以在应用设置中查找「集成」下的自定义服务管理页。如果该页提供创建操作,可直接开始。

将服务命名为「设备编号校验」,在描述中写明服务用来清理空格、统一大小写和检查编号格式。选择基于 JavaScript 的实现后进入代码编辑器。易企办自定义服务说明

配置变量和代码

先约定调用方传入什么、怎样接收结果。此示例只处理传入的文本。需要访问外部系统的服务可为该系统配置连接。服务参数与异常处理说明 · 易企办自定义服务模板

  • 输入。 rawCode,文本,调用方提交的设备编号。

  • 输出。 normalizedCode,文本,格式正确时返回 EQ- 后跟四位数字的编号。errorMessage,文本,输入无效时返回原因。

变量 ID 应与代码中的名称一致。将下面的逻辑写入服务代码编辑器。

export async function main({ params }) {
const rawCode = params?.rawCode;
const code = typeof rawCode === "string" ? rawCode.trim().toUpperCase() : "";

if (!/^EQ-[0-9]{4}$/.test(code)) {
return { normalizedCode: "", errorMessage: "请输入 EQ- 加四位数字组成的设备编号。" };
}

return { normalizedCode: code, errorMessage: "" };
}

试运行后发布

在编辑器测试区输入小写的 eq-0007,前后各加一个空格。应返回 EQ-0007,错误说明为空。再分别输入 EQ-07 和空白,核对错误说明,确认流程可以根据它转给人工处理。

保存草稿,样例验证通过后再发布。把已发布服务接入测试调用方,核对 rawCode 和两个输出的映射,并复测成功和失败情况。在工作流中调用自定义服务 · 在表单动作中调用自定义服务

设备编号校验示例。带空格和小写的编号返回 EQ-0007,位数不足的编号返回格式错误。

更新或停用服务

在应用设置的自定义服务管理页用名称找到服务,核对发布状态和版本。修改前先确认哪些工作流、表单动作或助手依赖现有变量。若编辑器提供历史操作,可以查看旧版。恢复为草稿后,先核对变量和重新试运行,再按需要发布。自定义服务版本与复用说明

如果管理页提供共享操作,先确认目标应用与调用权限,再到该应用测试。准备停用或删除时,先核对现有调用方并安排替代。若需要在另一个应用中维护服务副本,可以导出 .ycs 文件,导入后重新验证变量、连接与调用。导入和导出自定义服务

这是否解答了您的问题?