Pages: 1
Print
Author Topic: Randomized file names for webhelp  (Read 2022 times)
Anna
Member

Posts: 5


« on: March 27, 2013, 10:12:40 AM »

Hi,
I use XMetaL Author Enterprise for Documentum webtop, Version#: 2.1.0.084.

If I generate webhelp in XMetaL, using the files that are saved in Documentum, the html files get randomized file names.

If I instead export the files from Documentum to a local folder/network disk, and generate webhelp in XMetaL locally, the file names are consistent.

Is this a known, common issue?
Logged
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2621



WWW
« Reply #1 on: March 29, 2013, 01:03:45 PM »

I'm not sure about the exact details but the implementation is on purpose due to the way files are checked out of Documentum into its own local cache on your machine and the way linking in Documentum works. When output is generated using the DITA OT integrated with XMetaL Author Enterprise these cached files need to have their links fixed up so that the DITA Open Toolkit can understand them. By "fixed up" I mean altering the links from the Documentum "dctm:identifier" format (which are not file paths but references to "objects" in the CMS) to standard file system paths that reference real files. It is that process that does the randomized file naming. The DITA OT has no understanding of these identifiers and no direct integration with Documentum and so XMetaL makes a copy of the cached files containing these dctm identifiers and fixes the links in the copy by creating random file names and then fixing up the links so they point to the files.

You may wish to contact one of our partners that specializes in integrating the DITA Open Toolkit directly into the Documentum server so that output is generated from there instead. You can then continue to use the output generated from the XMetaL integrated copy of the DITA OT as a preview, but generate your real output from Documentum directly. We have several clients that are using this approach...or use your current workaround which relies on Documentum's export feature to decide what to name the files and fix up the links.
« Last Edit: March 29, 2013, 01:16:34 PM by Derek Read » Logged
Anna
Member

Posts: 5


« Reply #2 on: April 02, 2013, 02:33:28 AM »

Thanks for the reply, Derek!

Good to know that we haven't missed a simple solution.
Had I known of this issue earlier, we probably would have tried to move the html generation to inside Documentum. However, in the current situation, we'll probably continue with the work-around.
Logged
Pages: 1
Print
Jump to: