[Useful Tiny Little Things] Adding an action to an Application
LeandroCassa 270002840B Comments (4) Visits (10296)
Welcome to Useful Tiny Little Things, a series of topics that I will publish in the Process Automation blog. My name is Leandro Cassa and I work at IBM as the CCMDB Level 3 support team leader. The purpose of this series is to provide useful simple things that we sometimes have no idea exist. These tips apply to CCMDB, Tivoli Asset Management for IT, Service Request Manager, and other products based on Tivoli's process automation engine.
This week I'll explain how to create your own entry on a select action menu and apply an action to it.
Ok, ready to go. Open your TPAE based system, click on Go To > System Configuration > Platform Configuration > Application Designer (you must have permissions to do the next actions).
As usual lets use the Work Order Tracking application as a sample. Search for WOTRACK and enter the Work Order Tracking.
At this point a editable version of the application shows up, but we want to click on the Select Action and select Add/Modify Signature Options.
Next step is to click on new row, and edit the as follows (don't forget to expand the Advanced Signature Options; there are changes there as well):
Of course you can use another name and description for your Signature Option. Signature options specify privileges for using applications, menu options, and toolbar items.
Notice that the Advanced Signature Options has "This is an action that must be invoked by user in the UI" which is essential for this tip to work, so don't forget selecting the right option here.
Once again, click on Select Action, but this time select Add/Modify Select Action Menu. It is time to create your entry on the Application (on this example Work Order Tracking) Select Action menu.
Notice that I'm using the Element Type OPTION. This means it is an option on the Select Action menu.
Also the Key Value is CALLACTION. The Key Value field relates to the signature option ID that is associated with this menu item, which we just created.
I used the Position 1 and Subposition 1 to put our Select Action option as the first entry. But feel free to play around with this; the position and subposition are responsible for the order and subitem definition. If you want the menu item to appear under a header menu, enter a numerical value in the Subposition field, to indicate its position within the header menu.
Last but not least, in the Tabs field define where you want your entry to be available (to be visible), and MAIN in this scenario is the right one.
Very good! We are all done with the Application Designer. Now the most interesting piece of this post: The action!
Move to Go To > System Configuration > Platform Configuration > Actions. Create a new Action.
Name your new Action CALLACTION (otherwise TPAE won't be able to find it when you select the item on the Select Action), also choose the WORKORDER Object in this scenario because we did changes for the Work Order Track application, if yours differ select the appropriate Object.
In my case I'm selecting the Type as Application Action, which means I'm going to call an existing action from the Work Order Application, but there are other options you can use. Refer to the Infocenter for more on that right here. Since I chose Application Action, the Values are restricted to the application actions. I selected CREATECHANGE, which means every time I click on the Select Action created, a new related Change record is created.
The screenshot here shows what I selected to sample this feature, but you can select whatever is useful for you.
All set, now save the action and restart the MXServer (restart only the MAXIMO application works fine as well) to apply the changes.
As soon as your MXServer is back, Go To > Work Orders > Work Order Tracking, click on new.
Save the record.
Now click on the Select Action, confirm you have your new entry there and click on Call Custom Action.
And check the Related Records tab (Depending on the action you set, you might need to save the record again to refresh the MBO and see the changes made).
And here it is:
That's it for this week. Hope this helps.