用途:面向 Domo Custom Connector IDE 项目,帮助编写定义自定义 Domo 连接器的 JavaScript 代码。注意它不适用于 Domo App Platform 的自定义应用或卡片构建;自定义连接器经 Connector Dev Studio 发布后在服务端运行。
文件结构:authentication.js 负责校验凭据并与外部 API 完成认证;dataProcessing.js 负责从外部 API 拉取并处理数据;README.md 记录可用的报表与参数。
主要能力与做法:认证侧需先清洗凭据输入(用正则校验 API key/token),设置必要请求头后发起轻量测试请求验证凭据,并调用 auth.authenticationSuccess() 或 auth.authenticationFailed('reason'),不能留下模糊的认证状态。取数侧先检查 httprequest.getStatusCode() 再解析响应体,JSON 数组响应用 datagrid.magicParseJSON(jsonArray) 避免手工列映射,分页用 do...while 循环并以响应中的下一页链接或游标作为循环条件,用 metadata.report 区分报表类型、metadata.account.* 取凭据。错误处理按状态码捕获 HTTP 错误,尽量解析错误体得到可读信息,无法解析为 JSON 时回退到原始响应子串,并将错误重新抛出以便运行时正确呈现。
规则:始终清洗输入(API key、用户参数)以防注入;每行列数保持一致,缺失值用 null;使用 Domo 提供的方法(httprequest、datagrid、auth、metadata);authenticationFailed() 的消息应告诉用户需要修复什么;README.md 需记录全部报表与参数。完整认证、取数与错误处理样板可参阅 references/examples.md。
限制:资料未提供具体安装命令、收费或平台版本信息。