Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 49 Next »

Release Version: 2024 (10.0.63)
Release Date: November 2024

Installing MobileTech

Upgrading to MobileTech 2024 From a Previous Version

You can upgrade to MobileTech 2024 from version 9.0 (2022) or higher.

  • Before you upgrade from a previous version of MobileTech:
    • Make sure that all mobile devices have been synchronized to the host system. If you've made changes to views or stored procedures in previous versions of MobileTech, those changes will be overwritten during the upgrade.
    • IMPORTANT: Inactivate any active Woodford projects before running the upgrade.
  • You'll be prompted to install database objects the first time you log into MobileTech Administration after upgrading. You must do this for each company. If you're not prompted to install database objects, go to Tools > Create MobileTech Objects and select Process. For more information, see Log into MobileTech Administration in the Installation & Administration Guide. For additional upgrade notes, see Upgrade MobileTech Server in the Installation & Administrative Guide. Installing database objects during an upgrade does not remove any data from the middle tier.

Installing MobileTech for the First Time

You can install and set up MobileTech as described in the Signature MobileTech Installation & Administration Guide.

Installation Components and Compatibility

MobileTech Components to Install

To set up and implement MobileTech, you must install these components:

  • MobileTech Server 2024 (10.0.63) includes Resco Woodford v17.1.2.1781, Publish Version 16.0

  • MobileTech 10.0.63.Woodford (included in installation)
  • MobileTech with Inspections 10.0.63.Woodford (if you are using Inspections)
    IMPORTANTDue to issues with Resco licensing where the Inspection license is assigned to any technician who syncs with a project that has Inspections even if they are not assigned the Inspector Role, you need to have two Woodford projects (one for Inspections, one for non-Inspections). See Import the MobileTech Woodford Project for the updated steps for creating a child project and importing the Inspections project.
  • Resco Mobile CRM 16.0.9 or higher (from device App Store)  

Important Notes

  • Microsoft announced on May 24, 2024, that they are deprecating Bing Maps. Customers using Bing Maps for Enterprise Basic or Free license will no longer be able to use Bing Maps for Enterprise services beyond June 30, 2025. To continue using Mapping in MobileTech, you will need to obtain a Google Maps API key at https://cloud.google.com/maps-platform/pricing/. (You will need an API key that includes Maps and Routes. You do not need Places.) See Enter the Google Maps API Key.
  • As App Stores increase their security requirements, HTTPS (with Trusted SSL Certificates) will soon become required across all device types.  Therefore, we recommend you transition your MobileTech environment to use SSL with a trusted certificate.
  • Do not install MobileTech server components on your SQL Server machine. 
  • Install MobileTech Administration on the MobileTech web server.
  • Verify the eTimeTrack Web Service current release version matches the installed version of Signature. For installation instructions for each component, see the Installation & Administration Guide.

Compatibility

To find a complete list of system requirements across all the Signature modules, refer to the System Requirements documentation.

This table lists the tested and supported compatible versions for MobileTech 2024.

Software or deviceCompatible versions
Operating Systems 
  • Android 14, 15
  • iOS 17, 18
  • Windows 10, 11

Signature Version

IMPORTANT

If you are upgrading to Signature 2024 (18.7.9), you must upgrade to MobileTech 10.0. However, if you are only upgrading MobileTech to version 10.0, you can be on any of these compatible Signature versions.

  • Signature 2024 (18.07b09)
  • Signature 2023 (18.06b08)

Incompatibility

  • The MSI (non-Windows Store) version of the Resco Mobile CRM available from the Resco website is no longer compatible with MobileTech. If you currently use the MSI version, you must migrate to the Windows Store version and should plan accordingly before upgrading.
  • Flexible Forms are not compatible with Microsoft Windows 11.
  • Servers running Cylance script control. 
  • MobileTech inventory transactions do not support Microsoft Dynamics GP Inventory Lots.

Obtain a Google Maps API Key

To use the Mapping feature on any device, you will need to obtain a Google Maps API key at https://cloud.google.com/maps-platform/pricing/. You will need the Maps JavaScript API (Maps > Dynamic Maps) and Geocoding (Places tab). Geocoding is required for setting coordinates. See Enter the Google Maps API Key.

Microsoft announced on May 24, 2024, that they are deprecating Bing Maps. Customers using Bing Maps for Enterprise Basic or Free license will no longer be able to use Bing Maps for Enterprise services beyond June 30, 2025.

Installation Notes

  • After installing MobileTech 2024, if you have set up password complexity, you will need to set this up again as the MobileTechAdmin.exe.Config file is overwritten.
  • You will need to add the IIS APPPOOL\RescoCloud user to the SQL Server Reporting Services Home Folder permissions page. For instructions on adding the user, see https://docs.microsoft.com/en-us/sql/reporting-services/install-windows/reporting-services-configuration-manager-native-mode?view=sqlallproducts-allversions. You can filter the instructions to your SQL Server version.

  • The Job Summary Timesheet report no longer prints automatically when a technician completes a job appointment with billable transactions on the appointment. If your company would like to continue to have this report automatically generated, you can remove the comment lines from Offline HTML: 

    Enabling the automatic timesheet generation after completing a job appointment:

    1. In Woodford, select the MobileTech Woodford project and then select Edit from the menu bar.

    2. From the left navigation, select Offline HTML.
    3. Double-click Entity to open.
      Double-click Appointment to open.
    4. Select appointment-form_complete-job.html and then select Edit from the menu bar.
    5. Scroll down to FORM EXECUTIONS.
    6. Locate //,generateTimesheetReport(appointment) //Uncomment line to turn on automatic generation of timesheets.
    7. Remove the preceding //, and succeeding //Uncomment line to turn on automatic generation of timesheets so that the line only displays the following.
      generateTimesheetReport(appointment)
    8. Select Save.
    9. Select Save from the menu bar.
    10. Publish the project.

IMPORTANT

Deprecation Note:

The legacy UseXOi feature has been deprecated and is no longer available as a setup option in MobileTech Administration. 

New Features

General

Case #

New Feature

MT-1159

We've added Department and Position to the Employee lookup when entering helper technician time entries. The lookup is searchable by name, department, and position. UseTechnicianHelper must be set to True in Mobile Device Global Settings for technicians to be able enter time entries for technician helpers.

MT-1171

Technicians can now add multiple attachments at one time by selecting the new Select Attachments button on the Attachment form. If a description was entered before attaching the files, the description will apply to all the files. The description can be edited by selecting the specific file and then selecting More to enter a description for that attachment. As before, the type of file that can attached is dependent on the device hardware. Attachments can be added to service calls, appointments, equipment, locations, tasks, and time entries. See Working With Attachments.

 Click to view screenshot.

MT-1175

The Synced Devices Last Synchronized column in MobileTech Admin has been updated to sort by DateTime to provide a more accurate sorting. Previously this was sorting the date as a string.

MT-1184

We've added the Originating Service Call ID information to the MobileTech Service Call screen. This is a read-only field and the information originates from Signature.

 Click to view screenshot.

MT-1201

Location attachments are now supported in MobileTech. Technicians can add, edit, or view attachments for service and job locations from the new Attachments tab from the Locations form. The attachments can be added from Signature or MobileTech. See Working With Attachments.

MT-1203,
MT-1255

We've added a Jobs icon on the home screen that displays a list of jobs that can be selected to display more information or the technician can create a new job appointment for this job. Technicians can search and filter the list. The list can also be sorted by date or location. Technicians can display only the jobs on their device with DEVICE MODE or, by selecting SERVER MODE to search for a job in the Middle Tier or all active jobs in Signature depending on the setting for IncludeAllActiveJobs in Job Settings. Searching using Server Mode requires an internet connection. See Jobs and Job Appointments.

Technicians can now:

  • Create a new job appointment from the job list or the job appointment list. For information on how to create a new job appointment for a job, see Create a Job Appointment.

  • Create a labor time entry associated with a job instead of with a job appointment.

  • Using SERVER MODE requires the UseServerMode option set to True in Mobile Device Global Settings in MobileTech Setup Options. See Mobile Device Global Settings

  • The default records fetched is 3, however, you can update this number using ServerJobCount in Job Settings.

  • If you do not want your technicians to be able to create job appointments for the selected job, you can set AllowCreateJobAppointments to False in Job Settings.

There is a new Job Settings section in MobileTech Setup Options:

  • ShowJobListDetermines if the Job icon displays on the Home screen. Technicians can select this to view the list of jobs on their devices. The default value is True. See Create a Job Appointment.

  • IncludeAllActiveJobsDetermines if all active jobs from Signature display in the Job List. The default value is True. If False, only jobs with active appointments in MobileTech will display.

  • ServerJobCount: Determines the number of job records that are displayed when job data is requested from the server. The default value is 3.

  • AllowJobTimeEntries: Determines if technicians can create time entries for a job instead of the job appointment. The default value is True. See the description below for MT-1283.

  • AllowCreateJobAppointments: Determines if technicians can create job appointments in MobileTech. The default value is set to True.

MT-1241

We've added a “+” button to the Tasks form to create a new piece of equipment. On the Tasks form, users can now access the Equipment form to create a new piece of equipment by selecting the + button to the right of the All Equipment dropdown. On the Equipment form, users can select the < button to return to the Tasks form. The equipment will be automatically assigned to the service call. See Complete Tasks for a Service Call.

 Click to view screenshot.

MT-1238,
MT-1300,
MT-1647

When a technician assigns equipment to service calls, the associated equipment types' tasks can now be automatically assigned to the call instead of the DEFAULT task.

Three new setup options were added to Task Settings in MobileTech Admin Setup Options. The default value is False for all three options. The value needs to be set to True to enable the feature. 

  • UseEquipmentAssignmentforMCC

  • UseEquipmentAssignmentforMC

  • UseEquipmentAssignmentforNonMC

To use the new functionality on the device, with the appropriate option(s)set to True and the call type selected matches the setting when assigning equipment to the call or creating new equipment:

  • The DEFAULT task will be created if the equipment type is NOT populated.

  • If the equipment type is populated:

    • If the equipment type has a task list, and the task list has records in the master tables, the related tasks, subtasks, and responses will be created instead of the DEFAULT task.

    • If the equipment type does not have a task list, the DEFAULT task will be created.

Notes:

  • If the technician is creating a new piece of equipment and the setup option AllowModifiyNewEquipmentID = False, the task list on the task, task response, and subtask are not updated from PENDING until the next sync.

  • If the user does not sync after assigning the equipment to the service call, the user can unassign the equipment, and all related tasks, task responses, and sub-tasks are deleted.

  • The default task status assigned to any created task will be from the setup option DefaultTaskStatus.

MT-1244

We’ve added a hyperlink on the Equipment field on the Task Details page to navigate directly to the equipment form allowing the user to modify the equipment record. Users can click the < button to return to the Task Details page. See Entering Task Details on Complete Tasks for a Service Call.

IMPORTANT: If the Sublocation field is updated on the equipment form, only the equipment’s sublocation is updated, the task sublocation is NOT updated for existing tasks (because this is a key segment). Any future created tasks will have the updated equipment sublocation. 

 Click to view screenshot.

MT-1274

We’ve added an “Incomplete Equipment” view to the task list drop-down. When selected, any equipment that have at least one open task is displayed. Users can select the equipment and select a new Complete Tasks action item to complete the open task(s). A confirmation pop-up displays to verify that the tasks should be completed. See Complete Tasks for a Service Call.

 Click to view screenshots.

MT-1254

When adding consumed inventory, technicians can now multi-select up to 5 site inventory items to add to the appointment. The quantities can be edited on the initial form and after the initial creation. See Enter an Inventory Transaction Before Completing an Appointment.

From the Inventory tab, technicians click the new Select Inventory button.

 Click to view screenshot.

On the Site Inventory window, technicians can select up to 5 site inventory items. The selected items are highlighted in gray and displayed in the top preview section. To unselect an item, just click the item again. Select the Save icon to return to the Inventory form. 

 Click to view screenshot.
  • If only one inventory item is added, the Quantity, List Price, Unit Cost, List Price, and Description are displayed and can be edited.
    The Price and Cost display is based on your company’s setup option for ShowInventoryCost and ShowInventoryPrice.

    • Quantity: Enter the number of units.

    • Unit Cost: Enter the cost per unit. This field might not be displayed, depending on the setup.

    • List Price: Enter the list price per unit. This field might not be displayed, depending on the setup. You can't enter negative list prices for items that have an item type of Sales Inventory, Discontinued, or Kit.

    • Description: If you select a site inventory number, information about the item is displayed. If the transaction is for a non-inventory item, you can enter a description of the inventory transaction.

  • If more than one inventory item is added, only the Quantity can be edited for the Site Inventory items displayed in the grid below the Select Inventory button. The price, cost, and description are not displayed and this will be auto-populated from the site inventory item.

    • If you need to change items, click the Select Inventory button again and you can make your changes.

    • You can edit the inventory item by saving the form and then opening the Inventory tab again. Then select the inventory item and edit as needed and then save the edits.

MT-1257

We've added validation to the Task form so that if a technician has made changes on the task form and then selects the X to close the window, they will now be prompted to Save and Close, Discard Changes, or Continue Editing. See Complete Tasks for a Service Call.

MT-1264

We've updated the Conflict Resolution to Device Wins for appointments, service calls, tasks, subtasks, and task responses. With this update to Device Wins, only the fields changed on the client are uploaded. If the changes on the server affected different fields than on the app, both changes are preserved. If the same field is changed in both databases, server values are overwritten. 

Previously, we were using Device Wins (Full), where the whole client record, including unchanged field values, is sent to the server. Server changes are lost.

For more information, see Conflict resolution - Resco's Wiki (external link).

MT-1283

Technicians can now create a time entry for job labor without requiring a job appointment.

This time entry can be created by accessing Time Entries or the Job List. See Create Time Entry for Job Labor w/o Appointment.

If you do not want your technicians to be able to create a time entry for jobs without an appointment, you can turn this feature off by setting the AllowJobTimeEntries in Job Settings to False. This option defaults to True. See Job Settings.

Note: Manager Approval is not supported for this feature.

MT-1290

We've made notes more visible in MobileTech. 

  • If an entity has a note attached, the background color is yellow. For example, if the customer has a note attached, the background color of the customer displayed on the service call form is yellow.

  • A note icon now displays to the right of any entity that supports notes (such as service appointments, locations, service calls, job change orders, equipment, and equipment contracts). This icon displays regardless of a note available. Users can select the note icon to open the notes form where a note can be added or the list of notes is displayed.

 Click to view screenshot.

  • The maximum number of characters displayed for each note in the list is 500 characters. If you would prefer to have more characters displayed, the maxDisplayLength value in the Resco Offline HTML file found at entity\notes\note-list.html can be edited.

If the note length exceeds the maxDisplayLength, "..." is added to the display to indicate more text is available for the note. 

 Click to view screenshot.

MT-1324

We've added validation when creating maintenance contract (MC) service calls to align with the validation required in Signature. When a technician creates a new MC service call, they must add a piece of equipment covered by a maintenance contract. 

If the technician creates a new MC service call and clicks Save, the call will not be created if:

  • No equipment is selected. The message "Equipment is required for Call Type MC" is displayed.

  • Equipment is added to the MC service call but isn't assigned to a contract. The message "Equipment must be covered by a contract for Call Type MC" is displayed.

MT-1341

You can now enable a background sync when an appointment status is changed. When the status of an appointment is changed on the device, whether manually or automatically, a background sync is performed to push the data into Signature to get closer to real-time appointment status in the back office. You also have the option to send latitude and longitude values, if available, when the background sync is performed.

Changes are not pushed if:

  • Appointment only exists in MobileTech (new appointment not synced yet)

  • Appointment in Signature already has status “RE-ASSIGN” or “COMPLETE”

  • Appointment in Signature has been assigned to another tech

  • MobileTech Appointment Status is “DEFAULT” or “COMPLETE”

We've added two setup options to Mobile Device Global Settings:

  • UseAppointmentStatusBackgroundSync
    Determines if a background sync is performed when the appointment status is changed manually or automatically on the device. This option requires an internet connection and applies to all appointment types. The default value is False. When this option is set to True, only the appointment status is pushed during the background sync.

  • IncludeLocationWithAppointmentStatusSync
    Determines if latitude and longitude are included in the automatic background sync. This option applies to job and service appointments. The default value is False. This option is enabled when UseAppointmentStatusBackgroundSync is set to True. When both options are set to True, only the appointment status and GPS information is pushed during the background sync.

MT-1386

Technicians can now view inventory added to a service call by other technicians and from the Signature back office from the Appointment Completion form for service appointments when they select the Inventory tab. The inventory items are read-only. The technician's name is displayed on the list view and the Summary tab. (If the employee name isn't available the GP Technician ID displays.) This is only for service appointments. Job appointments will only show inventory added to that job appointment by the current technician and from the Signature back office.

 Click to view screenshots.

MT-1411

The legacy job safety audit (JSA) report request has been added to the existing UsedEventBasedSync setup option in Mobile Device Global Settings.

For the JSA Report:

  • True: If UseEventBasedSync is set to True, when a technician requests the JSA report, the Sync window opens. If there are pending changes to the Appointment form, the technician is prompted to save or discard the appointment changes before the sync window opens.

  • False: If this option is set to False, technicians will see the following message "Job Safety Report will be available upon next Sync."

When set to True, this setup option prompts technicians to sync their device after a:

  • A service call is created.

  • An appointment is created or completed.

  • A timesheet report is requested.

  • A legacy job safety audit (JSA) report is requested.

  • A piece of equipment is created.

  • A payment has been applied to a field invoice.

  • A purchase order is created. 

MT-1415,
MT-1727


You can now define any Summary report (Call Summary, Appointment, or Job Appointment) for a specific customer and/or a customer location. You can also filter to a specific Call Type and/or Division for the Summary report the customer receives. This lets you customize the Summary report for your customer's needs. For example, the type of report they receive, the subject line, and the body of the email.  See Set Up Report Email Options.

Note: You can define a summary report for one or more customers and/or a customer location (each a separate report line) and have a <Default> summary report line for all other customers to receive. For example, you define the Call Summary report for customer 102 and also have the <Default> call summary report. Only customer 102 will get their unique report and all other customers will receive the default Call Summary report. 

 Click to view screenshot.

MT-1577

You can now specify to hide site inventories if the item has a negative or zero quantity. We've added a new AllowNegativeSiteQty option to Inventory Settings. This option defaults to True to remain consistent with existing functionality that shows the negative or zero quantity items. The new setup option is enabled if ShowInventorySiteQtyAvailable is set to True.

  • True: When set to True, users can see and select an item, regardless of the available quantity.

  • False: When set to False, the item is not displayed if the site inventory has a zero or negative quantity for an item

MT-1562

Starting with the Signature 2024 release, you have the option to store attachments to Azure Cloud Storage (either WennSoft-hosted or self-hosted). Once you've set up Azure Cloud Storage in Signature, your MobileTech attachments will also use Azure Cloud storage. For more information, see the Signature 2024 What's New document.

We've added a new read-only DefaultDocumentCategory setup option to MobileTech Global Settings. This setting shows the Default Storage Location selected in Signature 2024's new Document Storage Setup window. 

  • Copy File

  • Attach File

  • Copy To Database: If your Signature version is earlier than 2024, this option is the default.

  • Cloud Storage

When a technician updates an attachment that is stored locally and not in the cloud, MobileTech will update the local version and this will not be uploaded to the cloud.

MT-1674

We've added the Current Company User count after the All Company User Count at the bottom of the Users list in MobileTech Admin.

 Click to view screenshot.

Resco Inspections

Case #

Description

MT-1168

IMPORTANT: Due to issues with Resco licensing where the Inspection license is assigned to any technician who syncs with a project that has Inspections even if they are not assigned the Inspector Role, you need to have two Woodford projects (one for Inspections, one for non-Inspections). See Import the MobileTech Woodford Project for the updated steps for creating a child project and importing the Inspections project.

Having the Inspections Woodford project as a "child" project of the Non-Inspection Woodford "parent" project allows you to make changes to the "parent" project and changes are automatically rolled down to the "child" project when you select to "Publish All".  You will not have to make customization changes on two Woodford projects. 

Note that if customizations are made to the "child" project, the link the "parent" project will be broken.

IMPORTANT

With this change, technicians must be assigned to either the MobileTech role or Inspector role, but not both roles. The assigned role determines which project the technician syncs their device to.

MT-1174

Resco is deprecating the Auto Dashboard due to a lack of people using it. We've removed the Auto Dashboard from our Manager Woodford project. For more information, see https://docs.resco.net/wiki/Automatic_Dashboard.

MT-1215

Additional new features from Resco's Winter 2024 Release:

  • Resco mobile platform

    • AI-assisted help in Woodford

    • Data model explorer

    • Migration from Xamarin to .NET platform

    • Sync improvements

    • Support for new languages

    • Bring some color to flexible forms

    • Code editor in Woodford

    • Not older than X days

    • Display options as segmented buttons

    • Display multi-dropdown as "chips"

    • Storage analyzer: questionnaire statistics

    • Save photos to device gallery

    • JSBridge: Is the question answered?

  • Inspections and questionnaires

    • Use optical character recognition (OCR) to answer questions

    • Export and import wizard

    • Questionnaire options

    • Complete questionnaire and open a new instance

    • Which answers to copy in repeatable groups?

    • Access style editor from style selector

  • Resco Cloud

    • Web app modernized

    • Improved cloning/pulling from connected environments

    • Custom fonts in server reports

    • Resco CRM Sync: upload filter

For information including a YouTube demonstration from Resco, please go to https://docs.resco.net/wiki/Releases/Winter_2024.

MT-1336

Additional new features from Resco's Spring 2024 Release:

  • Resco mobile platform (Microsoft, Resco Cloud)

    • Geofencing

    • JSBridge upgrade for web app

    • Microsoft Store app: switch to WebView2

    • OCR in forms

    • Too much flexibility in the forms

    • View designer redesigned

    • View designer: responsive resize

    • View designer: custom map pin

    • Woodford: find fields used in the mobile app

    • Woodford: more clarity into "Project Default"

    • Newly supported FetchXML operators

    • Monitor progress when publishing projects

    • Housekeeping: .NET 8

    • Clearer feedback for user actions

    • (iOS) nicer dropdown lists

  • Inspections and questionnaires (Microsoft, Resco Cloud)

    • Mark mandatory questions

    • Support for zero instances for repeatable group

    • Define score ranges for group results

    • Questionnaire Designer improvements

    • Save answers to a different table

    • Questionnaire integrity check

For information including a YouTube demonstration from Resco, please go to https://docs.resco.net/wiki/Releases/Spring_2024.

MT-1410,
MT-1543

We've added new steps in the Middle Tier Database Clean Up Job to remove inspection attachments and entities.

  • Inspection attachments: This will only clean up records where the attachment is saved in Signature for a related entity (service call, appointment, job, job appointment, equipment, or customer). 

  • Inspection entities: 

    • Removes any related entities for JSA inspections where the created date is older than 14 days.

    • Removes any orphaned child inspection entities for any inspection, not just JSA inspections.

You will need to create a new cleanup job in MobileTech Admin to add these new cleanup steps. For more information, see Create a Cleanup Job for the Middle-Tier Database.

Bug Fixes

Case #Fixed Issue
MT-1181Android users will now see the Entry Type field as expected when entering time entries.
MT-1198When adding an administrator in MobileTech Admin, we are now checking to see if the email address already exists.
MT-1206You can now add an icon on an inspection template.
MT-1340The Legacy JSA and Summary reports are now created as expected when there are more than three appointments. 
MT-1379Job reports are now saved as expected to the correct job appointment attachment location.
MT-1410We've improved the fetch request performance to be more efficient for users who have many tasks on several pieces of equipment and are attempting to add equipment to the Appointment Completion form.
MT-1544We've fixed an issue where some users report receiving the error message "Check Report Signatures Error: Missing Summary Report" when completing an appointment.
MT-1651Notes at the job level are no longer duplicated in the notes list.
MT-1685The sync logic was updated so that null values are not created in the Branch field of the Technician Team Branch table. When a lookup refresh is performed, data that has null references are removed.
MT-1757Technicians can now update their password from their device.
MT-1769Users will no longer receive an error message when creating a task response.
MT-1776The Field Invoicing preview is now working as expected. 
  • No labels