Introduction

This document contains the high-level release notes for ServiceMobility 3.48.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: January 10th, 2020

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.

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 mostly 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

New Features

NEW Large Form Factor Dynamic Product Filter

The Add Line Items screen within the Work Order process flow has now been enhanced to allow the user to filter the products in the list when the source is catalog.

Setup: These filters are setup via System Category 201 utilizing the System Categories API. A sample JSON payload is as follows:

{
    "SysCatID": "201",
    "Desc": {
        "en": "Product Group Identifiers"
    },
    "SubCats": [
        {
            "SysCatID": "Size",
            "Desc": {
                "es": "Admin Category",
                "en": "Admin Category"
            },
            "SysActs": [
                {
                    "SysActID": "1001",
                    "IsActive": true,
                    "Desc": {
                        "es": "Small",
                        "en": "Small"
                    }
                },
                {
                    "SysActID": "1002",
                    "IsActive": true,
                    "Desc": {
                        "es": "Medium",
                        "en": "Medium"
                    }
                },
                {
                    "SysActID": "1003",
                    "IsActive": true,
                    "Desc": {
                        "es": "Large",
                        "en": "Large"
                    }
                }
            ],
            "IsActive": true
        },
        {
            "SysCatID": "Installation",
            "Desc": {
                "es": "Admin Category 2",
                "en": "Admin Category 2"
            },
            "SysActs": [
                {
                    "SysActID": "1001",
                    "IsActive": true,
                    "Desc": {
                        "es": "Easy",
                        "en": "Easy"
                    }
                },
                {
                    "SysActID": "1002",
                    "IsActive": true,
                    "Desc": {
                        "es": "Complex",
                        "en": "Complex"
                    }
                }
            ],
            "IsActive": true
        },
        {
            "SysCatID": "Helpers",
            "Desc": {
                "es": "Admin Category 3",
                "en": "Admin Category 3"
            },
            "SysActs": [
                {
                    "SysActID": "1001",
                    "IsActive": true,
                    "Desc": {
                        "es": "One Helper",
                        "en": "One Helper"
                    }
                },
                {
                    "SysActID": "1002",
                    "IsActive": true,
                    "Desc": {
                        "es": "Two Helpers",
                        "en": "Two Helpers"
                    }
                },
                {
                    "SysActID": "1003",
                    "IsActive": true,
                    "Desc": {
                        "es": "Three Helpers",
                        "en": "Three Helpers"
                    }
                },
                {
                    "SysActID": "1004",
                    "IsActive": true,
                    "Desc": {
                        "es": "Four Helpers",
                        "en": "Four Helpers"
                    }
                }
            ],
            "IsActive": true
        },
        {
            "SysCatID": "Safety",
            "Desc": {
                "es": "Admin Category 4",
                "en": "Admin Category 4"
            },
            "SysActs": [
                {
                    "SysActID": "1001",
                    "IsActive": true,
                    "Desc": {
                        "es": "Not Safe",
                        "en": "Not Safe"
                    }
                },
                {
                    "SysActID": "1002",
                    "IsActive": true,
                    "Desc": {
                        "es": "Safe",
                        "en": "Safe"
                    }
                }
            ],
            "IsActive": true
        }
    ]
}

Once these filters are setup in the System Categories, they must also be added to the Mobile Application Configuration as well. This can be done by adding the productSearchDefaultFilters collection as follows:

    "productSearchDefaultFilters": [
        "Helpers",
        "Installation",
        "Size",
        "Safety"
    ],

Product Setup:

Filters utilize the Tags collection within the product. To setup these filters, add the Tags with the [Top Level] | [Second Level] via the Product API as shown here:

 "Tags": [
        "Size|1001",
        "Installation|1001",
        "Helpers|1001",
        "Safety|1002"
    ],

Product Filters are currently required to be setup in the System Categories and then specified as default filters in the Mobile Application Configuration. In an upcoming release, we will provide additional functionality to allow the user to utilize filters not specified as default as they see fit.

Add Line Item Filter (1)

Add Line Item Filter (2)

Mobile Application Changes

CHANGED ServiceMobility now provides an indicator when retrieving an ordered part's availability from the back office.

CHANGED FlexAttributes of type Barcode Scannable Field now provides validation.

ESB Release Notes

CHANGED Modified the Work Order REST API and Work Order Export API to change the change the Alerts and AlertResponses block from a map to a collection.

Issues Resolved

FIXED Resolved an issue where appointment searches were displaying in the order they were received from the API. They now appear in chronological order.

FIXED Resolved an issue where the superseded part would display multiple times in the line items list when two different parts are superseded by the same part.

FIXED Resolved an issue where two work orders can simultaneously be put onsite via standard use of the mobile application. Note: Two work orders can be marked onsite by marking them onsite via the Work Order REST API or by unearmarking a work order that is onsite in ServiceScheduling and reearmarking a work order after another work order is already onsite within ServiceMobility.

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