Inspiring

Answered

RoboHelp 2019 | Map Files & Mapping

Forum|Forum|6 years ago
April 8, 2019
5 replies
4130 views

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!

This topic has been closed for replies.

Correct answer Agnès2935133486cq

Merci, merci

Le problème venait effectivement de ce fichier qui a changé de nom (csh.js qui est devenu csh.new.js). Et surtout que son format est passé de XML à JSON.

L'appel d'aide a été modifié en conséquence et tout fonctionne bien maintenant.

Merci encore à tous pour votre aide

A

Amebr

Community Expert

I have an idea about why old IDs continue to work, while new ones do not.

In Classic RH, I believe the map ids were added to a file called csh.js in the output. In New UI the equivalent file is csh.new.js.

Because your developers have written a custom solution to create the URL, I wonder if their solution is looking for csh.js rather than the new file? It's hard to say without knowing what method your developers used to translate the standard RH help call (URL with map id, or api function) to your custom URL.

If you haven't deleted all the old files off the webserver, the old csh.js file will still be on the server (publishing does not delete any files), and thus the old RH2017 map ids will work. The new map ids will not work, as they exist in a different file that the custom help solution is not looking at.

If I'm right, your developers will need to change their help call to look for the new file instead of the old one.

A

Agnès2935133486cq

Inspiring

La piste me parait être la bonne.

J'ai demandé aux développeurs de vérifier. Je vous tiens au courant dès que j'ai leur retour.

Merci

A

Amebr

Community Expert

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.

A

Agnès2935133486cq

Inspiring

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

Community Expert

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.

Peter Grainge

Community Expert

@Agnès2935133486cq

I think you will need to work with your engineers looking at the previous replies. @surbhi_maheshwari9120543 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.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.

A

Agnès2935133486cq

Inspiring

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

surbhi_maheshwari9120543

Community Manager

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

isabelleg85447096Author

Inspiring

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

Community Expert

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

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.

Sign up

To post, reply, or follow discussions, please sign in with your Adobe ID.

Sign in to Adobe Community

To post, reply, or follow discussions, please sign in with your Adobe ID.

Scanning file for viruses.

This file cannot be downloaded