Linking Between PeopleSoft Components in HTML
By Chris Malek | Tue, Nov 13, 2012
I have been creating a lot of self-service pages where the user base are not PeopleSoft experts, nor will they ever be. With these types of users you can’t assume the users:
- Will have an understanding of all the fields, codes, and abbreviations.
- Will have received any training.
- Will know or care anything about the correct business process.
- Will have any sort of “cheat-sheet” or guidebook for the business process in their possession.
In order to guide these types of users through the business process, I like to put nice HTML formatted instructions on my pages. The best way to get HTML on a PeopleTools page is to put an “HTML Area” control on the page and bind it to a record field which is typically a derived record. You then set the field value with PeopleCode from some source like the message catalog or a setup table. I typically hand off the actual content creation to a Business Analyst and forgot about it. For some screen-shots on how to accomplish this you can read the Making Pretty Page Text with HTML Areas KB article.
So let’s say that you have a splash page at the beginning of some business process. This splash page has some policy text that the user must read and acknowledge. Here is an example that I mocked up.
In this example, the text is contained in an HTML area that is stored in
a message catalog. This text can change often based on the business
requirements. When we first created the page, the users only wanted one
link. So we had one bind variable in the message catalog. We then
generated the link with for the message catalog bind using the
GenerateComponentRelativeURL PeopleCode function. This is all fine
until the business wants to put in links to different menus and
components later after go-live. Yes, you could change the code and
migrate it to your production database. However, there is probably more
important things you could be doing with your development skills. So how
do we link between PeopleSoft components using just HTML so the Business
Analysts can maintain the links and text without incurring the cost of a
It is actually very easy if you can deal with all the caveats that I will list below. You do not want to use this in every scenario but it will be useful in certain situations.
If you were to navigate to the self service address update
ROLE_EMPLOYEE.HR_HOME_MAILING, your browser should
display a URL similar to this. (I have put in some line breaks for
https://localhost/psp/hrdem/EMPLOYEE/HRMS/c/ ROLE_EMPLOYEE.HR_HOME_MAILING.GBL ?NAVSTACK=Clear &FolderPath=PORTAL_ROOT_OBJECT.CO_EMPLOYEE_SELF_SERVICE .HC_PERSONAL_INFO_ESS.HC_HR_HOME_MAILING_GBL &IsFolder=false &IgnoreParamTempl=FolderPath%2cIsFolder
Generally, you can ignore the “?” and everything after that. Those are just instructions for how to render the breadcrumbs. If we remove th