Documents related to Qlik NPrinting.
NPrinting can be run as a Windows service to execute scheduled jobs, External XML Requests, and On-Demand reports. The NPrinting service does not require any user to be logged on to the machine to run because it does not run on a user session. The service may also start up without any manual intervention every time the machine is re-started if the "Start Type" is set to "Automatic" because it is a Windows service.
QlikView NPrinting Service can be configured to use:
Before you start you need a Windows account that must:
If you are configuring multiple QlikView NPrinting Servers you must create a Windows account for each one.
QlikView NPrinting Server needs a fully licensed version of QlikView Local Client (Desktop). You can activate QlikView Local Client by inserting a license code and control number or by manually assigning a Named User CAL from a QlikView Server. Dynamically leased licenses and Personal Edition are not supported. To activate, or check, the QlikView Local Client license, find the QlikView executable file (tipically in C:\Program Files\QlikView\Qv.exe), right click while pressing SHIFT and CTRL and select "Run as Different User". Insert the credentials of the Windows user dedicated to the NPrinting Service and check that QlikView Local Client is activated. This is one of the most frequent causes of issues with the Service.
You can assign a source folder to NPrinting Service for External XML Request reporting. NPrinting Service regularly checks for new XML files with the .request extension in the defined source folder, parses any new ones it finds, executes the contained instructions, and changes the .request extension to .processed. It then writes information into a new file about what Task(s) or Job(s) were run and their outcomes. Finally it names this new file the same as the original but with a .result extension. You can find detailed information on the syntax of these XML files and how the process works in this tutorial: How to Execute NPrinting Reports by External XML Request.
When you install QlikView NPrinting Server the GUI is also installed for configuring automated report generation and distribution. Launch QlikView NPrinting Server GUI by clicking on its desktop or taskbar icon or searching for NPrintingSvcConfig.exe and double clicking on it.
The first thing that happens when you start QlikView NPrinting Server GUI is that the User Account Control window pops up. Click on the Yes button to proceed.
The Service page is selected by default. You will need to stop the service, if it is running, in order to be able to configure it. Skip this step if the service is stopped or if you are configuring it for the first time.
All paths to NPrinting files located on computers different from the one running NPrinting Service must be in the UNC (Uniform Naming Convention) format. For instance \\Server\NPrinting\Templates is good, but Z:\NPrinting\Templates will not work. That is because Windows does not support mapped drivers in Session 0.
It is also possible to add an entire folder. All NPrinting projects (.nsq files) contained in the folder will be scheduled. You can specify an empty folder and add .nsq files to that folder as and when they are ready. The Jobs in all the nsq files in that folder will be automatically executed as scheduled. This could be useful in case you do not want developers to access the server configuration.
Adding an NPrinting project (.nsq file) is not mandatory. The Service will start even if the list is empty. This is useful if you plan to use NPrinting On-Demand. When the NPrinting Service receives an On-Demand request, it automatically retrieves the required .nsq. For instance, when the .nsq is saved with a Client of a different version from that of the Server.
It is not necessary to add an .nsq file and it's containing folder although everything will work fine and the schedules will be executed correctly if you do.
If you start the service but a specified .nsq is no longer available, you will get an error message in the log and the service will continue to work. This means that you can continue to use External Requests and On-Demand without a .nsq file specified in the Management Console.
Click on the OK button.
1. Select how you want NPrinting Service to start:
2. The second and the third Service configuration status indicators must be green before clicking on the Install button to install the service. The first status indicator can be green or a yellow triangle in case you didn't add any NPrinting project.
Note: You will have to click on the Stop button to change these settings and manually restart the service when you have finished by clicking on the Start button.
When starting, the service adds two different log messages to the log file; one for starting the On-Demand thread and the other for the External Request thread.