用途:@domoinc/toolkit 为 Domo 服务提供带类型的客户端类,用于在应用中访问身份、用户、群组、文件、SQL、AppDB、AI、CodeEngine 与 Workflow 等能力。安装:yarn add @domoinc/toolkit。
主要能力:AppDBClient 提供 NoSQL 文档存储(DocumentsClient 支持增删改查、MongoDB 风格查询与聚合,CollectionsClient 管理集合);IdentityClient 获取当前登录用户;SqlClient 执行 SQL 查询并可解析页面过滤器;UserClient、GroupClient 查询用户与群组;FileClient 上传、下载、修订与权限管理;AIClient 提供文本生成、Text to SQL、Text to Beast Mode、摘要等静态方法;CodeEngineClient 调用无服务器函数;WorkflowClient 列出、启动与查询工作流实例;DomoClient 作为 ryuu.js 的替代。
使用方式:多数方法返回 ToolkitResponse,数据在 body 中;AIClient 例外,负载常在 data 下,建议用 response.data || response.body || response 取值,并优先读取顶层 output。AppDB 查询支持 $eq、$in、$and、$or 等操作符,更新支持 $set、$unset、$inc、$push。CodeEngineClient 需在 manifest.json 配置 packageMapping。
限制:SQL 端点不遵循页面过滤器,仪表板内嵌应用应改用 Query 端点;AIClient 方法为静态且使用 snake_case 命名。其余细节资料未提供。