Adding Exits to a Resource

Exits are Percussion extensions that process XML documents. The are represented on the resource by the Exit icon:Exit Icon 

Exits fall into two categories. Pre-exits (also known as Document Pre-processors) process the document before it is input to the resource. They are represented on the input side of the resource (on the left in a query, on the right in an update). Post-exits (Result Document Processors) process the document after it is output by the resource. They are represented on the output side of the resource (on the right in a query or on the left in an update.

Most exits are specifically designated as belonging to one of these categories, but some exits can be used generically as either pre-exits or post-exits. Whether a generic exit behaves as a pre-exit or a post-exit depends on whether it is added to the input side of the resource or the output side.

To add an exit to a resource:

  1. In the XML Server Explorer, expand the Extensions node, then expand the Exits node. Exits are categorized as pre-exits, post-exits, or generic exits. Locate the exit you want to add to your resource.
  2. Drag the exit to the resource and add it to the correct location. Pre-exits can only be added to the input side of the resource, while post-exits can only be added to the output side of the resource. Generic exits can be added to either side.
  3. Specify values for the parameters of the exit:
    1. Double-click on the exit icon where the exit you want to maintain is located.
    2. The Workbench displays the Exit properties dialog.
    3. All of the exits currently assigned to the specified side of the resource are listed in the Java Exits field. Exits are processed in the order listed. To change the order, select an exit that you want to reposition and click the up and down arrow buttons to move it in the list.
    4. The parameters for the selected exit are listed in the Parameters box. To assign a value to a parameter, double-click in the Value column of the corresponding row, then click the browse button to display the Value Selector. Use the Value Selector to specify the Value for the parameter.
  4. When you have finished maintaining the order of exits and their parameters, click the [OK] button to save your changes.

Leave a comment