Class URLAction

• TopLevel.Object
  • dw.web.URLAction

The class is needed for the URL creation within template processing. It represents a reference to a pipeline name and start node, usually used in a HREF or a FORM action. URLAction instances are usually passed to one of the methods in URLUtils in order to generate an appropriately constructed Commerce Cloud Digital URL. For example:

` var urlAction : URLAction = new URLAction(“SimplePipeline-Start”, “SampleSite”);

var url : URL = URLUtils.abs(false, urlAction1);

// url.toString() equals “http://” + request.httpHost + “/on/demandware.store/Sites-SampleSite-Site/default/SimplePipeline-Start”

`

Constructor Summary 

Constructor	Description
URLAction(String)	Constructs an action for the current site and locale.
URLAction(String, String)	Constructs an action for the specified site and the current locale.
URLAction(String, String, String)	Constructs an action for the specified site and locale.
URLAction(String, String, String, String)	Constructs an URL action for the specified site, locale and hostname.

Method Summary 

Methods inherited from class Object 

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

Constructor Details 

URLAction(String) 

URLAction(action: String)

Constructs an action for the current site and locale.

Parameters:

• action - the target pipeline/controller, e.g. 'Default-Start'

---

URLAction(String, String) 

URLAction(action: String, siteName: String)

Constructs an action for the specified site and the current locale.

Parameters:

• action - the target pipeline/controller, e.g. 'Default-Start'
• siteName - the target site, e.g. 'SampleSite'

---

URLAction(String, String, String) 

URLAction(action: String, siteName: String, locale: String)

Constructs an action for the specified site and locale.

Parameters:

• action - the target pipeline/controller, e.g.: 'Default-Start'
• siteName - the target site, e.g. 'SampleSite'
• locale - the target locale, e.g. 'default'

---

URLAction(String, String, String, String) 

URLAction(action: String, siteName: String, locale: String, hostName: String)

Constructs an URL action for the specified site, locale and hostname.

The hostname must be defined in the site alias settings. If no hostname is provided, the HTTP/HTTPS host defined in the site alias settings will be used. If no HTTP/HTTPS host is defined in the site alias settings, the hostname of the current request is used.

Parameters:

• action - the target pipeline/controller, e.g.: 'Default-Start'
• siteName - the target site, e.g. 'SampleSite'
• locale - the target locale, e.g. 'default'
• hostName - the host name, e.g. ‘www.shop.com'

Throws:

• Exception - if hostName is not defined in site alias settings

---