Using FSM Mobile


 

Login to the Mobile Reach Client

Note: Touch ID is available on iOS and Android after the initial login. Touch ID is not available when logging out of the MR Client or changing users. Visit the Help Center for how to set up Touch ID.

Step One:

From the Phone, Tablet, or PC, Launch the Mobile Reach application

iOS and Android: 

1770219382498-259.png

Windows 10:

1770219391973-249.png

Step Two: Enter the Gateway Server 

 NOTE: UAT used for initial testing and training, PROD used for full deployment

 Username: Enter End-User Network Login

Password:  Enter End-User Network Password

Login Screen

1770219399736-337.png

Step Three: Tap the Login, MR Client Home Screen displays 

Navigate the Mobile Reach Client

MR Client Home Screen

Launch a Mobile App by tapping on one of the two Mobile App icons (“Create New Asset” or “Location Audit”) in the central panel of the screen (Note*: You may have additional apps on this screen that are not a part of this user guide). 

Tap an icon at the bottom of the screen to : 

  • Update Client Settings (1770347876238-196.png)
  • Refresh or update your Mobile Apps via the App Manager (1770347887505-549.png)
  • Clear your entire device cache (1770347900010-387.png

Tap the Logout icon (1770347910371-142.png) at the top right of the screen to fully logout of the MR Client. 

MR Client Home Screen

1770347921798-589.png

Client Preferences

When you tap the Client Preferences icon (1770347959657-435.png) on the MR Home Screen, you will launch the preferences screen. Greyed-out fields represent locked fields and can only be changed via the Preferences Files (_preferences.xml) located on the MR Gateway Server. Once you have completed making your desired changes, make sure to tap the Save button (on the top-right of the screen) to save all changes. See Appendix D: Client Preferences or visit the Help Center  for assistance on configuration details.

Configure Touch ID

Touch ID is available on iOS 10 or later and Android 6 or later. Touch ID must be configured on the Mobile Device before configuring in the Mobile Reach Client. Touch ID is not applicable on Shared Devices as fingerprint capabilities are configured for a single user, not multiple users. 

Touch ID is available from the Lock Screen but is not available on initial login or after a full logout.

1770347986196-788.png

  1. Configure Touch ID within your iOS / Android mobile device settings (a fingerprint must be associated with the mobile device before configuring in the MR Client)

Settings > Touch ID & Passcode

  1770348014425-633.jpeg

  1. Launch and Login to the MR Client
  2. Tap the Client Preferences icon (1770348026835-517.png) > Tap the ‘Network’ Tab
  3. Enable the ‘Use Touch ID’ (iOS) / ‘Use biometric login’ (Android) option > Tap ‘Save’ :

1770350105508-157.png

NOTE: If this is not your first time to login to the MR Client, then make sure to delete cache (1770348045807-752.png) at this point before proceeding 

  1. Tap the Logout icon (1770350140913-287.png)
  2. Tap the ‘Mobile App Window’ open on the mobile device (this is the icon that allows you to ‘X’ out of or ‘Close’ the MR Client)
  3. Find the MR Client within the Mobile App Window > Close the MR Client
  4. Re-launch and Login to the MR Client
  5. Complete!

App Manager

Tap the App Manager icon (1770348078532-874.png) to launch the app manager screen. Tap the Refresh icon (1770348066383-138.png) to ensure the latest apps have been pulled to the client device. 

An orange circle (1770348096502-785.png) indicates an update is required. Tap on the Mobile App to download the latest app(s) to the mobile device. 

A green checkmark (1770348104782-167.png) next to a mobile app indicates that it is current. A red X (1770348109864-530.png) indicates the mobile app is no longer available and will be deleted from the device during the next update. 

See Appendix E: App Manager for more details about downloading updated applications.

Clear Cache

When you tap the Clear Cache icon (1770348045807-752.png) on the MR Home Screen, you will delete all data from the Client Device. Clearing cache will clear all downloaded data as well as any updates made by the end-user that has not been synced to Source System. Make sure this is what you want to happen because once you Clear the Cache, any unsynced data will be permanently lost. 

Clearing cache is typically required when migrating from Test to Production or when the Source System structure has changed within the Source System tables used by the Mobile App. Clearing cache should not be required, however, on a regular, business as usual basis. 

Navigation and Update Icons

Most mobile apps begin in or use a “List Screen”, which lists out the items being managed by the app. Each List Screen is different, depending on the app and how it’s used. 

There are several actions that can be performed on the List Screen. Some of these actions will just affect the way the information is being displayed, but some actions will affect all of the records in the List Screen. 

List Screen Navigation Icons

1770347659492-788.png: Sync changes to Source System / Download updates from Source System. This action synchronizes data between the List Screen and your Source System. 
1770347675680-225.png: Group records by a specific field. This action affects how the records are displayed on the screen. 
1770347686761-263.png: Sort records by a specific field. This action affects how the records are displayed on the screen. 
1770347691861-405.png

: Delete all changes made on the Records. This action permanently removes all changes that have been made on this device that hasn’t already been Synched. 

 iOS: Swipe Left to Reset a Single Record

Android: Tap + Hold to Reset a Single Record

List Screen Record Update Icons

1770347724932-466.png: Record updated, Tap the Sync Icon () to send changes to Source System
1770347713172-630.png: Error on Record Upload; Tap and Hold the Error Symbol to review the Error Message. Contact Administrator for assistance.

App Icons and Navigation

Save: Saves the current record. In some instances, a new record will be created after the save.1770348164745-847.png
Search: Searches for values associated with the adjacent field.1770348189902-411.png
Home: Navigates to the home page of the work order.1770348195329-556.png
Forward: Navigates to the location details of the work order. 1770348201501-404.png
Boostock/Inventory: Navigates to the equipment management tab.1770348207544-938.png
Photo: Navigates to the photos tab.1770348212278-142.png
Checklist: Navigates to the checklist tab.1770348218366-733.png
Signature: Navigates to the signature tab.1770348223095-254.png
View: Navigates to the work info tab.1770348229685-267.png
Knowledgebase: Navigates to the knowledgebase tab.1770348234495-699.png
Client Details: Navigates to the client details tab.1770348240227-965.png
Add: Add a new record (Work Info or Photo)1770348244365-956.png
Replace: Replace current equipment with equipment from your bootstock/inventory.1770348250935-506.png
In Inventory: Move the current equipment item into your bootstock/inventory.1770348257126-374.png
Optional: Indicates that the checklist is optional to complete the work order.1770348261429-478.png
Incomplete: Indicates that the checklist is incomplete and must be completed to complete the work order.1770348275662-660.png
Complete: Indicates that the checklist has been completed.1770348281398-106.png
Complete: Indicates that the work order is marked Completed.1770348286350-773.png
Assigned: Indicates that the work order is marked Assigned.1770348291694-943.png
In Progress: Indicates that the work order is marked In Progress.1770348296166-125.png
Review Star: Indicates the users satisfaction with the completed work. 1770348307405-162.png
Calendar View: Navigates to the calendar view in the Calendar app.1770348314874-305.png
Sync: Sync data within the Calendar app.1770348324014-125.png
Scan Icon: Indicates that a field accepts a scan.1770348328765-245.png

Work Orders

Overview

The Work Orders application serves as a mobile extension of the BMC Helix Field Service Management (FSM) platform. It enables field technicians to manage and complete assigned work orders directly from their mobile devices, even in offline environments where network connectivity is limited or unavailable.

Designed with field efficiency in mind, the app supports full task execution in both connected and disconnected modes. This ensures uninterrupted access to critical job data, asset records, and workflow tools while on site.

To begin using the application, launch the Work Orders app by tapping its icon from the Mobile Reach Client Home Screen.

Work Order App Icon

1770348502975-853.png

Work Order Process

Work Order Home Screen

After selecting a work order from the list, you’ll be navigated to the Work Order Home Screen. This serves as the central hub for managing the selected work order and provides access to all related information and actions.

From this screen, you can:

  • View general work order details
  • Access customer contact information, knowledgebase articles, and work notes
  • Capture signatures from both the field technician and the customer
  • Modify the status of the work order as progress is made

At the top of the screen, a navigation bar provides quick access to other key areas of the app. The icons include:

  • Truck icon – Bootstock and inventory management
  • Pin icon – Work order site location details
  • House icon – Home screen (current view)
  • Camera icon – Photo capture
  • Checkmark icon – Assigned checklists

The currently active screen is visually indicated by a orange-highlighted icon.

Note: If the work order is still in the Assigned status, you must tap the Start Work button before full functionality becomes available. Inventory management (accessible via the truck icon) will remain disabled until the work has been started.

1776347479832-761.png

 

Customer Contact

 Tap the 'i' bubble icon from the Home screen to view customer contact info.

1776347581511-911.png

Knowledgebase

 Tap the lightbulb icon for knowledgebase access.

 

1776347601193-542.png

Work Notes

You can add a new work note directly from the Home Screen by entering your comments into the “Enter Work Info Here” field. Once you've entered your note, tap the Plus (+) icon next to the eye icon to save it as a new work note record.

To view work notes associated with the current work order, tap the eye icon in the navigation bar. This will display a list of previously added and new work notes for review and reference.

Tip: You can also add a new work note from the Work Notes screen itself by tapping the Add (+) icon in the bottom-right corner. This provides another way to document observations or updates during the job.

1776237586195-693.png

Bootstock and Inventory Management

Tapping the truck icon in the navigation bar opens the Inventory Management section of the app. This section allows you to view and interact with three types of equipment lists:

My Inventory

This list displays equipment currently in your bootstock (i.e., items physically in your possession).

  • Tap a record to view detailed information about the equipment.

From the detail view, you can choose to Install the equipment on site.

1776237638509-816.png

1776347620965-559.png

Site Inventory

This list includes equipment that is currently located at the work order site.

  • Tap a record to view the equipment details.
     
  • From this screen, you have two options:
    • Tap the Replace icon to swap the on-site equipment with an item from your bootstock.
       
    • Tap the In Inventory icon to remove the equipment from the site and add it to your bootstock.

1776237741029-652.png

1776347638098-331.png

WO Inventory

This list shows equipment that is associated with the current work order.

  • The available actions depend on the status of each equipment item:
    • If the item is marked In Inventory, you can choose to Install it.
       
    • If the item is marked Deployed, you may either Replace it or move it to your bootstock.
1776347648785-747.png

Site Location Details

Tapping the location pin icon in the navigation bar opens the Site Location screen. This section provides detailed information about the work order’s associated site, including:

  • Region
  • Site Group
  • Site Name
  • Address

To assist with navigation, you can tap the Directions button to open your device’s default maps application (e.g., Google Maps or Apple Maps). The site’s address will automatically populate as the destination, allowing for quick and seamless routing from your current location.

Site Location Screen

1776347665476-258.png

Photo Capture

Tapping the camera icon in the navigation bar opens the Photos screen. This screen displays all photos currently associated with the selected work order.

To add a new photo, tap the Add (+) button located in the bottom-right corner. This will navigate you to the Photo Details screen.

On the Photo Details screen:

  • Tap the camera icon in the center to take a new photo.
     
  • After capturing the photo, the app will automatically attach a timestamp and GPS coordinates, which will be overlaid on the image for documentation purposes.

You can also annotate the photo by tapping the pen and paper icon, located just below and to the right of the image. This allows you to draw directly on the photo to highlight specific elements.

Additionally, you may enter a short description to provide context or explain details that may not be visually obvious in the photo itself.

Photos Screen

1770348689934-104.png

 Photo Details Screen

1770349148959-367.png

Checklists

Tapping the checkmark icon in the navigation bar opens the Checklist screen. This screen displays all checklists that are associated with the current work order.

Each checklist is assigned one of the following statuses:

  • Pre-Work: Must be completed before work on the work order can begin
  • Pre-Complete: Must be completed before the work order can be marked as completed
  • Optional: Can be completed at the technician’s discretion

To begin a checklist, tap its entry from the list. This will open the Checklist Detail screen, where you can answer each question. All questions must be completed for the checklist to be considered complete.

Checklist questions use drop-down menus with predefined answers, making it quick and easy to select the appropriate response.

Checklist Screen

1770348810150-970.png

Checklist Details Screen

Capture Signatures

When you're ready to sign off on the work performed, tap the Pen icon located next to the Finish Work button on the Home Screen to open the Signature screen.

On the Signature screen, you have two options:

  • Tap Field Tech to capture the technician’s signature.
  • Tap Customer to collect a signature from the customer while on site.
1770348820781-338.png

Field Tech Signature

Selecting Field Tech opens the Field Tech Signature screen. The technician can sign directly on the screen and tap Save to complete the process.

1770348826498-756.png

Customer Signature and Survey

Selecting Customer opens the Customer Signature screen. The customer will be prompted to:

  • Provide their signature
  • Enter their name
1770348835211-754.png

After saving, the customer will be asked if they would like to leave a review.

  • Tapping Yes will navigate them to the Customer Review screen, where they can complete a short satisfaction survey by rating various aspects of the service using a 1–5 star scale.
  • Tapping No will save the signature and return the user to the Signature screen.
1770348839884-721.png

Closing the Work Order

To complete a work order, navigate back to the Work Order Home Screen and tap the Finish Work button. If all required tasks have been completed—such as checklists and signatures—the button will update to Completed, and the work order’s status will reflect this change.

Before saving the completed work order, make sure to fill out the required Status Reason and Resolution fields, both of which are located in the lower half of the Work Order Home screen.

 

Completed Work Order Home Screen

1776347762623-290.png

 

Once the record is saved, the app will return you to the Work Order List screen. The completed work order will now appear in green, with a green checkmark and an upward arrow indicating successful completion.

To upload the completed work order to the source system (if you have an active network connection), tap the Sync icon (two circular arrows) to synchronize the record with the database.

1776347777565-517.png

Calendar

Overview

The Calendar application provides users with a centralized view of their daily and upcoming schedule, displaying all scheduled events such as assigned work orders, approved leave requests, and sick time entries in a clear and organized format. In addition to viewing their schedule, users can conveniently submit leave requests directly from their mobile device, streamlining the time-off process without the need for a desktop.

Behind the scenes, the system intelligently manages scheduling conflicts. For instance, if a user reports sick, any overlapping work orders are automatically reassigned to the next most suitable technician based on factors like availability, location, and qualifications. This ensures continuous service delivery with minimal disruption to field operations.

Calendar App Icon

1770743304519-847.png

Calendar Process

Accessing Your Events

Upon launching the Calendar app, you are presented with a daily calendar view that displays all scheduled events for the current day. Each event is color-coded based on its status, allowing you to quickly distinguish between different types of activities.

Event statuses may include:

  • Leave Requested
  • Leave Approved
  • Leave Taken
  • Leave Rejected
  • Leave Cancelled
  • Work Order Assigned
  • Work Order In Progress
  • Work Order Pending
  • Work Order Completed
  • Work Order Closed

By default, the app opens in Day View mode. However, you can easily switch to Week View or Month View using the navigation icons located along the top row at the bottom of the screen. This flexibility allows you to manage both your immediate schedule and longer-term planning with ease.

Calendar Week View

 View calendar events in a given week.










 

Calendar Month View

 View calendar events in a given month.










Event Details

 Tapping on any calendar event, whether in Day, Week, or Month view, opens a detailed view of that event. This screen displays key information including the event type, start and end time, and the current status of the event.

Calendar Day View

 1770743331376-504.png
Calendar Week View

1770743372328-533.png

 
Calendar Month View

1776347846347-604.png

 
Calendar Event Details Screen

1770743429618-635.png

 

Submitting a Leave Request

To submit a new leave request, tap the Plus (+) icon, which is available on any of the calendar views. This action navigates you to the Add Leave Request screen.

On this screen, you can complete the request by providing the following details:

  • Type of Leave – Select from options such as Family Responsibility, Maternity, Sick, Study, or Vacation
  • Duration – Choose whether the leave spans a specific number of hours or full days
  • Requested For – Indicate whether the leave is for yourself or another individual
  • Description – Add a brief reason or note for the leave
  • Leave Period – Set the start and end dates for the leave

After entering the necessary information, tap the Save icon to create the leave request.

The new entry will appear in the Leave Request List View, marked as pending until it is successfully synced.

When network connectivity is available, tap the Sync icon (circular arrow) to send pending leave requests to the database. You can return to the main calendar view at any time by tapping the Calendar icon in the bottom navigation bar.

 

Add Leave Request Screen

1770743461544-298.png

 
Leave Request List View

1770743537677-670.png

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Field Service Management 26.2