配置资产目录与 BI 对接任务

数据资产中的任务管理用于与适配的 BI 服务对接目录。此功能与数据市场申请后的线下数据交付不是同一流程。

准备对接

此操作面向具备相应权限的目录空间管理员、目录管理员。先由 BI 管理员准备应用认证、服务地址及接口授权。使用帆软对接应用且采用“AkSk 直接认证”时，需核对以下接口权限：

接口用途	原对接说明中的接口路径	准备检查
获取所有文件夹	v3/bi/conf/groups	能读取目标 BI 目录
添加文件夹	v3/bi/conf/pack	具备创建所需目录的授权
查询数据连接列表	v3/connection	可获得需使用的数据连接
添加数据库数据集	v3/bi/spider/table/db	具备建立数据集的授权

这些路径是对接准备清单，不是需要用户在 DAM 手工逐个调用的 API。实际接口和适配范围应与所部署 BI 服务核对，不把一套配置套用到任意 BI 产品。

DAM 任务配置	应由谁提供	注意事项
BI 服务地址	BI 管理员	使用应用 API 服务入口，而不是浏览器登录首页；原对接说明的入口路径为 /webroot/decision/sp/client/api
应用 Client ID	BI 管理员	对应本次授权应用，不是操作人的登录名
应用 Secret	BI 管理员	与 Client ID 成对，不能写进文档或问题截图
任务属性及同步范围	目录管理员	对齐需要对接的资产目录，首次运行先确认范围

新建与运行任务

1. 进入“数据资产 → 任务管理”，单击“新建”。
2. 填写任务属性、BI 服务地址、应用 Client ID 与 Secret。
3. 测试连接，成功后才能保存。
4. 单击“确定”，在列表确认任务已建立；保存成功仅表示配置已保存。
5. 按需要使用操作栏“开启”或“关闭”。首次运行前检查目标目录和同步范围。
6. 单击“立即运行”。若出现“不在系统时间模版允许范围内执行”的提示，先核对允许窗口和目标 BI 的运行安排，再决定是否继续。
7. 若显示“排队中”，说明存在正在运行的任务，应继续跟踪执行状态，而不是重复单击立即运行。
8. 执行完成后，到目标 BI 检查对应目录结果。

编辑连接后重新检查连通性。删除任务前确认是否仍承担周期同步。凭据只填写在产品配置中，不放在手册、截图或共享的问题记录中。

验证对接结果

1. 确认本次执行已经结束，记录任务、时间及结果。
2. 在 BI 侧找到预期目录，核对名称、层级及需要关联的连接或数据集。
3. 以获准的 BI 使用者检查是否能访问预期对象；管理员连接成功不能证明普通用户可用。
4. 出现差异时记录对应目录、任务结果与错误信息，再检查接口授权和连接配置。

此处验证的是目录与 BI 的对接结果，不代表数据市场的申请已经审批，也不代表 DAM 已替用户完成线下数据交付。

常见问题

现象	排查顺序
连接测试不通过	服务入口及网络 → Client ID/Secret 是否匹配 → 认证方式与接口授权
任务无法保存	先确认连接测试通过，再检查表单提示的属性
任务一直排队	检查已有运行任务的状态，不并行重复提交同一同步
运行前提示时间限制	核对系统时间模板及当前运行窗口
DAM 任务成功但 BI 结果不符合预期	对照目录范围、目标 BI 实例、授权及实际目录/数据集，不仅检查成功提示

相关任务：目录维护、资产注册与发布、任务调度。