Resourceid appname & appid

Post here questions and problems related to editing and publishing DITA content.
Tristan
Posts: 30
Joined: Tue Jun 02, 2015 2:01 pm

Resourceid appname & appid

Post by Tristan »

Hi,

Are there plans to translate the appname & appid attributes in a <resourceid> to the context-help-map.xml in the webhelp output?
If so will the two attributes be concatenated in the helpID?

e.g. <resourceid appname="application" appid="functionid"/> becomes
<appContext HelpID="application.functionid" path="..."/>

Thanks,

Tristan
radu_pisoi
Posts: 403
Joined: Thu Aug 21, 2003 11:36 am
Location: Craiova
Contact:

Re: Resourceid appname & appid

Post by radu_pisoi »

Hi,

Yes, we want to update the Context-Sensitive WebHelp system to take care about the new attributes added to the resourceID element in DITA 1.3 specification.
Tristan wrote:Hi,

Are there plans to translate the appname & appid attributes in a <resourceid> to the context-help-map.xml in the webhelp output?
If so will the two attributes be concatenated in the helpID?

e.g. <resourceid appname="application" appid="functionid"/> becomes
<appContext HelpID="application.functionid" path="..."/>

Tristan
For the case when both @appname and @appid attributes are specified, I think we will adopt the next convention:

Code: Select all

<appContext helpID="functionid" appName="application" path="topics/topic.html"/>
where the @helpID value is taken from resourceid@appid. So, the information from the @appname attribute will be transferred in the 'context-help-map.xml' file as it is.
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
Tristan
Posts: 30
Joined: Tue Jun 02, 2015 2:01 pm

Re: Resourceid appname & appid

Post by Tristan »

Thanks for the swift reply and considering the update.
I assume the appid will then also be added as a parameter in the url next to the contextid?

Code: Select all


index.html?contextId=functionid?appid=application
Best regards,

Tristan
radu_pisoi
Posts: 403
Joined: Thu Aug 21, 2003 11:36 am
Location: Craiova
Contact:

Re: Resourceid appname & appid

Post by radu_pisoi »

Tristan wrote:I assume the appid will then also be added as a parameter in the url next to the contextid?

Code: Select all
index.html?contextId=functionid?appid=application
I suppose that you are referring to the @appname attribute.

Yes, we will update the list of parameters allowed by Context-Sensitive WebHelp system by adding the 'appname' parameter.
So, for you case:

Code: Select all

<appContext helpID="functionid" appName="application" path="topics/topic.html"/>
you will be able to open a WebHelp system showing the page 'topics/topic.html' with the next query:

Code: Select all

index.html?contextId=functionid;appName=application
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
Tristan
Posts: 30
Joined: Tue Jun 02, 2015 2:01 pm

Re: Resourceid appname & appid

Post by Tristan »

Perfect!
Indeed it was appname I wanted to refer to and the ? should have been a ; in my url
I blame it on the monday morning feeling :wink:

Thanks again,

Tristan
alin
Site Admin
Posts: 268
Joined: Thu Dec 24, 2009 11:21 am

Re: Resourceid appname & appid

Post by alin »

Hello,

I wanted to let you know that the feature you have requested was implemented in oXygen 18.1 which was released a few weeks ago.
Here is a fragment from the "What is new" section:
Context Sensitive WebHelp was Updated for DITA 1.3
The Context Sensitive WebHelp system was updated to support the new changes from DITA 1.3 specifications. For example, you can now associate a topic with an application by using the @appid and @appname attributes available on the resourceid element.
You can read more in our User Manual:
https://www.oxygenxml.com/doc/versions/ ... -resp.html

Regards,

Alin
Alin Balasa
Software Developer
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply