XMetaL® Author Enterprise and Essential 5.5 Service Pack 1 Release Notes

Contents

What is included in this service pack?

ActiveDocument.RulesFile property returning wrong values fixed

The RulesFile property is commonly used by XMetaL customizations to determine where related assets and files are located. But, the RulesFile property was returning an incorrect value, either an empty string or a full path filename to the per-user copy of the corresponding .rlx or .rld file. This incorrect value resulted in XMetaL customizations being unable to properly locate other assets and files necessary for their proper operation. The related defects:

  • PROD00031156: RulesFile API broken for XSD customizations
  • PROD00031041: ActiveDocument.RulesFile return empty string when debugging
  • PROD00030650: Cannot integrate addendum because ActiveDocument.RulesFile backward-compatibility broken

XMetaL.Global and XMetaL.Application automation object registrations fixed

These two top-level XMetaL Author COM automation objects had their corresponding Windows registry entries written with an incorrect file path to the xmetal55.exe. The incorrect file path was always setup as 'C:\Program Files\XMetaL 5.5\Author\xmetal55.exe' regardless of the drive and folder chosen at installation time. As a result, users would experience various side effects including the following defects:

  • PROD00031061: XMetaL Developer is unable to open XFT form from the solution Explorer on German Windows
  • PROD00031055: Cannot open Java Demo in German Windows

Editing a CALS table's 'frame' property value crash is fixed

Adjusting the value of a CALS table's frame property via the Table Properties dialog would cause XMetaL Author to crash in the case when more than one table cell was selected beforehand.

The 'frame' dropdown will now be disabled in the Table Properties dialog whenever more than one table cell selected in the active document. Adjust the active document's selection to be an insertion point if you need to set a CALS table's frame property.

Export with Reviewer Data enhancement (XMetaL Author Enterprise-ONLY)

The 'Export with Reviewer Data' feature has been incorporated into the XMetaL Author Enterprise Service Pack 1 installers. This enhancement allows users to better prepare DITA content for reviewing when DITA conrefs are present.

View attachment enhancement (XMetaL Author Enterprise-ONLY)

The 'View Attachment' enahancement has been incorporated into the XMetaL Author Enterprise Service Pack 1 installers. This enhancement allows users to open attachments added during the review process.

Service pack installation & removal instructions

Before you begin

XMetaL Author Enterprise or Essential 5.5 software must already be installed. This service pack installer will only apply itself to an existing 5.5 installation.

Note: Some installations require Vista's UAC feature be disabled or the service pack installer be given administrator privileges. Elevated privileges can be granted by right-clicking the service pack installer and choose 'Run as Administrator').

Note: If the XMetal_55_Patch_for_Reviewer_55_20090304.zip patch has been installed, it is recommend that this patch be removed prior to running the service pack installer.

Choose an appropiate installer format

The XMetaL Author service pack installers are available in two formats, .exe and .msp. The .exe format is meant for 'attended' installations and should be used if XMetaL Author was previously installed using setup.exe.

The .msp format is meant for 'unattended' or Citrix installations and should be used if XMetaL Author was previously installed using "XMetaL Author Enterprise.msi" or "XMetaL Author Essential.msi".

Please choose a format that meets your needs.

To complete an 'attended' installation

Double-click the xmee55_sp1.exe (Enterprise) or xmes55_sp1.exe (Essential) and follow the installer prompts.

Note: For XMetaL Author Enterprise installation, launch XMetaL Author once with the Ctrl-key held down to reset the workspace and toolbars. This is necessary to allow the new XMetaL Reviewer add-on menus to display.

To complete an 'unattended' installation

Open a command prompt window into the directory where the .msp file is located and enter the following command:

  • For XMetaL Author Enterprise 5.5 Service Pack 1
    msiexec.exe /quiet /update xmee55_sp1.msp
  • For XMetaL Author Essential 5.5 Service Pack 1
    msiexec.exe /quiet /update xmee55_sp1.msp

To deploy the service pack on Citrix, create a package using the Citrix Installation Manager software:

  1. Using the Citrix management console, select either xmee55_sp.msp or xmes55_sp1.msp.
  2. Click Yes to add command line parameters.
  3. In the MSI attributes dialog, specify the /Update command line parameter as needed.

No command line parameters are required to un-install.

To remove an 'attended' installation

  • For XMetaL Author Essential 5.5 Service Pack 1
    1. Choose Settings from the Start menu, and then Control Panel.
    2. Double-click Add/Remove Programs.
    3. Ensure Show Updates is checked.
    4. Select XMetaL Author Essential Service Pack 1 entry.
    5. Click Remove and follow the remaining instructions.

  • For XMetaL Author Enterprise 5.5 Service Pack 1, the entire program must be uninstalled and reinstalled in order to remove the service pack. Please refer to install-readme for more details.

To remove an 'unattended' installation

Open a command prompt window into the directory where the .msp file is located and enter the following command:

  • For XMetaL Author Enterprise 5.5 Service Pack 1
    msiexec.exe /quiet /uninstall xmes55_sp1.msp

  • For XMetaL Author Essential 5.5 Service Pack 1, the entire program must be uninstalled and reinstalled in order to remove the service pack. Please refer to install-readme for more details.

Known issues

XMetaL Author Enterprise 5.5 Service Pack 1 has no 'Remove' option

When XMetaL Author Enterprise 5.5 service pack is installed, it doesn't provide a 'Remove' option. This is a known limitation that is a result of adding new files to the service pack installer's manifest that were not originally included with the XMetaL Author Enterprise 5.5 product installer.

To remove the service pack, the entire XMetaL Author Enterprise 5.5 product must be removed and re-installed without the service pack.

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.