FAQ - pegasystems/uplus-wss GitHub Wiki
Uplus is not working with Chrome - images are very large
this is because Uplus is using rem for all the different settings and it uses a minimum font-size of 1px. At one point, Chrome is defaulting to a minimum font-size of 6px - to change it go to Settings - click on 'customize font' and make sure that the 'minimum font size' is set to the minimum (tiny)
How to get personalized offers when unauthenticated
Pega Marketing relies on cookies to track unauthenticated users navigating inside the Application. In order to get different offers when browsing the site, the Pega Marketing application and the Uplus application must be on the same hostname. As such you need to deploy the Uplus application inside the same application server as the Pega Marketing system. You can follow these instructions for more details
Browser location inside a Mashup is not working
Modern browsers have a feature policy that requires inner iframe to be allowed to query the user location - see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Feature-Policy. IN Pega 8.4, the iframe generated by Pega Web Mashup should set the attribute 'allow= geolocate:*" on the iframe tag. If you use an older version of the Pega Platform, deploy the Uplus application on the same host as the Pega platform.
To use geolocation and the address component in your application - follow these steps:
- Make sure to set the correct Google map key in the DSS
- set 'Enable geolocation tracking' for each case type
- Make sure to accept the location tracking popup generated by your browser when the Pega Web Mashup loads
if the location is enabled by the browser, you should see a pin icon in the address bar
How to use a different skin when displaying a Mashup
To use the Mashup with the uplus application, it is expected that your application is built on the 'Theme-Clarity:01-01' application rule. The Uplus application will use the correct Cosmos Engage theme palette depending of the industry selected - see [https://github.com/pegasystems/uplus-wss/blob/master/src/components/MashupMainArea.vue]. For example, Comms will use the skin called 'ClaritySkin_HoneyFlower'.
If you re-theme the Uplus application, start from one of the existing 7 themes (ClaritySkin_XXX) and change the primaryColor mixins and other mixins to align with your next branding.
If you want to use a complete different skin, you can tell Uplus to use a different skin by passing the skin name as parameters - you can either set the skin on the quicklinks extra parameters settings (the change will only apply to this quicklink) or on the user extra parameters settings (preferred option). In this case set the value of pzSkinName in field - the extra parameters are passed as a set of key values for example key1=value1,key2=value2
In the Mashup, I want to navigate back to the Home page
Create a button with the runscript action and call the API 'pegaMashupNavigateBack' on click. This JS function will communicate with the top level document using postMessage to let the Uplus application to navigate to the main page (could be the acccount page or home page). This function in included in the OTB Work-!Perform harness provided by the Clarity Theme - see the section pyB2CActionAreaInc
If this is still not working correctly, make sure that you have correctly set the host url of the Uplus app in the application rule under the security tab (Mashup)
If this is correctly setup and not working, right click inside the Mashup and click 'Inspect' to open the browser dev tools
Go to console and confirm that you are running inside the Mashup iframe
Finally run the following commands in the console
If the function is not defined (first command), then it is likely that the fragment 'pyB2CActionAreaInc' is not included - Check that you have not customized the Perform harness and included sections shipped in Theme-Clarity at work- in your case type class.
If the value of the strDomainWhitelist is empty, then you have not configured correctly the application rule (Mashup config)
If the last command works and move you back to the account page, then you need to double check the button configuration on the Mashup
I am getting the error 'Unregistered mashup'
You are likely running the Pega Platform with BAC (Broken Access Control) turned ON - follow these steps to resolve the issue: https://github.com/pegasystems/uplus-wss/wiki/Configuring-the-mashup-for-systems-that-have-BAC-turned-ON
Can I use a different user for the quicklinks or other mashup rendered in the account page?
While the intend is that all the Mashup should use the same user as the one used to login to the Uplus application, it is possible to override the user passed during the mashup by using extra parameters.
First enter the user name and password in the user settings and make sure that the Mashup is correctly working for this user. Using developer tools, look at how the Mashup div is being initialized. You will see that the username and password are passed as parameters.
For example if the user password is ‘install@123’ for example, the encoded password is aW5zdGFsbEAxMjM=
In the quicklink settings, remove the character = at the end of the password and set the extra parameters like this
UserIdentifier=wssuser2,Password=aW5zdGFsbEAxMjM
The height of the iframe is not correctly set and I am seeing a scrollbar
Make sure that you have correctly set the host url of the Uplus app in the application rule under the security tab (Mashup). If you use the console of your browser and check of the value of the global variable 'strDomainsWhiteList' inside the iframe (not in the top document), it should list all the urls as a comma separated list
If this is correctly set - inspect how the iframe is generated - there should be an 'onresize' attribute on the body class of the harness - the function doHarnessResize() is called every-time an Ajax request is made and the screen is updated - you should also see some inline style set on the iframe with a fixed pixel height.
If your harness does not have the onresize="doHarnessResize()" attribute, make sure that the harness is set as a 'workarea' harness under the Advanced tab - you can also do a saveAs of the Data-Portal!pyToDoList harness provided in the Theme-Clarity layer - this todo list can be used to show the worklist using the Clarity Theme.
