用途:在 Domo App Platform 应用中通过 Toolkit 的 WorkflowClient 启动并监控工作流,属于开发规则类资料。
主要能力:安装依赖 yarn add @domoinc/toolkit,导入 import { WorkflowClient } from '@domoinc/toolkit'。用 WorkflowClient.startModel('myWorkflow', { inputVar: 'value', anotherVar: 123 }) 启动,返回体取 startResponse.body;用 WorkflowClient.getInstance('myWorkflow', instance.id) 查询状态,取 statusResponse.body.status。还可用 getAllModels()、getAllModels(true)、getModelDetails('myWorkflow')。
关键约束:方法使用 manifest.json 中 workflowMapping 的 alias,而非 UUID。manifest 需配置 workflowMapping,含 alias、modelId 和 parameters(aliasedName、type、list、children)。需在 Domo 卡片/应用配置 UI 中把应用卡片映射到目标工作流模型,并确认工作流起始节点输入参数与应用发送的 payload 键名、类型、list 设置一致,否则可能启动失败或静默错误处理输入。生成 startModel 调用时必须明确告知用户传入的输入变量名和类型。
错误处理:用 try/catch 包裹 startModel,失败时记录日志并抛出。
检查清单:workflowMapping 已配置;卡片已映射到正确工作流;起始节点参数与 payload 匹配;使用基于 alias 的方法;代码传 alias 而非 UUID;解析 response.body;长时工作流需状态检查或异步反馈。
限制:资料未提供具体平台版本、收费、性能或效果信息。