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

  1. Select an activity from the NetSuite folder of the Activities tab.
  2. 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.

  3. 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.
  4. 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.

  5. Click Test Connection to verify that a connection can be established.



Feedback | Notices


Timestamp icon Last updated: Monday, 11 February 2019


https://www.ibm.com/support/knowledgecenter/en/SS3LC4_7.5.3/com.ibm.wci.doc/netsuite_Creating_a_NetSuite_Endpoint.html