Custom List Button Setup

Introduction

You can add custom buttons to related lists to extend standard functionality.

This powerful feature gives you the ability to add new records and pull in information from the related record.

With a custom list button, you can add a list of records so users can accomplish a task to many records at once, without the need to open each record. Examples could be

  • Create Return Tickets

  • Mark Job Complete

  • Send to Mobile

Prerequisites

To set up custom list buttons, you need the following permissions:

  • Minimum permissions for the FieldFX modules you are using

  • System permissions:

    • Customize Application

    • View Setup and Configuration

Step-by-Step Guides

Job Grid Examples

Add a New AP Job Button to the Jobs related list

In this example, we will add a New AP Job button to the Jobs related list on accounts and price books.

Once we set up the New AP Job button, the following applies:

Record Type Fields automatically added in the new job

Customer Record

  • Name

  • Record Type

  • Customer

  • Notes

office record

  • Name

  • Record Type

  • Office

  • Notes

Price Book

  • Name

  • Record Type

  • Customer

  • Office

  • Segment

  • Notes

Add a New Mark Job Complete Button

This button lets a dispatcher or back office user select multiple jobs and marks them as Complete in one click.

Add a New Service Job Button

  1. You can add a New Service Job button to the Jobs related list on the Price Book object.

  2. You can configure the button to pull in information from the price book and make the "AP" record type selected automatically for the job.

Access Fields

  1. Access FieldFX Back Office.

  2. Switch to Salesforce Classic.

  3. Complete these sections in order:

Add the "Is Office" field

  1. From Setup, enter accounts in the Quick Find box, then select Fields.

  2. Under Account Custom Fields & Relationships, click New.

  3. Select Formula and then click Next

  4. In Field Label, enter "Is Office".

  5. Under Formula Return Type, select Checkbox and click Next.

  6. Enter the following formula:

    RecordType.DeveloperName=="Office"

  7. Click Next.

  8. Click Visible twice and then click Next.

  9. Select the page layouts on which to include the field and click Save.

  10. Grant permissions for the field.

Add the New AP Job button

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

  2. Click Job.

  3. Under Buttons, Links, and Actions, click New Button or Link.

  4. Complete the following:

    Field Action

    Label

    Type a name for the button.

    Display Type

    Select List Button.

    Behavior

    Select "Display in existing window with sidebar".

    Content Source

    1. Select "URL".

    2. Enter the following URL:

      /apex/FX5__JobEditor?EntityType=FX5__Job__c&RecordType=AP&FX5__Price_Book__c={!FX5__Price_Book__c.Id}&FX5__CustomerAccount__c={!IF(ISBLANK(Account.Id), FX5__Price_Book__c.FX5__AccountId__c, IF(Account.Is_Office__c, NULL, Account.Id))}&FX5__Office__c={!IF(ISBLANK(Account.Id), FX5__Price_Book__c.FX5__OfficeId__c, NULL)}&FX5__Segment__c={!FX5__Price_Book__c.FX5__Segment__c}&Name={!IF(ISBLANK(Account.Id), FX5__Price_Book__c.FX5__Account_Name__c, Account.Name)} Job {!TODAY()}&FX5__Notes__c=Enter your comments and observations here&retURL=%2F{!FX5__Price_Book__c.Id}&sfdc.override=1

  5. Click Save.

  6. Click OK.

  7. Continue with Add to Customer Page Layouts.

Add to Customer Page Layouts

See customer page layouts for more information.

  1. From Setup, enter accounts in the Quick Find box, then select Page Layouts.

  2. Click Edit next to the page layout for customers.

  3. Move down to the Jobs (Customer) related list.

  4. Click the Wrench icon.

  5. Click + to expand the Buttons section.

  6. Under Custom Buttons, add "New AP Job" to the Selected Buttons list.

  7. Click OK.

  8. Click Save.

  9. Repeat these steps for other page layouts as needed.

  10. Continue with Add to Office Page Layouts.

Add to Office Page Layouts

See office page layouts for more information.

  1. From Setup, enter accounts in the Quick Find box, then select Page Layouts.

  2. Click Edit next to the page layout for offices.

  3. Move down to the Jobs (Office) related list.

  4. Click the Wrench icon.

  5. Click + to expand the Buttons section.

  6. Under Custom Buttons, add "New AP Job" to the Selected Buttons list.

  7. Click OK.

  8. Click Save.

  9. Repeat these steps for other page layouts as needed.

  10. Continue with Add to Price Book Page Layouts.

Add to Price Book Page Layouts

See price book page layouts.

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

  2. Click Price Book.

  3. Under Page Layouts, click Edit next to a page layout.

  4. Move down to the Jobs related list.

  5. Click the Wrench icon.

  6. Click + to expand the Buttons section.

  7. Under Custom Buttons, add "New AP Job" to the Selected Buttons list.

  8. Click OK.

  9. Click Save.

  10. Repeat these steps for other page layouts as needed.

Convert HTML to PDF Custom Button

If you have HTML files attached to a ticket, job, or a quote, you can convert them to a PDF. See Convert HTML to PDF Custom Button.

Troubleshooting

Issue Solution

The button doesn’t show in the list view.

Ensure the button is added under Search Layouts > List View Actions in the Lightning Experience.

The flow doesn’t receive IDs

Ensure the variable name exactly matches the record ID.

Users can see the button but it fails to run when clicked.

Check the flow for single records

Do you Need per-row or multi-row.

Use a Row Action in Lightning for single record or Mass Action/List View Action for many records.

Recommended Reading

For more information, see:

FieldFX Documentation Salesforce Documentation