youdata-report-export
SKILL.md
有数报告导出技能
功能
该技能允许用户导出有数BI的报告为pdf/图片/excel/word。
依赖环境
- Node.js 20+
- 需要网络连接访问知数平台API
- 需要安装 skill
youdata-env-config并完成配置
使用方法
- 提供报告ID (reportId)
配置要求
需要在skill目录下 /scripts/env.js 中配置:
tokenKey: 用户的有数tokenKeydomainUrl: API域名
调用示例
- step1:使用 skill
youdata-env-config获取 env(json字符串格式),同一次会话youdata系列的skill可以复用,不用二次生成 - step2:获取当前 SKILL.md 的绝对目录地址 skillFolder
- step3: 确认reportId。若没有给到报告ID,而是给到了报告链接地址,则可以通过以下方式解析和获取到reportId:
- dash/preview 接口解析规则:https://d.youdata.netease.com/dash/preview/${reportId}/${dashboardId}/${componentId}
- dash/folder 接口解析规则: https://d.youdata.netease.com/dash/folder/${projectId}?rid=${reportId}
- step4: 确认exportType, 目前参数支持pdf、picture、excel、word
- step5: 如果导出类型为excel,可以设置limit,即为导出行数限制,默认为50000
- step6:调用脚本
node ${skillFolder}/scripts/index.js <reportId> <exportType> <env> <limit>
参数说明
reportId: 报告的唯一标识符exportType: 导出类型(可选 pdf/picture/excel/word)
返回结果
返回JSON格式的查询结果,主要包含以下内容:
{
"code": 200,
"result": "http://..." // 文件下载地址
}
错误处理
- 缺少参数时会提示正确用法
- 配置不完整时会提示配置信息
- 网络错误会显示具体错误信息
- 脚本查询失败时显示错误信息并立刻终止问答