Configuration File Structure

The Field Service Management (FSM) config file is powerful and flexible but it can also get big and complex. Knowing its main sections helps you quickly find the settings you need, make changes, and connect the config to product features.

The config file has several key sections, each with its own role in controlling FSM behavior.

Section

Scope

Features

routes

Controls app or server behavior of the mobile and scheduler

Mobile app tabs, schedule board views

models

Data sourcing, validation, record events

Field mapping, auto-naming, default values

views

NetSuite UI elements such as sublists and buttons

Add Tasks sublist, field filters, custom button labels

notifications

Email templates and service reports configuration, PDFs

Case Service Report, Task Service Report, Project Task Service Report, and their email templates

other sections

Product automation, billing rules, global settings, miscellaneous features

Preventative maintenance, billing rules, service reports, recurrence, custom business logic

The routes Section

The routes section controls how FSM apps and services work, like the mobile app and the schedule board.

routes/scheduler

This section has all the config for the schedule board. It controls filters, color palettes, sorting, and which records show up as events or resources.

  • event – Sets which records show up as events.

  • resource – Sets which records can be assigned as resources.

routes/mobile

This section has all the config for the FSM mobile app. It controls everything you see and do in the app, including which tabs or pages appear, their order, labels, and what data mobile users get.

  • event – Sets which records show as jobs on mobile.

  • resources – Sets which tabs or pages you see in jobs.

  • inventory – Shared data for every job.

  • user – Data specific to each user.

  • tabs – Sets up each mobile tab or page.

The models Section

Models define what data other parts of the config like views can use, and which fields the data is pulled from or goes to. Models also set up things like autonaming records when you save, and default values when FSM creates records, for example, cases made automatically for preventative maintenance. For example, if you want to change how asset data is sourced or checked, update models/asset.

The views Section

The views section controls NetSuite UI elements like custom sublists, buttons, and field filters. It doesn’t affect the mobile app or schedule board. For example, if you want to add a custom Add Tasks sublist to a case, edit views/case/tasks.

The notifications Section

This section manages email templates and PDF service reports. You can also set which templates are used for different reports like Case, Task, or Project Task, and set up the content and recipients for automated emails. For example, if you want to update the template for the Task Service Report email, edit the right section in notifications.

Other Sections

Other sections covers global product features, automation, billing rules, and setting up automatic preventative maintenance cases and tasks. For example, if you want to change how preventative maintenance cases are made.

Related Topics

General Notices