Legacy platform

Deploying customization

To deploy your customizations, run the gulp scripts, build your changes, and test your customization.

Running the gulp scripts

Depending on your environment, complete any one of the following steps:
  • If you are working with an exploded wscdev.war file, run the following commands:
    1. cd <STORE_BUILD_FOLDER>
    2. gulp --gulpfile ngstore_local_extn_gulp.js
  • If you are working with a local runtime or a central runtime, run the following commands:
    1. cd <STORE_BUILD_FOLDER>
    2. gulp --gulpfile ngstore_build_extn_gulp.js

Building your changes

Perform the following steps, if you want to test your customizations in the exploded wscdev.war file.
  1. Create a soft link for the extension files.
  2. Update the gulp configuration file (ngstore.local.extn.config.json ) to use the <WSCDEVWAR_FOLDER> and <EXTN_FOLDER>.
  3. Run the gulp script ( ngstore_local_extn_gulp.js ) to generate minified files, CSS files.
  4. Test the application for your customizations.
Perform the following steps, if you want to test your customizations in your local or central runtime:
  1. Place all you extension code inside <INSTALL_DIR>/extensions/wsc/webpages/ngstore folder.
  2. Update the gulp configuration file ( ngstore.build.extn.config.json ) to use <INSTALL_DIR>/extensions/wsc/webpages/ngstore directory.
  3. Run the gulp script ( ngstore_build_extn_gulp.js ) to generate minified files and CSS files.
  4. Build and deploy the application WAR or EAR.
  5. Test the application for your customizations.

Testing your customization

  • If you have modified client-side files such as JS, HTML, CSS and so on, ensure that the changes are available in the exploded war, clear cache, and reload the browser.
  • If you have modified server-side files such as mashup XMLs, java code, or any other server-related files, you need to ensure that the changes are available in the exploded war and restart the application server.

Copying customizations to production

After the successful completion of a gulp task, both scripts and style folders are created in the following “dest” path:

  • scripts - contains the js and html minified code with customizations
  • style - contains the css minified code with customizations
Complete the following steps:
  1. Copy and paste the generated files to runtime/extensions/wsc/webpages/ngstore folder so that the runtime/extensions/wsc/webpages/ngstore folder structure is present.
    
    -- shared
    -- store
    -- scripts (created by gulp)
    -- styles (created by gulp)
  2. Run the build ear and restart your server.