Document Properties
Kbid
297U63
Last Modified
25-Aug-2021
Added to KB
19-Jan-2021
Public Access
Everyone
Status
Online
Doc Type
References
Product
  • ICM 7.10
  • ICM 11
ISML Function - pwaUrl()

Name

pwaUrl()

Short Description

generates a URL that is part of a link to the PWA application

Table of Contents

Product Version

7.10

Product To Version


Status

Info

This function is available from ICM 7.10.21.

Introduction

The function pwaURL() is used in a template to dynamically generate a URL that is part of a link to the PWA application. The PWA base URL is configured in the property ExternalApplicationBaseURL.

Syntax

pwaURL(<urlPath>)
pwaURL(<urlPath>, [<pwaQueryParameter>]...)

Example

The following example shows how to generate the link to /products?SKU=foo&category=bar for the PWA in the Backoffice:

<a src="#pwaURL('/products', pwaQueryParameter('SKU', 'foo'), pwaQueryParameter('category', 'bar'))#">To Product</a>

When the template is processed, the generated link replaces the ISML expression like (e.g. with "http://localhost:4200" set as base path):

<a src="http://localhost:4200/products?SKU=foo&category=bar">To Product</a>

Info

To return to the correct locale in the PWA storefront (e.g. the locale of the REST call that was used to trigger an email creation) the pwaURL  function always adds the current locale as matrix parameter to the generated URL.

For this reason the actually generated URL to a German PWA looks like this:

<a src="http://localhost:4200/products;lang=de_DE?SKU=foo&category=bar">To Product</a>

Parameters

urlPath

The path reference to a specific page in the PWA.

pwaQueryParameter

This optional parameter can be used multiple times. Each pwaQueryParameter will hold a key and a value to generate HTTP Query Parameters.

Reference - ISML Functions

Disclaimer
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
Home
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.