Mobile App

The following behaviors can be observed within the Field Service mobile app.

Dynamic Forms

Currently the "required" property of elements on the mobile app can only be set to be a static value and is not supported as part of the dynamic forms functionality. Setting the "required" property dynamically such that it depends on other elements on the same form will not behave as expected.

Custom Forms

While custom entry forms (entry forms for standard and custom records) can be used to automatically load elements/fields for use on a custom tab on the mobile app, custom transaction forms (entry forms for transaction records) are not officially supported.

Article Searches

Search options such as the "all": true property will not be passed through to the search system if they are applied directly within the "article" section. But if you nest searches inside the article section any search options will be passed through and will take effect.

For example, the following would not have any effect:

            {
  "routes/mobile": {
    "asset": {
      "article": {
        "all": true,
        "record": "customrecord_nx_asset",
        "filters": ["isinactive","is","F"],
        "map": {
          "id": "internalid"
        }
      }
    }
  }
} 

          

Nesting the search within the article will mean the "all": true property will have an effect:

            {
  "routes/mobile": {
    "asset": {
      "article": {
+       "assets": {
          "all": true,
          "record": "customrecord_nx_asset",
          "filters": ["isinactive","is","F"],
          "map": {
            "id": "internalid"
          }
+       }
      }
    }
  }
} 

          
Important:

The nesting in the sample above will fail with an error (“Cannot read property "record" from undefined“) if you are loading your elements through a custom form instead of manually defining them. If you receive this error, contact NetSuite Support to discuss solutions.

Item Groups

Item groups are not officially supported for editing on the mobile app. Item groups can be added to the sales order, but, after it is added, the group and its components cannot be modified.

Serial Number Validation on Sales Order

It is expected that the serial number is not required on sales order lines on the mobile app. This allows the user to partially fulfill a serialized line or add the line and choose not to fulfill.

Barcodes and QR Codes

The barcode scanner can be enabled on "select" and "text" type fields only. The scanner will accept barcodes and QR codes. When a code is scanned, it’s value is set within the field (for text fields this results in the exact value being populated within the field, for select fields an option is selected based on the option’s "barcode" property matching the code that was scanned).

The following code formats are supported by default:

  • UPC-A

  • UPC-E

  • EAN-8

  • EAN-13

  • Code 39

  • Code 93

  • Code 128

  • Codabar

  • ITF

  • RSS-14

  • QR Code

  • Data Matrix

  • Aztec

  • PDF 417

File and Image Uploads

The following image formats are supported by the mobile app: JPG, PNG, JPEG, GIF, and BMP.

Files uploaded into a file type field will be recognized in the file cabinet. For more information, see File Types Recognized in the File Cabinet.

Images printed using NetSuite’s advanced PDF tools (such as on our service reports) will only honor image orientation data if they are of the type PNG. This is a known NetSuite limitation. Some images on service reports may appear side-ways depending on their file type.

Expense Receipt Uploads and Enhanced File Security

Field Service Management does not currently support the Enhanced File Security feature in relation to uploading receipts from the mobile app. If this feature is enabled, file uploads using the expenses tab on mobile will fail.

Mobile Emulator and Offline Mode

The mobile emulator which is available by accessing the mobile app through NetSuite, for instance, by right clicking an employee on the Scheduler and clicking the mobile symbol, does not fully emulate the offline mode behavior of the full mobile app.

If you want to test or troubleshoot offline mode behavior, you must be using the full external mobile app accessed through the login link emailed when the “Email Mobile Login” button is pressed on the employee record.

Single Sign-On (SSO)

We do not currently support Single Sign-On (SSO) for the mobile application.

Custom Date Formats

Custom date formats are not currently supported on the mobile application. All dates are displayed in the format dictated by the locale set on the user’s device.

Mobile Tabs that Cannot be Copied

The following out-of-the-box mobile tabs cannot be directly copied in config. Additional logic or automation is hooked up to the following tabs which will not automatically carry across if the tab was manually duplicated in config:

  • History

  • Sales Order

  • Quote

  • Files

  • Return

  • Receive

Refresh and Automatic Overnight Refresh Behavior

When the mobile app is first opened for the day, it checks if the most recent refresh occurred yesterday (before 12 a.m. in the user's time zone), the app will then automatically complete a refresh of the task list.

In cases where the back office processes a record update in NetSuite (for example, when the customer site address is changed), the field technician would need to perform a manual refresh to see the new update.

Office personnel should alert technicians who are impacted by such updates to give them the opportunity to enact a manual refresh.

General Notices