Gentrack Support

Getting Started

You have chosen Gentrack to help you drive critical meter-to-cash processes. Delivering a great service needs a reliable back office capability and a connected front-office. Gentrack Cloud Integration Services is designed to allow you to leverage key data and events from your meter-to-cash processes across the digital enterprise. You can use this to develop tailored customer experiences, harness best-in-class applications and services for more specialized capability, and do so knowing that the data is connected.

To get you started on that journey is our which exposes key events from the core. These events can be used in many ways:

  • Tailor interactions – enhance your communications by leveraging richer tooling
  • Initiate workflows – trigger follow-on action in other systems based on an event occurrence
  • Analyse behaviours – store in an analytics tool

We realize you will want to do more. We are working to expand the capability to unlock more of what you need in your digital enterprise. If there is a scenario that you are thinking about, send us product feedback so we can help you differentiate at speed!

Connecting to the tenants

The first step is connecting your each instance of your core product to Gentrack Cloud Integration Services. We provide a Data Gateway component which is responsible for establishing a secure, efficient connection from the core product to Gentrack Cloud Integration Services. It is self-contained and automatically updated by Gentrack Cloud Integration Services once activated. A typical setup may include a tenant to cover each environment - development, test, and production:

Installing Data Gateway is straightforward. For managed services customers you can request provisioning via our service desk. For on-premise customers our expert services team will work with you to install the data gateway. Once installed, your account manager will create your organization account in Gentrack Cloud Developer Portal. For on-premise customers they will also provide you the keys necessary to establish the final connection. You will receive an invitation to manage the organization and the tenant connections, as well the ability to invite others to manage app connections to any of the tenants:

As an organization administrator you can also invite external developers and partners to participate.

Setting up your integration

Once your tenants are registered with Gentrack Cloud Integration Services, you are ready to create your first app. Logging into the developer portal you will see a list of apps, and an option to create one:

Apps work against a single tenant. If you need to manage test separately from production applications you will need to create two applications. This is by design as Gentrack Cloud Integration Services always work against a single tenant to prevent data cross over. Once the app is created you can enable Gentrack Cloud Integration Services features you want that app to use.

App development lifecycle

When the application is created you will be issued public and private API keys. Most people will create 2-3 application entries with each aligned to a specific tenant. For example, development, test, and production. From here you can use each of the respective keys at each stage of your developer workflow.

1. Create your development app and build your prototype

You will start by exploring the using the development instance of your core product. This will allow you to begin to exercise the APIs, including manipulating any of the data in the core product systems. 

2. Test the app you have built

Once you have your app working and unit tested it is time to move it to your test environment. Similar to how you progress changes around your core product you will run more formal user acceptance testing. This is the time to also test swapping out the API keys to ensure that your app still functions correctly before you move it to production.

3. Launch your app in production

When the app has been fully tested and is ready, it is time to move it to production. Swap out the API keys for your production app keys, then deploy your app using the appropriate channel. We will monitor Gentrack Cloud Integration Services interactions with your core. If something goes wrong, we will be in touch to help you troubleshoot any issues.

Next steps

Last updated on 9 Jun 2019