Guidelines for Creating a Dataset Builder Plug-in Implementation Script File

The following guidelines apply when creating a Dataset Builder Plug-in implementation script file:

If you create an invalid dataset using a Dataset Builder Plug-in, the dataset may produce an unexpected error in the SuiteAnalytics Workbook UI. This error may occur if there are syntax or logic errors in the code used to create the dataset in the plug-in. The invalid dataset will not appear in the list of available datasets, and you will not be able to use the dataset in any workbooks.

To work around this issue, you should test your dataset creation code in the SuiteScript Debugger before using it in your plug-in implementation script file. To test for syntax errors, copy your dataset creation code into the debugger and run it. The debugger will identify any syntax errors before executing the dataset creation code. To test for logic errors, run the created dataset in the debugger using Dataset.run(). If parts of the code are incorrect (such as invalid field names or incorrect joins), the debugger will identify them at runtime. If you do not receive errors in the debugger, your dataset creation code is safe to use in your plug-in implementation script file and will not produce an unexpected error in the SuiteAnalytics Workbook UI. For more information about the SuiteScript Debugger, see SuiteScript Debugger.

The following general guidelines apply when creating a plug-in implementation script file:

The plug-in script file can have any name, provided it has a .js extension and contains an implementation of each interface function.
You can include utility files with helper functions when you create the plug-in implementation.
Due to limitations with how strings are handled in NetSuite, you cannot use the JavaScript case statement in the plug-in implementation script file.
The plug-in allows up to 1000 usage units. For more information, see SuiteScript Governance and Limits.
If the character limit is exceeded in a field, the value will be truncated.