Ticket Item Builder Setup

Prerequisites

The Ticket Item Builder does not support required fields.

Use Validation rules as an alternative to implement this functionality.

Setting Up the Ticket Item Builder

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "static" in the Quick Find box, then select Static Resources

  4. Complete one of the following:

    • If the en_US file displays in the list, proceed to step 11

    • If the en_US file doesn’t display in the list, proceed to step 5

  5. Download the en_US file

  6. Extract the file and save it to your local computer

  7. Move back to FieldFX Back Office

  8. Click New

  9. Complete the following:

    1. In Name, enter "en_US"

    2. In Cache Control, select "Public"

    3. Click Choose File

    4. Select the en_US file you downloaded

  10. Click Save

  11. Configure the Ticket Details fields

  12. Configure the Item grid

  13. Configure the Item picker

Ticket Details

Basics

The Ticket Details section displays basic ticket information.

Screenshot of the Ticket Details section in FieldFX Back Office
Figure 1. The Ticket Details section as seen in FieldFX Back Office

Selecting the Fields to Display

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Ticket

  5. Under Compact Layouts, click New

  6. Complete the following:

    1. In Label, enter "Ticket Details"

    2. In Available Fields, select the fields to include

    3. Click Add

    4. In Selected Fields, change the order

    5. Click Save

  7. Click Compact Layout Assignment

  8. Complete the following:

    1. Click Edit Assignment

    2. Under Record Type Overrides, select ticket types to use the compact layout

    3. In Compact Layout to Use, select "Ticket Details"

    4. Click Save

Item Grid

Fields

Basics

The Item grid displays the ticket items on a ticket.

Screenshot of a list of ticket items in a grid as found on a ticket
Figure 2. A list of ticket items in a grid as found on a ticket

Page layouts control the fields that display on the Item grid, as follows:

Layout Result Note

Master Layout

Controls the fields that display on the Item Grid when you are viewing All items.

The fields on this layout must also display on record type layouts before they will display data.

Equipment Layout

Controls the fields that display on the Item Grid when you select the Equipment filter.

The fields on these layouts must also display on the Master layout before they will display data.

Labor Layout

Controls the fields that display on the Item Grid when you select the Labor filter.

Service Layout

Controls the fields that display on the Item Grid when you select the Service filter.

Supplies Layout

Controls the fields that display on the Item Grid when you select the Supply filter.

Selecting the Fields to Display

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Ticket Item

  5. Configure the Ticket Item Layout:

    1. Under Page Layouts, click Edit next to Ticket Item Layout

    2. Change the fields

      To sort ticket items by sequence number, include the Sequence Number field on the Ticket Item Layout.
    3. Click Save

  6. Add every new field you added to the Ticket Item Layout to the relevant ticket item record type layout:

    1. Under Page Layouts, click Edit next to the layout

    2. Drag the field onto the layout

    3. Click Save

    4. Repeat steps a to c for other page layouts as needed

  7. Remove every field you removed from the Ticket Item Layout from the relevant ticket item record type layout:

    1. Under Page Layouts, click Edit next to the layout

    2. Click the Remove button next to the field

    3. Click Save

    4. Repeat steps a to c for other page layouts as needed

Configuring a Field to Display Read-Only

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Ticket Item

  5. Under Custom Fields & Relationships, click the field name

  6. Click Set Field-Level Security

  7. Select Read-Only next to the user profiles on which to impose the read-only restriction

  8. Click Save

Fields use a combination of page layout and field-level security settings and the most restrictive field setting always applies.

For example, if you make a field required in the page layout security settings and read-only in the field-level security settings, the field displays read-only for the user profiles specified in the field-level security settings.

FX Header

Basics

The expandable and collapsible FX Header displays at the top of the Item grid for tickets, defaulting to collapsed when first accessed.

Screenshot showing the Header as displayed on a Ticket in FieldFX Mobile
Figure 3. The Header on a ticket in FieldFX Mobile

Adding the FX Header to the Ticket Item Grid

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Ticket

  5. Click Edit next to the applicable page layout

  6. Drag Section below Standard Buttons on the Ticket Detail

    Screenshot showing a Section being dragged into the Fields on a page layout
    Figure 4. A new Section being dragged onto a page layout

    The Section Properties window displays.

  7. In Section Name, enter FX Header

    The Section Name must be entered precisely as shown to meet script requirements.

    Section Name is case-sensitive.

  8. In Layout, select 2-Column

  9. Click OK

  10. Drag fields into the FX Header section

  11. Click Save

Item Picker

Search Results

Basics

Search results display at the bottom of the Item picker.

Screenshot of Item Picker search results
Figure 5. Search results for price book items

You can add items in the search results to a ticket.

Selecting the Fields for Price Book Item Search Results

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Price Book Item

  5. Under Search Layouts, click Edit next to Search Results

  6. Complete the following:

    1. In Available Fields, select the fields to include.

    2. Click Add

    3. In Selected Fields, select the fields to remove

    4. Click Remove

    5. In Selected Fields, change the order

    6. Select Override the search result column customizations for all users

    7. Click Save

Selecting the Fields for Quote Item Search Results

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Quote Item

  5. Under Search Layouts, click Edit next to Search Results

  6. Complete the following:

    1. In Available Fields, select the fields to include

    2. Click Add

    3. In Selected Fields, select the fields to remove

    4. Click Remove

    5. In Selected Fields, change the order

    6. Select Override the search result column customizations for all users

    7. Click Save

Selecting the Fields for Scheduled Crew Search Results

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Crew Planning

  5. Under Search Layouts, click Edit next to Search Results

  6. Complete the following:

    1. In Available Fields, select the fields to include

    2. Click Add

    3. In Selected Fields, select the fields to remove

    4. Click Remove

    5. In Selected Fields, change the order

    6. Select Override the search result column customizations for all users

    7. Click Save

Selecting the Fields for Scheduled Equipment Search Results

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "object" in the Quick Find box, then select Objects

  4. Click Equipment Planning

  5. Under Search Layouts, click Edit next to Search Results

  6. Complete the following:

    1. In Available Fields, select the fields to include

    2. Click Add

    3. In Selected Fields, select the fields to remove

    4. Click Remove

    5. In Selected Fields, change the order

    6. Select Override the search result column customizations for all users

    7. Click Save

Picker Width

Basics

You can set the width of the Item picker to control how far it displays across the page.

Setting the Picker Width

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "custom setting" in the Quick Find box, then select Custom Settings

  4. Click Manage next to FX Settings

  5. Click Edit

  6. In TktItemBldr PBI MaxFlyoutWidth, specify the picker’s width when it flies across the page

  7. Click Save

Custom Lookups

Basics

The Custom Lookups feature improves how lookups work on the Ticket Item Builder.

This powerful feature gives you the ability to:

  • Limit the records that display available in lookups

  • Define the fields that display in lookups

  • Define the fields analyzed for keyword searches in lookups

Examples

Contact Lookup

Here’s an example of how you can configure the Contact lookup.

Setting Value Impact

QueryFilter

(LastName=NULL OR LastName LIKE 'S%')

Only contacts with a blank last name or a last name starting with the letter "S" display available for selection.

QueryFields

FirstName, LastName, FX5__Office__r.Name

The listed fields display for contacts in search results.

KeywordSearchFields

LastName

Keyword searches analyze the last name of contacts.

OrderBy

LastName

Contacts sort in alphabetical order by last name.

Equipment Lookup

Here’s an example of how you can configure the Equipment lookup.

Setting Value Impact

QueryFilter

(FX5__Office__r.Name LIKE 'H%')

Only equipment linked to offices starting with the letter "H" displays available for selection.

QueryFields

Name, FX5__Description__c, FX5__Office__r.Name

The listed fields display for equipment in search results.

KeywordSearchFields

Name, FX5__Description__c

Keyword searches analyze the name and description of equipment.

OrderBy

Name

Equipment sorts in alphabetical order by name.

Configuring Custom Lookups

Scenario

As an example, we will show you how to configure the Contact lookup.

  1. Add a CSF_Settings static resource:

    1. Open a text editor

    2. Enter the following to name the static resource:

      window.csf_settings = {
    3. Enter the identifying code for the Ticket Item Builder and Item grid:

      window.csf_settings = {
        tib: {
          maingrid: {
    4. Enter the API name of the lookup:

      window.csf_settings = {
        tib: {
          maingrid: {
            "FX5__Contact__c": {
              "FX5__Contact__c": {
    5. Enter a SOQL query to restrict the records that display available for selection in the lookup:

      Refer to the SOQL reference documentation for more information on how to write SOQL queries.

      window.csf_settings = {
        tib: {
          maingrid: {
            "FX5__Contact__c": {
              "FX5__Contact__c": {
                "QueryFilter": "(LastName=NULL OR LastName LIKE 'S%')",
    6. Enter the fields to display for records in search results:

      window.csf_settings = {
        tib: {
          maingrid: {
            "FX5__Contact__c": {
              "FX5__Contact__c": {
                "QueryFilter": "(LastName=NULL OR LastName LIKE 'S%')",
                "QueryFields": "FirstName, LastName, FX5__Office__r.Name",

      In this example, the First Name, Last Name, and Office fields display for records.

    7. Enter the fields to analyze in keyword searches:

      window.csf_settings = {
        tib: {
          maingrid: {
            "FX5__Contact__c": {
              "FX5__Contact__c": {
                "QueryFilter": "(LastName=NULL OR LastName LIKE 'S%')",
                "QueryFields": "FirstName, LastName, FX5__Office__r.Name",
                "KeywordSearchFields": "LastName",

      In this example, keyword searches analyze values in the Last Name field.

    8. Enter the field by which to sort records:

      window.csf_settings = {
        tib: {
          maingrid: {
            "FX5__Contact__c": {
              "FX5__Contact__c": {
                "QueryFilter": "(LastName=NULL OR LastName LIKE 'S%')",
                "QueryFields": "FirstName, LastName, FX5__Office__r.Name",
                "KeywordSearchFields": "LastName",
                "OrderBy": "LastName"

      In this example, records sort in alphabetical order by last name.

    9. Add braces { } to end the lookup configuration:

      window.csf_settings = {
        tib: {
          maingrid: {
            "FX5__Contact__c": {
              "FX5__Contact__c": {
                "QueryFilter": "(LastName=NULL OR LastName LIKE 'S%')",
                "QueryFields": "FirstName, LastName, FX5__Office__r.Name",
                "KeywordSearchFields": "LastName",
                "OrderBy": "LastName"
              }
            }
          }
        }
      };

      Every left brace { should have a matching right brace }.

    10. Save the file with "CSF_Settings" as the file name.

  2. Upload the CSF_Settings file to FieldFX Back Office:

    1. Access FieldFX Back Office

    2. Switch to Salesforce Classic

    3. From Setup, enter "static" in the Quick Find box, then select Static Resources

    4. Click New

    5. In Name, enter "CSF_Settings"

    6. In Cache Control, select "Public"

    7. Click Choose File

    8. Select the CSF_Settings file

      When you upload a new CSF_Settings file, the lookup configurations in the new file replace any existing lookup configurations.

  3. Test the Contact lookup

    1. Open the Ticket Item Builder

    2. Open the Contact lookup

    3. Verify that the lookup works as configured

Barcode Scanning Feature

Basics

The Barcode Scanning feature gives you the ability to scan barcodes on items to add them to tickets.

This feature is ideal when you need to add large numbers of parts and/or supplies to tickets.

Setting Up the Barcode Scanning feature

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. Add a Barcode field to the Price Book Item object:

    1. From Setup, enter "object" in the Quick Find box, then select Objects

    2. Click Price Book Item

    3. Under Custom Fields & Relationships, click New

    4. Select Text

    5. Click Next

    6. In Field Label, enter "Barcode"

    7. In Length, enter "255"

    8. Click Next

    9. Click Visible twice

    10. Click Next

    11. Select the page layouts on which to include the field

    12. Click Save

  4. Update page layouts for the Equipment object:

    1. From Setup, enter "object" in the Quick Find box, then select Objects

    2. Click Equipment

    3. Under Page Layouts, click Edit next to a page layout for FieldFX Back Office

    4. Add the Barcode field to the layout

    5. Click Save

    6. Repeat steps b to e for other page layouts as needed

  5. Configure FX Settings:

    1. From Setup, enter "custom setting" in the Quick Find box, then select Custom Settings

    2. Click Manage next to FX Settings

    3. Click Edit

    4. In Equipment exact match search field, enter FX5__Barcode__c

    5. In PriceBookItem exact match search field, enter Barcode__c

    6. Click Save

  6. Grant permissions:

    1. Grant users Read and Edit permission for the Barcode field on the Equipment object

    2. Grant users Read and Edit permission for the Barcode field on the Price Book Item object

  7. Run a script for the Barcode field:

    1. Access Workbench

    2. Select UtilitiesApex Execute

    3. Enter the following script:

      System.debug(FX5.FXWorkerLauncher.DoWork('FX5.CustomFieldInfoHandler', null));
    4. Click Execute

  8. Add barcodes to equipment:

    1. Open the Equipment tab

    2. Open the equipment

    3. Click Edit

    4. Click in the Barcode field

    5. Scan the barcode on the equipment

    6. Repeat steps b to e to add barcodes to other equipment items as needed

  9. Add barcodes to price book items:

    1. Open the Price Book Items tab

    2. Open the price book item

    3. Click Edit

    4. Click in the Barcode field

    5. Scan the barcode on the item

    6. Repeat steps b to e to add barcodes for additional price book items as needed

Scanning an Item

  1. Open the Ticket Item Builder.

  2. Click in the Barcode field

    Screenshot highlighting the Barcode field in FieldFX Back Office
    Figure 6. Highlighting the Price Book Item’s Barcode field in FieldFX Back Office
  3. Scan the barcode on the item

    The item now displays in the Item grid.

    You can also add an item manually by typing the barcode and clicking Add.

Ticket Item Builder Button

Basics

The Ticket Item Builder button displays at the top of a ticket in FieldFX Back Office.

Screenshot highlighting the Ticket Item Builder button on a ticket in FieldFX Back Office
Figure 7. A Ticket Item Builder button on a ticket in FieldFX Back Office

Changing the Name of the Ticket Item Builder Button

  1. Access FieldFX Back Office

  2. Switch to Salesforce Classic

  3. From Setup, enter "translation" in the Quick Find box, then select Override

  4. In Package, select "FieldFX Base Package"

  5. In Language, select "English"

  6. In Setup Component, select "Button and Link Label"

  7. In Object, select "Ticket"

  8. Double-click the Button or Link Label Override column next to Ticket Item Builder

  9. Enter a new button name

  10. Click Save

Hiding Ticket Item Builder Components

Basics

To make things easier for users, you can hide unused components on the Ticket Item Builder.

Hiding Components on the Ticket Item Builder

  1. Add the pageSettings_TIB FX Setting:

    1. Access FieldFX Back Office

    2. Switch to Salesforce Classic

    3. From Setup, enter "custom setting" in the Quick Find box, then select Custom Settings

    4. Click FX Settings

    5. Under Custom Fields, click New

    6. Select the Text data type

    7. Click Next

    8. In Field Label, enter "pageSettings_TIB"

    9. In Length, enter "255"

    10. Click Next

    11. Click Save

  2. Select the components to hide:

    1. Click Manage at the top of the page

    2. Click Edit

    3. In pageSettings_TIB, enter the names of the components to hide (use commas to separate the values):

      • Enter HideBarCodeReader to hide the Barcode field

      • Enter HideBulkEdit to hide the Bulk Update button

      • Enter HideCopy to hide the Copy Selected button

      • Enter HideDelete to hide the Delete Selected button

      • Enter HideHeader to hide the Ticket Details section

      • Enter HideItemSearch to hide the Keyword Search field above the Item grid

      • Enter HidePicker to hide the Item picker

      • Enter HideSelectChildren to hide the Add Child Items button for dynamic parent items

      • Enter HideSortByMostRecent to hide the Sort by Most Recent option above the Item grid

      • Enter HideStagePricing to hide the Apply Stage Pricing button

    4. Click Save