前言¶

给用友 BIP 高级版写报表的人，通常要面对两类问题：一类是「这个字段到底存的是什么」，报表里带金额、带数量、带单据头的字段名往往看不出含义，只能翻表结构；另一类是「这个环境下能不能直接连库」。多数情况下你只能靠 DBA 开账号、靠人肉比对字段，取数 SQL 写完也说不清字段来源。

下面介绍的 Skill「用友BIP高级版自由报表撰写」就是处理这件事的：以数据字典的本地检索为核心，按你所处的环境（可连库 / 不可连库）给出对应的产出方式，把取数 SQL、视图、校验逻辑写出来并做数据验证。

这是什么¶

一句话定位：在写 BIP 高级版自由报表之前，先用数据字典把字段、外键和特殊含义字段查清楚，再据此产出取数 SQL / 视图 / 校验逻辑并验证数据。

发布与维护：由社区开发者 user_3d743042 发布，坐标 @user_3d743042/yonyou-js-djw-report，来源 community，当前版本 2.4.0，分类 data-analysis。

解决什么问题：替代「先连库看表结构 / 找同事问字段含义」的做法，把字段解释和外键关系固化进一条可复用的流程里。

核心能力¶

资料里明确列出的能力有以下几项：

• 撰写 BIP 高级版业务报表时，按需求产出取数 SQL、视图与校验逻辑，并对结果做数据验证。
• 区分「可连库」与「不可连库」两种环境：能连库时可以直接对照实际库验证，不能连库时依赖数据字典与已有结构信息推进。
• 解析字段含义与外键关系，回答「某字段来自哪张表、关联条件是什么」。
• 定向查找具有特殊含义的字段，例如带特定前缀或后缀、命名上看不出实际业务的字段。

触发场景按官方简介列出四种：撰写 BIP 高级版业务报表、按需求出取数 SQL、解析字段与外键、定向查找特殊含义字段。

数据字典：首次调用自动拉取，不内嵌在技能包里¶

这是这个 Skill 在结构上最需要注意的一点：数据字典不内嵌在技能包里，而是在扩展数据包首次被调用时自动拉取。

带来的实际影响有两个：

1. 首次使用前需要保证扩展数据包能正常拉取字典，否则检索无从谈起。
2. 字典内容会跟随扩展数据包的更新而变化，写死字段结论的意义不大，每次都应以当前字典为准。

因此在使用上要养成顺序：先触发一次字典拉取与检索，再谈 SQL 产出，不要默认技能包里已经带了完整字典。

安装与启用¶

已抓取的资料中只给出了坐标、版本、分类与标签，没有给出官方安装命令或目录约定，因此这里不写未经核实的安装方式。需要安装时，以官方页面为准：

https://www.skillhub.cn/skills/user_3d743042/yonyou-js-djw-report

https://api.skillhub.cn/user_3d743042/yonyou-js-djw-report

在页面上确认安装方式、所需权限与扩展数据包的拉取要求后，再在自己的环境里启用。该 Skill 标签为 requires_api_key=false，即不要求提供 API Key，但数据字典来自扩展数据包这一前提不变。

按 SkillHub 页面数据（抓取时点 2026-10-30）：评分 100000，下载 2181 次，安装 0 次。页面数据会变动，使用时以页面实时值为准。

典型用法¶

官方简介给出的是触发场景而非逐字操作步骤，下面按资料中的触发条件梳理一条可复现的工作流：

1. 明确需求属于哪一类：撰写报表、出取数 SQL、解析字段与外键，还是定向查找特殊含义字段。
2. 确认环境：当前是可连库还是不可连库。这一步决定后面能不能用实际库做验证。
3. 触发扩展数据包的字典拉取，检索字段名与含义，记录表名与外键关系。
4. 对命名看不出业务含义的字段做定向查找，确认其实际语义后再在 SQL 中使用。
5. 产出取数 SQL / 视图 / 校验逻辑。
6. 做数据验证：可连库时对照实际数据核对结果，不可连库时至少校验字段来源与关联条件是否自洽。

注意第 5、6 步的产出质量取决于第 3、4 步检索到的字典信息。跳过字典直接写 SQL，等于回到人肉猜字段的老路。

适用场景与注意¶

适合谁：

• 在用友 BIP 高级版上做自由报表开发、需要频繁写取数 SQL 的开发者。
• 接手已有报表项目、需要快速弄清字段含义与关联关系的维护人员。
• 环境受限、无法长期直接连库查表结构的人，可用字典检索替代部分人工确认。

限制与坑：

• 字段解释依赖扩展数据包中的字典，字典未覆盖的表或字段查不出来，这类情况仍需回到实际库或向业务方确认。
• 不可连库环境下无法用真实数据做验证，校验逻辑的可靠性要另外想办法确认。
• 「特殊含义字段」的判定依赖字典，字典未收录的新字段名可能被漏掉。
• 安装方式与扩展数据包拉取要求请以官方页面为准，本文未获取到可直接复制的安装命令。

小结¶

这个 Skill 的价值在于把写报表前的字段确认工作收敛成一条流程：先区分环境，再检索字典，然后产出取数 SQL / 视图 / 校验逻辑并验证。它不替代你对业务的理解，但能减少「猜字段、问同事、连库翻表结构」这类重复劳动。

官方地址：https://www.skillhub.cn/skills/user_3d743042/yonyou-js-djw-report