HowTo:Create Application-Specific Help

Work In Progress: This page is under development.

About Application-Specific Help

The information here in the support wiki is intended primarily for application builders, admins, and installers. But end-users need information that is specific to the application they are using--and that is where application-specific help comes in.

In this article, we assume that you know how to add a button to a form, and that you know how to create an interface tab that displays a single HTML page of information. (The important point is to make sure that your help pages have no headers, so that links work.) With those basics in hand, you can go on to create context-sensitive help pages for your application.

Learn more:

• Form Scripts#Add a Help Button to an Arbitrary Form
• Application Help Tab

Working with Application-Specific Help

Here, we assume that you want to display different pages, depending on the user's current location--so you'll be wiring help buttons that appear on different forms so they display different pages in the help tab. (You may even use JavaScript to go to different help pages, under different conditions.)

Tip: JavaScript functions are most easily tested by adding them to the OnLoad script in a Form. But hey are most easily reused by uploading them in a static resource file. Learn more: Static Resources#Accessing a JavaScript Resource from an Object Form

Going to the Help Tab

To go to the Help and display the default page, use this code to get the tab ID and "click" on it:

<syntaxhighlight lang="javascript" enclose="div">

function findByAttributeValue(attribute, value) {

 var All = document.getElementsByTagName('*');
 for (var i = 0; i < All.length; i++)       {
   if (All[i].getAttribute(attribute) == value) { return All[i]; }
 }

}

function goToHelpTab() {

  var helpTabLinks = findByAttributeValue("display_title","HELP"); // there should be only one
  helpTabLinks[1].click();

} </syntaxhighlight>

Loading a Specific Page Into the Help Tab

When the Help button is clicked, code is invoked to find the Help tab, and effectively, reach an arm out from behind the screen, grab the mouse, and click on that tab!

To do do that, add these functions to the form's OnLoad script:

<syntaxhighlight lang="javascript" enclose="div">

function findByAttributeValue(attribute, value) {

 var All = document.getElementsByTagName('*');
 for (var i = 0; i < All.length; i++)       {
   if (All[i].getAttribute(attribute) == value) { return All[i]; }
 }

}

function go(loc) {

  var helpTabLinks = findByAttributeValue("display_title","HELP");
  helpTabs[1].src = loc;   

  // The iFrame that displays the content is created after the link is clicked.
  // The value we need to find it is stored in the link's "id" attribute.
  // Look for the iFrame until it is created. (Give up after 1,000 tries.)
  var iFrameID = "" + helpTabLinks[1].id;

alert("Looking for: "+iFrameID);

  var iFrame = document.getElementByID(iFrameID);
  iFrame.src = loc;

} </syntaxhighlight>

Then add the following code to the Help button:

<syntaxhighlight lang="javascript" enclose="div">

onclick="go(\+targetURL+'\')" // For example: networking/pages/MoreInfo.jsp </syntaxhighlight> where the target URL has the form, "networking/pages/PAGE_NAME.jsp", for a page hosted in the platform.