Skip to content
A Qlik server-side extension plugin for accessing R.
Branch: master
Clone or download
kjartan-qlik Merge pull request #39 from qlik-oss/ipv6_handling
Minor changes to allow usage of plugin with the IPv6 standard.
Latest commit 2335385 May 28, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
csharp Minor changes to allow usage of plugin with the IPv6 standard. May 24, 2018
docs Fixed issue #32 (remove script linebreaks and bumped version to 1.2.1 Apr 15, 2018
proto Updated SSE proto file to version v1.1.0 Dec 22, 2017
qlikview_apps/R_BasicExample Support for defined functions (#21) Dec 7, 2017
sense_apps Updated load script in R_BasicExample.qvf to load tables from R. Also… Jan 5, 2018
.gitignore Initial commit Jun 26, 2017
GetStarted.md Documented table support feature and increased version to 1.2.0. Jan 7, 2018
LICENSE.txt Initial commit Jun 26, 2017
NOTICE.txt Updated grpc lib to 1.7.3 and protobuf lib to 3.5.0 Dec 14, 2017
README.md Fixed issue #32 (remove script linebreaks and bumped version to 1.2.1 Apr 15, 2018

README.md

SSE R-plugin

This repository provides a server-side extension (SSE) that allows you to extend the Qlik built-in expression library with functionality from R. You can use this in both load scripts and charts. In Qlik Sense and QlikView, you connect to this SSE R-plugin by defining an analytic connection.

R is not a supported language in gRPC by default. The purpose of this repository is therefore to provide an SSE, written in C# and is called SSEtoRserve, that accesses Rserve to be able to run R scripts. All documentation and guides regarding SSE in general, referred to as server-side-extension, are valid and useful for this plugin as well.

Status

Latest Version: v1.2.1 (using SSE protocol version v1.1.0)
Disclaimer: Use it at your own risk. See License.

All Versions

Documentation

See the docs folder and the general SSE repo (server-side-extension).

Build and Run the R-Plugin!

Security

General Security Attention

Since R scripts can be very powerful and you will never know what R script will be executed (when EvaluateScript method is called from the client) by this plugin and the R installation, you must be extra careful to secure the machine that this plugin and the R installation are deployed to as much as you can. If possible, sandbox the execution. Be aware of which user account that is starting the plugin and R installation and what access rights this user got in the machine and in your domain to minimize any harm a malicious script can cause.

To be in full control, the EvaluateScript functionality can be disabled by setting the config param allowScript to False in the SSEtoRserve config file. See Configure SSEtoRserve for more info.
Instead you can define the functions that should be available in this SSEtoRserve plugin together with predefined R scripts that cannot be changed by the client (Qlik). See Defining and using your own functions for more info.

Secure connection using certificates

Enable secure connection between the plugin server and Qlik by enabling mutual authentication. See the folder generate_certs_guide that explains how to generate proper certificates. This can be found in the general SSE repo (server-side-extension).

Limitations

Changed Plugin Configuration (Qlik Limitation)

  • If you make changes to the plugin config or add/remove plugins you have to restart the Qlik engine (i.e. restarting the Desktop process for Qlik Sense Desktop and QlikView Desktop, and restarting the Qlik Sense Engine Service or QlikView Server Service for server version). It is only during Engine startup that Qlik connects to the plugin and calls the GetCapability plugin method to see what the plugin is capable of and which functions that are available.

License

See LICENSE.txt. Also have a look at NOTICE.txt.

Contributing

Please follow the instructions in CONTRIBUTING.md.

You can’t perform that action at this time.