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:
Windows 10:
|
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
|
| 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 (
) - Refresh or update your Mobile Apps via the App Manager (
) - Clear your entire device cache (
)
Tap the Logout icon (
) at the top right of the screen to fully logout of the MR Client.
MR Client Home Screen
|
Client Preferences
When you tap the Client Preferences icon (
) 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.

- 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 |
- Launch and Login to the MR Client
- Tap the Client Preferences icon (
) > Tap the ‘Network’ Tab - Enable the ‘Use Touch ID’ (iOS) / ‘Use biometric login’ (Android) option > Tap ‘Save’ :

NOTE: If this is not your first time to login to the MR Client, then make sure to delete cache (
) at this point before proceeding
- Tap the Logout icon (
) - 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)
- Find the MR Client within the Mobile App Window > Close the MR Client
- Re-launch and Login to the MR Client
- Complete!
App Manager
Tap the App Manager icon (
) to launch the app manager screen. Tap the Refresh icon (
) to ensure the latest apps have been pulled to the client device.
An orange circle (
) indicates an update is required. Tap on the Mobile App to download the latest app(s) to the mobile device.
A green checkmark (
) next to a mobile app indicates that it is current. A red X (
) 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 (
) 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 | |
![]() | : Sync changes to Source System / Download updates from Source System. This action synchronizes data between the List Screen and your Source System. |
![]() | : Group records by a specific field. This action affects how the records are displayed on the screen. |
![]() | : Sort records by a specific field. This action affects how the records are displayed on the screen. |
![]() | : 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 | |
![]() | : Record updated, Tap the Sync Icon () to send changes to Source System |
![]() | : 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. | ![]() |
| Search: Searches for values associated with the adjacent field. | ![]() |
| Home: Navigates to the home page of the work order. | |
| Forward: Navigates to the location details of the work order. | ![]() |
| Boostock/Inventory: Navigates to the equipment management tab. | |
| Photo: Navigates to the photos tab. | ![]() |
| Checklist: Navigates to the checklist tab. | ![]() |
| Signature: Navigates to the signature tab. | ![]() |
| View: Navigates to the work info tab. | ![]() |
| Knowledgebase: Navigates to the knowledgebase tab. | ![]() |
| Client Details: Navigates to the client details tab. | ![]() |
| Add: Add a new record (Work Info or Photo) | ![]() |
| Replace: Replace current equipment with equipment from your bootstock/inventory. | ![]() |
| In Inventory: Move the current equipment item into your bootstock/inventory. | ![]() |
| Optional: Indicates that the checklist is optional to complete the work order. | ![]() |
| Incomplete: Indicates that the checklist is incomplete and must be completed to complete the work order. | ![]() |
| Complete: Indicates that the checklist has been completed. | ![]() |
| Complete: Indicates that the work order is marked Completed. | ![]() |
| Assigned: Indicates that the work order is marked Assigned. | ![]() |
| In Progress: Indicates that the work order is marked In Progress. | ![]() |
| Review Star: Indicates the users satisfaction with the completed work. | ![]() |
| Calendar View: Navigates to the calendar view in the Calendar app. | ![]() |
| Sync: Sync data within the Calendar app. | ![]() |
| Scan Icon: Indicates that a field accepts a scan. |
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
|
Work Order Process
Work Order Home ScreenAfter 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:
At the top of the screen, a navigation bar provides quick access to other key areas of the app. The icons include:
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. |
|
Customer ContactTap the 'i' bubble icon from the Home screen to view customer contact info. | ![]() |
KnowledgebaseTap the lightbulb icon for knowledgebase access.
| ![]() |
Work NotesYou 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. |
|
Bootstock and Inventory ManagementTapping 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 InventoryThis list displays equipment currently in your bootstock (i.e., items physically in your possession).
From the detail view, you can choose to Install the equipment on site. |
|
Site InventoryThis list includes equipment that is currently located at the work order site.
|
|
WO InventoryThis list shows equipment that is associated with the current work order.
| ![]() |
Site Location DetailsTapping 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:
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
|
Photo CaptureTapping 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:
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
Photo Details Screen
|
ChecklistsTapping 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:
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
Checklist Details Screen |
Capture SignaturesWhen 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:
| ![]() |
Field Tech SignatureSelecting Field Tech opens the Field Tech Signature screen. The technician can sign directly on the screen and tap Save to complete the process. | ![]() |
Customer Signature and SurveySelecting Customer opens the Customer Signature screen. The customer will be prompted to:
| ![]() |
After saving, the customer will be asked if they would like to leave a review.
| ![]() |
Closing the Work OrderTo 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
|
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. | ![]() |
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
|
Calendar Process
Accessing Your EventsUpon 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:
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 ViewView calendar events in a given week.
Calendar Month ViewView calendar events in a given month.
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
|
Submitting a Leave RequestTo 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:
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
|


























































