Analyze Certinia Data in Infragistics Reveal

Reveal is a data visualization solution provided by Infragistics and can be paired with the CData API Server and Certinia ADO.NET Provider to build dynamic dashboards from live Certinia data. The CData API Server generates an OData API for Certinia, which is natively consumable in Reveal. In this article, we walk through connecting to Certinia in API Server and connecting to the API Server from Infragistics Reveal to create a simple dashboard.

Connect to Certinia from API Server

CData API Server uses a straightforward, point-and-click interface to connect to data sources and generate APIs.

1. Open API Server and click Settings -> Connection -> Add Connection
2. Select "Certinia"
3. Enter the necessary authentication properties to connect to Certinia.

   There are several authentication methods available for connecting to Certinia: login credentials, SSO, and OAuth.

   Authenticating with a Login and Token

   Set the User and Password to your login credentials. Additionally, set the SecurityToken. By default, the SecurityToken is required, but you can make it optional by allowing a range of trusted IP addresses.

   To disable the security token:

   1. Log in to Certinia and enter "Network Access" in the Quick Find box in the setup section.
   2. Add your IP address to the list of trusted IP addresses.

   To obtain the security token:

   1. Open the personal information page on certinia.com.
   2. Click the link to reset your security token. The token will be emailed to you.
   3. Specify the security token in the SecurityToken connection property or append it to the Password.

   Authenticating with OAuth

   If you do not have access to the user name and password or do not want to require them, use the OAuth user consent flow. See the OAuth section in the Help for an authentication guide.

   Connecting to Certinia Sandbox Accounts

   Set UseSandbox to true (false by default) to use a Certinia sandbox account. Ensure that you specify a sandbox user name in User.

   

Add Certinia Resource Definitions in API Server

After connecting to Certinia, create Resources, which represent API endpoints for Certinia data.

1. Click Settings -> Resources -> Add Resource
2. Select the Certinia connection
3. Select the table you wish to retrieve and click Next
4. (Optional) Edit the resource to select specific fields and more
5. Save the settings

Add an API Server User

Create a User to connect to Certinia from Reveal through API Server.

1. Click Settings -> Users
2. Click Add
3. Configure a User with access to the Certinia Connection and Resource(s)

(Optional) Configure Cross-Origin Resource Sharing (CORS)

When accessing and connecting to multiple different domains from an application such as Ajax, there is a possibility of violating the limitations of cross-site scripting. In that case, configure the CORS settings in Settings -> Server.

• Enable cross-origin resource sharing (CORS): ON
• Allow all domains without '*': ON
• Access-Control-Allow-Methods: GET, PUT, POST, OPTIONS
• Access-Control-Allow-Headers: Authorization

Save the changes to the settings.

Create a Dashboard in Reveal

With the API Server configured, we can visualize Certinia data in Reveal.

1. Log into Reveal and click Dashboards -> New
2. Click Data Source -> OData Feed
3. Specify the API Server API endpoint URL, for example: https://serverurl/api.rsc
4. Select Generic Credentials and specify the API Server username and authentication token
5. Select the entity you wish to visualize
6. Select fields and choose a chart type

More Information & Free Trial

At this point, you have created a simple dashboard from live Certinia data. For more information on creating OData feeds from Certinia (and more than 150 other sources), visit the API Server page. Download a free, 30-day trial and start working live Certinia data in tools that consume OData APIs.