From blogs to case studies to news, we love sharing our tips and tricks for asset management, cloud, IoT and smarter operations.

by | Dec 3, 2020

Maximo Integration and custom endpoint for token retrieval

Maximo Endpoints are used for outbound integration. When we trigger integration in Maximo, publish channel with associated object structure create a message and store it in an outbound queue. Cron task for the outbound queue invokes the endpoint which routes outbound message to an external system.

There is a number of different types of endpoints to cover a number of different external systems, such as Flat File Handler, XML Handler (JSON) , HTTP handler, Web Service Handler etc.

The message will be stored as a flat file, XML or JSON file, placed into custom interface table, or sent to predefined URL using HTTP or HTTPS protocols. In some cases, however, functionality does not meet the requirements and our only choice is customization.The purpose of this blog is to exhibit an example of custom endpoint used in integration with external systems that are using Token Functionality.

Custom HTTP Handler for token retrieval

Some external systems require use of token functionality, which entails logging into an external system using username/password and then retrieving the token. After token retrieval, another request delivers the actual message. Due to the nature of integration, Maximo can invoke only one request. We will examine ways to pack two requests into one.

The example used for the purposes of this blog is integration between IBM Maximo and Zinier Mobile Platform.  The integration uses REST API on both sides and all messages are in json format.

What is Zinier?

Zinier is an intelligent field service automation platform that helps organizations with complex processes transform their field service operations with AI-driven recommendations.

BPD Zenith and Zinier have collaborated to provide clients with an all-in-one mobile experience to supercharge every aspect of an organization’s field service operation from the back office to the field.

The process:

Zinier require access to its REST service by token instead of username and password, but before that we must retrieve token using username and password.

We will need two endpoints: ZINLOGIN and ZININSERTWO.

ZINLOGIN endpoint uses standard HTTP handler and the response is in JSON format. Username and password are provided, and token is retrieved.

ZININSERTWO endpoint is using custom handler. Let us call it ZINIER. The goal of this customization is to reuse token supplied in first endpoint.

We will create new handler class:

~ Create new handler class ~

Handler will have one additional parameter added through class for endpoint that is fetching token:

~ Additional parameter for ZINLOGIN ~

Headers parameter will have arbitrary default value for token.

In the class, we will create method getToken(), which is retrieving token using endpoint ‘ZINLOGIN’.

~ Method getToken() ~

This method will be used in invoke(…) method of the class.

Later, we will have to place token value into header by replacing default value:

~ Place token value into header ~

And that is all. Let’s recap:

  1. Publish channel will have defined endpoint ZININSERTWO.
  2. When end point is triggered it will first invoke login end point defined as a parameter.
  3. Login end point will retrieve token.
  4. During initialization of end point default token in HEADERS parameter will be replaced with fetched token.
  5. Call will proceed with accurate token.

This is a simple and very useful way of integrating with an external system that is utilizing Token functionality and demand for it is significantly high. Until IBM creates this handler in OOB Maximo environment, this is a workaround for all of you Maximo enthusiasts out there. If you’d like to learn more about Maximo integration or have any questions regarding the contents of this blog, please contact BPD Zenith.

Velibor Djukic

Velibor Djukic

Velibor has been working with Maximo for more than 13 years in Middle East and Australia. He had been working as Team Lead on large scale Maximo project such as KOC (Kuwait Oil Company). He spent last couple of years in Mobile space working with Anywhere, EZMax, and Datasplice. Currently works as Solution Architect for BPD Zenith Australia and like to share knowledge with everybody who seeks it.


Submit a Comment

Your email address will not be published.

Asset Management for Net-Zero Futures

Asset Management for Net-Zero Futures

Sustainability is not a new concept and BPD Zenith have always strived to be socially responsible, however, it is a critical imperative for today’s business operations – and for the planet... There has been a shift from using digital to improve the bottom line, to...

The Hidden Value of CMMS Master Data

The Hidden Value of CMMS Master Data

Having made a significant investment in your CMMS, advances in Data analytics are prompting rethinks about the Master Data that underpins your ability to launch programs such as Asset performance management, Monitor Asset health and enhance Predictive Maintenance. A...

BPD in Offshore: When the wind blows, our assets perform…

BPD in Offshore: When the wind blows, our assets perform…

London Array Limited (LAL) maintain a critical electricity production wind farm in the Outer Thames Estuary.   Lucy Horner (then Maintenance Strategy Engineer) joined the AiTalks podcast last year to discuss her world of offshore wind provision, the levels of...

Happy International Woman’s Day 2022 – Woman in Tech

Happy International Woman’s Day 2022 – Woman in Tech

International Woman’s day, which is celebrated globally on the 8th of March, commemorates the cultural, socioeconomic and political achievements of woman across the globe with a strong focus on gender equality, and on preventing violence and abuse against woman. The...

Sign up to our free newsletter to explore emerging technologies, industry events and Maximo best practice.

Come with BPD Zenith to the future of Asset Management

Partner Ecosystem

BPD Zenith partners with a diverse array of the world’s top Technology, Business and Solution Integration leaders.