RH7: Map ID and Frame Topic-Splitting

Question

Greetings. Hope someone could help with the following:
I've created a very simple Frame file with two 'Heading2'
paragraphs and a handful of other paragraphs types to describe
contents.
For illustration purposes, let's say the Map file I have
received form my developer has exactly two entries:
HIDD_APP_PREF_FIRST_DIALOG 0x200E8
HIDD_APP_PREF_SECOND_DIALOG 0x200E9
At the beginning of each paragraph I have inserted a custom
marker with the name 'HelpMarker'.
(Question 1) What is the exact text that should go in each
marker text box?
When I add my Frame file by reference, I specify 'HelpMarker'
in the 'Define Context-Sensitive Help Marker' text box.
In the 'Style Settings' dialog...
-- I specify 'H2' as the 'User-Defined HTML Tag'
-- I check 'Heading 2' for pagination settings and click
'Finish'.
Once the Frame file has been processed I have only one topic.
I would expect to have two.
(Question 2) What should be done differently to have one
topic per 'Heading 2' paragraph type in my original Frame document/
When done

Answer 1

First the answer to your following question
(b) Must I manually match the hypertext marker with a topic
using the 'Edit Map IDs Dialog'?
Yes, you are correct in the understanding that "this is the
traditional way of accomplishing the required task". So, this is
one possible way but this can be done in a better way using
FrameMaker integration feature.
It provides a different automated flow for creating Context
Sesitive Help map IDs which is discussed below.
So coming to your another question
(a) Does the marker 'automatically' map the topic if the
string it contains forms a match with an entry in the .hm file
provided by the developer?
The answer to this question is "No. Although it works
automatically but not in this manner."
There is a little difference in the flow that RoboHelp
provides and the approach that your developer and help author are
expecting.
According to my understanding here is your developer and help
author's approach. Please correct me if my understanding is not
right.
1. Developer uses Map IDs in his application.
2. He puts all the Map IDs along with their values in a .hm
file.
3. That .hm file is provided to the help author.
4. Help author is suppossed to make use of those Map IDs
present in the .hm file in the Context Sensitive Help he develops.
5. Help author inserts those Map IDs in the marker text in
FrameMaker document(s) and expects RoboHelp to make use of the same
.hm file as provided by the developer for mapping.
Here is the flow in RoboHelp.
1. Help Author inserts his own Map IDs as marker text in the
FrameMaker document. (e.g. HIDD_APP_PREF_FIRST_DIALOG)
2. Help Author mentions the name of the marker in RoboHelp
during Add/Import of FrameMaker document.
3. RoboHelp reads the marker, marker text and the document
content and generates Context Sensitive Help Map IDs. It also
generates a .h (equivalent to .hm) file.
4. This .h file is provided by the help author to the
developer to be used in his application.
As we can see in one approach .h file is generated first and
in the second flow .h file is generated at the end.
As of now, one possible way is to use the RoboHelp's approach
and ask the developer to use RoboHelp generated map ID file.
Another possible way is
1. Create a copy of the .hm file provided by the developer
and convert it to the following format
#define HIDD_APP_PREF_FIRST_DIALOG 0x200E8
#define HIDD_APP_PREF_SECOND_DIALOG 0x200E9
2. Close the RoboHelp project.
3. Rename the above copy of file with the RoboHelp's CSH
mapping file(BSSCDefault.h by default). And replace Robohelp's
mapping file with this copy.
4. Open the project and you will find the map ids as provided
by the developer.
And answer to your following query
Could you please explain each class of entry that I see here
and how they are to be used in this context?
Robohelp's Edit Map IDs functionality is a RoboHelp's generic
functionaliity and is not specific to FrameMaker integration
feature.
A help author using FrameMaker integration feature need not
open this dialog ever if he uses the RoboHelp's approach as
described above.
However, for other users this feature provides the
funcionality of creating Context Sensitive Help for any topic or
bookmark present in the project.
Since, topics and bookmarks generated during a FrameMaker
document Add/Import are no different from the generic topics and
bookmarks in RoboHelp, they are also listed and can be mapped from
the dialog.
Mayank
RoboHelp Team