SuperAPI AI 工具集

domo-js

通用与其它

查看项目

更新于 10-15 23:39

技能介绍

用途:domo.js(包名 ryuu.js)是 Domo 应用/App Studio 自定义应用使用的 JavaScript SDK,用于与 Domo 运行环境交互。

安装:React/npm 项目使用 npm install ryuu.js,再 import domo from 'ryuu.js';原生 JavaScript 通过 CDN 引入 https://app.unpkg.com/ryuu.js@5.1.2。

主要能力: 环境信息:domo.env 提供 userId、customer、pageId、locale、platform。注意这些值可能被伪造,不能用于安全校验;需要可信身份时应服务端校验,如 await domo.get('/domo/environment/v1/'),或使用 @domoinc/toolkit 的 IdentityClient。 事件监听:domo.onDataUpdated 监听数据集更新;onFiltersUpdated/onFiltersUpdate 监听同页原生筛选器卡片变化,需在顶层注册,建议做兼容回退;onVariablesUpdated 监听 App Studio 变量变化,变量以数字字符串 ID 为键,返回的是展示标签,常需映射为内部值。 回写:requestVariablesUpdate 以 functionId(数字)写变量,回调为 onAck 与 onReply,更新会再次触发 onVariablesUpdated,需防循环;requestFiltersUpdate 以 column、operator、values、dataType 更新页面筛选器。注意入站字段名为 operand,出站用 operator。 导航:Domo 应用中普通 href 锚点不可靠,需用 domo.navigate('/page/123456789'),第二参数为 true 时新标签打开,外部 URL 同样支持。 数据:domo.getAll 可并行拉取多个数据集。

适用场景:Domo 自定义应用与 App Studio 中的环境读取、事件响应、联动筛选、依赖下拉和页面跳转。

限制:env 值不可信;筛选器与变量的字段命名存在不一致;变量变化需采用暂存/提交模式;部分监听器在部分运行时可能未初始化;上述之外的功能、收费与平台细节暂未提供。