Welcome Guest, you are in: Login

QVSource: The QlikView & Qlik Sense API Connector (Docs)

Web Edition Doc Quick Links
QVSource Web Edition is now commercially available should be used - if you are still using the WinForms edition please upgrade now as this is deprecated and will no longer be supported after the 22nd May 2016.

You should find most of the documentation on this wiki for the WinForms edition of QVSource still applies, particularly the connector specific pages (ignoring the minor UI differences).

The following are the most important Web Edition specific pages:

  • Web Edition Overview - A short introduction to the new QVSource Web Edition including the benefits and high level differences.
  • Getting Started - A guide on running the QVSource Web Edition in its simplest mode (e.g. servicing requests from localhost only with no user authentication).
  • Example Deployment Scenarios - Some example diagrams showing how QVSource Web Edition might be deployed with QlikView and Qlik Sense.
  • Advanced Configuration - How to perform advanced configuration of QVSource, for example allowing remote access and setting up users.
  • User Management - How to manage users.
  • Upgrading from WinForms Edition - How to upgrade.
  • SSL Configuration - How to set up a test SSL certificate so that traffic between your browser (or QlikView/Qlik Sense) is encrypted.
  • Troubleshooting - Read this page first if you are having trouble running QVSource.
  • Cloud Hosted Demo - Information on a cloud host demo edition we are currently testing out.


Users in QVSource Web Edition are those who are able to log in to QVSource, work with connectors to build and test data requests and generate QlikView or Qlik Sense load scripts to then pull this data directly into Qlik applications. They are equivalent to developer licences in the older Win Forms edition of QVSource.

QVSource Web Edition 1.0 and later contains a user management UI as illustrated below.

Note that this UI is only available if all of the following conditions are met:
  • You have authentication set up in deploy.config as detailed here (i.e. you do not have the authentication type set to 'None').
  • You are browsing QVSource either over SSL or from the local machine.
  • You are logged in as an administrator.

By default, when you first use QVSource it is configued with no authentication/users and localhost access only. The quickest and easiest way to enable users is to follow the notes in this section for copying the 'Forms Auth and Remote Access' sample deploy.config and logins.xml files into the QVSource root - this should enable two default users as well and show the following UI.

Note that the currently logged in user is highlighted with a small icon and the username is highlighted in green. You do not have the option to either delete the currently logged in user or remove them from the Admin role.

At the bottom of the screen you will see how many users your current QVSource licence permits and how many of these you have used. If you are using a QVSource trial licence or a licence for the earlier Win Forms edition of QVSource this will automatically be set to 2 by default.

Image

If you click on the Edit button for a user you should see the following:

Image

You now have the option to create a new password or access token for the user or to promote them to the Admin role.

By default, passwords are now stored using a secure salted hashing algorithm so you should make a note of the password to send to the user before clicking save, after which the password will no longer be available.

Tokens are user specific keys which are embedded in the generated load script (specifically the URL of the HTTP request) which maps the request to a particular user, allowing, for example, any associated settings for the request which are now included in the URL to be retrieved, and also allowing the system to build a log file for the user, and track API requests. You should also guard your token carefully. Ultimately it will be embedded in your QlikView and Qlik Sense load script so you should be careful how you distribute these as the access token would potentially allow others to make requests to your QVSource installation and retrieve data for connectors you are working with.

Adding, deleting and editing users should be straightforward. The only thing to point out is that, at present, when you delete a user you may still wish to manually delete any associated data for them (settings, cached data, log files etc.) from the file system.

By default these will be stored in: \{QVSource Folder}\App_Data\{User GUID}\

You can locate the User GUID by hovering your mouse cursor over the user name:

Image

Once you have deleted the user you should be able to safely delete this entire folder (i.e. the folder named with the user's GUID and everything below it. You should not delete the App_Data folder).

Conversely, if you are moving QVSource from one machine to another, or would like to sync settings between a production server and a test server, copying these folders provides a quick and simple solution.
  Name Size
- edit user.png 34.03 KB
- list.png 31.12 KB
- user guid.png 22.11 KB


(QVSource works with Qlik Sense as well as QlikView - See this page for notes.)
QVSource - The QlikView & Qlik Sense API Connector | © Copyright 2011 - 2016 Industrial CodeBox Ltd