Enhancements to SuiteScript User...

TL;DR

Recent updates to SuiteScript provide clarifications regarding the user and role context under which various scripts are executed. This impacts how developers and administrators manage script submissions, particularly with map/reduce and scheduled scripts.

What’s New in SuiteScript?

Enhancements have been made to the SuiteScript documentation, specifically detailing which user and role a script operates under during its execution. The updates affect several areas, including:

Scheduling a Map/Reduce Script Submission
Submitting an On-Demand Map/Reduce Script Deployment from the UI
Submitting an On-Demand Map/Reduce Script Deployment from a Script
Scheduling a One Time or Recurring Scheduled Script Submission
Submitting an On-Demand Scheduled Script Instance from the UI
Submitting an On-Demand Scheduled Script Instance from Another Script

These enhancements help clarify the role of the System user with administrator permissions under which scripts run, allowing for more accurate scheduling and execution of scripts.

Key Points on Scheduling Scripts

When scheduling map/reduce scripts for deployment, it is essential to understand:

You can configure a one-time or recurring schedule for script executions.
Script execution may not occur exactly at the scheduled times; delays can happen based on other queued scripts.
Ensure the Deployed box is checked for deployments to be processed.

Note: Times on the Schedule subtab reflect the session time zone of the logged-in user, which may differ from company settings.

Example: Submitting a Map/Reduce Script

To submit a map/reduce script for processing:

Upload the corresponding JavaScript file and create the script record.
Access the script record in view mode and click on Deploy Script.
Ensure the Deployed box is checked.
Set the Status to Not Scheduled.

This provides a streamlined process for handling script submissions and ensures clarity in management roles.

Who This Affects

Developers: Better understanding of context leads to optimized script management.
Administrators: Improved clarity helps manage script deployments effectively.

Key Takeaways

Recent updates clarify user roles in SuiteScript execution.
Script timings are subject to scheduling nuances and potential delays.
Essential to verify deployment status for effective script processing.

Frequently Asked Questions (4)

Does the clarification of user roles in SuiteScript affect both map/reduce and scheduled scripts?

Yes, the updates impact both map/reduce and scheduled scripts, clarifying the role of the System user with administrator permissions under which scripts are executed.

How should I schedule a one-time execution for a map/reduce script in SuiteScript?

To schedule a one-time map/reduce script execution, ensure the Deployed box is checked, and set the schedule. Keep in mind execution may not occur exactly at scheduled times due to other queued scripts.

What should I do if my script does not execute at the scheduled time?

Delays in script execution can occur if other scripts are queued. Ensure the script is properly deployed and check for scheduling conflicts in the SuiteScript queue.

Does the session time zone of the logged-in user affect script scheduling?

Yes, times on the Schedule subtab reflect the session time zone of the logged-in user, which may differ from your company's settings, affecting script scheduling.

Enhancements to SuiteScript User Role Context Clarification