RTC Help File

derrick

Hi Experts,

I'm following the "Walkthrough: Creating and Building a New Help Topic" in the "Help Toolkit" to make sample RTC Help File.

By the way, after the Help.Builder.EXE -t=c:\HelpExample\object.txt -out=c:\HelpExample\Object.xml was executed to convert the object.txt to Object.xml, the generated Object.xml is empty. (If I remembered correctly, I saw something last time I tried once with the same thing).

I subsequently continued to generate the addin_a.chm and addin_a.hh, and placed them in the accordingly folders.
However, the F1 user action called up but doesn't link to its topic.

I'm suspecting the failed linkage is it because of the empty Object.xml? :?: :-k How can this be resolved?
Thank you for any inputs.


object.txt

T50000-P2818-L30:Direct Purchase Header
T50000-F1-P2818-L30:Linked Sales Order
N50000-P2818-L30:Direct Purchase Order
N50000-C1160030000-P2818-L30:Test

Object.xml

<?xml version="1.0" encoding="UTF-8"?>
-<objects xsi:schemaLocation="http://tempuri.org/object.xsd object.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://tempuri.org/object.xsd"> 
   <tables/> 
   <forms/> 
   <reports/> 
   <pages/> 
   <dataports/> 
   </objects>

derrick

Hi Experts,

Well, does anybody had already done the conversion of Classic HelpFile to RTC HelpFile?
In general, I would like to know:

1. if Object.xml file is empty for a particular Object, does that mean the later generated RTC HelpFile, by pressing F1 will never point to its particular topic? Means fail.
2. I had tried both way, which is through Command Line (Help.Builder.EXE -t=c:\HelpExample\object.txt -out=c:\HelpExample\Object.xml) and "Create Object File" menu in Help Builder, both made empty Object.xml, any suggestions on what to look into?

I appreciate any advice. Thank you.

* Environment: Nav 6.0/2009 SP1 and R2

alekp

Hello derrick,
Please refer to the topic "Troubleshooting: Some Objects are Missing from Object.xml File" in NAV Help Guide, that is installed with Help Toolkit.
Your object.xml file is empty because you have not defined CaptionML property for your objects. So you have to define this property and export object.txt again. Also you should use correct language switch when converting to object.xml file (matching your language selected for CaptionML property).

Object.xml file is used to update object tokens in help (tokens like ($ T_50000 abc table $). If this file is empty, it should not break F1 functionality.

In order to troubleshoot why F1 is not working, you can have a look into "How to: Analyze Help Call Errors" topic in help guide. Most likely there is an issue with generated addin_a.hh file.
You can check whether:
- you deployed file correctly (.hh file should be deployed on NAV server to make F1 working in RTC)
- your .hh file is not empty and contains correct entries for your help topics.

derrick

Thank you, Ola, the Object.xml thingie is okay now.