如何通过Enigma.js将Qlik对象发布至Qlik Hub？

问题本质 #

你使用createObject()创建的是内存临时对象，这类对象仅存在于应用内存中，未被持久化到应用存储，因此无法调用publish()方法（该方法仅对已持久化的应用对象生效），这就是你收到"Bad Request"错误的原因。

正确实现步骤 #

1. 创建持久化应用对象 #

放弃createObject()，改用Enigma.js中app实例的createAppObject()方法，它会将对象持久化到应用中，为后续发布操作提供基础。

示例代码（以柱状图为例）：

// 定义对象属性，根据实际对象类型调整配置
const objectProps = {
  qInfo: {
    qType: 'barchart', // 合法类型：barchart/table/variable/dimension等
    qId: '' // 留空让引擎自动生成唯一ID
  },
  qMetaDef: {
    title: '自定义柱状图' // Hub中显示的对象名称
  },
  // 柱状图核心配置：维度与度量
  qHyperCubeDef: {
    qDimensions: [{ qDef: { qFieldDefs: ['你的维度字段'] } }],
    qMeasures: [{ qDef: { qDef: 'Sum(你的度量字段)' } }]
  }
};

// 创建持久化对象
const persistedObject = await app.createAppObject(objectProps);

2. 执行发布操作 #

持久化对象创建完成后，调用其publish()方法即可发布到Hub。注意需确保应用已归属某个流，或指定目标流ID：

// 方式1：发布到当前应用所在的流（应用需已在流中）
await persistedObject.publish();

// 方式2：指定目标流ID发布
await persistedObject.publish({ qStreamId: '目标流的ID' });

3. 关键注意事项 #

• 权限验证：确保Enigma.js连接使用的账号拥有应用编辑权限和流发布权限，权限不足会直接触发Bad Request。
• 对象类型合法性：qInfo.qType必须是Qlik官方支持的类型，错误类型会导致对象创建失败。
• 配置完整性：不同类型对象需对应完整配置（如变量需qStringExpression，维度需qFieldDefs），缺失必要参数会引发错误。

错误排查技巧 #

• 查看Qlik Server引擎日志（默认路径：C:\ProgramData\Qlik\Sense\Log\Engine），日志会给出Bad Request的具体原因（如参数错误、权限不足）。
• 使用Qlik Engine API Explorer测试CreateAppObject和Publish接口，验证参数正确性后再迁移到Enigma.js代码中。

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