SuiteApp Version: eXtendMobile 1.12 and above
Mobile App Version: eXtendMobile 1.12.769 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. They are listed below:

  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.
    This is only available on the eXtendMobile Web portal.
  3. Initiating Linked Function: For this configuration, you will need an existing function in eXtendMobile which will be linked to and opened upon using the custom button.
  4. 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.
  5. Printing record: Add printing of list view results using a custom button. Users can select a printer and number of copies from a modal window.

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
Image Placeholder
In the eXtendMobile Web portal, it will be in Advanced Settings.
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. Linked Function: Select an existing eXtendMobile function to be opened when initiating the button.
  6. Integration Name: Specify the integration name to use when creating a queue record in NetSuite for processing the records.
  7. Map-Reduce Script ID: Select the Map/Reduce script you want to execute when initiating the button.
  8. Map-Reduce Queue Parameter Script ID: Select the script parameter where the queue record ID will be received by the Map/Reduce script.
  9. Map-Reduce Deployment IDs: Select the deployment IDs of the Map/Reduce script.
  10. Open In Modal: Enable to open the button's associated function in a modal window.
  11. Function Modal Height: Specify the height of the modal.
  12. Function Modal Width: Specify the width of the modal.
  13. Printer Configuration: Configure a custom print button.

Frequently Asked Questions (FAQs)

Q: Do all custom button configurations require advanced development?
A: Initiating a linked function is straightforward and doesn't require custom development. However, other options like hook functions, client-side updates, and Map/Reduce scripts are for advanced use cases and require additional configuration and custom development.

Q: What is required for the Map/Reduce script configuration to work properly?
A: Your Map/Reduce script must have a script-level parameter of the Free-Form Text field type. This parameter ensures your script receives the queue record ID that contains the context of the incoming request from the custom button.