Configure SSP Applications for SuiteCommerce Customization

Configure SSP applications in NetSuite to customize your SuiteCommerce website's functionality and enhance user experience.

·3 min read·1 views·View Oracle Docs

The process of configuring SuiteScript Server Pages (SSP) applications is essential for enabling customized functionalities on your SuiteCommerce website. This guide outlines the steps required to properly configure your SSP applications after uploading the necessary files to NetSuite.

How to Configure Your SSP Applications

After successfully deploying your local files to the NetSuite file cabinet using the Gulp.js command, the next step is to configure your SSP applications. To enable your website to effectively use the uploaded customized SuiteCommerce application, follow these steps:

  1. Access Your SSP Application
    Navigate to Commerce > Hosting > SSP Applications and click Edit next to the SSP application you created for SuiteScript 1.0.

  2. Add Required Libraries
    Under the Libraries subtab in the Scripts section, click Add. You need to find and add the following JS files:

    • ssp_libraries.js
    • ssp_libraries_ext.js
      These files were transferred during the earlier deployment process and should be located in the root directory of your SSP application.

    Note: If you encounter difficulties locating the files due to a large number in your cabinet, keep in mind that the file list may not refresh and can result in a 'no matches found' error even if the files exist.

  3. Define Touch Points
    Next, navigate to the Touch Points tab to define the entry points for your web store. Here’s how to do it:

    • In the Name field, select your desired touch point that your website will use.
    • In the Entry Page field, select the appropriate .ssp file as the starting point.
    • Click Add to link the touch point to the .ssp file.
      For example, to link the home page to your shopping application, select the View Homepage touch point and set shopping.ssp as the entry page.
  4. Save Your Configuration
    After configuring the necessary touch points and libraries, click Save on the record to save your changes.

  5. Link the SSP Application to Your Domain
    Associate your SSP application with a specific domain:

    • Click View next to your SSPv1 application.
    • Select Link to Domain.
    • Choose the domain you want to link to this SSP application from the dropdown and click Save.
  6. Deploy the SSP Application (For SCA 2019.1 or Later)
    Depending on your setup (single domain for shopping and checkout versus separate), follow the appropriate steps:

    • Single Domain: Click View next to your SSPv2 application, select Deploy to Domain, choose the site domain, and click Save.
    • Multiple Domains: Navigate through the same steps, but add the respective sites for shopping and checkout domains using the conditions provided in the steps.

Note: You can deploy to separate domains for checkout and shopping, if needed, by selecting the corresponding sites from the dropdown lists.

Key Considerations

  • Ensure all touch points and entry pages are correctly defined to facilitate user navigation in your web store.
  • After configuration, testing is crucial to ensure all parts of the web store communicate effectively with the SSP applications.

This final setup positions your SuiteCommerce site to leverage the customized functionalities you have designed in your SSP applications.

Frequently Asked Questions (4)

Do I need to upload specific files before configuring SSP applications in SuiteCommerce?
Yes, before configuring SSP applications, all required files, including ssp_libraries.js and ssp_libraries_ext.js, need to be uploaded to the appropriate root directory in NetSuite.
How do I link an SSP application to a domain in SuiteCommerce?
To link an SSP application to a domain, you need to click 'View' next to the SSPv1 application, select 'Link to Domain', choose your desired domain from the dropdown, and click 'Save'.
Can I use a single domain for both shopping and checkout when deploying SSP applications?
Yes, if using SCA 2019.1 or later, you can deploy the SSP application using a single domain by choosing 'Deploy to Domain' after viewing the SSPv2 application.
Is there a specific method to define touch points for SSP applications?
To define touch points, select the desired touch point in the Name field, choose the corresponding .ssp file in the Entry Page field, and click 'Add'. This connects your SSP application to the appropriate entry points in your web store.
Source: Step 3: Configure SSP Applications Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in Commerce

View all Commerce articles →