You can customize the modules in FSM to suit the needs of your organizational process. You can choose the fields which are essential for your process, set their properties, and placement in the module.
Add Custom Fields
To customize a module:
- Navigate to Setup > Customization > Module and Fields.
Only users with the profile Administrator will have this option. - Click the module you want to customize.
- In the Module Builder page, drag and drop the fields you want from the New Fields tray.
- Enter the properties for the field and click Save.
- You can also drag and drop a new section, provide a name for the section and add fields to the section and click Save.
- For the Services and Parts module, select the required layout depending on whether you want to customize the Create Parts page or Create Services page.
Auto-Number
If you need to have incremental values or a series for a field, you can use the auto-number field. This customization is currently limited to a few pre-defined fields (Request Name, Estimate Name, Work Order Name, and Appointment Name). The auto-number has the following format:
Prefix Start number Suffix
Example of an auto-number is Zylker-0001-13-10-22, where,
- Prefix is optional
- Start number: The value provided here will be incremented for each subsequent record. Only numbers are allowed.
- Suffix
- An ending string for the auto-number. It will be appended after the Start number.
- Alphanumeric (0-9, a-z, A-Z) values are allowed.
- Special chars except !, #, ^, *, (, are allowed.
You can add current dates using the format Day-Month-Year where,
Value | Format |
Day | (dd) |
Month | (MM) or (MMM) |
Year | (yy) or (yyyy) |
E.g. (dd)-(MM)-(yy) or (dd)-(MMM)-(yyyy)
- Suffix is optional
Preview: It will display the value that will be used in the next record created.
The changes made to the auto-number field will only be applied to the future records.
URL
You can define the following properties for a URL field:
- Field label: A name for the field
- Mandatory: Mark the field as required
- Character Limit: Maximum characters allowed
- Contains personal data (PII): To designate the field as one having Personally Identifiable Information like mailing address, or SSN
- Encrypt data: To encrypt the data in the field
Currency
You can define the following properties for a Currency field:
- Field label: A name for the field
- Mandatory: Mark the field as required
- Maximum digits allowed: Maximum digits allowed. This includes the Number of decimal places as well.
- Number of decimal places: Maximum number of decimal places allowed
- Contains personal data (PII): To designate the field as one having Personally Identifiable Information like mailing address, or SSN
- Encrypt data: To encrypt the data in the field
Manage Sections
The following are the actions that can be performed on a section:
- Add sections: Add a new section by dragging and dropping the New Section tile from the New Fields tray. You can add fields to the section thus newly added. Fields can be added only inside a section.
However, there are some predefined sections to which you cannot add fields.
- Reposition sections: You can move a section by hovering over the section header and dragging it (see screenshot below) to the desired location within the page. The fields can be moved within a section as well as between sections.
- Rename labels: The section and field name labels are editable.
- Delete: You can remove a section by clicking the Delete [] icon.
If a section has mandatory or system-configured fields, then the section cannot be deleted.
Edit Custom Fields
You can edit a custom field. You can change the field label, length, etc. You can also reposition a field by dragging and dropping it to its new position.
To edit a custom field:
- Navigate to Setup > Customization > Module and Fields.
- Click the module whose fields you want to edit.
- Select the field you want to edit and make edits to its properties listed in the right pane.
- Click Save.
Some system-configured fields can be edited.
Delete Custom Fields
You can delete a custom field. The field can be deleted temporarily or permanently.
To delete a custom field temporarily:
- Navigate to Setup > Customization > Module and Fields.
- Click the module whose fields you want to delete.
- Select the field you want to delete and click the more options [ ] icon for a field. Click Remove.
You can also delete a field using the Delete [ ] icon at the bottom of the right pane. The deleted field will be moved to Unused fields.
- In the confirmation message, click Yes, Move to Unused Fields.
If the field is used in the service report template, then the field cannot be deleted.
You can also drag and drop a field to Drop here to delete located at the bottom of the New Fields tray.
To delete a custom field permanently:
From the
Unused fields section, you can either retrieve the field or delete it permanently from the module. To retrieve the field, drag and drop it back to the desired section of the module. To delete the field permanently, click on the Delete [
] icon, and click
Delete in the confirmation message.
If a field is associated with a workflow rule, or field update, then the field cannot be deleted.
Mandatory Validation
Adding the mandatory validation
When the mandatory validation is added to a field, the following features will be affected and you need to take appropriate actions:
- In the Field Mapping for the FSM-Invoice/Books integration, ensure that the FSM field marked as mandatory is mapped to a field in Invoice/Books.
- If the field now marked as mandatory has been used in custom functions, or integrations involving FSM REST APIs, then their functioning will be impaired. You might need to revisit them and make the necessary changes.
- The field marked mandatory will be added to the Quick Create layout.
- If the mandatory validation is added to a field in the Work Orders module, then it might affect any existing work order templates you have created for scheduled maintenance plans.
Removing the mandatory validation
While removing the mandatory validation for a field, you have the option to remove it from the Quick Create layout. Select the Also, remove this field from the Quick Create layout checkbox if you want to remove the field from the Quick Create layout.
Other Info section
The custom fields will be displayed in the Other Info section of the [Module] Details page in the web app.
In the mobile app, the custom fields will be displayed in the Other Info section under the Overview tab of the [Module] Details page.