Qlik Sense Desktop仪表板布局导出及字段溯源技术问询

1. 在Qlik Sense Desktop中查看仪表板结构/布局（XML/JSON格式） #

有两种实用方法：

• 解压QVF文件
  Qlik Sense应用（.qvf）本质是压缩包，将后缀改为.zip后解压，data目录下的layout.json包含完整仪表板、可视化组件及样式配置；objects目录下的单个JSON文件对应每个可视化对象的详细结构。
• 调用Qlik Engine API
  启动Qlik Sense Desktop后，通过本地WebSocket端点（默认ws://localhost:4848/app/{app-id}）建立连接，发送GetLayout请求获取指定仪表板对象的完整JSON结构，可通过浏览器开发者工具调试或用enigma.js编写脚本调用。

2. 通过Qlik Engine JSON API编写Python脚本是否可行？ #

完全可行。Qlik Engine API基于WebSocket协议，支持JSON格式的请求与响应，Python可通过websocket-client或pyenigma（enigma.js的Python封装库）实现连接交互。这种方式能直接操作应用底层对象，适合批量提取布局、字段映射等自动化场景，效率远高于GUI操作。

3. 解决enigma.js报错：TypeError: doc.mUnbuild is not a function #

错误原因是调用了不存在的方法，正确方法名为unbuild（无前缀m，小写开头）。enigma.js中文档对象的unbuild()方法用于将应用对象转换为JSON结构，修正方法名即可解决问题。

修正后的代码片段：

const app = await session.openDoc('your-app-id');
const appJson = await app.unbuild(); // 替换原有的app.mUnbuild()

同时需确保enigma.js版本与Qlik Sense Desktop的Engine版本兼容，建议主版本号匹配（如Qlik Sense 5.x对应enigma.js 2.x）。

4. 自动确定可视化字段/度量的源数据表（替代LLM方案） #

直接利用Qlik Engine API的元数据查询能力即可，无需依赖LLM：

• 获取字段原始表信息
  发送GetFieldDescription请求，返回的字段元数据中qSrcTable字段即为源数据表名称；对于计算度量，先解析表达式中的字段，再逐个查询源表。
• 处理脚本重命名字段
  Qlik脚本重命名（AS语句）会在元数据中保留原始字段与别名的映射，通过GetTableDescription请求获取表的字段列表，其中qName是别名，qSrcField是原始字段名，结合GetFieldDescription可追溯到源表。
• 批量处理脚本
  编写enigma.js或Python脚本，遍历所有可视化对象的维度/度量，解析字段后批量查询元数据，自动生成字段-源表映射表。

示例Python伪代码（基于pyenigma）：

from pyenigma import Enigma

async def get_field_source_table(doc, field_name):
    field = await doc.get_field(field_name)
    desc = await field.get_description()
    return desc['qSrcTable']

内容的提问来源于stack exchange，提问作者Wig