<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.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
- topic/resourceid
Example
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>
Attributes
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
- Before DITA 1.3, this attribute
specified a value that was used by a specific application to identify the topic. That
usage is deprecated in favor of using the
@appid
attribute. This attribute is defined with the XML Data Type CDATA. @appname
- A name for the external application that references the topic.
@appid
- An ID used by an application to identify the topic.
@ux-context-string
- Contains the value of a user-assistance context-string that is used to identify the topic.
@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:- topic-and-map
- Use IDs from both the topic and map.
- topic-only
- Use IDs from the topic only.
- map-only
- Use IDs from the map only.
- map-takes-priority
- Use the IDs from the map (if they exist); otherwise, use IDs from the topic.
- topic-takes-priority
- Use the IDs from the topic (if they exist); otherwise, use IDs from the map.
@ux-windowref
- References the
@name
attribute on the<ux-window>
element that is used to display the topic when called from a help API.