Creation of context sensitive help with pure FM 12 usage doesn't work

Hi,
I hope somebody is able to help me with a good hint or tip.
I am trying to create a context-sensitive Microsoft Help with FM12 only using the abilities of FM (no RoboHelp). For some reasons, my assigned ID's are not used in the generated chm file and therefore the help does not work context-sensitively.
What did I do?
- I created my FM files and assigned topic aliases to the headers. I did this two ways: a) using the "Special" menue and assigning a CSH marker and/or b) setting a new marker of type "Topic Alias" and typing the ID. I used only numeric IDs like "2000" or "4200",
- I created a .h file (projectname.h) - based on the format of the file projectname_!Generated!.h (I read this in some instructions). So the .h file (text file) looks like this:
#define 2000 2000 /* 4 Anwendungsoberfläche */
#define 2022 2022 /* 4.1.1 Menü Datei */
#define 2030 2030 /* 4.1.3 Menü Parametersatz */
#define 2180 2180 /* 6.6.7 Objektdialog Q-Regler */
#define 2354 2354 /* 6.9.2 Objektdialog Extran Parameter */
#define 2560 2560 /* 6.9.5 Objektdialog Extran2D Parametersatz */
- I published the Microsoft HTML Help. A projectname_!Generated!.h has been created. My IDs were not used in this file:
#define 2000    1
#define 2022    2
#define 2030    3
#define 2180    4
#define 2354    5
#define 2560    6
- When I open the .chm file and look in the source code, the ID even is totally different. It is not the one, I assigned in FM, it is not the one which I assigned in the projectname.h file and it even is not the one, which was put in the projectname_!Generated!.h file. It is a generated name starting with CSH_1 ...n in a consecutive way numbered.
Example:
<p class="FM_Heading1"><a name="XREF_72066_13_Glossar"></a>Gloss<a name="CSH_1"></a>ar</p>
What goes wrong? Why does FM not take my assigned IDs? I need to use these IDs since our programmers are using those already - I had to re-create the whole online help but the programs stay untouched.
Please help!
Many thanks
Mohi

Hi Jeff,
thanks for your note!
The text in my marker is just a number like "2000" or "4200". As said, I created manually a my.h file and used this marker there. E.g.
#define 2000 2000.
Whereby the first 2000 (in my opinion) is the marker text and the second 2000 is the context ID which the programmers are using for the context sensitive call of the help. My definitions in the my.h file were translated to #define 2000 1 (in the my_!Generated!.h file). The source code "translates" the context ID into CSH_8.
I am still confused :-/
Thanks
Mohi

Similar Messages

Error Opening 2nd Context-Sensitive Help Topic

Hi All,
We were having an issue that when opening a 2nd instance of the context-sensitive help (with the help already open), a blank window would appear and we would receive an "Access Denied" error related to the whcsh_home.htm file. I found the fix posted on Peter Grainge's site at http://www.grainge.org/pages/authoring/rh8/using_rh8.htm (thank you!), and this resolved the issue in IE7 and Firefox. However, our QA team is reporting that the issue still occurs in IE8.
Can someone please confirm that this fix works for IE8 as well as IE7 and Firefox? I'm able to load a 2nd instance of the help in IE8 on my computer without an issue after implementing this fix, so I think this is an issue specific to the tester's machine, but wanted to post here for any additional information.
Thanks in advance for any assistance.

I'm just now running into this IE 8 issue with my Robo HTML 6 WebHelp project. It worked (and continues to work) perfectly in IE
7, but not in IE 8. The fix didn't work for me. Any more info about (or fixes for) this one?
thanks
writer5010

Is there a way to open context-sensitive help in a new window with RH10?

I'm linking my context sensitive help using the RoboHelp_CSH.js file to my web application.
The correct topic opens when I click the help link, but it opens in a pop-up window. This causes problems in Firefox and Chrome (which block pop-ups by default).
Is there anyway to force the context-sensitive help topics to open in a new window?
I've tried adding
<p><A HREF="javascript:RH_ShowHelp(0,'http:/myurl/index.htm', HH_HELP_CONTEXT, 100)" target="_blank">Help</A>
which opens an empty tab in Firefox with no content in it. And it doesn't work in Chrome either.
Has anyone else run into this? Any help is greatly appreciated.
Thanks,
Colleen

Hi and welcome to the forums.
Using the RoboHelp API, that is quite a bother. (Read: major pain)
Fortunately, there is a simple solution:
<a href="http://myurl/index.htm#<id=4>>newwnd=false" target="blank">Help<a/>
This link does exactly the same, only opens the help in a new browser window.
You may also be interested in my custom WebHelp API: http://www.wvanweelden.eu/blog/2012/08/03/custom-webhelp-apis
Greet,
Willam

Cannot get simple merged HTML Help project going with context sensitive help

I have built a very simple project in RH9 from scratch, consisting of a main project and a sub-project now after I have modified our large project in changing every hyphens from file and directory names over a couple of days now only to see that context help still doesn't work.
The map IDs are not visible in the main project. To test it in the example, invoke the CSH-Test (context sensitive help test) from the Toolbox, enter !SSL!\Microsoft_HTML_Help\main.chm in the Offline field and a number 57 in the ID field. In our large project I'm getting nothing (no window pops up). In this example I'm getting this mystical error box, saying HH_HELP_CONTEXT called without a [MAP] section.
Christoph

Hi William,
thanks having a look at my problem. I read in another thread today a description which comes close to the problem I'm facing.
Maybe I formed the mini sample not exactly as our problem is situated. (thus the doubled map ids you were claiming).
I will try to explain again: we have a couple of CHMs in separate single help projects. These go into their own TOCs, Index Glossar etc. like in sub1->Einzel. For the merged project we produce a chm that goes into the directory of the master (main) project, like in sub1->Primäres Layout.
Each Topic in the sub project (e.g. sub1->Erstes Thema) has a symbolic link address (e.g. "Linkadresse=det_org_angaben), which is mapped to the MAP ID via the .h file.
This all used to work that way in RH5.
Now it seems that this information between the map ID and the symbolic Linkaddress gets lost with the merge process.
I am not using the same ID (57) twice in my example. The MAP ID in the main project comes from the sub1 project (see the yellow locked MAP ID).
The simplest test is using the CSH-Test in the Toolbox giving the main.chm as the Helpfile to test and enter the 57 as a MAP ID.
The idea behind is to use one CHM later to have to open in the application. The other CHMs of the subprojects only need to be present in the application directory. Then you invoke HtmlHelp(with the MAPID),like I posted in this thread.
The method you are suggesting in mapping the ID to the topic in the main project will not work since the topic is in the CHM of the sub project.
I modified the sample project once again (somehow the baggage files were not showing) to come closer to the constellation we are using in the large project, though I'm getting the "HH_HELP_CONTEXT called without a [MAP] section" error (which does not occur in our large project).
Christoph

Need help with a Context Sensitive Help project

Hey everyone,
I'm the RoboHelp administrator around here - I've done some
RoboHelp projects and created the procedures, stylesheets and
templates for our company's WebHelp, WinHelp 2000, and JavaHelp
projects, but now I'm sort of the consultant for the content
authoring team that creates the help systems. I think I need to
call in some help from the forum about a project I'm consulting on.
Here's the situation: A project team here thinks they want
field-level help to support a web-based application. I've told them
"That's fine, it's possible, just don't demand that the help author
create topics for EVERY field, even the obvious ones like "Name",
"Address", "Zip", etc, since there is very, very little value in
doing that." We already have a very old help system that is being
CONVERTED to WinHelp 2000 (from a "mocked-up" version of WinHelp)
that did just that - every field in every screen was a separate
topic, even if it wasn't useful. Every topic was essentially "This
information goes in this field". As a result, we abandoned creating
an Index, since we had about 27 entries for "Name", 13 for
"Address1", 15 for "Address2", etc.
Well, I just heard back yesterday that they totally ignored
my suggestion and they want to go ahead with the "all help for all
fields" idea. I still think I have a chance of convincing them to
choose context-sensitive topics wisely, if it can present my case
clearly and be persuasive. I just found John Daigle's article about
context sensitive help (
http://www.macromedia.com/devnet/robohelp/articles/context_help.html)
and I'm looking at it now (very well done, by the way - thanks
John!). It looks like, from first glance, that it might convince
that project team that "Whoa, this context-sensitive thing is more
than we bargained for", which is what I want them to think, since
they have very limited resources and a help author that is VERY new
to RoboHelp and WebHelp. I personally have never built a
context-sensitive help project with different windows, but I have
built several projects using conditional builds.
What does everyone think of this approach?
Thanks,
Jim

Here's a nice, convincing argument that I just thought of -
the only thing wrong with it is that I don't know if it's true or
not.
Does the end user's browser cache the .htm files for the help
topics that are grabbed from the server? If so, consolidating the
field definitions lessens the server traffic.
(Always get the server guys on your side - everywhere I've
worked, they wield a big stick!)
Also, I'm a big believer in functional help topics, but I
have compromised for some clients and included one-per-screen
conditional topics with the field labels. John, I wish I had known
about the map numbering trick back then - I would have loved to
give them F1 help.
Elisa

Muddled context sensitive help ids

Hi All
I've done some quite major updates to a help project,
including the creation of new context sensitive help Map Ids.
When I generate the help I get two files, cshdat_webhelp.htm
and cshdat_robohelp.htm. The cshdat_webhelp.htm contains the
correct map ids, however cshdat_robohelp.htm is still picking up
old IDs and some that look like random IDs, and this appears to be
the file that is called from the top level file
(projectname_rhc.htm) that the application calls. We can't get the
app to work with the projectname_csh.htm, so we need to use the
projectname_rhc.htm and cshdat_robohelp.htm files.
The only map file used in the project is the BSSCDefault.h
file, which only contains the correct IDs. I can't understand where
it is picking up the old/incorrect map IDs from. Can anyone please
help??
Thanks in advance,
Emma.

In case this is of use to anyone else, I found that there was
a .ppf file (whatever that is) in the directory, which was somehow
messing with the cshdat_robohelp.htm file. I deleted this, and hey
presto, problem solved.
Emma.

How can I reference an external help file from context sensitive help at the control level?

My goal is to provide context sensitive help for each control displayed on the front panel using a help file created externally. I know that at the VI level I can specify a Help Path; I want the same behaviour for each control inside a VI. I also know about creating a custom control and specifying the Help Path in there, but it doesn't help in this situation, for I have hundreds of controls in my application and I cannot go back and replace each one with a unique .ctl. If I could override each instance of the custom control with unique path data that would do the trick, but that's not how it works.
Is there a way to add the Help Path information to regualr controls?
-euge
ne

This functionality is not yet built into LabVIEW.
About all you can do is cut and paste the help for each control into the description for the control. It is tedius but a finite task.

Context-sensitive help breaking in RoboHelp 8

Peter - you're a lifesaver and I hope you're out there today . . . or somebody's out there who can help . . .
I shouldn't have said that in my last post about something being the "wackiest" thing I'd ever seen in RoboHelp. Now we have a new problem that's much more serious.
We have an aforementioned (in previous post) enormous RoboHelp 5 project, converted to RoboHelp 8 after much anguish, replacing hundreds of WYSIWYG graphics with true code etc. Map IDs were *not* touched.
Now the context-sensitive help for our VB app is not working, even though the map IDs are still in place on both ends (dev and docs) and all the relevant .hh files were included in my compile. Some topics (within the same help file) appear when called from the app, some don't.
A developer had a theory that in one case the topic ID was assigned (on their end) during design time, the other during run time. He's testing it now.
If it doesn't work, I have no idea where to begin. Is anyone aware of any changes in RoboHelp 8 that would affect the way the .hlp links to VB?
Thank you! - Sandy

Hi all,
I wanted to thank everyone who responded and post a follow-up to this, as well as a caution.
I felt like the world's biggest *** when I found this out, but it turns out that in my .doc files for this particular .hlp file (our project includes multiple .hlps) "Automatically Generate Map IDs" was turned on, and of course it should not have been. So the problem was on my end, not the software developers' end.
However - part of the reason it took me so long to figure this out is that I know I never turned that setting on. The other writer on this project has been here longer than I have and never would have turned it on. And it's not like that command is easy to stumble upon and set off accidentally (For those of you who don't know, it's under File>>Project Settings in RoboHelp Explorer). I have to think that RoboHelp defaulted those settings in somehow, maybe during our conversion from 5 to 8.
(Unless someone knows a way that you *can* just stumble on this setting and trigger it accidentally, maybe by inserting some random character in your .hpj . . . if anyone does, I would love to know about it.)
So, especially if you just changed versions of RoboHelp, I would encourage you to be proactive and, if you don't want "Automatically Generate Map IDs" turned on, double-check and make sure nothing is selected for Automatic Map ID Generation on the "Map Files" tab of the Project Settings dialog. After what happened to me this last time around, I'm probably going to check it every time I compile. - why not add another neurosis to the list?
Thanks again - Sandy

Context-Sensitive Help Issues

I have problem where context-sensitive help markers disappear
from my .h files.
I started with a .h file from my old WebWorks project. After
a little reformatting, I was able to get the CSH Map IDs to load
and map properly to my RH topics (I had to do the mapping manually
even though the topic names were the same) . I was also able to add
several new Map IDs to facilitate help in the latest version of our
product. The final help was tested and worked properly.
Now that it's time to update the help for another new release
of our product, I am noticing that many, many of the Map IDs that
were in my project before have now disappeared. Anybody have any
idea what is happening here?
I'm sick of struggling to get RH to play nice with these .h
files. Manually remapping the Map IDs to the topics each time we
release a new project is terribly dull work and time consuming.
Is there any way to add the Map ID numbers to the CSH markers
in FM so that RH can automatically map the IDs to the topics? I
want to use the Map IDs we already have established with our
development team; I don't want RH's automapping which starts at one
and advances incrementally through all of your topics).

I think you dint check the option "Project Map File" from drop down list in the dialog box for editing Map ids. For this, in the main menu point to "Edit" tab, select "Map Id's". Edit Map Ids dialog box appears. Choose the option for Map File as "Project Map File" from the drop down list.

Context-Sensitive Help in RoboHelp 9

Hi -- I recently upgraded from RoboHelp 5 to RoboHelp 9. My first WebHelp project that I created using RoboHelp 9 is giving me problems with Context-Sensitive Help. When a user clicks on a Help link that is supposed to bring him/her to a specific topic, the user is brought instead to the project's main screen with the TOC, Index, and Search.
Is there something specific that my Developers and I should be doing differently in RoboHelp 9 vs. RoboHelp 5? Is the problem being caused because I made the jump from 5 to 9 without upgrading in between?
Any help that anyone can offer will be greatly appreciated.
Thank you.

Maybe this link will help.
http://www.wvanweelden.eu/robohelp/context_sensitivity_in_webhelp
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Setting up context sensitive help for WebHelp in web application.

Hi,
I'm working on a help system for a web application. It will include context sensitive help triggered by an icon on the screen, and the Topic will open in an iframe with a set size. The developer has already set up the iframe that pops up when the icons are clicked. He is giving me the ID for the screens with the help icons as a fully qualified java file name. I'm not sure what the correct process would be in RoboHelp to map the ID's to the topics.
1. Do I create a map file using the list of ID's the developer sends me? Would it be in this format:
#define Topic_Name Java_File_Name
2. Do I then add the ID to the appropriate help Topic using Project Setup pod Context-Sensitive Help folder?
3. When I generate the layout I specify the map file I created above (.h extension)
3. If the developer already set up the iFrame size, is it correct that I don't need to create a custom window to set up the size? Is there a way to set it so two panes open? (I believe using the method above one pane opens with link to navigation pane)
Thanks in advance,
Joanne

Welcome to our community
See if the link below helps.
Click here to view
Cheers... Rick
Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7, 8 or 9 within the day!
Adobe Certified RoboHelp HTML Training
SorcerStone Blog
RoboHelp eBooks

.CHM Context Sensitive Help - Any Best Practice advice?

Hi,
Using RH9 and generating .CHM as the output.
I need to create context sensitive help that will work at screen level only. The project has around 600 help topics. I know i can autogenerate the MAP file using RH and pass this to development for them to plumb into the system which seems the quickest way. I know I could also manually map the 200 or so topics that refer to each screen in the application but that will take much longer (but will reduce the size of map file).
This is for a version of the help that has already changed i.e, I am now working on another version of the help so there are changes including new topics being added, some removed or renamed etc.
Is it ok to autogenerate on the first build, then import this map file into new updated project?. Any pitfalls I should be aware of before starting or not?
Generally what is others experience?
PDF Boy.

Hi, glad I could help.
There are certain javascript calls which will close the window automatically when focus is shifted somewhere else, but there are gotchas. You will notice Yahoo and some airline sites that have popup calendars face the same problem.
Not all browsers (or older versions) observe those newer calls dependably. So we are stuck with asking the user to close them. If I understand what you want, you could enable the Show button. This would show the Navigation pane and the rest of the topics so your user could proceed deeper. Still, they will have to close the window! Alternatively you could manually put link "arrows" in the top right of the topic and let them navigate to whatever topic you choose. But, that's time consuming and even this trick is not accessed by F1, so I'm reaching here .
What we really need is a browse sequence button that can be placed in the topic itself rather than those dinky arrows in the Navigation pane. I have requested this feature and maybe you could add your request here https://www.adobe.com/cfusion/mmform/index.cfm?name=wishform&product=38
Thanks!
John Daigle
www.showmethedemo.com

RoboHelp 10 Context Sensitive Help Displays Full Help File, Not the One Topic

I create WebHelp with RoboHelp V10 that contains context sensitive help to be displayed in a software application. When I click on any of the field names in the application, the entire Help file displays with TOC, Index, & Search, tabs but not the field level popup definition the Map ID is mapped to. I moved the RoboHelp V9 generated version files back to the server and the context sensitive help works correctly. Is there something different I need to deploy to the server to display the correct Map ID? I am using IE8 to test both conditions.
The Map ID's the software application calls to the Map IDs have not changed between the versions of RoboHelp.

Whilst the HHP is required to create CHMs, it can also be used to open damaged projects. Just be aware it will only be as good as the last time you generated some help and not just CHMs.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Map.xml and context-sensitive help question

We're changing the tools we use to generate JavaHelp from RoboHelp to WebWorks.
RoboHelp's output always includes a file named map.xml. WebWorks doesn't include this file.
My understanding is that map.xml is what applications use to find the correct context-sensitive topic. Is that right? Will the app be able to find context-sensitive files without it?
Stan Stansbury

There are a couple of posts about masterdata.xml that seem to indicate it's not a problem. See if either of these help.
Context Sensitive Help Question
MasterData.xml
For the 'main portal page' bit - maybe the developer wants to know the Start Page of the project, rather than the Default Topic? I'm not very familiar with CSH and webhelp, so I'm uncertain of the details the developer needs, but I wouldn't think you'd have to change anything as long as they have all the necessary details.
Amber

Problems converting context sensitive help to Robohelp 6

I’m new to Robohelp and have inherited about 60 WinHelp
projects which were created several years ago by a previous tech
writer, using Blue Sky Robohelp Classic 2000.
I am having a problem with converting these projects to
Robohelp 6. The same three compile errors are coming up in every
project I convert to Robohelp 6. Yet, when these same projects are
compiled in Robohelp Classic 2000 they are error free.
These are the basic steps I follow:
1. Open Robohelp 6.0 for Word.
2. Open the .hpj
3. Choose the “Generate Primary Layout” icon to
compile the project.
The Primary Layout for these projects is WinHelp3.
At completion, the compiler says the WinHelp 3 project has
been built successfully, although the error log contains three
errors.
When viewed, the help files appear as normal. However, the
projects are used for context-sensitive help which is activated by
the user pressing F1 or Shift + F1.
When I test the help files with our software, I receive the
following WinHelp error message: The topic does not exist. Contact
your vendor for an updated help file (129).
The following three compile errors come up in every project:
Error 1230: line...21 of MENU0000.hpj : File '!HPJ-OPT.TXT'
not found.
Error 1230: line...52 of MENU0000.hpj : File '!HPJ-CFG.TXT'
not found.
Error 2050: line...42 of MENU0000.hpj : Invalid #include
syntax.
In larger projects, the Invalid #include syntax error appears
many times, in smaller projects just once.
The two .TXT files that are not found during the compile are
present in the project folder for each project, but RoboHelp seems
to think they are not there.
As for the #include statement, I can only find one #include
statement in the project. It’s in the Project > Startup
Macros area and it calls HPJ-CFG.TXT. The syntax is correct. I have
tried deleting this startup macro and recompiling. This removes the
“HPJ-OPT.TXT' not found” error but still leaves the
other two errors. I cannot find the reference to HPJ-OPT.TXT
anywhere in the project , so I haven't been able to delete it and
see what effect this would have.
I am running Robohelp for Word, version 6.0 with Word 2002
(10.6826.6825) SP3 on Windows XP Pro operating system.

Hi Carenb and welcome to the RH community. Although you don't
specifically say it does sound like you are continuing to output
winhelp. Can I ask why? It would be wise to think about converting
to another format (e.g. HTML Help or WebHelp) in order to keep up
with recent Microsoft announcements. Anyway, RH Classic 2000 was a
very different product than RHX6. For a start it uses a completely
different set of project files (.HPJ are now .XPJ) which I think
explains the error message you are getting. If you want to continue
using winhelp I suspect you may have to rebuild your map files. If
you migrate to another help format you can concert your existing
project by creating a new project in RoboHelp HTML and importing
your .HLP file or word documents.

Creation of context sensitive help with pure FM 12 usage doesn't work

Similar Messages

Maybe you are looking for