Document toolboxDocument toolbox

4.14.0

Introduction

This document contains the high-level release notes for ServiceMobility 4.14.0.

The release notes are grouped by the major ServiceMobility components: Mobile Application, ESB Integration, and Web Management Console. Please refer to the specific product documentation for complete details, examples, use cases and configuration information. 

This release primarily focused on adding new functionality and bug fixes to the ServiceMobility mobile application. 

Release Date: December 7th, 2021

On This Page:

Disclaimer of Warranty

ServicePower makes no representations or warranties, either expressed or implied, by or with respect to anything in this document, and shall not be liable for any implied warranties of merchantability or fitness for a particular purpose or for any indirect, special or consequential damages.

Confidentiality and Copyright

This document contains information confidential to ServicePower Technologies plc. This information is patented under European Patent Number 97301142.2-2201 (Appointment booking and scheduling system). The information is supplied by ServicePower Technologies plc on the understanding that it will not be used in any way which is or may be detrimental to the commercial interests of ServicePower Technologies plc. In particular, the contents may not be disclosed in part or in whole to any other party without the prior written consent of ServicePower Technologies plc.

Copyright in this document remains vested in ServicePower Technologies plc and no copies may be made of this document or any part thereof except with the agreement of the company.

Copyright © 2002-2023, ServicePower plc

All rights reserved.

GOVERNMENT RIGHTS LEGEND: Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the applicable ServicePower license agreement and as provided in DFARS 227.7202-1(a) and 227.7202-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (Oct 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14, as applicable.

"ServicePower" and ServicePower’s products are trademarks of ServicePower Technologies plc. References to other companies and their products use trademarks owned by the respective companies and are for reference purpose only.

About this Release

This release represents a major improvement to the ESB and major and minor improvements to the mobile application. 

Minimum System Requirements

Mobile Application

  • iPhone running iOS 13+
  • iPad running iOS 13+
  • Android phones and tablets running Android 9.0+ 
  • Devices (including laptops, desktops, tablets, etc. ) running the latest versions of Chrome or Edge


Mobile Application Release Notes

Mobile Application Changes

NEW The large form factor version of ServiceMobility now displays FlexForm information captured from within previous call visits within the site and asset history detail screens. 

Note

Because FlexForm definitions are a "living" concept within the ServiceMobility product and therefore doesn't inform/track historical changes, the Property FlexFormDisplayValues was added to provide a historically accurate view of the field/data at the time the FlexForm was created. Consequently, only work orders completed post 4.14.0 will display form data within the history detail screens. 

NEW ServiceMobility now provides System Alerts capability. This is a generic framework that is designed to provide the user with context-specific alerts. The first of these alerts that has been implemented is the route change alert. The route change alert will come down to the mobile device from the back-office whenever a work order has been added to or removed from the user's schedule. This alert will appear as a badge indicator on the alerts icon on the top bar of the application. When the alerts icon is tapped, the user is presented with a list of alerts. The user may tap a specific alert to view more details and navigate to the work order.

This functionality is controlled by the parameter  systemAlertsEnabled within the Mobile Configuration API.  When set to true, alerts will be sent down to the mobile client when work orders are added to or removed from the schedule.

NEW ServiceMobility now provides sight into the transfer history within the large form factor version of ServiceMobility.  This provides the technician with all of the transfers that have been performed within the last x number of days, after which it is purged from the device.  This amount of time the history is kept on the device is dictated by the purgeValues.inventory value, where that value is measured in days.  Additionally, ServiceMobility provides a UI template for the Transfer History List.  This can be customized to display additional information captured within the process such as form values, etc.  The UI templates are as follows:

  • LFF - Tablet.InventoryTransfer.HistoryList
  • SFF - Phone.InventoryTransfer.HistoryList

NEW ServiceMobility now provides the ability to add begin of day activities.  When adding a begin of day activity, the user must complete that activity prior to starting work on any other activity or work order.  Only one start of day activity may be assigned to the technician for any given day.  If a begin of day activity exists for any other day (other than today), the user may work on work orders or activities from a future day (given other constraints are not in place preventing them from starting that activity or work order) without having to complete the future day's begin of day activity.  The user may not start a begin of day activity for a future day.  The begin of day activity is displayed on the Schedule list with a blue border.

NEW  ServiceMobility now provides the user with the ability to see usage statistics on the inventory and transfer screens.  These are automatically displayed if the usage statistics exist for that product.

NEW ServiceMobility now provides the ability to limit the Ship to location of ordered parts when a user closes a work order with a Closed-Complete status. This is setup via the AllowedShipToLocations collection within the Product REST API payload (see the ESB change section for details).

CHANGED ServiceMobility now hides the billable field by default within the action panel.

CHANGED ServiceMobility now hides the taxable field within the action panel when the work order is not billable.

CHANGED ServiceMobility now provides the ability to set FlexForm Attributes from within the FlexAttrRules property of the FlexForm definition. This allows ServiceMobility to automatically populate a FlexForm data field value by default based on the value of another flex form field. 

An implementation example is available upon request.


CHANGED ServiceMobility has enhanced the setup of the FlexForms within the product. Previously, FlexForms were able to be added by work order type, asset type, and activity type via System Categories, as well as via the FlexForms collection. If the FlexForms collection was populated, however, the higher levels were disregarded. They are now combined. The FlexForms collection, however, will only hold the values originally passed into the collection and will not add to those by the FlexForms added via configuration (via System Categories). The FlexAttrs property within the Work Order JSON payload will contain the additional forms.

CHANGED ServiceMobility will now always display the payment screens when closing a work order in the following circumstances:

  • Payment has been made
  • Unable to collect amount has been added

NEW ServiceMobility now allows the user to swipe left and right on the Schedule List to navigate to the previous/next day respectively.

CHANGED Passwords created within Mobility are now required to be a minimum of 8 characters including 1 special character, 1 letter, and 1 number. This does not apply to customers utilizing the SSO flow, as these customers utilize their own password requirements.

ESB Release Notes

NEW The Product REST API has been modified to support the ability to limit the allowable shipping locations that a user may associate with an ordered part when closing a call closed-complete. This is done via the collection AllowedShipToLocations. When present, ServiceMobility will validate that ordered parts can only ship parts to those locations indicated within the AllowedShipToLocations when closing a call Closed-Complete.

Issues Resolved

FIXED Resolved an issue in the large form factor version of ServiceMobility where the side navigation disappeared when putting the Media tab into "Edit" mode.

FIXED Resolved a minor UI issue where the user was taken to the top of the inventory screen upon dispositioning a part. The user is now taken back to the same position in the list.

FIXED Resolved an issue where superseded parts were not updating correctly when the parts availability check was performed within the Preview Mode.

FIXED Resolved an issue where the ActualEndTime was being removed due to a merge issue.

FIXED Resolved an issue in the large form factor version of ServiceMobility where, in some cases, the Preview panel within the Schedule List contains information even when the Schedule List is empty.


For more information, email us at info@servicepower.com.

US Offices

8180 Greensboro Drive, Suite 600, McLean, VA 22102 Tel: 1 (703) 287-8900

2961 W. MacArthur Blvd., Suite 212, Santa Ana, CA 92704 Tel: 714.428.0010

EU Office

Petersgate House, St Petersgate, Stockport. SK1 1HE Tel: 011 44 161 476 2277

www.servicepower.com