CA API Gateway 9.1

9.4 9.1

Look Up Item by Index Position Assertion

The Look Up Item by Index Position Assertion looks up a value based on index position in a multivalued context variable. If a value is found, it is stored in another context variable.
gateway90
The
Look Up Item by Index Position Assertion
 looks up a value based on index position in a multivalued context variable. If a value is found, it is stored in another context variable.
This assertion is designed to work with the Look Up Item by Value Assertion, which creates a context variable containing the index position.
Example
:
The (Non-SOAP) Verify XML Element Assertion stores information about the XML element across several context variables. Using the Look Up Item by Value Assertion, you determine that the element you need is in the third position in the
elementsVerified
 variable. With this knowledge, you can use the Look Up Item by Index Position assertion to look up more information about the XML element:
  • The signature method that was used (third position in the
    signatureMethodUris
     variable)
  • The digest method employed (third position in the
    digestMethodUris
     variable)
Using the Assertion
  1. Do one of the following:
    • To add the assertion to the Policy Development window, see Add an Assertion.
    • To change the configuration of an existing assertion, proceed to step 2 below.
  2. Right-click
    Look Up Item by Index Position
     in the policy window and select
    Look Up Item by Index Position Properties
     or double-click the assertion in the policy window. The assertion properties are displayed.
  3. Complete the properties:
    Setting
    Description
    Extract value with index
    Enter the index position of the value to extract from the multivalued context variable (specified in the next field). You may enter a fixed value (such as "3") or may specify a context variable that contains the position. For example, to extract the first item in the variable, enter
    0
    ; to extract the second item, enter
    1
    .
    (1) Use the variable from the "Store matching index(es) in variable named" field in the Look Up Item by Value Assertion. (2) If you specify a context variable, be sure to enclose it with the "${ }" characters.
    Extract from multivalued variable named
    Enter the name of the multivalued context variable from which to extract. The "${ }" delimiters are not required.
    Store extracted value in variable named
    Specify the name of the context variable that holds the extracted value. The "${ }" delimiters are not required. Default:
    output
  4. Click [
    OK
    ].

Content feedback and comments