Here's a question that we received in our Dev Team group email, and thought it was a good discussion thread to share:
QUESTION
I have just tested your MSI on NS 7 SP2 and it works! It looks like there is an issue with Task help in NS 7 GA. Try and upgrade your NS and you should observe the same. Let me know if you have any questions.
COMMENT
Thanks for your help. We will let you know on this when we move to SP2.
COMMENT
We moved to NS SP2, later to which I updated the help mapping according to our discussions earlier. But it looks like the context sensitive help is still not getting hooked up the way we want.
Here is an example of a mapping I tried with,
<helpMapping pageId="{2fb04367-xxxx-xxxx-xxxx-86a652d6f00d}" url="SolutionX/index.htm?topic=TaskXtask&Context=s..." context=""/>
COMMENT
This is looking like it is an issue with the documentation mapping or the url used in the config file. When we replace the url with an NS platform help url, the page properly loads the NS url. When the SolutionX url is provided, the default SolutionX homepage is loaded. We will need your help to resolve this.
COMMENT
<helpMapping pageId="{2fb04367-xxxx-xxxx-xxxx-86a652d6f00d}" url="SolutionX/index.htm?topic=TaskXtask&Context=s..." context=""/>
This looks valid. Can someone go to that UI page and View Source on the page. Search for “helpURL” and send me the entire line of code. It should look something like this:
window.helpControl.helpUrl = "/Altiris/Documentation/en/index.htm?topic=RuleLibrary&context=Mon?ProductId={fdbe62d3-5ccd-4d2b-b814-b702695a4452}&PageId=RuleLibrary_aspx&Context=";
Also, what happens if you try the following URL from the local host computer:
"http://localhost/Altiris/Documentation/en/SolutionX/index.htm?topic=TaskXtask&Context=s..."
COMMENT
When entering the url in the browser, the default homepage loads. I am pretty sure the url we tried was just how you have typed it -
"http://localhost/Altiris/Documentation/en/SolutionX/index.htm?topic=TaskXtask&Context=s..."
COMMENT
Hmmm. Just like you said, I think everything is working properly on the development side of the world. Please confirm that the token and Help Context correct. Now, when you say default page, do you mean the SolutionX default page or the SMP default page?
COMMENT
It is the SolutionX default page.
COMMENT
OK, this tells me, I think, that the help context is set correct; otherwise it would never make it that far, so it is the token value that is maybe the problem. Please also check to make sure you do not have the token value used twice in your deliverable, along with checking the spelling.
COMMENT
The other thing I noticed was that SolutionX help documentation installed differently in the file system and the url is different from other products.
For example, other products install to –> Documentation\Web\<culture>\<product name>\help
SolutionX installs to ----------------------------> Documentation\Web\<culture>\<product name>
I tried manually creating the help folder moving the SolutionX files into it. After doing this, I would get 404 errors when browsing directly to the page. Invoking the F1 help causes the SMP default page to load.
In the database, other products have url -> index.html?topic=<page id>&context=<context>
SolutionX has url as ------------------------------> SolutionX /index.html?topic=<page id>&Context=<context>
Finally, I see that the page id in the url is different from the page id given in the config file.
<helpMapping pageId="{2fb04367-xxxx-xxxx-xxxx-86a652d6f00d}" url="SolutionX/index.htm?topic=TaskXtask&Context=s..." context=""/>
COMMENT
I am really stumped on this one. I did look at the URLs and it should be OK that SolutionX does not have a help folder, at least in part. They should be able to launch their own documentation, but they will not be able to work in the multi-volume environment. Also, because they are using a model that is not using multi-volume, they need to navigate all the way into the SolutionX folder to launch the index.htm file that is in that folder and not the one at the root of the en folder.
Just some clarification here. Is all the help for SolutionX broken or only some of them? I though we were able to get some of them to work and the example you gave me was just the one or one of the few that were not working. Is this true? If none of the help is working, then
Also, can someone look in the folder where the help files (HTML) are installed and give me an example of the name of one of the files? Please also check that there is an index.htm file in this folder.
SOLUTION COMMENT
It looks like the URL is the problem. It is case sensitive. I have installed the MSI provided by Rahul. SolutionX has a task page URL as :
SolutionX /index.htm?topic=TaskXtask&Context=s... with ‘context’ query string token having a capital ‘C’.
When I change this to lower case ‘c’, the help loads as expected.
SolutionX /index.htm?topic=TaskXtask&context=s...
I tested this by updating the database with this query :
update contexthelp set url = 'SolutionX /index.htm?topic=TaskXtask&context=s...' where pageid = '{2fb04367-xxxx-xxxx-xxxx-86a652d6f00d}'
I then ran iisreset as I saw the task page was caching the old help URL. Reloaded the task portal, launched create new task dialog, clicked ‘recover drive’, hit f1 and the topic “Configuring a remote Recover Drive task” page opened.
COMMENT
I have changed the url for all the tasks.