,

Role-Based Applications – Technician (1)

Last Updated on January 17, 2024 by maximosecrets

Technician is a Maximo Mobile application which will also be found on the desktop in the Work Orders module and Role Based Applications. There may be some differences between the mobile application and the role-based application, and I aim to uncover those differences. Maximo Mobile aims to be an offline solution, the Role Based Application performs the same functions, but only works online from a browser.

This is the first article on the Role-Based Application – Technician and the screenshots have been taken with an iPad in landscape mode. The article will cover more details than the Maximo Mobile article for Technician which will be focused on an end-user, for example, in the last article in this series I will also review the Object Structures and Queries that support the applications.

The Technician application was the first Maximo Mobile application to be released and I reviewed it in January 2022 following the MAS 8.6 release. It has been enhanced consistently over the last two years so there is a lot to catch up on. The last time the Technician application required three articles, and I didn’t write about the Create Work Order function which is where I will start with this set of articles, I also now have mapping enabled. I expect there to be four or five articles for the Technician application, this is the first.

To show as many features as I can discover I have enabled a few System Properties and I’ll discuss those at the appropriate point. The biggest hurdle for me remains finding out what features exist, and what hasn’t been added to the application yet, so apologies if I miss something out. I am now much more used to looking at the configuration code to find out what I might expect to find, then conjuring the data to see if anything is revealed.

The environment I am using is MAS 8.11.0, Maximo Manage 8.7.2 and Maximo Mobile 8.11.0.

Create Work Order

The Maximo Mobile Application Navigator has a button in the top right corner for creating records including the option Create Work Order.
Application Navigator

From the Navigator, the plus button at the top will allow you to create a work order.

The Create Work Order screen has fields for the Description, Long Description, Priority and Scheduled Start and Scheduled Finish. Work Type, Asset and Location will be found by scrolling down.
Create Work Order

The Create Work Order screen will create a work request, a work order at waiting to be approved (WAPPR) state. The first two fields allow you to enter a short and long description. 

Earlier this week an integrated fridge/freezer which we have had for 23 years decided to pack-up, so I’ll make a work order with the title – Replace fridge/freezer. The long description has a button which must be where you enter the details.

The Long Description button opens a screen with a rich text formatting toolbar.
Create Work Order – Long Description

The Long Description has a rich-text formatting toolbar and I have highlighted some text in red and then used background highlighting for other text on the second line – After 23 years the fridge/freezer decided to permanently defrost. A replacement was ordered from John Lewis who will install and takeaway the old unit. Now I am worried, will it fit, will they install or find a reason not to, will the doors be flush afterwards. Result is a few sleepless nights.

I would recommend trying the rich-text formatting toolbar first on a desktop as there are tool tips on the buttons which I don’t think you can activate on a touch screen device. You might see that I didn’t work out how to turn-off the background highlighting after the words John Lewis, I just changed the background colour. I have since found out that you need to use the button with a red diagonal line to turn off coloured text or highlighted text.

When you have added the long description you will receive a message - Save or discard changes? You need to use the Save button if you do not wish to lose what you have written.
Create Work Order – Long Description save/discard message

When you use the chevron (<) button you are presented with a message Save or discard changes? You should use the Save button if you don’t want to lose what you have written in the long description. The first time I thought the message was referring to saving the work order, so I lost what I had written in the long description.

When you go to enter the Schedule Start and Schedule Finish dates, if the Scheduled Start will be in the future then enter the Scheduled Finish first otherwise you'll get an error message - The start date must be before the finish date. This is because both fields are defaulted with today's date.
Create Work Order – Schedule Dates

Further down are fields for the work order priority, I entered 9 which is high, being without a fridge/freezer over Christmas and New Year is certainly not ideal.

The next two fields are the Scheduled Start and Scheduled Finish, personally I would much prefer these to be a Target Start and Target Finish and leave the schedule dates to be decided by the Scheduling team. I have raised an IBM Idea (RFE) to give a choice of whether to use Target or Schedule dates. You can see the Enhancement Ideas I’ve raised towards the bottom of this article.

I entered the Schedule Start as of next Wednesday 20th December which is when the new fridge/freezer is due to be delivered. I immediately ran into an error when moving from the Schedule Start Time to the Schedule Finish Date because the mobile application defaulted today’s date to the Scheduled Finish and then gave the error message ‘The start date must be before the finish date’. 

The only way to overcome this error is to clear the Scheduled Start Date by using the (X) button and setting the Scheduled Finish Date before going back to the Scheduled Start Date. The default for the Scheduled Finish Date should come from the Scheduled Start Date, similarly for the time element. I’ve created a case for this with IBM Support.

For the Estimated Duration I entered 3:00 hours. At the bottom of the screenshot is the Work Type.

The Work Type field has a lookup, a left-hand panel opens, called a sliding drawer.
Create Work Order – Work Type lookup

The Work Type field has a lookup which appears from the left-hand side, the panel is called a sliding drawer. The Work Type has a search facility, but with typically a small number of records the user will probably scroll to find the work type before using the button on the right. I chose CM – Corrective Maintenance.

The Location lookup has just two fields for location and its description. This is not the same as seen in other Maximo Mobile applications where there are more options for finding a location. There is a search bar.
Create Work Order – Locations lookup

In the Asset and Locations section I missed out the asset and used the button on the right and selected Search, the other option was Scan.

The Location Search gives a list of locations with their descriptions. In the Service Request role-based application, the choice for select locations is more comprehensive and hopefully this will be added to the Technician application in due course, but I did raise an IBM Idea for this as well.

All you can do is use a word search and after I entered ‘Filleigh’ you use the button on the right to activate the filter.

The list of locations has been narrowed by using a search.
Create Work Order – Filtered Location

Two records were found, one for my home and one for St Pauls church which is next door. The (X) button would clear the filter. But I will select the location FILLEIGH.

Once you have entered the fields, you use the Save button on the top right to create the work order.
Create Work Order – Form Completed

After you have completed the Create work order form you use the Save button on the top right of the screen.

After saving, the Review Work Order screen opens and the work order number will be found at the top next to the description and work type. There are several buttons available to continue adding extra details to the work order. The status can be changed from the status field.
Review Work Order

This creates the work order, 1285 in my case, at status WAPPR (Waiting on approval). The Reported By is the person logged in, WILSON in my case, and the Reported Date is date/time now.

In my case the location FILLEIGH has the Service Address 1005, but this is not copied onto the work order as it would be on the desktop Work Order Tracking application with the WOSERVICEADDRESS fields populated from the equivalent SERVICEADDRESS fields. I’ve raised an IBM Support case about this.

You can now modify the work order created, and we’ll explore this screen in the next section of this article. The work order will be found as part of the query – Work created by me.

Review Work Order Created

Form the Technician application you can find the work order just created by using the query - Work created by me, and filtering by the description or work order number.
Technician application – Query Work Created by me

You can find the work order you created by using the My Schedule button from the blue Navigator screen and choosing the query – Work created by me. I made a query by the work order number 1285, but you could have used some of the text from the description you gave – fridge or freezer in my case. We’ll explore the other search, filtering, and sort buttons in another article.

The fields displayed are as follows:

Top section – Description, Work Type and Work Order Number and on the right the Status and Priority. The Status can be changed from the button, but I will also show that in another article.

Middle section – The number of days before the Scheduled Start. Below this the Asset Number with Asset Description below and Location Description below this.

Bottom section – Buttons – The buttons shown will depend on context, the one shown is the Work Log, but Safety Plan, Materials and Tools, Meter Readings, and the Map button are all possible. For a newly created work order it is likely to only be the Work Log that is shown.

Next to the Status and Priority is a button (>) which allows you to review the Work Details.

You can navigate from the query to the Review Work Order screen. The screenshot is looking at the bottom half of the screen.
Technician application – Review Work Order (bottom)

We saw the top of the Work Order Details screen in the screenshot before the last one. Below the description and long description is a set of buttons which are Materials and Tools, Work Log, Set GPS Location and Report Work. Again, there could be other buttons depending on context, for example if the work order had now had a Job Plan applied there might be a Tasks button.

The Asset and Location section shows the Asset Number, Asset Description and Location Description with an image to the right. As I did not reference an asset this all looks rather bear.

You can create Attachments, you might want to take some photos for the newly created work order, however, it is unlikely you would be creating a Follow-up work order yet.

At the bottom is a panel of fields displaying the Reported Date, who reported this work order and their contact telephone number.

One of the buttons on the Review Work Order screen takes you to the Edit Work Order dialog, this looks a lot like the original Create Work Order screen.
Technician application – Review Work Order – Edit work order (Top)

Next to the Status and Priority fields is a button which navigates to the Edit Work Order screen. This should look familiar because it is the same layout as the New Work Order screen. 

It has fields for the Description, and you can view the text and navigate to change the Long Description with the same rich-text formatting as was available for the New Work Order. The Priority is displayed, with the Scheduled Start Date/Time and Scheduled Finish Date/Time displayed after this.

The Edit Work Order screen spans a couple of vertical pages with the last three fields being Work Type, Asset and Location. If you made changes you use the Save button in the top right corner.
Technician application – Review Work Order – Edit work order (Bottom)

At the bottom of the Edit Work Order screen is the Estimated Duration, the Work Type and finally the Asset or Location. There is a Save button at the top right.

The first button displays the planned materials and tools, which will be empty for a newly created work order.
Technician application – Review Work Order – Planned Materials and Tools

The first button is Materials and Tools. This shows the work plan materials and tools, but it doesn’t allow you to create records. The technician who creates a new work order may be able to identify a part that is needed, but currently they can only create a work log record identifying those details.

The 2nd button displays the Work Log. You can add a new note at the bottom of the Work Log side panel. Beside this there are two buttons the top one opens the long description and the bottom one submits the new note.
Technician application – Review Work Order – Work Log

The second button is the Work Log. For new work orders there won’t be an existing work log, but you can create a new log note record. I entered – Don’t forget you need to be at home on Wednesday.

There are two buttons, the top one expands to allow you to enter a long description and select the log note type. The lower arrow-head button submits the log note that you have entered as a summary.

When opening the Work Log Long Description there is a rich text formatting toolbar, slightly different to the one we saw for the  work order long description. You can also choose the Work Log Type and at the bottom is a checkbox to make the log note visible to the requester of any originating Service Request.
Technician application – Review Work Order – Work Log – Long Description

Expanding the log note shows a screen where you can enter the long description of the log note, there is a rich-text formatting toolbar. In two places I’ve used bold and a font colour, and in another I’ve highlighted some text. Above the toolbar are three options:

I did use the Insert – Link option to enter a link to my Maximo Secrets website.

There is a radio button for you to select the Work Log Type, the default is Client Note. Right at the bottom is a checkbox called Visibility which would allow the log note to be visible to any originating Service Request or other Ticket.

The top of the Work Log displays the notes in the style of a chat history. You can navigate from each record to see its long description, but you cannot change the text.
Technician application – Review Work Order – Work Log submitted

After you have used the blue arrow-head button the log note summary appears at the top of the Work Log panel on the left-hand side with the name of the submitter and above this the date the work log record was created. Preceding the date is some text ‘Today’, but it might also say something like ‘4 days ago’.

The Work Log panel is designed to represent a chat log. The chevron button to the right of each log note record expands so that you can see the long description, it is read-only and cannot be modified.

The third button sets the GPS Location of the device on the Work Order record, it populates the Latitude and Longitude fields so that it becomes visible on a map. The message Device Location Saved will be displayed.
Technician application – Review Work Order – Set GPS Location

The third button sets the GPS Location on the current work order, when you use this the green background message – Device location saved – is displayed. A map button will also be activated on the right of the long description, and this will show a map with the position of the work order, which if you do this immediately will be at the same point as the green circle identifying your current GPS location.

After activating, if you review the work order in the Work Order Tracking application, you’ll find that the Latitude/Longitude fields have been set, and this would show the position of the work order on the Map tab if maps have been set-up on your Maximo environment.

The fourth button is Report Work where you can enter a failure report and labor, materials and tools used. Not of much value when you have just created a new work order, but the same screen is used when the status has advanced and the work is in progress.
Technician application – Review Work Order – Report Work

The fourth button opens the Report Work screen, which would not be used for a new work order that hasn’t yet been approved. You can enter a Failure Report using the edit button in the top right, I’ll review this in much more detail in another Technician article.

Attachments

At the bottom of the review Work Order screen you can navigate to the Attachments screen. Here there is a button for adding an attachment from the Photo Library of the device, Take Photo or Video, and the third option is to Choose Files, for example a completed inspection spreadsheet.
Technician application – Review Work Order – Attachments

At the bottom of the Review Work Order screen there is a button that opens the Attachments screen with the ability to create new attachments using the Photo Library, by Taking a Photo or Video, or by Choosing a File on your device. This last one might be used if you had filled out a spreadsheet that is used in a special type of inspection, for example.

I am using the 2nd option Take Photo or Video and the camera opens and I am taking a picture of my notebook. There are two options to Retake or Use Photo.
Technician application – Review Work Order – Attachments – Take Photo

I used the second option – Take Photo or Video – and the devices camera opened, and I took a photo of my notebook with some topics for forthcoming Maximo Secrets articles.

There are two options, to Retake the photo or Use Photo, I used the photo taken.

After opting to Use Photo the Attachment Details asks for a File Name and Description.
Technician application – Review Work Order – Attachment Details

You will need to optionally supply a File Name and a Description, and I entered Notebook for the File and a Description of Notebook image of upcoming role-based application articles. You save with the blue button at the top of the left-hand side panel. A blue background information message – Attachment Added – will be displayed.

After the Attachment Details have been entered these are used in the display of an Attachment record. On the right is a thumbnail image which if clicked will open full-size.
Technician application – Review Work Order – Attachments with thumbnail

The Description and File Name that you provided will now be displayed with a thumbnail of the image on the right-hand side. You can click the thumbnail to expand the image to full size. With buttons to Zoom In, Zoom Out, and Reset, which you would use after you had been zooming in and moving the image to view the detail.

If you use the Photo Library option, the photos are saved to your device. If you use the option, Take Photo or Video then the photos are only downloaded to Maximo, they are not saved on your device. The Photo Library option allows you to select multiple photos, but it opens the File Name and Description dialog which means that it can only save one attachment at a time. It would be better to allow multiple photos to be saved as attachments and then allow someone to modify the File Name and Description from the Attachments screen. I’ve raised an IBM Idea for this.

Enhancement Ideas

While writing this article I came up with a few enhancement suggestions for the application and I have raised the following IBM Ideas:

Option to choose Target or Schedule dates when creating a work order.

When you create a new work order the requester should be able to provide dates when they think the work order should be targeted this could be many months ahead, and beyond any scheduling period. Some Maximo sites would not want the Schedule dates to be entered with a new work order as this gives the impression that the work order has been scheduled by the planners/schedulers, which is not the case. There should be a System Property to say whether the two dates used when creating a new work order should be the Target Start/Finish or the Schedule Start/Finish.

https://ideas.ibm.com/ideas/MASMOBILE-I-466

Selection of Asset and Location should be the same as for Service Requests (RBA)

When creating a new work order you should have the same capability to select a location or asset as is found on the Service Requests application. The Select Values have more fields, there is a drilldown capability with navigation back up the location hierarchy (location tree), you can also select from the map. The two applications should work identically in this respect instead of being inconsistent.

https://ideas.ibm.com/ideas/MASMOBILE-I-468

Select multiple photos from Photo Library

When you have taken several photos which you wish to include on a new work order, then as you review the work order and navigate to the attachments you can select multiple photos using the Photo Library option, but the File Name and Description dialog then opens which only allows one photo to be saved as an attachment. It would be better to not provide the filename, description dialog when multiple photos or videos have been selected, but then to be able to rename the file or provide a description from an option on the Attachments list where the thumbnail is shown.

https://ideas.ibm.com/ideas/MASMOBILE-I-469

Leave a Reply

Your email address will not be published. Required fields are marked *