1 Star 0 Fork 0

超哥 / QlikView-Report-Generator

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
LGPL-3.0

Report Generator

The Report Generator bridges QlikView Personal Edition (Desktop) 12.0, which can be downloaded here: http://www.qlik.com/products, and Microsoft Word to facilitate the automatic copy/pasting of charts and objects into tagged locations in the Word document while making specified selections in the QlikView engine. The intent is that a user creates a Word template and a QlikView chart repository in order to run small batches of custom reports on a Windows machine.

Why Would I Use This?

The main benefits of this project compared to QlikView's built in reporting and Qlik NPrinting is threefold; it's free, it's open source, and it works with QlikView Personal Edition. This project was developed for the specific needs of our organization (which is why it outputs a Word document), and we encourage other developers to add features to fit their own needs. For instance, our organization has developed a "Report Generator Server" project which allows us to automatically email reports on a schedule or when a request is sent to the server. By no means are we attempting to compete with Qlik's existing methods of report generation. We are simply trying to build a flexible, developer-friendly project for the Qlik Community.

Getting Started

To simply run the application, open the ReportGeneratorSetup/Debug folder in the main project and download and run the ReportGeneratorSetup.msi (Windows Installer Package) file. This will create a program called "Report Generator (Active)". Download the entire project if you wish to contribute features and ideas. Don't hesistate to contact us directly!

We also have a quick tutorial video on YouTube here: https://youtu.be/WYofPNv9V_0

Understanding the Tags

Tags are placed in the Word template so the Report Generator knows where to paste QlikView objects.

Chart Tags

Follow the format

<CH01>

The above tag will insert the chart from the QlikView document with the Object ID of CH01 at this location. You can find the Chart ID by right clicking an object, clicking Properties and finding the Chart ID field. If the Properties option is not available, you can see a full list of all charts and their IDs on a sheet by going to the Settings ribbon in the main toolbar, selecting Sheet Properties, and going to the Objects tab.

Looping Tags

Follow the format

[FieldName]...[/FieldName]

These tags copy and paste whatever is between them for each possible value of FieldName. Hidden formatting symbols such as page breaks and new paragraphs will also be copied and pasted.

[State]<CH01>[/State]

The above tag will paste the chart with Object ID of CH01 for each possible value of State.

Selection Tags

Follow the format

{'FieldName1','FieldValue1','FieldName2','FieldValue2',...}

These tags force specific selections into the tags.

<CH01{'FieldName','FieldValue'}>

The above tag will insert the chart with Object ID of CH01 after selecting FieldValue in the FieldName field.

[State{'Country','United States'}]<CH01>[/State]

The above tag will insert the chart with Object ID of CH01 for each possible value of State after making the selection United States in the Country field.

You can also use the selection tag by itself in the "Static Selections" text box in the application interface in order to make a universal selection for all chart objects in the Word template.

Quick Reference Tags

Follow the format

<!QuickRefText>

Refer to the section below to learn how to use these tags.

Image Attribute Tags

Attribute tags can be added to certain chart tags in order to customize a chart image as it is inserted into Word. Chart tags have attribute tags added in the following manner:

<CH01?height=2.00&width=3.55>
<CH01{'FieldName','FieldValue'}?height=2.00&width=3.55>

The above example sets the height to 2 inches and the width to 3.55. Specifying a single dimension will maintain the image's aspect ratio. As of version 1.1.0, only the height and width attributes can be adjusted.

Pivot Tables

In pivot tables any column with the label as a single asterisk will be deleted.

Using the Application

Reference interface.png to see what the application looks like when run.

Set Document Paths

Browse for the Word Template (.doc and .docx) and QlikView Document (.qvf) using their respective "Browse" buttons.

Quick Reference Variables

If you happen to have a text object in QlikView that you reference very often add the QuickRefText (without the <>'s or !) and the Chart ID to the list. This will speed up the report generating and only works with Text Box objects in QlikView.

Static Selections

Use a static selection tag as mentioned above to apply a universal selection to all QlikView objects as they are copied into the Word Template.

Log

As the program runs, this list box is populated with the output telling the user what objects were copied successfully and where there may be errors in your Tag structure.

Known Issues

If an error causes the program to break, your Word document will hang in limbo and prevent you from running any other actions against it. Open the Task Manager and end this process manually to continue.

Prerequisities

To contribute, you must install the QlikView and Microsoft Word references to your Visual Studio project. Refer to the Built With section for information on how this program was built and tested.

Example

RG-Example.doc
We find it helpful to turn on the hidden characters in Word (Crtl + Shift + 8)

Prescription Tracker.qvw
This document is included when you download QlikView 12.0. The example QlikView document is located at the following path, C:\Program Files\QlikView\Examples\Documents\Prescription Tracker.qvw

Target these two files with the Report Generator and click Generate to watch it run.

Deployment

If you wish to simply use the program, download and run the setup utility in the Setup.zip file.

Built With

Microsoft Visual Studios 2015 Community - Windows Forms
Built and Tested on Windows 8.1 OS
Microsoft Word 15.0 Object Library Version 8.6
QlikView 12.0 Type Library Version 12.0

Compatibility and Testing

This project was built and tested with the following software versions:

QlikView 11.20, 12.0
MS Word 2013, 2016
Windows 8.1 Pro, 10 Pro (64-bit)

Contributing

Feel free to contact tkendrick@prioritythinking.com if you are interested in contributing to this project.

Versioning

We use semantic versioning. Reference tags and description for version number.

Authors

Priority Thinking Team
Tim Kendrick
John Murray
Mitali Ajgaonkar
Grant Parker
Qasim Ali

License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

Acknowledgements

Rochester Institute of Technology
https://community.qlik.com/
https://www.prioritythinking.com

GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below. 0. Additional Definitions. As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License. "The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below. An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library. A "Combined Work" is a work produced by combining or linking an Application with the Library. The particular version of the Library with which the Combined Work was made is also called the "Linked Version". The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version. The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work. 1. Exception to Section 3 of the GNU GPL. You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL. 2. Conveying Modified Versions. If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version: a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy. 3. Object Code Incorporating Material from Library Header Files. The object code form of an Application may incorporate material from a header file that is part of the Library. You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following: a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the object code with a copy of the GNU GPL and this license document. 4. Combined Works. You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following: a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the Combined Work with a copy of the GNU GPL and this license document. c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document. d) Do one of the following: 0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source. 1) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version. e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.) 5. Combined Libraries. You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License. b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 6. Revised Versions of the GNU Lesser General Public License. The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation. If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library.

简介

暂无描述 展开 收起
LGPL-3.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
1
https://gitee.com/yhc2020/QlikView-Report-Generator.git
git@gitee.com:yhc2020/QlikView-Report-Generator.git
yhc2020
QlikView-Report-Generator
QlikView-Report-Generator
master

搜索帮助