The AddPersonalAreaToURLPath function is a built-in function that returns a string where the Personal Area is added (if applicable) to the URL path set in Text t input parameter. This function allows you to run any page (or resource) of your module in the Personal Area without having to manually change their paths.

Behavior

This function adds the Personal Area for the user name that is running the module to the URL path provided by the input parameter.

The URL returned by this function has the same syntax as the input parameter but with the Personal Area added after the module.

Input parameters

t: Text Type

Output parameters

Text Type

Although this function can be used in any type of flow, it only returns significant values in Web Flows.

Examples

Usage

Result

AddPersonalAreaToURLPath( "/Customers/ListCustomers.aspx" )

"/Customers/JohnSmith/ListCustomers.aspx"

In this situation, the eSpace is currently running in the Personal Area of the JonhSmith user so this Personal Area is added to the ULR path.

AddPersonalAreaToURLPath( "http://MyServer/Customers/ListCustomers.jsf" )

"http://MyServer/Customers/JohnSmith/ListCustomers.jsf"

Like the previous example except that a complete URL is provided to the function.

AddPersonalAreaToURLPath( "/Customers/ListCustomers.aspx" )

 

"/Customers/ListCustomers.aspx"

In this situation, the eSpace is currently running in the Public Area so no Personal Area is added.

AddPersonalAreaToURLPath( "ListCustomers.jsf" )

"ListCustomers.jsf"

In this situation, the function receives a relative URL path. Therefore, the value returned is the same as the input parameter.

AddPersonalAreaToURLPath( "/ListCustomers.aspx" )

"/ListCustomers.aspx"

In this situation, the function receives a URL path that is not compliant with Platform Server. Therefore the value returned is the same as the input parameter.

See Also

Available URL Functions | Available Built-in Functions