SuiteApp Version: eXtendMobile 1.12.214 and above

Mobile App Version: eXtendMobile 1.12.914 and above

Audience: eXtendMobile Admin

Use Case

  • Add custom buttons to perform custom actions in List functions.

Summary

eXtendMobile lets you add custom buttons to perform various tasks based on your needs.

Note: With the exception of initiating a linked function, custom buttons are for advanced use cases and require additional configuration and custom development.

Prerequisites

Based on your requirements, there are five ways to configure a custom button, each needing additional details:

  1. Performing custom actions using hook functions: For this advanced configuration, contact eXtendTech Support to discuss implementation options.
  2. Performing any client-side update: For this configuration, create a JavaScript file with the client-side action you want to perform and upload it using the uploader field named Select Client JS Script.
    eXtendMobile Web only.
  3. Initiating a linked function: For this configuration, you need an existing function in eXtendMobile that will be linked to and opened when the custom button is used.
  4. Initiating a Map/Reduce script: For this configuration, you need the Map/Reduce script in NetSuite that you want to initiate and the script deployment you want to run. Your Map/Reduce script must also have a script-level parameter of the Free-Form Text field type. This parameter ensures the script receives the queue record ID, which carries the context of the incoming request from the custom button.
  5. Printing records: Add printing of list view results using a custom button. Users can select a printer and number of copies from a modal window.

Configuration

To configure a custom button, open the List function where you want to add it in edit mode, and select the Custom Buttons option.

In the eXtendMobile App, it is on the main function details page:

Custom Buttons option on the function details page in the eXtendMobile App

Custom Buttons configuration in the eXtendMobile App

In the eXtendMobile Web portal, it is under Advanced Settings:

Custom Buttons option under Advanced Settings in the eXtendMobile Web portal

Specify details based on your requirements, as described in the Prerequisites section.

Button Label

Specify the label shown on the button.

Button ID

Specify the ID of the button.

Suite Script Function Hook

If you are using a hook function, specify the function name to call when the button is initiated.

Client Function

If you are using client JavaScript, specify the function name to call when the button is initiated.

Linked Function

Select an existing eXtendMobile function to open when the button is initiated.

Integration Name

Specify the integration name to use when creating a queue record in NetSuite for processing the records.

Map-Reduce Script ID

Select the Map/Reduce script to execute when the button is initiated.

Map-Reduce Queue Parameter Script ID

Select the script parameter where the Map/Reduce script will receive the queue record ID.

Map-Reduce Deployment IDs

Select the deployment IDs of the Map/Reduce script.

Open In Modal

Enable to open the button's associated function in a modal window.

Function Modal Height

Specify the height of the modal.

Function Modal Width

Specify the width of the modal.

Printer Configuration

Configure a custom print button.

Frequently Asked Questions (FAQs)

Do all custom button configurations require advanced development?

No. Initiating a linked function is simple and doesn't require custom development. The other options (hook functions, client-side updates, and Map/Reduce scripts) are for advanced use cases and require additional configuration and custom development.

What is required for the Map/Reduce script configuration to work properly?

Your Map/Reduce script must have a script-level parameter of the Free-Form Text field type. This parameter ensures the script receives the queue record ID, which carries the context of the incoming request from the custom button.