Entering Embedded Help Messages in the Message Catalog

To configure embedded help, first you must create Message Catalog messages that you specifically design for use by scroll areas, grids, and group boxes. To enter embedded help messages in the Message Catalog:

  1. Access the Message Catalog (PeopleTools, Utilities, Administration, Message Catalog).

  2. Select an existing or create a new message.

    Note:

    You should create new message sets to avoid extra upgrade maintenance tasks.

  3. Enter the help content in the Explanation field. Include the necessary variables if you want to generate other help links that appear on the embedded help pop-up page. The table at the end of this section describes the variables and their usage.

    Note:

    The help content should be contextual and specific to the page control to which it will be associated in the next section.

  4. Save the message entry.

Embedded Help Variables

This table describes the variables that you can add to the embedded help content in the Message Catalog. Use these variables to generate links on the embedded help pop-up page that enable the user to access additional online help.

Note:

You must install the Online PeopleBooks Library for any PeopleBooks Online Help link to function properly.

Variable URL Label 
%PBCTXT()

This variable uses the current page name as the %CONTEXT_ID% to build the PeopleBooks Help URL so the embedded link takes the user to the PeopleBooks content associated with the current page.

Because no message is referenced, the label of the help link appears as Help.

 
%PBCTXT(sn,mn)

The argument sn is the Message Set Number. The argument mn is the Message Number.

This variable uses the current page name as the %CONTEXT_ID% to build the PeopleBooks Help URL so that the embedded link takes the user to the PeopleBooks content associated with the current page.

Because a message is referenced, the label of the help link appears as the value that is stored in the Message Text field for the referenced message.

If you reference an invalid message, the label appears as Help.

 
%PBCTXT(CTXT_PG_NM)

The argument CTXT_PG_NM is a page definition name.

This variable uses the CTXT_PG_NM argument as the %CONTEXT_ID% to build the PeopleBooks Help URL so that the embedded link takes the user to the PeopleBooks content associated with the page referenced by the argument.

Because no message is referenced, the label of the help link appears as Help.

 
%PBCTXT(CTXT_PG_NM, sn,mn)

The argument CTXT_PG_NM is a page definition name.

The argument sn is the Message Set Number. The argument mn is the Message Number.

This variable uses the CTXT_PG_NM argument as the %CONTEXT_ID% to build the PeopleBooks Help URL so that the embedded link takes the user to the PeopleBooks content associated with the page referenced by the argument.

Because a message is referenced, the label of the help link appears as the value that is stored in the Message Text field for the referenced message.

If you reference an invalid message, the label appears as Help.

 
%PBURLTBL(<URL_IDENTIFIER>⇒
⇒
,sn,mn)

The argument <URL_IDENTIFIER> is any URL_ID that is stored in the URL Maintenance component.

See System and Server Administration: URL Maintenance.

The argument sn is the Message Set Number. The argument mn is the Message Number.

This variable uses the <URL_IDENTIFIER> argument to build help URL so that the embedded link takes the user to the site associated with the URL_ID.

Because a message is referenced, the label of the help link appears as the value that is stored in the Message Text field for the referenced message.

If you reference an invalid message, the system uses the <URL_IDENTIFIER> argument as the label. 

%PBLNK(http://www.site.com⇒
⇒
,sn,mn)

The argument sn is the Set Number. The argument mn is the Message Number.

This variable uses the hard-coded URL so that the embedded link takes the user to the specified site.

Because a message is referenced, the label of the help link appears as the value that is stored in the Message Text field for the referenced message.

If you reference an invalid message, the system uses the URL as the label.

Related Topics