Custom Tool Script Enhancements in NetSuite SuiteScript

TL;DR

NetSuite introduces significant enhancements to custom tool scripts, enabling better monitoring and management. This includes updates to execution logs and a centralized Custom Tools page for easier navigation of tools.

What's New in Custom Tool Scripts

NetSuite has rolled out enhancements to custom tool scripts that improve functionalities and effectiveness. These updates focus on logging and tool management, making it easier for developers to implement and monitor tool scripts.

Custom Tool Script and SDF Object Updates

The introduction of the Script Execution Logs page provides visibility into the execution of custom tool scripts. You can find the logs by navigating to Customization > Scripting > Script Execution Logs. Developers need to update their existing scripts and SDF objects to leverage this feature fully. Here are the required updates:

• Custom Tool Scripts

  • Include the JSDoc tag @NScriptType CustomTool.
  • Define entry point functions for tool methods as asynchronous.

• SDF Object XML Definition Files

  • Change the SDF object name from tool to toolset.
  • Update the scriptid prefix from customtool_ to custtoolset_.
  • Rename the attribute exposeto3rdpartyagents to exposetoaiconnector.

These modifications enhance script monitoring and debugging capabilities. For detailed guidance, refer to the article about updating custom tool scripts.

New Custom Tools Page

A significant new feature is the Custom Tools page, which provides a centralized interface for viewing and managing custom tool scripts within your NetSuite account. This page displays tools from SuiteApps and account customization projects (ACPs), organized by toolset. Here's what you need to know:

• Access the Custom Tools page via Customization > Scripting > Custom Tools.
• The page lists all available tools and their permissions, allowing for easy management.
• Individual tools can be deleted directly from the Custom Tools page for ACP toolsets (but not for SuiteApp toolsets).

These enhancements streamline the process of managing custom tools and enhance integration with external AI clients via the NetSuite AI Connector.

Who This Affects

• Developers: Those working with custom scripts will benefit from enhanced logging and management capabilities.
• Administrators: Can oversee and manage custom tools effectively.
• Integrators: Those connecting AI applications with NetSuite will find improved functionalities.

Key Takeaways

• Custom tool scripts have improved logging for better monitoring.
• A new Custom Tools page streamlines tool management.
• Developers must update existing scripts and SDF definitions for compatibility.

Source: This article is based on Oracle's official NetSuite documentation.