Manage Encapsulated Assertions

The Manage Encapsulated Assertion task is used to create, modify, and delete encapsulated assertions. These assertions are then available from the assertion palette configured in the encapsulated assertion properties.
gateway92
The
Manage Encapsulated Assertion
task is used to create, modify, and delete encapsulated assertions. These assertions are then available from the assertion palette configured in the encapsulated assertion properties.
To learn more about encapsulated assertions, see Encapsulated Assertions.
(1) One or more policy fragments must be defined before you can create an encapsulated assertion. (2) Avoid modifying encapsulated assertions being used in a read-only policy, as the changes will not be reflected in the policy. For more information about read-only policies, see "Read-Only Entities" in Manage Solution Kits.
To manage encapsulated assertions
:
  1. In the Policy Manager, select [
    Tasks
    ]
    > Extensions and Add-Ons > Manage Encapsulated Assertion
    from the Main Menu (on the browser client, from the Manage menu). The Manage Encapsulated Assertion Configurations dialog appears.
    (1) This dialog box is used solely for the creation and maintenance of the encapsulated assertions. How to add, remove, and use them in a policy is the same as the factory created assertions. (2) To quickly locate an entry, type a few characters of the encapsulated assertion name in the filter box at the bottom of the dialog.
  2. The following table describes each column (these are set in the encapsulated assertion's properties):
    Column
    Description
    Name
    The name of the encapsulated assertion as it appears in the assertions palette.
    Palette Folder
    The palette in which this assertion appears.
    Policy Name
    The name of the underlying policy fragment for the encapsulated assertion.
    In
    How many input variables are defined for the encapsulated assertion.
    Out
    How many output variables are defined for the encapsulated assertion.
  3. Select a task to perform:
    To...
    Do this...
    Create a new encapsulated assertion
    You can also create a new encapsulated assertion by right-clicking the policy fragment in the Services and Policies list and then selecting
    Create Encapsulated Assertion
    . If the fragment is already associated with an encapsulated assertion, select
    Encapsulated Assertion Properties
    to view the settings.
    Clone an existing encapsulated assertion
    1. Select the assertion to clone.
    2. Click [
      Clone
      ]. A new encapsulated assertion is created, populated with information from the clone source. The name of this assertion defaults to "Copy of <assertion name>".
    Remove an encapsulated assertion
    1. Select the assertion to remove. Use [Ctrl]-click to select multiple assertions to remove.
    2. Click [
      Remove
      ].
    3. Select the confirmation check box, and then click [
      OK
      ].
    Ensure that the encapsulated assertion is not in use in any policy prior to removal. If it is in use, removing the assertion will make the policy invalid.
    View or edit the properties of an encapsulated assertion
    1. Select the assertion to view.
    Export an encapsulated assertion
    1. Select the assertion to export.
    2. Click [
      Export
      ].
    3. Enter a name for the exported file and choose a target directory, then click [
      Save
      ]. Both the encapsulated assertion and its underlying policy fragment are saved to an XML file.
    Import an encapsulated assertion
    1. Click [
      Import
      ].
    2. Choose the encapsulated assertion file to import and then click [
      Open
      ].
    3. If there is a conflict with the GUID for the encapsulated assertion, choose an action:
      • Overwrite:
        Select this to update the existing encapsulated assertion with attributes from the imported assertion
        except for the name
        , which remains unchanged. The underlying policy fragment of the existing assertion will also be overwritten by fragment associated with the imported encapsulated assertion.
      • Create New:
        Select this to give a new name for the imported encapsulate assertion and its underlying policy fragment. You will be asked to resolve naming conflicts if you enter a name already in use.
      • Cancel:
        Close the dialog box without importing anything.
    The encapsulated assertion and its underlying policy fragment are imported. If the policy fragment includes references to other entities (for example, JDBC connections or other policy fragments), these are also imported. If conflicts occur, the  Resolve External Dependencies Wizard displays.
  4. Click [
    Close
    ] when done.