Server Request Files in SuiteScript for Read-Only Access

Server request files in SuiteScript enable developers to access HTTP request data within server scripts. This feature, introduced in NetSuite 2015.2, provides a read-only view of the server's request files, allowing for efficient handling of incoming data.

What Are Server Request Files?

Server request files are objects within the N/http Module that allow access to the HTTP request information sent to an HTTP server, such as a Suitelet or RESTlet.

Property Description

• Property: Server request files
• Type: Object (read-only)
• Parent Object: http.ServerRequest

The structure also implies that these properties are part of the server's request object and are not alterable, making them suitable for secure data handling.

Error Handling

When attempting to modify these properties, developers will encounter an error:

• Error Code: READ_ONLY_PROPERTY
• Thrown If: You attempted to edit this property. This property is read-only.

Syntax for Using Server Request Files

The following code samples illustrate the syntax for accessing server request files. Keep in mind these snippets are for demonstration purposes and do not constitute functional scripts.

Sample Code 1: Accessing Request Files

1// Add additional code 
2...
3log.debug({
4    title: 'Server Request Files',
5    details: request.files
6});
7...
8// Add additional code

Sample Code 2: Accessing a Specific File

var file = request.files['file_id'];

For thorough example usage, developers should refer to the N/http Module Script Samples.

Who This Affects

This information is essential for:

• Administrators: Managing server scripts effectively.
• Developers: Integrating server request handling in SuiteScripts.

Key Takeaways

• The server request files provide read-only access to HTTP request data in SuiteScripts.
• Attempting to modify the read-only property will result in an error.
• Effective logging and debugging can be implemented using server request files.
• Always refer to N/http module samples for more comprehensive examples.