<resourceid>
The <resourceid>
element provides an identifier for applications
that must use their own identifier scheme, such as
context-sensitive help systems and databases.
The @appid
and @appname
attributes are available to
associate an ID with an application. Multiple @appid
values can be associated with a
single @appname
value, and multiple @appname
values can be
associated with a single @appid
value. Because the values
for the @appid
and @appname
attributes work in combination to
specify a specific ID for a specific application, each combination of values for the
@appid
and @appname
attributes should be unique within the context
of a single root map.
Versions of DITA before 1.3 used the @id
attribute on the
<resourceid>
element to specify an ID for an external application.
Beginning with DITA 1.3, this use of the @id
attribute is deprecated in
favor of using the @appid
attribute.
See appendix for information about this element in OASIS document type shells.
- topic/resourceid
In the following example, user-assistance context hooks are applied to three topics that are referenced from a DITA map. The second topic has two hooks for the same topic.
<map title="Widget Help">
<topicref href="file_ops.dita" type="concept">
<topicref href="saving.dita" type="task">
<topicmeta>
<resourceid appname="ua" appid="1234" ux-context-string="idh_filesave"
ux-source-priority="topic-only" />
</topicmeta>
</topicref>
<topicref href="deleting.dita" type="task">
<topicmeta>
<resourceid appname="ua"
appid="2345" ux-context-string="idh_filedelete" />
<resourceid appname="ua"
appid="6789" ux-context-string="idh_filekill" />
</topicmeta>
</topicref>
<topicref href="editing.dita" type="task">
<topicmeta>
<resourceid appname="ua"
appid="5432" ux-context-string="idh_fileedit" ux-windowref="csh" />
</topicmeta>
</topicref>
</topicref>
</map>
In the following example, a user-assistance context hook is defined in the prolog of a task
topic. The context hook is made up of a context ID (value for @appid
attribute) and a context string (value for @ux-context-string
attribute). A
user-assistance window profile also is referenced for this topic.
<task id="fedt">
<title>Editing a File</title>
<prolog>
<resourceid appname="ua"
appid="5432" ux-context-string="idh_fileedit" ux-windowref="csh" />
</prolog>
<taskbody>
<context>After you have created a new file, you can edit it.</context>
<steps>
<step><cmd>Open...</cmd></step>
<step><cmd>Edit...</cmd></step>
<step><cmd>Save...</cmd></step>
</steps>
</taskbody>
</task>
The following attributes are available on this element: Universal attribute group (with a narrowed definition of
@id
, given below) and the attributes defined below.
@id
@appid
attribute.
This attribute is defined with the XML Data Type
CDATA.
@appname
@appid
@ux-context-string
@ux-source-priority
Specifies precedence for handling <resourceid>
definitions
that exist in both a map and a topic. This attribute only is valid when used within a
<topicref>
element in a map. The allowable values are
-dita-use-conref-target and the following:
@ux-windowref
@name
attribute on the
<ux-window>
element that is used to display the topic when
called from a help API.