Extending existing transforms in transformation extensions

You can specify that a transformation extension extends an existing transform by adding an ExtendTransform element in the manifest of the transformation extension. The transform that you extend must exist in the target transformation that you specify in the targetTransformation attribute of the TransformationExtension element.

Before you begin

You must open the plug-in manifest file of the transformation extension. The manifest file must contain a TransformationExtension element.

About this task

To add an ExtendTransform element to the transformation extension:

Procedure

  1. In the manifest editor, on the Extensions tab, right-click a TransformationExtension element; then click New > ExtendTransform.
  2. On the Extensions tab, in the Extension Element Details area, specify values for the following fields:
    • In the targetTransform field, specify the unique identifier of this transform in the extended transformation.
      Tip: You can obtain this information from the documentation for the transform or the transformation that contains this transform.
    • In the id field, specify a unique value that enables you to recognize the ExtendTransform element.
    • In the name field, specify a name that enables you to identify the extended transform.
    Note: Typically, you only use the values of the id and name fields when you debug a transformation extension.
  3. Click File > Save.

What to do next

The ExtendTransform element is added to the Extensions tab, in the hierarchy of the TransformationExtension element. You can now add the rules, extractors, and transforms to the extended transform, and specify the order in which the elements run.

Note: You can add an ExtendTransform element by editing the plugin.xml file of the plug-in that contains the transformation extension. The ExtendTransform element must contain an attribute called targetTransform and optional attributes called name and id.
Note: Some information, such as links to Eclipse documentation or to developer guides, is available only from the help topics that are installed with the product.

Feedback