RoboHelp 2019 | Map Files & Mapping

[isabelleg85447096]

Hello,

I have created a few WebHelp systems with RH 2019 and since the feature has been available I've been including the map Files in the Output, however, in all cases when the published version of the WebHelp is opened the first page shown is the default page and not the corresponding page.

ie: When WebHelp was created with RH 2017 we could map the pages to our site so that if the user was on the "all about green" page of our system and pressed help they would be taken to the "all about green" topic. Right now no matter which page a user is when they press the Help button they get the default page.

I would like to have this functionality in our Webhelps output from RH2019. I don't want the default page to open, I need the matching page to open.

I know that in the first few versions of RH2019 Map Files were not at all included but it is now. Does it seem likely that the mapping isn't working yet, either buggy or not fully available, or are my developers making an error when they implement the output package? My Developers have had a lot of difficulty implementing my RH2019 files.

Thank you!

[surbhi_maheshwari]

Hi,

In RH 2019, CSH Map IDs are maintained properly. You can use Map file editor to map files. Also map files created in Classic version are upgraded to new RH 2019 map files.

Using you help button, how are you calling a specific page? Are you using query parameters or CSH API directly?

If possible, can you please share the project with us where this is not working?

Thanks and Regards,
Surbhi Maheshwari

[isabelleg85447096]

Hello,

I can't answer that. That's what I'm trying to ask.

I create the content, put it in RoboHelp 2019, output it including the map file which is listing all the topics with numbers beside them.

My developers take the output and do magic to it. Then I get a link to our UAT site and test what happens when I press the help button.

When I press the help button WebHelp opens but always to the default page. With our RH2015 WebHelps the WebHelp would open to the topic that matched the page you were on when you pressed help.

What could be going wrong? Where can I start triaging the issue with my team?

Thank you!

[Peter Grainge]

Surbhi will be offline right now.

I suggest you show your developers this thread as they will be able to provide the detailed sort of information that Surbhi needs to be able to advise you.

If you hover over Surbhi's name above, you will be able to send her a message to arrange how to send her your project. I'm guessing she wants to check things are right as far as the output is concerned.

Then if you can get some information from your developers to post here or in another message, hopefully she will be able to advise you.

---

See www.grainge.org for free RoboHelp and Authoring information.

@petergrainge

[isabelleg85447096]

My developers too! Good idea! Thank you!

[surbhi_maheshwari]

Hi,

You can directly send details to me at sumahesh@adobe.com

Once we can see how the help button is implemented, we shall be able to resolve this issue.

Thanks and Regards,
Surbhi Maheshwari

[raym74268509]

Hello -

I'm running into the same problem described in this thread. When I upgrade a project into 2019, it brings over the map file and everything looks good. Next -- when I publish as responsive HTML and then access Help from a page in the application, the correct Map ID displays in the address bar, but the default Welcome page loads rather than the page associated with the Map ID.  Were you able to resolve this issue? Did it have to do with how the Help button is implemented?

Thanks!

[Amebr]

Were you generating responsive html5 output before upgrading? If you were generating some other output, your developers might need to change the code for calling the page, depending on how they were calling it. If you can let us know what you were generating pre-upgrade and the method your developers are using, that would help.

[surbhi_maheshwari]

Hi,

I suspect that you are using the RH_ShowHelp function.

Can you please try with RH_ShowResponsiveHelpWithMapNo function rather than RH_ShowHelp?

1. e.g. <p>Click for <a HREF='javascript:RH_ShowResponsiveHelpWithMapNo("help2/index.htm", "", 2)'>Help</a> (map number 2)</p>

Details of this function are in RoboHelp_CSH.js file. I am pasting it here:

// The Helper function for Responsive Context Sensitive Help using Map Number

//--------------------------------------------------------------------------------------------------

// Syntax:

// function RH_ShowResponsiveHelpWithMapNo(szHelpURL, szWnd, dwMapNo)

//

// Parameters:

// szHelpURL

// Path to help system start page ('http://www.myurl.com/help/index.htm' or 'help/index.htm')

//

// szWnd

// Name of custom window in which the help is to be shown.

// Allowed values:

// Window Name String      to specify a window : e.g. "ResponsiveWindow"

// Blank String to specify no window : e.g. ''

//

// dwMapNo

// Map number associated with the topic to open.

// Allowed values:

// Map number for a specific topic : e.g. 10

// Zero value for opening the default topic

This shall resolve the issue you are facing. Do let me know if you get stuck anywhere.

Thanks and Regards,
Surbhi Maheshwari

[juliec18791782]

Hello, Thank you both for your responses. We were not generating HTML5 prior to the upgrade. We were publishing WebHelp Pro using a RH Server 10.

Based on your replies, we have informed the developers of the new script to call help using...RH_ShowResponsiveHelpWithMapNo. 

I hope we can complete a test today, and will update this forum with our results. 

Kind Regards,

Julie

[Agnès2935133486cq]

Bonjour,

Je viens de migrer mon projet RoboHelp de la version 2017 à la version 2022.

J'ai exactement le même problème.

- Tous les nouveaux ID de mappage créés avec la version 2022 ne me ramènent pas sur la bonne page d'aide, mais restent sur la page d'aide principale.

- Les anciens ID créés avec la version 2017 de RoboHelp continuent de fonctionner correctement.

Mon fichier de mappage (.ali) est bien alimenté correctement avec les nouveaux ID.

L'appel de l'aide au niveau de mon applicatif n'a pas changé : les développeurs indiquent le lien vers notre site web et ensuite le numéro d'ID de la fenêtre sur laquelle on est positionné est ajouté.

L'URL de l'aide appelée est correcte, avec le bon ID :

Sauf que c'est la fenêtre d'aide par défaut qui est affichée.

Si je remplace l'ID dans l'URL pour indiquer un ID créé avec la version 2017, il me ramène bien la bonne page d'aide. C'est seulement les nouveaux ID créés avec la version 2022 qui ne fonctionnent pas.

Je n'ai pas trouvé de bonnes réponses à ma problématique sur le forum.

A priori plusieurs utilisateurs ont le même problème que moi, mais pas de solutions qui correspondent.

Merci à celui ou ceux qui pourraient m'aider

[Peter Grainge]

@Agnès2935133486cq 

I think you will need to work with your engineers looking at the previous replies. @surbhi_maheshwari is a senior member of the engineering team so you can rely on the information she has already provided being correct.

In addition, there is a page on my site about calling context sensitive help. RH2022 Calling Context Sensitive Help (grainge.org)

Beyond that I suggest for this one you need to go to Adobe Support. See https://helpx.adobe.com/contact/enterprise-support.other.html#robohelp for your Adobe Support options. The email link tcssup@adobe.com is recommended as it reaches a team dedicated to Technical Communication Suite products including RoboHelp.

Please do not email Surbhi direct as Engineering are not part of Support, unless of course she sees this thread and asks you to.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Amebr]

There are two ways of getting new IDs.

1. You generate new IDs in Robohelp..

You give the list of new IDs to your developers so they can assign them to the correct screen in the application. 

2. The developers create IDs for each new screen in the application.

They give you the list to add to RH and you assign the new IDs to the correct topics in RH.

Given the old ids work and the new ones don't, I suspect you are not exchanging IDs the same way as you did in RH2017.

[Agnès2935133486cq]

Bonjour,

Merci de votre retour.

J'utilise la méthode 2. Ce sont les développeurs qui me donnent la liste des nouveaux identifiants, que je cree dans RoboHelp et les affecte aux sujets d'aide corrects.

Comme l'interface dans RoboHelp a changé entre 2017 et 2022, forcément je ne fais pas exactement pareil.

- En 2017, sur chaque nouvelle rubrique créée je faisais :

[Clic droit], Propriétés, Onglet Avancé, bouton [Modifier les ID de mappage]

Ensuite je choisis mon fichier de mappage dans la liste et je clique sur le bouton [Créer un ID de mappage], je renseigne l'ID de mappage (j'indique le nom exact de ma fenêtre dans mon applicatif) et en numéro de mappage, l'ID que m'a donné le développeur.

Et ensuite, je choisis le bouton [Assigner].

- En 2022, je ne peux pas accéder à l'ID de mappage à partir des propriétés de la rubrique. Elle est visible, mais non modifiable.

Je passe donc par le menu Sortie, Fichiers de mappage. Je choisis mon fichier de mappage et ensuite [clic droit] et Modifier.

Je renseigne l'ID de mappage (j'indique le nom exact de ma fenêtre dans mon applicatif) et en numéro de mappage, l'ID que m'a donné le développeur. Je clique ensuite sur le bouton [+] à droite du champ pour sélectionner ma rubrique.

Et ce nouvel ID se renseigne bien à la suite des autres dans la liste.

A part l'ergonomie dans l'applicatif, je ne vois pas ce qu'il y a de différent entre les 2 versions.

[Jeff_Coatsworth]

Your map file should be a .h file, not a .ali - did you notice from Peter's site that the calls to MapIDs have changed? You haven't mentioned which way your developers are calling the help. 

[Agnès2935133486cq]

Je ne comprends pas car dans mon projet robohelp 2022, sur mon fichier de mappage, si je fais [clic droit] et "afficher dans l'explorateur", il me donne bien des fichiers .ali.

Dans lesquels je retrouve toutes mes ID de mappage (les anciennes comme les nouvelles créées en 2022).

Les développeurs indiquent dans le code, la constitution d'une adresse URL envoyée dans le navigateur par défaut du poste. Ci-dessous le code Windev correspondant :

wi_http est une chaine de caractères

wi_Fen est une chaine de caractères prenant la valeur de l'ID (indiquée dans la fenêtre de mon application à partir de laquelle j'ai appuyé sur le bouton d'aide).

Sur mon poste client, en étant positionné sur une fenêtre de mon application, l'appel de l'aide me renvoie bien la bonne url complétée du bon numéro d'ID de ma fenêtre.

Sauf que l'aide correspondante n'est pas trouvée, et donc je suis positionnée sur l'écran d'aide par défaut.

[Jeff_Coatsworth]

What output are you creating? I don't think you've mentioned what type it is...

[Agnès2935133486cq]

Effectivement, c'est un oubli.

J'utilise une sortie Responsive HTML 5

[Amebr]

Is the correct map file selected in the Output Preset?

[Agnès2935133486cq]

Désolée, je n'avais pas vu le message.

J'ai plusieurs fichiers de mappage (un par module), et oui ils sont tous bien sélectionnés.

Celui sur lequel j'ai des soucis est CRM (le seul pour l'instant dans lequel j'ai ajouté de nouvelles ID).

[Jeff_Coatsworth]

And do the contents of the CRM file look the same as the contents of your older existing ones (like PMI for example)?

[Agnès2935133486cq]

Avec la version 2017, le fichier est un fichier .h avec cette structure :

Avec la nouvelle interface (version 2022 pour moi), le fichier est un fichier .ali avec cette structure :

Tous mes ID fonctionnent sauf le dernier 5047 que j'ai créée sur la version 2022.

Tous mes fichiers .ali ont la même structure.

J'ai créé d'autres ID (avec la version 2022) dans d'autres fichiers de mappage qui eux non plus ne fonctionnent pas. Ce n'est pas seulement le CRM qui pose problème.

[Jeff_Coatsworth]

Alright - got me stumped. You've verified that if you build the call to the topic manually using the URL and mapid provided, that it launches the right topic?

[Agnès2935133486cq]

Si à partir de l'URL, je saisi mon ID (créé en 2022), il ne me lance pas la bonne rubrique, il m'amène sur ma page d'aide par défaut ... comme s'il ne la trouvait pas.

Si à partir de l'URL, je saisi un ancien ID (créé en 2017) cela fonctionne, il m'amène bien la bonne rubrique.

[Peter Grainge]

See if this helps.

RH2022 Calling Context Sensitive Help (grainge.org)

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.