Parameters for Server Response in SuiteScript
Understand parameters for writing pages with ServerResponse in SuiteScript. Learn about required options and error handling.
The parameters for the ServerResponse.writePage method in SuiteScript are crucial for generating pages effectively. This method is utilized within server scripts to produce a page output, offering essential capabilities for NetSuite developers.
How Does the ServerResponse.writePage Method Work?
This method enables the generation of web pages based on a specified page object. It’s important to note that the framework allows for various types of page objects, which must be included in the request.
Method Description
- Generates a page.
- Returns:
void
Supported Script Types
- Server scripts.
For more details on the types of scripts available, refer to the SuiteScript 2.x Script Types.
Governance
- None
This method does not impose any governance limits on usage.
Module
- N/http Module
This method is a member of the N/http module, enabling HTTP functionalities within SuiteScript.
Parent Object
- http.ServerResponse
It operates under theServerResponseobject, enabling you to manage HTTP responses.
Parameters
The function requires certain parameters to perform successfully. Here’s a breakdown:
| Parameter | Type | Required | Description |
|---|---|---|---|
options.pageObject | serverWidget.Assistant | ||
serverWidget.Form | |||
serverWidget.List | required | A standalone page object in the form of an assistant, form, or list. |
Error Handling
Error handling is a critical aspect when using this method:
- Error Code:
SSS_MISSING_REQD_ARGUMENT - Message: Missing a required argument: {param name}
- Thrown If: The
options.pageObjectparameter is not specified.
Syntax Example
The following code sample illustrates how you can use the writePage method. Note that the syntax provided is for demonstration and is not a complete functional script.
1// Add additional code 2...3var myPageObj = serverWidget.createList({4 title: 'Simple List'5});6 7ServerResponse.writePage({8 pageObject: myPageObj9});10...11// Add additional codeThis code creates a simple list page object and writes it as a response. Ensure to follow the necessary syntax structure when developing your server scripts.
Related Topics
- http.ServerResponse
- N/http Module
- SuiteScript 2.x Modules
Key Takeaways
- The
ServerResponse.writePagemethod generates pages based on a requiredpageObjectparameter. - Proper error handling is essential to avoid missing required arguments.
- This method is essential for server scripts in the SuiteScript framework.
Frequently Asked Questions (4)
What types of page objects can be used with the ServerResponse.writePage method?
Is there any governance limit for using the ServerResponse.writePage method?
What error might occur if the required parameters for ServerResponse.writePage are not provided?
Which module do you need to include for using the ServerResponse.writePage method?
Was this article helpful?
More in SuiteScript
- Common SuiteScript Errors and Solutions for NetSuite
Common NetSuite script errors include INVALID_SCRIPT_DEPLOYMENT_ID and SSS_AUTHORIZATION_HEADER_NOT_ALLOWED. Learn effective solutions.
- SuiteScript 2.x Sublist Values: Standard and Dynamic Mode
Use setSublistValue in standard mode; select a line, set its current value and commit it in dynamic mode. Choose the API from the record's mode.
- SuiteScript Record.setValue: Body Fields, Types and Errors
Set NetSuite body fields with Record.setValue, matching field IDs and value types and checking common API errors.
- SuiteScript 2.1 Enhancements and API Updates in NetSuite
SuiteScript 2.1 enables execution of 2.0 scripts and supports PATCH method for enhanced API capabilities.
