IBM Support

The Power of Maximo URL Parameters

Technical Blog Post


Abstract

The Power of Maximo URL Parameters

Body

URLs are what we send to our friends whenever we're trying to share a YouTube video of a cat playing the piano.  But URLs are more powerful in business contexts; launching a colleague to a specific bit of information can save lots of valuable time. To understand how to launch into Maximo and start an operation, you need to understand the format of URLs and landing events that Maximo supports.  For example, you can send an email containing a link that takes your users to a specific record within Maximo.
 
Here's an example URL that will insert a new incident record into Maximo, automatically setting the reportedbyid field and reportedpriority field:
 
http://<hostname>/maximo/ui/login?event=loadapp&value=incident&additionalevent=insert&additionaleventvalue=reportedbyid=maxadmin|reportedpriority=2&forcereload=true
  • event=loadapp causes an application to be loaded
  • value=incident specifies the application ID to load
  • The additionalevent=insert causes a new record to be created within the application
  • The attributes to automatically fill in are specified in the additionaleventvalue parameter: additionaleventvalue=attributename=attributevalue|attributename2=attributevalue2. Use the | character to separate each name=value pair.  The attribute names we are setting are "reportedbyid" and "reportedpriority".  You can figure out the attribute name for an application field, by putting your cursor in the field and pressing ALT-I.
  • The forcereload=true is recommended otherwise the URL will not be processed if you're already logged into your Maximo server. 
 
My colleague Bruno Portaluri has written an excellent blog post on all the kinds of parameters you can pass in a Maximo URL:
 

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

UID

ibm11134039