Наша организация использует Qlik Sense Enterprise, и мы стремимся автоматизировать процесс загрузки данных, используемых для визуализации (формат может быть Excel или csv), вместо ручного процесса, который приводит к следующему (показан обрезанный снимок экрана):
Для нашего варианта использования предположим, что есть только одно приложение с одним листом внутри, и этот лист имеет 3 визуализации.
Я написал скрипт Python, который в настоящее время подключен к локальному хосту, и я могу получить app_id, sheet_id и идентификатор трех диаграмм, представленных с помощью Qlik Engine JSON API. Код работает следующим образом:
Я предоставил код ниже для справки, а ссылку на pastebin можно получить здесь
import requests
import websocket, ssl
import json, csv
import os, time
from pprint import pprint
#Connecting to the server. The lines below will be replaced by the certificates and headers for enterprise usage later
ws = websocket.WebSocket()
ws.connect("ws://localhost:4848/app/")
#For getting the doc (app) list
doclist_req = {
"handle": -1,
"method": "GetDocList",
"params": [],
"outKey": -1,
"id": 1
}
ws.send(json.dumps(doclist_req))
result = ws.recv()
ws.send(json.dumps(doclist_req))
result = ws.recv()
result_json = json.loads(result)
print(result_json)
print()
#For opening the doc (app)
app_req = {
"jsonrpc": "2.0",
"method": "OpenDoc",
"handle": -1,
"params": [
#Can iterate if multiple apps are there
#Since only one app was present we used the index 0
result_json['result']['qDocList'][0]['qDocId']
],
"outKey": -1,
"id": 2
}
#The first call seems to be for establishing the connection and second to actually send the request body
ws.send(json.dumps(app_req))
result = ws.recv()
ws.send(json.dumps(app_req))
result = ws.recv()
result_json = json.loads(result)
print(result_json)
print()
app_req_handle = result_json['result']['qReturn']['qHandle']
#For creating the session object necessary for fetching dimensions, fields, etc.
session_req = {
"jsonrpc": "2.0",
"method": "CreateSessionObject",
"handle": app_req_handle,
"params": [
{
"qInfo": {
"qType": "SheetList"
},
"qAppObjectListDef": {
"qType": "sheet",
"qData": {
"title": "/qMetaDef/title",
"description": "/qMetaDef/description",
"thumbnail": "/thumbnail",
"cells": "/cells",
"rank": "/rank",
"columns": "/columns",
"rows": "/rows"
}
}
}
],
"outKey": -1,
"id": 3
}
ws.send(json.dumps(session_req))
result = ws.recv()
ws.send(json.dumps(session_req))
result = ws.recv()
result_json = json.loads(result)
print(result_json)
print()
session_req_handle = result_json['result']['qReturn']['qHandle']
#For fetching the layout of the sheets
layout_req = {
"jsonrpc": "2.0",
"method": "GetLayout",
"handle": session_req_handle,
"params": [],
"outKey": -1,
"id": 4
}
ws.send(json.dumps(layout_req))
result = ws.recv()
ws.send(json.dumps(layout_req))
result = ws.recv()
result_json = json.loads(result)
print(result_json)
print()
#Since only one sheet was present we used the index 0
list_of_charts = result_json['result']['qLayout']['qAppObjectList']['qItems'][0]['qData']['cells']
for chart in list_of_charts:
print(chart['name'])
print()
ws.close()
Я изучил множество страниц в сообществе Qlik, а также SO, и ExportData кажется подходящим способом, но я не могу написать для него правильный запрос JSON. Для справки, вывод, который я получаю в своем терминале при выполнении скрипта Python, приведен ниже. Я совершенно новичок в этом, и я был бы очень благодарен за любую помощь от всех вас.
{'jsonrpc': '2.0', 'id': 1, 'result': {'qDocList': [{'qDocName': 'Test_2.qvf', 'qConnectedUsers': 0, 'qFileTime': 44188.190983796296, 'qFileSize ': 851968, 'qDocId': 'C:\Users\mohdm\Documents\Qlik\Sense\Apps\Test_2.qvf', 'qMeta': {'hassectionaccess': False, 'encrypted': False}, 'qLastReloadTime' : '2020-12-22T19:12:22.245Z', 'qTitle': 'Test_2', 'qThumbnail': {}}]}}
{'jsonrpc': '2.0', 'id': 2, ' результат': {'qReturn': {'qType': 'Doc', 'qHandle': 1, 'qGenericId': 'C:\Users\mohdm\Documents\Qlik\Sense\Apps\Test_2.qvf'}}, 'change': 1 }
{'jsonrpc': '2.0', 'id': 3, 'result': {'qReturn': {'qType': 'GenericObject', 'qHandle': 2, 'qGenericType': 'SheetList', 'qGenericId': '4b344780-a350-48db-8b65-27bb5a2c62b2'}}, 'change': 1}
{'jsonrpc': '2.0', 'id': 4, 'результат': {'qLayout': {'qInfo': {'qId': '4b344780-a350-48db-8b65-27bb5a2c62b2', 'qType': 'SheetList'}, 'qMeta': {'привилегии' : ['чтение', 'обновление', 'удаление', 'экспорт данных']}, 'qSelectionInfo': {}, 'qAppObjectList': {'qItems': [{'qInfo': {'qId': '8a0f6a01- ef89-4d65-821f-371c26208dcf', 'qType': 'лист'}, 'qMeta': {'привилегии': ['чтение', 'обновление', 'удаление', 'экспорт данных'], 'заголовок': ' Sheet_1", "описание": ''}, 'qData': {'rank': нет, 'миниатюра': {'qStaticContentUrl': {}}, 'столбцы': 24, 'строки': 12, 'ячейки' : [{'name': 'kfxNpV', 'type': 'auto-chart', 'col': 0, 'row': 0, 'colspan': 15, 'rowspan': 6, 'bounds': { 'y': 0, 'x': 0, 'width': 62,5, 'height': 50}}, {'name': 'qHzmARQ', 'type': 'qlik-barplus-chart', 'col' : 0, 'row': 6, 'colspan': 21, 'rowspan': 6, 'bounds': {'y': 50, 'x': 0, 'width': 87,5, 'height': 50} }, {'name': 'BXBQmw', 'type': 'auto-chart', 'colspan': 15, 'row': 0, 'colspan': 9, 'rowspan': 6, 'bounds': { 'y': 0, 'x': 62,5, 'ширина': 37,5, 'высота': 50}}], 'название': 'Лист_1', 'описание': ''}}]}}}}
kfxNpV
qHzmARQ
BXBQmw
Первоначально я разместил этот вопрос в сообществе Qlik, но не получил ответа.
В таких случаях я обычно «наблюдаю» за сообщениями Qlik из браузера.
(в Хроме)
(если вы не видите сокеты на вкладке «Сеть», просто обновите страницу)
Ниже приведен код Javascript/Node, который экспортирует данные для одного объекта. (В моем случае я жестко кодирую идентификатор объекта)
const fs = require('fs');
const axios = require('axios');
const enigma = require('enigma.js');
const WebSocket = require('ws');
const schema = require('enigma.js/schemas/12.20.0.json');
const session = enigma.create({
schema,
url: 'ws://localhost:9076/app/engineData',
createSocket: url => new WebSocket(url)
});
(async function () {
// open new session
let global = await session.open();
// open the app
let doc = await global.openDoc("C:\\Users\\USERNAME\\Documents\\Qlik\\Sense\\Apps\\Consumer_Sales.qvf");
// get the required object
let qObj = await doc.getObject("MEAjCJ");
// OOXML - export the data in Excel (xlsx) format
let data = await qObj.exportData("OOXML");
// generate the full download link
let downloadLink = `http://localhost:4848${data.qUrl}`;
// download and save the file
await axios.get(downloadLink, { responseType: "stream" })
.then(response => {
response.data.pipe(fs.createWriteStream("export.xlsx"));
});
})()
Официальная документация по методу ExportData находится здесь
Обновление — фрагмент кода Python
Цикл по объектам листа может выглядеть так:
id = 5
list_of_charts = result_json['result']['qLayout']['qAppObjectList']['qItems'][0]['qData']['cells']
for chart in list_of_charts:
obj_req = {
"jsonrpc": "2.0",
"method": "GetObject",
"handle": app_req_handle,
"params": [ chart["name"] ],
"outKey": -1,
"id": id
}
ws.send(json.dumps(obj_req))
result = ws.recv()
ws.send(json.dumps(obj_req))
result = ws.recv()
result_json = json.loads(result)
# print(result_json)
obj_req_handle = result_json['result']['qReturn']['qHandle']
export_req = {
"jsonrpc": "2.0",
"method": "ExportData",
"handle": obj_req_handle,
"params": [ "OOXML" ],
"outKey": -1,
"id": 6
}
ws.send(json.dumps(export_req))
result = ws.recv()
ws.send(json.dumps(export_req))
result = ws.recv()
result_json = json.loads(result)
downloadURL = "http://localhost:4848" + result_json["result"]["qUrl"]
r = requests.get(downloadURL, allow_redirects=True)
open('export_python_' + chart["name"] + '.xlsx', 'wb').write(r.content)
id += 1
Я не специалист по питону, но запустил ваш код и добавил часть экспорта (обновил мой ответ фрагментом). В моем случае он работал нормально - сгенерировал правильное количество файлов и запустился только один раз.
Спасибо за ответ Стефан. Я думаю, причина в том, что URL-адрес, сгенерированный на локальном компьютере, указывает на каталог Exports, который находится в «C:\Users\user_name\Documents\Qlik\Sense\Exports», где он получает доступ к файлу, когда вы вызываете его в сценарии. с помощью модуля запросов. Я предполагаю, что Qlik Enterprise Server работает по той же концепции, но вместо этого файл хранится на сервере.
Я не уверен насчет Python, но я считаю, что обычно самая сложная часть — правильная аутентификация. Библиотеки, подобные тем, которые существуют для JavaScript, обычно значительно упрощают эту задачу. Лично я предпочитаю использовать C# для такого рода гаджетов, где .NET SDK предоставляет операторы для выполнения сантехнических работ за вас. Это пример того, как это может выглядеть с использованием этих двух пакетов nuget:
Этот код загружает файлы xlsx для всех визуализаций на первом листе приложения.
var location = Location.FromUri(uri);
location.AsNtlmUserViaProxy();
var restClient = new RestClient(uri);
restClient.AsNtlmUserViaProxy();
using (var app = location.App(new AppIdentifier {AppId = appId}))
{
var theSheet = app.GetSheets().First();
var objs = theSheet.GetChildInfos().Select(info => app.GetGenericObject(info.Id));
foreach (var o in objs)
{
var exportResult = o.ExportData(NxExportFileType.EXPORT_OOXML);
var data = restClient.GetBytes(exportResult.Url);
using (var writer = new BinaryWriter(new FileStream(o.Id + ".xlsx", FileMode.OpenOrCreate)))
{
writer.Write(data);
}
}
}
Это действительно потрясающе, и большое спасибо за вашу помощь, @Stefan. Я написал эквивалент этого кода на Python из-за того, что не знаю node.js и борюсь с ним. Код работает с запросом JSON с единственной проблемой, заключающейся в том, что он создает 6 папок для 3 объектов (я думаю, в основном выполняется дважды). Если это не проблема, не могли бы вы просмотреть код, который я написал на Python, и оставить свой отзыв? Также дайте мне знать, если мне нужно опубликовать измененный код в исходном вопросе или на pastebin.