Switching to SuiteScript 2 Versions of Integration Bundle Scripts
After you update the bundles, you can switch to the SuiteScript 2 versions of scripts in each bundle, or continue to use the updated SuiteScript 1.0 versions. All SuiteScript 1.0 versions that were deployed before the update are deployed by default after the update. When updating the NetSuite OpenAir SRP Real-time Add-on from version 2.0, 2.01, or 2.02, SuiteScript 1.0 or SuiteScript 2.0 versions that were deployed before the update are deployed by default after the update.
When updating NetSuite OpenAir SRP Single Sign-On (Bundle ID 369619) to version 7.0 or later, the switch to SuiteScript 2 versions of scripts in this bundle is done automatically.
To switch to SuiteScript 2 versions of integration bundle scripts:
-
In NetSuite, go to Customization > Scripting > Scripts.
-
For each deployed SuiteScript 1.0 version script in any of the NetSuite bundles for the OpenAir integration:
-
Locate the script in the list and click Edit.
-
On the Deployments subtab, make a note of the script and all deployment list entries with a
YES
under Deployed. If the script applies to different record types or events, and is deployed only for specific record types or events, you will need to refer to this list to deploy the SuiteScript 2 equivalent later. -
For each list entry, clear the Deployed box then click OK.
-
Click Save.
-
-
For each SuiteScript 2 version script in any of the NetSuite bundles for the OpenAir integration:
-
Locate the script in the list and click Edit.
-
On the Deployments subtab, for each deployment list entry equivalent to the SuiteScript 1.0 versions you undeployed earlier, check the Deployed box then click OK.
-
Verify that the script is deployed for all roles and, in the case of portlet, Suitelet, or user event scripts, executed as the
NSOA Connector
or the custom role you created for the integration. See Verifying Integration Script Deployment Settings. -
Verify that all SuiteScript 2 equivalent to the SuiteScript 1.0 versions you undeployed earlier are deployed to ensure that you retain the same integration functionality.
-
Click Save.
Important:Review the Switch to SuiteScript 2 Versions Additional Guidelines.
-
-
Skip this step when updating NetSuite OpenAir SRP Single Sign-On (Bundle ID 369619) to version 7.0 or later. Otherwise, after you switch to SuiteScript 2 versions of the NetSuite OpenAir SRP Single Sign-On (Bundle ID 369619), update the category links for the OpenAir (PSA) center tab. To do so:
-
Go to Customization > Centers and Tabs > Center Tabs.
-
Locate the row for the OpenAir (PSA) center tab and click the center tab name.
-
On the Content > Categories subtab, click Edit on the
Modules
row. -
For each line on the category link sublist, update the link to point to the SuiteScript 2.1 Suitelet script deployment.
-
Click the name of SuiteScript 1.0 Suitelet script deployment under Link –
OpenAir: <Module> module deployment
, where<Module>
is the name of the OpenAir module. -
Search and select the name of the SuiteScript 2.1 Suitelet script deployment –
OpenAir: <Module> module deployment v2.1
. -
Click OK.
-
-
Click Save.
-
On the Content > Categories subtab, click Edit on the
Help & Support
row. -
For each line on the category link sublist, update the link to point to the SuiteScript 2.1 Suitelet script deployment (Use the same steps as for the Modules center category).
-
Click Save.
-
-
Skip this step when updating NetSuite OpenAir SRP Single Sign-On (Bundle ID 369619) to version 7.0 or later. Otherwise, after you switch to SuiteScript 2 versions of the NetSuite OpenAir SRP Single Sign-On (Bundle ID 369619) or NetSuite OpenAir SRP Real-time Add-on (Bundle ID 369630) scripts, edit existing Portlet, Suitelet and User Event connection points in the SuiteSignOn record for OpenAir. To do so:
-
Go to Setup > Integration > SuiteSignOn.
Important:Until the OpenAir 2023.2 release, the OpenAir Within NetSuite and Real-Time Record Import features relied on the NetSuite Outbound Single Sign-On (SuiteSignOn) feature as outbound single sign-on method. NetSuite plans to end support for SuiteSignOn with the NetSuite 2025.1 for production accounts. Support for SuiteSignOn has already ended on non-production accounts, such as sandbox accounts. If you are using older version of these features relying on SuiteSignOn, upgrade your integration configuration before the NetSuite 2025.1 release to ensure service continuity.
See Upgrading OpenAir NetSuite Connector Features to Remove the Dependency on SuiteSignOn.
-
Click the name of the SuiteSignOn record for OpenAir.
-
Click Edit.
-
On the Connection Points subtab, for each Portlet, Suitelet and User Event connection points, do the following:
-
Click the SuiteScript 1.0 script name under Display Context.
-
Select the SuiteScript 2 equivalent from the dropdown list.
-
Click OK.
-
-
Click Save.
-
-
If you are using real-time record imports from NetSuite into OpenAir, verify that the user event script sending the record to OpenAir runs after all other user event scripts for that record type. See Verifying User Event Scripts Running Order.
-
Verify the integration configuration settings for SuiteScript 2 versions of the bundle scripts.
Important:When using SuiteScript 2 versions of NetSuite OpenAir SRP Integration (Bundle ID 369637), NetSuite OpenAir SRP Single Sign-On (Bundle ID 369619), or NetSuite OpenAir SRP Real-time Add-on (Bundle ID 369630) bundle scripts, integration configuration settings are sourced from the
OpenAir: SRP Integration Settings
custom record.When using SuiteScript 1 versions NetSuite OpenAir SRP Integration (Bundle ID 369637), NetSuite OpenAir SRP Single Sign-On (Bundle ID 369619), or NetSuite OpenAir SRP Real-time Add-on (Bundle ID 369630) bundle scripts, integration configuration settings are sourced from Setup > Company > General Preferences (Custom Preferences tab).
To do so:
-
Go to Customization > Lists, Records and Fields > Record Types.
-
Locate
OpenAir: SRP Integration Settings
and click list.The list for the
OpenAir: SRP Integration Settings
record type appears and should include one record only (OpenAir SRP Integration Settings Record
). -
Click View.
-
Verify the settings and edit the record to change any settings, if required.
-
Switch to SuiteScript 2 Versions Additional Guidelines
In most cases, upgraded versions of the script have the same name as their SuiteScript 1.0 equivalent followed by the version number (v2.1
or 2.1
for example).
Note the following exceptions:
-
There are no SuiteScript 1.0 equivalent for
OpenAir: Add Timestamp v2.1
. Only the SuiteScript 2.0 version was present in previous versions of the bundle. The script has been upgraded to SuiteScript 2.1 and are deployed by default. There are no actions required for this script. -
OpenAir: 'Export to OpenAir' Flags v2.1
is equivalent to the SuiteScript 1.0OpenAir: Set 'Export to OpenAir' Flags
-
OpenAir: Set 'Limit Time...' v2.1
is equivalent to the SuiteScript 1.0OpenAir: Set 'Limit Time and Expenses'
-
OpenAir: 'Limit Time...' Client v2.1
is equivalent to the SuiteScript 1.0OpenAir: Set 'Limit Time and Exp' Client
-
OpenAir: Rev. Rec. % Complete v2.1
is equivalent to the SuiteScript 1.0OpenAir: Rev Rec PCO
-
The SuiteScript 1.0
OpenAir: SFA Integration
has no SuiteScript 2 equivalent. Support for this feature ended with the April 2021 OpenAir release.
Most of your integration settings and preferences are copied to the OpenAir: SRP Integration Settings
custom record so they can be maintained after you update the bundles and switch to SuiteScript 2 versions.
Note the following exceptions:
-
NetSuite OpenAir SRP Integration
-
After you deploy the
OpenAir: PO/VB/VC Validate v2.1
script, you need to change preferences at the user level to let employees view projects and items and check the Billable and Export to OpenAir boxes for purchase order (or vendor bill and vendor credit) line items and purchase order (or vendor bill and vendor credit) records. To do so, go to Home > Set Preferences and check the Validate OpenAir PO/Vendor Bill 2 box on the Custom Preferences tab. -
After you deploy the
OpenAir: Create JE from Time v2.1
script, you need to change the parameters for this script deployment manually to match the settings for the previous SuiteScript 1.0 deployment. To do so, go to Customization > Scripting > Script Deployments, locate the deployment for theOpenAir: Create JE from Time v2.1
script and click Edit, go to the Parameters subtab and edit the parameters.
-