XMetaL® Author Enterprise for Documentum® Webtop Release Notes

Contents

Introduction

With XMetaL Author Enterprise for Documentum Webtop, you can now create XML content with unparalleled speed and ease. Together, XMetaL and Documentum provide everything your company needs to create, share, reuse, and deliver XML content in any format, for any destination.

With this version, XMetaL Author Enterprise for Documentum Webtop is certified for use with EMC's D6.6 release .  Our Documentum connector software no longer supports EMC's D5.3 release and D6 release.

Also new for this release, the software extends functionality and is certified for use under Windows Vista operating systems.

New features

DITA 1.2 DocApps

OASIS DITA 1.2 authoring support is now available for Documentum with the application of new DocApps.

Documentum D6.6 compatibility

You can now use the product with EMC's D6.6 release.

Support registry.mode: file

Please refer to Section "Logging in to the repository" in XMetaL Author for Documentum Webtop User's Guide.

"Search" capability in DITA reference dialogs

All DITA reference dialogs (except for web reference dialogs) support "Search" Capability.

Quality improvements and enhancements

  • Referencing an image in a non-dita document, no extra copy is created.
  • Child components are displayed in "Select Document To Open..." dialog.
  • Search result list item contains the value of "title" attribute.
  • Repository url can be specified either with or without trailing slash.

Note:

The user needs to login Webtop via web browser at lease once before using the integration.

Installation Requirements

Client-side

XMetaL Author Enterprise for Documentum Webtop needs the following system and software requirements met prior to installation:

Server-side

Please refer to the XME Webtop Administrator's Guide for specific details on what system and software requirements must be met prior to installation of XMetaL software.
 

Known issues

Cannot check-in document with conref to image (PROD00029260)

If an image element has a conref attribute specified, then you may not be able to check-in the parent document.  This is likely because the image's href attribute has a '-dita-use-conref-target' attribute value specified (per OASIS DITA spec). But, the DocApp's link-rule for image href values triggers Documentum into attempting to follow this '-dita-use-conref-target' href value.

A feature request has been submitted to EMC to address this issue. But for now, please work-around this issue by not conref-ing images...just link direct to the particular image.

Documentum-style chunking for DITA content

JustSystems doesn't not test or recommend people use Documentum's chunking configuration in DocApps designated for DITA content.  XMetaL Author Enterprise's DITA features are implemented in accordance with the OASIS DITA specification where applicable.  As a result, invoking a DITA operation where chunked markup is operated upon may result in unknown side-effects and problems.

Updating references is unsuccessful if target document is checked in with 'Same version'

Updating references is unsuccessful if file A that contains a link to another file B, after editing file B and checking it in with the 'Same version' option selected. This issue resolves itself when file B is no longer in the Documentum client-side cache and fetched from the server again.

Cannot insert an image from my computer into DITA content

Currently, the XMetaL connector for Documentum only allows users to choose an image that was previously imported into Documentum. Though Documentum supports automatic-importing of referenced images from the local computer (upon check-in of a xml document), the XMetaL-Documentum connector doesn't support creating/editing image href values outside of Documentum. 

The XMetaL team is looking to address this issue in a future release and for now, you must import the image prior making references to it within DITA content.

Security warning does not appear

After you install XMetaL Enterprise Edition and Webtop integration and then jre1.6 in this order and then try to create or open a document, the security warning dialog ('digital signature verified') does not appear. XMetaL continues to show the 'Initializing plug-in' page. Workaround: If you log into Webtop and then open XMetaL, the security warning appears when creating or opening a document.

Error appears unexpectedly

Occasionally, some actions may cause an unexpected error 'Unable to display an error as an exception is not set'. Workaround: If this error appears only once, continue with the process that triggered it. If it appears consecutively, clean up Internet Explorer cache and re-launch XMetaL while pressing the Control key.

Support services

For a list of telephone support offerings, online service options, and support downloads, visit http://na.justsystems.com/support.

To contact XMetaL support directly, e-mail us at supportxmetal@justsystems.com, or telephone us at one of the numbers listed at http://na.justsystems.com/contact.