Generic filters
Exact matches only
  1. Home
  2. Knowledge Base
  3. Interfaces & Data Sources
  4. Interfacing Visual KPI with Data Sources

Interfacing Visual KPI with Data Sources

Interfacing with data sources allows the Visual KPI Server to communicate with and retrieve data from almost any data source. By connecting to various databases or third-party platforms, Visual KPI can import select portions of the source data.

A Visual KPI interface is a required component that acts as the data connector between the external databases and the Visual KPI server. The image below shows you the architecture of the various components of Visual KPI and how they interact.


Visual KPI components - data sources

Visual KPI Product Architecture


An interface specifies the type of technology used to communicate with the system (OLAP, JSON, SQL, etc.), any login credentials to the database, and the queries needed to extract the desired data. It establishes a connection to a database using a URL. An interface also specifies event logging levels and regional and time zone settings.

Interfaces read data from foreign systems in a read-only and lightweight fashion so there is no worry about impacting the original data.

Once an interface is created, you should never have to go back to it for maintenance (except upgrading to a newer version of Visual KPI).

From Data to KPI Visualizations

The interfaces component of Visual KPI allows you to establish a data connection, one for each KPI, to many different potential data sources. The interface specifies which data to obtain without worrying about how the data is presented. Visual KPI takes care of how data is expressed using visualizations.

Using the Visual KPI Designer, an admin decides how this data will “look” in the Visual KPI website. This allows you to create data connections to many different database types (SQL, OLDB, Oracle) or database locations (Facility 1, Facility 2), or both, and present them with the same types of visualizations. You can mash up data from a wide variety of databases without needing to build more complicated data extracts or dumps.

Visual KPI Interface Components

The basic components of a Visual KPI interface include the connection to the source (how to connect), several queries (what can be asked of the data and what the system expects to get back), and security or authentication information to access the data.
Note: Visual KPI includes several pre-packaged interfaces to historian data sources like OSIsoft PI & AF, GE Proficy, Rockwell FactoryTalk, Wonderware and others. These interfaces contain all of the components above and are configured with a simple wizard (no need for the queries).


The connection string (in the case of SQL-based sources) or URLs (in the case of JSON/Odata/XML/Web services) determines how you connect to the data source. You specify the Internet address of the database you are connecting to as well as any particular database time zone or date time format. Finally, you specify the location where the data will reside locally so the Visual KPI server can consume it.


A second aspect of the interface connection is the security information for authentication. You may have to specify a username/password or use a trust system. (See Interface Security and Encryption for recommendations about the account used for data access.)


The third part of the interface includes up to four data queries. The queries specify the data to be retrieved:

  • Current value – the most recent or current value in the database.
  • Historical value – a value within a specific time stamp in the past. If you specify a specific time and there is no value, the query returns the data with the nearest earlier time stamp.
  • Trend data – is a sequence of data between two different time stamps. To make the trend line look smoother at either end, data is also retrieved for the data point previous to the beginning of the trend and the data point following the end of the trend.
  • Historical data – is optional and only needed for more complex data analysis when all the data points are needed rather than less granular running averages. For example, data may be collected every second, but for visual display purposes, a less granular average is calculated for every 10 seconds.

Types of Data Sources

Visual KPI can read from thousands of data sources. Below are some examples:

  • industrial or enterprise historians (OSIsoft PI, GE Proficy, Rockwell, Honeywell, etc.)
  • relational databases (Microsoft SQL Server, Oracle, MySQL, Access, Etc.)
  • external web services (weather, market pricing, supplier data, etc.)
  • manually entered data (Excel, forms applications and even direct in Visual KPI)
  • business applications (ERP, CRM, vertical industry applications, etc.)
  • devices (sensors, IoT, IIoT, controls systems (DCS/PLC)

See Supported Data Sources

Configuring Interfaces

In order to access these systems, you must install an appropriate interface and configure it using the Visual KPI Server Manager. Visual KPI Designer then uses this interface to build KPIs against the data in the interface query.

Remote Context Service

In addition to interfaces, Visual KPI also has the concept of a Remote Context Service. An interface is designed to access raw data from a data source for KPIs visualizations (e.g. a temperature, speed, price or sales volume). A Remote Context Service, however, is designed to accesses configuration data or metadata from external sources. This configuration data includes things such as group membership and hierarchy, KPI attributes including targets and limits, geolocation, security information and many other attributes.

Learn more:
Visual KPI Interface Prerequisites

Getting Started with Visual KPI Interfaces

Was this article helpful?

Related Articles