Creating or editing a NetSuite endpoint
Endpoints provide the NetSuite connection information that Studio and the Integration Appliance use to connect with NetSuite.
Before you begin
The connector supports "User Credentials" and "Token Based" authentication mechanisms. By default when the endpoint panel is created in Studio, user credentials authentication is selected. The integration developer can choose that option and provide the credentials or select token based authentication.
Procedure
- Select an activity from the NetSuite folder of the Activities tab.
- Drag the activity onto the orchestration.
The Summary panel is displayed along with a Checklist that lists the tasks that must be performed to configure the activity.
- Click the Endpoint task from the Checklist and
choose one of the following options:
- Browse - To select an existing endpoint from the project.
- New - To create a new endpoint.
- Edit - To edit an existing endpoint.Note: Edits are global, not local. Editing an endpoint affects all orchestrations that use that endpoint in the Project.
- When the NetSuite endpoint screen is displayed, complete,
or edit, the information in the following fields:
- NetSuite Customer Login - Users are limited to two sessions for
each username/password. One session is through the browser and the
other session is through Web Services. Attempting a second login through
the browser with the same username and password results in the first
session terminating. The same scenario applies to attempts to establish
two concurrent Web Services sessions. For multiple concurrent Web
Services connections, obtain a Web Services Plus license.
Fields for user credentials authentication Field Description Email Address E-mail address used to login to NetSuite Password Password for E-mail address Account Number Account number associated with E-mail address Application Id The application id of the integration created in the NetSuite UI. Application Id is mandatory only if you are using WSDL version 2015.2 and above Fields for token-based authentication Field Description Consumer key The value of the consumer key when a new integration is created in NetSuite UI Consumer Secret The value of the consumer secret when a new integration is created in NetSuite UI Token ID The value of the token id when a new access token is created Token Secret The value of the token secret when a new access token is created Signature Hash Algorithm The algorithm used to hash the value of the signature. The supported values are HMAC_SHA1 and HMAC_SHA256 Important note When using token-based authentication, the timestamp of the machine on which you are testing (studio or appliance or live) must be correct; otherwise, the authentication will fail. - Login Options - Choose either Login normally or Login in to the
specified URL and specified version.
If you purchased the Web Services Concurrent License, click Web Services Plus License.
- Getting data center URL - The web service URL is based on the data center in which the customer account is running.
To get the URL specific to the customers data center, click on the Update button in the endpoint panel. The login URL will get updated. The value will not change if it is same as the default value.
- Connection Pool Options - Leave the default values or change the
values for the Connection Pool Options:
Field Description Minimum Connections The default is 1. Maximum Connections The default is 1. If Web Services Plus License (Concurrent Web Services User preference) is selected, the default is 5. Maximum Idle Time The maximum number of minutes, the session can remain idle before ending the session. The default is 120 minutes. NetSuite enforces a 120 minute maximum. Maximum Wait Maximum Wait The maximum number of seconds to wait for the session to start. The default is 300 seconds. - Connection Timeout - Use the up and down arrows to select the number of seconds, that you want to wait to establish a connection to the endpoint before ending the attempt.
- Proxy - To use a proxy server to connect with NetSuite, select Connect
via a Proxy Server.
For Authentication, click the arrow and choose the mode, either Basic or NTLM.
For Realm, if you choose Basic authentication, you can specify a realm. If you do not specify a realm, the endpoint authenticates to 'any realm'.
Complete the following fields:
Field Description Host Name The name of the proxy server or the IP address of the proxy server. Port The port number used by the proxy server to connect with NetSuite. User Name The ID used to login to the proxy server. Password The password for User Name. - Update - Use the Update WSDL to_2011_1 button to upgrade the NetSuite WSDL. The button is inactive if WSDL_2011_1 is already present. After clicking the button, you will be presented with a list of project entities that will be affected by this update. At that point, you can decline to update to WSDL_2011_1 or proceed with the update.
- Changing Authentication Mechanism in existing projects
If you want to use projects developed in older versions of Studio, open these projects in the latest version of Studio, and then click the button Update WSDL to _2018_1 to update the WSDL. Restart Studio and provide an Application ID, as Application ID is mandatory if we are using WSDL version 2015.2 and above for user authentication mechanism. All projects containing NetSuite connector activity's developed in earlier versions of App Connect will by default use User credentials as authentication. The developer can edit the project in Studio and change this option to use token based authentication.
- NetSuite Customer Login - Users are limited to two sessions for
each username/password. One session is through the browser and the
other session is through Web Services. Attempting a second login through
the browser with the same username and password results in the first
session terminating. The same scenario applies to attempts to establish
two concurrent Web Services sessions. For multiple concurrent Web
Services connections, obtain a Web Services Plus license.
- Click Test Connection to verify that a connection can be established.