TPAE-based products like MAM, TAMIT, TSRM, CCMDB or SCCD provide a common way to open an application and perform some basic action like displaying a specific entry or performing a simple query. This can be very useful to integrate Maximo with other applications implementing navigation integration or launch in context.
The base URL has this syntax: http://[hostname]/maximo/ui/maximo.jsp?[arguments]
where:
- hostname - Server's host name
- arguments - A set of name-value pairs, similar to the HTTP GET request
In the arguments, you can define the following information:
- Run an application - event=loadapp&value=[appname]
- Login - login=true&username=[user]&password=[pwd]
- Open a record - uniqueid=[uniqueidnumber]
The unique ID is created using an identity column and is typically hidden. It contains an integer sequence with increasing value.
- Open an application tab - tabid=[tabid] or changetab=[tabid]
To determine the ID of a specific application tab, open the application in the Application Designer, and then open the Properties window for the tab. This parameter is used only when the search for a record yields exactly one response.
- Force refresh - forcereload=true
ensure that the page is refreshed on subsequent launch of the target page.
- Perform an action - additionalevent=[action]
Look at application sigotions for available values.
- Perform a query using QBE - additionalevent=useqbe&additionaleventvalue=[qbe]
The additional event value contains a list of attribute value pairs in the format of key1=value1|key2=value2...
- Perform a query using a where clause - additionalevent=useqbe&additionaleventvalue=[qbe]
The additional event value has the where clause of a valid SQL statement.
- Use the new skin - skin=tivoli09
- Use the old skin - skin=classic
Note: URLs must be properly escaped. For example the "=" character must be converted to "%3D" and spaces must be converted to "%20".
Examples
Here are some useful links (URL) that can be used to open Maximo UI and perform some action.
Move to home page
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=startcntr
Move to home page (with automatic login)
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=startcntr&login=true&username=maxadmin&password=maxadmin
Open ROLE application
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=role
Create a new PERSON record
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=person&additionalevent=insert
Create a new PERSON recor and populates some fields
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=person&additionalevent=insert&additionaleventvalue=firstname=Scott|lastname=Dickerson
Display an ASSET record using the UID of the record
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=asset&uniqueid=1152
Display a WORKORDER record using the WONUM of the record
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=wotrack&sqlwhere=WONUM%3D1000
Display a WORKORDER record using the WONUM of the record (using additionalevent)
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=wotrack&additionalevent=sqlwhere&additionaleventvalue=WONUM%3D'1000'
Display a WORKORDER record using the WONUM of the record (using QBE)
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=wotrack&additionalevent=useqbe&additionaleventvalue=wonum=1000
Display all work orders with status WAPPR
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=wotrack&additionalevent=sqlwhere&additionaleventvalue=status%20in%20('WAPPR')
Display a WO record AND call a Maximo Action
http://localhost/maximo/ui/maximo.jsp?event=loadapp&value=wotrack&uniqueid=133&additionalevent=viewcosts
Labels: beginner, integration, maximo, tips