SuiteApp Version: eXtendMobile 1.12 and above
Mobile App Version: eXtendMobile 1.12
Audience: eXtendMobile Admin

Use Case

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

Summary

eXtendMobile allows you to add custom buttons to perform various tasks based on your requirements. These custom buttons require additional configuration to work properly. In this article, we will learn about the configuration details for adding a custom button to a List function.

Prerequisites

Based on your requirements, there are three ways to configure a custom button, each needing additional details. They are listed below:

  1. 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.
    This is only available on the eXtendMobile Web portal.
  2. Performing custom actions using hook functions: For this configuration, first create a function in the eXtendMobile transformers file. This file is located at SuiteScripts → eXtendTech → suite_mobile_transformers.js.
  3. Initiating Map/Reduce script: For this configuration, you will need a Map/Reduce script in NetSuite that you want to initiate, the script deployment you want to run, and your Map/Reduce script should also have a script-level parameter of the Free-Form Text field type. This script parameter ensures your Map/Reduce script receives the queue record ID that has the context of the incoming request from the custom button.

Configuration

Configure a custom button by navigating to List function where you want to add it while in edit mode, and select the Custom Buttons option.

In the eXtendMobile App, it will be present on the main function details page:
Image Placeholder

In the eXtendMobile Web portal, it will be in the Advanced Settings section.
Image Placeholder

Specify details based on your requirement as discussed in Prerequisites section.
  1. Button Label: Specify the label of the button to be shown.
  2. Button ID: Specify the ID of the button.
  3. Suite Script Function Hook: If you are using a hook function, specify the function name to be called when initiating the button.
  4. Client Function: If you are using client JavaScript, specify the function name to be called when initiating the button.
  5. Integration Name: Specify the integration name to use when creating a queue record in NetSuite for processing the records.
  6. Map-Reduce Script ID: Select the Map/Reduce script you want to execute when initiating the button.
  7. Map-Reduce Queue Parameter Script ID: Select the script parameter where the queue record ID will be received by the Map/Reduce script.
  8. Map-Reduce Deployment IDs: Select the deployment IDs of the Map/Reduce script.