Specifying the order of rules, extractors, and transforms in extended transforms

After you declare the rules, extractors, and transforms of a transformation extension, and specify an ExtendTransform element in the manifest file of the transformation extension, you can add the elements of the transformation extension to the ExtendTransform element, and specify the order in which the elements run.

Before you begin

The plug-in manifest file of the transformation extension must be open in the manifest editor. The manifest file must contain at least one TransformationExtension element and at least one ExtendTransform element. For each rule, extractor, or transform in the transformation extension, the plug-in manifest file must contain a RuleDefinition, ExtractorDefinition, or TransformDefinition element.

About this task

The location of the AddRule, AddExtractor, and AddTransform elements, and the corresponding zero-based index value of these elements, indicate where to insert the element among the existing elements of the target transform. If you do not specify a value for the index attribute, the element that you add is appended to the list of elements in the target transform.

Procedure

  1. In the plug-in manifest file of the transformation extension, on the Extensions tab, in the TransformationExtension element hierarchy, right-click an ExtendTransform element; then complete one of the following steps:
    • To add a rule, click AddRule.
    • To add an extractor, click AddExtractor.
    • To add a transform, click AddTransform.
  2. In the Extension Element Details area, you must complete the following steps for the element that you added in step 1:
    Note: For more information about the fields in the Extension Element Details area, place the mouse pointer over the name to display hover help.
    • The following table shows the values that you must specify for each type of element that you add to the target transform.
      Element Field Value
      AddExtractor element id Specify the identifier of the corresponding ExtractorDefinition element in the TransformationExtension element.
      transform Specify the identifier of the transform that processes the elements that the content extractor extracts.
      AddRule element id Specify the identifier of the corresponding Rule Definition element in the TransformationExtension element.
      AddTransform element id Specify the identifier of the transform that you added in step 1.
    • Optional: Optional: For each element that you add, specify where to insert the element in the extended transform by completing one of the following steps:
      • In the index field, specify an integer value that is in the range of elements for the target transform. The list of elements in the target transform is a zero-based list.
      • In the insertAtID field, specify the identifier of the target transform element that runs next in sequence after the new element.

    If you do not specify a value, the new rule, extractor, or transform is appended to the list of elements that compose the extended transform.

    Tip: You can change the order of the elements in an ExtendTransform element by editing the plugin.xml file in the transformation extension plug-in.
  3. Click File > Save.

Feedback