End of Support for Data Center-Specific Email Domains

Data center-specific domains are targeted for deprecation in 2020.2 production accounts. Before the 2020.2 release, you must update your integrations, RESTlets, external Suitelets, and external forms in your production account that are still using data center-specific domains. Using account-specific domains removes dependencies on the data center where your account is hosted.

Solution

Traffic Health Reports

Traffic Health reports identify URLs that use data center-specific domains in your account. You must change the data center-specific domains in the URLs to your account-specific domains. To make the necessary changes to a data center-specific URL:

  • You may need the help of a developer in your company.
  • You may need to ask your company’s IT department to locate the owner of the integration, or the owner of the link to an external form.
  • You may need to contact a partner who set up an integration, or the third-party who supplied an integration.

For more information about account-specific domains.

Administrators and other users with the Set Up Company permission can access the Traffic Health tool at Setup > Company > Company Management > Traffic Health (Administrator). The first time this page is accessed in an account, click Generate Report to populate the report.

Generating a Traffic Health Report

Each area of NetSuite traffic is evaluated using a specific set of parameters. The Traffic Health report displays results for many NetSuite services. The rows listed in each section of the report can help you to locate the source of the problem. In many cases, you can resolve problems by using an account-specific domain, or by using a method for dynamically discovering the correct domain.

Resolve the items listed for each service, then generate a new report to ensure that there are no more items for you to resolve. Continue this process (fixing all items then generating a new report) until all sections of the report contain the message No records to show.

  • The combination of parameters with the highest number of occurrences appearing in the Count column may point out the severity of an issue. Items are listed in order of highest count first.
  • There is a limit of 50 rows listed for each service on a generated report. If a section of the report returns 50 rows, and you wish to view the complete list of results, contact NetSuite Customer Support.
  • A single integration can be represented by multiple rows on a section of the report, based on the combination of parameters evaluated. Each row represents a single use case. For example, a row can represent when an integration was run from a different computer, or when an integration connects to a different endpoint with different parameters.

To generate a Traffic Health report:

  1. Go to Setup > Company > Company Management > Traffic Health (Administrator).
  2. Click Generate to create a fresh report. By default, the report displays activity for the last seven days.
  3. Click each of the sections of the report to verify whether there is any incoming traffic using data center-specific domains.
    1. If you see the message No records to show, congratulations, all incoming traffic is using account-specific domains.
    2. If you see items listed in a section of the report, you must identify the non-compliant traffic, and determine the severity. The severity determines the order in which you will update the items in the list to use an account-specific domain or a dynamic discovery method when appropriate.
  4. For more information on how to correct items listed on your report, see the following topics:
  5. As you correct items listed in a Traffic Health report, you may want to generate a fresh report to verify that the items have been fixed.
    • By default, the initial report displays the last seven days of non-compliant traffic for your account.
    • When you generate subsequent reports, you can select a value for the desired time period: the Last hour, the Last 7 days, or the Last 24 hours.
    • The timestamps and fixed periods are based on the Pacific time zone.
    • Text on the page informs you of how long you must wait before generating another report, and when the current report was generated.

Inbound Email

If the Email Case Capture feature is enabled in your account or if you are using the Email Capture Plug-in, all inbound email traffic to your account that is using a data center-specific domain is listed in this section of the report.

Correcting Your Inbound Email Traffic

The data listed in each column indicates where to find the inbound email traffic that is using a data center-specific domain. You should update the source of the traffic to use your account-specific domain.

Traffic Health reports identify URLs that use data center-specific domains in your account. You must change the data center-specific domains in the URLs to your account-specific domains. To make the necessary changes to a data center-specific URL:

  • You may need the help of a developer in your company.
  • You may need to ask your company’s IT department to locate the owner of the integration.
  • You may need to contact a partner who set up an integration, or the third-party supplier of an integration.

For more information about account-specific domains.

The following procedure assumes that you have already generated a report. If this is not the case, or if you want to refresh the report data.

To correct your inbound email traffic:

  1. Click Inbound Email.
    1. If you see the message No records to show, all of the inbound email-related traffic in your account is using account-specific domains.
    2. If you see items listed in this section of the report, you must identify the non-compliant traffic, and determine the severity.Use the number in the Count column to determine the priority of the updates you should make. The higher the count, the higher the priority to make updates to use an account-specific domain.Column NameHow This Information Can Help You Identify the TrafficMail FromMail From is the email address to which bounce messages are delivered (see RFC 5321). The Mail From field is also called the Return Path address, the Envelope From address, or the Bounce address.The Mail From address is used to inform the sender’s system when an email cannot be delivered to a recipient’s mailbox.FromThe RFC 5322.From field specifies the authors of the message, that is, the mailboxes of the persons or systems responsible for writing the message.SubjectThe subject line of the inbound email. Per RFC 5322, the subject is a short string identifying the topic of the message.ToThe RFC 5322.To field contains the addresses of the recipients of the message.Envelope ToDisplays the actual SMTP recipient who received the email. If someone sends email directly to a case handler email address (similar to cases…@cases.netsuite.com) there is no difference between the TO field and the ENVELOPE TO field.However, if, for example, you created an alias to obscure the actual case handler address from your customers, and added a rule to your email infrastructure, the TO and ENVELOPE TO fields could be different.The ENVELOPE TO address can help you determine what rule to look for in your email infrastructure. Change the rule to use your account-specific domain.(See RFC 5321. The ENVELOPE TO address is the same address as identified by the RECIPIENT (RCPT) command in the RFC.)CountThe number of times during the reporting period that the traffic with the same parameters used a data center-specific domain.Count can help you to determine the severity of the problem. Prioritize correcting line items with a high value in the Count column. A higher number indicates a larger volume of traffic is using a data center-specific URL.
  2. Update each instance in the list so that the inbound email traffic uses account-specific domains
  3. After you have updated all of the instances listed in the original report, generate a fresh report to validate that there is no inbound email-related traffic in your account that is using data center-specific domains.
  4. Repeat this entire procedure as needed to continue correcting items listed on your Traffic Health report until no items remain in the list.

Viewing Your Inbound Email Account-Specific Domains

To view the account-specific domain used for general case capture:

  1. Go to Setup > Support > Preferences > Support Preferences.
  2. Click the Inbound Email subtab.
  3. Copy the NetSuite Address. This field is displaying the account-specific domain NetSuite Address that you should be using for general case capture.
  4. Use the account-specific domain NetSuite Address to replace data center-specific domains in use in your account or email infrastructure.

To view the account-specific domain attached to a case profile:

  1. Go to Setup > Support > Case Management > Case Profiles.
  2. Click View on the desired profile.
  3. Copy the NetSuite Inbound Email Address.
  4. Use the account-specific NetSuite Inbound Email Address domain to replace data center-specific domains in use in your account or email infrastructure.

1 comment

  1. I presume that this will impact every integration defined from a third-party system to NetSuite. Usually, we define a static URL endpoint in these third-party systems (Shopify, Salesforce – few tasks that I’ve done). These endpoints will start to shatter once NetSuite ends support for the data center specific URLs.

Leave a comment

Your email address will not be published. Required fields are marked *