Using the Dynamic User-Defined DataPower Policy Component (Pipeline)

Learn how to reference a "User-Defined Category" that is defined in a non-pipeline version of the Dynamic User-Defined DataPower Policy and configure policy attachments.

Dynamic User-Defined DataPower Policy (Non-Pipeline) DataPower Policies

Managing Policies

Table of Contents

  1. Introduction
  2. Configuration

Introduction

The "Dynamic User-Defined DataPower Policy Component" allows you to reference one or more DataPower "Processing Rules" by allowing you to dynamically attach to the non-pipeline version of the policy by referencing the "User-Defined Category."

  • First, using the Add Policy Wizard, add a Dynamic User-Defined DataPower Policy, define a "User-Defined Category" and add one or more DataPower "Processing Rules."

  • After this step is complete, add the Dynamic User-Defined DataPower Policy Component to your Pipeline Policy and enter the "User-Defined Category" specified in the non-pipeline version of the policy.

  • Each policy must be attached to a service operation. The attachment sequence should be non-pipeline version first followed by the pipeline version.

  • When the policy gets deployed with the service to DataPower, it matches the specified "User-Defined Category" to the correct Dynamic User-Defined DataPower Policy, searches for the name of each DataPower "Processing Rule" (i.e., Rule Name) in the DataPower domain and executes the rule based on the sequence specified in the policy.

Back to top

Configuration

Let's take a quick walkthrough of the User-Defined DataPower Policy Component configuration process to get your started.

Note: A Dynamic User-Defined DataPower Policy (non-pipeline) version must be added using the Add Policy Wizard and defined and configured prior to this configuration as the User-Defined Category from this policy is referenced in the pipeline version of the policy. See Dynamic User-Defined DataPower Policy (Non-Pipeline) for more information.

Step 1: Add Policy / Use System Policy

You can create a Pipeline Policy instance using Add Policy in the Policies > Operational Policies section.

Step 2: Modify Policy

When you Modify the Pipeline Policy, and use Add Component to add the Dynamic User-Defined DataPower Policy Component, the Modify Pipeline Policy will look like this:

This component can be used in the Request Configuration, Response Configuration, or Fault Configuration. You can position the component anywhere in the request, response, or fault.

Step 3: Configure

The process of configuring the Dynamic User-Defined DataPower Policy Component involves referencing a "User-Defined Category" that is defined in a non-pipeline version of the Dynamic User-Defined DataPower Policy. If you have not configured a Dynamic User-Defined DataPower Policy see Dynamic User-Defined DataPower Policy (Non-Pipeline) for more information.

To configure the Dynamic User-Defined DataPower Policy Component, select the policy on the Modify Pipeline Policy screen and click Modify Component. The Modify Dynamic User-Defined DataPower Policy Component screen displays. Enter the category to reference in the "User-Defined Category" field display and commit your changes.

For example, if the category you defined in the Dynamic User-Defined DataPower Policy (non-pipeline) is SampleCategory:

You will enter SampleCategory in the User-Defined Category field on the Modify Dynamic User-Defined DataPower Policy Component screen.

Step 4: Attach Policy

After you have saved your policy you must attach both the Dynamic User-Defined DataPower Policy Component and the Dynamic User-Defined DataPower Policy that contains the User-Defined Category you referenced to specific web service or at the Organization level and the policy will be active for all services defined within the orgnization. The non-pipeline policy should be attached first as follows:

Back to top