DITA and XMetaL Discussion
pmasal June 2, 2010 at 9:08 pm
Cross references to reusable components in XMetal 5.5 EEJune 2, 2010 at 9:08 pmParticipants 6Replies 7Last Activity 12 years, 8 months ago
I'm using XMetal 5.5 EE for Documentum Webtop. When I insert a reusable component reference in a DITA topic (for example a
, as shown in the attached screen capture), I cannot cross reference the content in the reusable component (insert
's list of available elements does not include the reusable component and its ID).
The reusable component has an ID that was auto-assigned by XMetaL when the component was created (AVM_RAID_groups_table). Does anyone know why I can't cross-link to this conref'd content as if it were “normal” content?
PaulDerek Read June 3, 2010 at 12:37 am
Reply to: Cross references to reusable components in XMetal 5.5 EEJune 3, 2010 at 12:37 am
Paul, do you know if the id attribute set on the “local content” or in the “conref target” (or possibly both)? I suspect it is set on the
element in the conref target and not on the conref source.
The local content, which DITA officially calls the “conref source” is essentially the placeholder
that is in the document just to keep it valid. It will typically contain the minimum number of elements to keep the document valid, but probably no actual content. The “conref target” is the element that contains the actual table (typically in an external file) containing your real content. The conref source has the conref attribute set to point to the conref target and it may not (probably won't) have an id attribute set on it. It doesn't have an id attribute set because we don't want it to appear as a false hit that you might try to link to in our dialogs. I think this usually makes sense the majority of the time because you probably don't want to link to a placeholder with no content (the conref source).
The conref source can be viewed by right clicking on your
that appears gray and selecting “Show Local Content”. When you do this the styling will change from a gray background to a yellow background (so you can tell what you're looking at). You can then check the Attribute Inspector to see what the attributes are or hover over the opening or closing tag.
If you do want to reference the “local content” you would need to set an id attribute on it. If you want to reference the target you would select the file that contains it and then select the id corresponding to the table.
Hope you can follow this and that you have not uncovered a bug or something.pmasal June 3, 2010 at 4:07 pm
Reply to: Cross references to reusable components in XMetal 5.5 EEJune 3, 2010 at 4:07 pm
Derek, thank you as always. When I “show local content” for the conref to the Reusable Component, I see the local version of the table as you describe. The table has an id, but it still doesn't show up in the available elements for insert -> cross reference (see the two attached images).
to the reusable component in Documentum, but the cross reference doesn't resolve correctly in our print output. It could be an issue with our customized transforms, but I have a feeling if I was able to xref to the local table (using “show local content”), it would be ok.
Is there any chance you can try re-producing this in your dev environment? I'm using XMetaL EE 5.5 with DCTM 6.5 SP1.
PaulDerek Read June 3, 2010 at 7:07 pm
Reply to: Cross references to reusable components in XMetal 5.5 EEJune 3, 2010 at 7:07 pm
I can't reproduce this with a basic install with no Documentum involved. I'll check to see if this is a known issue with the DCTM connector by testing there as well. I do have to explicitly and manually give the conref source (the yellow table) an id before it will be listed and I can link to it, which is expected.
This might take a little while to set up a test here with your version.pmasal June 4, 2010 at 11:18 am
Reply to: Cross references to reusable components in XMetal 5.5 EEJune 4, 2010 at 11:18 am
I just re-tested with a) Accepting XMetaL's default ID for the local table and b) manually specifying my own ID for the local table. Neither work, both produce the same error situation (no table ID shows for cross-referencing). Thanks in advance for any further help you can provide, Derek.
Paulpmasal July 7, 2010 at 1:43 pm
Reply to: Cross references to reusable components in XMetal 5.5 EEJuly 7, 2010 at 1:43 pm
Did anyone at JustSystems look at this issue? Thanks.
PaulDerek Read July 7, 2010 at 6:09 pm
Reply to: Cross references to reusable components in XMetal 5.5 EEJuly 7, 2010 at 6:09 pm
Paul, we aren't able to reproduce this, but perhaps we're missing a particular detail. I'm not sure what to ask for though as I believe we should just need XMetaL Author Enterprise with the Documentum connector installed. Is there something custom about your installation? Additional scripts or some other modifications?pmasal July 7, 2010 at 7:45 pm
Reply to: Cross references to reusable components in XMetal 5.5 EEJuly 7, 2010 at 7:45 pm
Because reusable components initially didn't work in XMetaL EE 5.5 for DCTM Webtop, we have a macro (attached and temporarily named to jpg from .mcr) in C:Program FilesXMetaL 5.5AuthorStartUp, created by your team, that enables that to happen. Could this be the culprit?
- You must be logged in to reply to this topic.