10.2 Mapping Table Objects

A mapping table object is used by a policy to map a set of values to another set of corresponding values. After a mapping table object is created, the Map token maps the results of the specified tokens from the values specified in the mapping table.

To use a mapping table object, the following steps must be completed:

  1. Section 10.2.1, Creating a Mapping Table Object

  2. Section 10.2.2, Adding a Mapping Table Object to a Policy

To edit a mapping table, see Section 10.2.3, Editing a Mapping Table Object.

10.2.1 Creating a Mapping Table Object

A mapping table object can be created in a library, driver object, Publisher channel, or Subscriber channel.

  1. In the Outline view, right-click the location to create the mapping table, then select New > Mapping Table.

  2. Specify the name of the mapping table object.

  3. Select the check box for Open the editor after creating the object, then click OK.

    Creating a mapping table object fields

  4. Click Yes in the file conflict message to save the mapping table.

    File conflict message

  5. Click the untitled column.

    Untitled column

  6. Specify the name of the column, then select if the value is Case Sensitive, Case Insensitive, or Numeric.

    Column name and data type

  7. Click Close.

  8. Click New Value, then specify the value for the row.

    New value in a row

  9. (Optional) To add an addition column, right-click in the Mapping Table editor, then select Add Column.

    or

    Click the Add Column icon, then repeat Step 5 through Step 7.

  10. (Optional) To add an additional row, right-click in the Mapping Table editor, then select Add Row.

    or

    Click the Add Row icon, then repeat Step 8.

  11. Press Ctrl+S to save the mapping table object.

  12. Continue with Section 10.2.2, Adding a Mapping Table Object to a Policy.

10.2.2 Adding a Mapping Table Object to a Policy

  1. Either create a policy to use the mapping table in, or select an existing policy to edit.

  2. Launch the Argument Builder in the Policy Builder.

  3. Double-click Map from the list of Verbs to add it to the expression panel.

  4. Select either true or false to indicate whether you want this mapping table traced.

  5. In the Editor field, browse to and select the mapping table object created in Section 10.2.1, Creating a Mapping Table Object.

  6. Specify the source column name.

  7. Specify the destination column name.

    Mapping table DN, source column name, and destination column name

    The mapping table can be used in any manner at this point. In this example, the OU attribute is populated with the value derived from the mapping table.

    Map token in the Argument Builder

10.2.3 Editing a Mapping Table Object

Designer provides the following options to edit the mapping table:

Figure 10-1 Editing a Mapping Table

  • Cut: Cuts the selected row.

  • Copy: Copies the selected row.

  • Paste: Pastes the selected row.

  • Move Row Up: Moves the selected row up one row.

  • Move Row Down: Moves the selected row down one row.

  • Add Row: Adds a row to the mapping table.

  • Add Column: Adds a column to the mapping table.

  • Remove Row: Deletes a row from the mapping table.

  • Remove Column: Deletes a column from the mapping table.

10.2.4 Testing a Mapping Table Object

You can test the functionality of the mapping table with the Policy Simulator. The Policy Simulator tests the mapping table by testing the policy that is using the mapping table. For more information, see Section 9.0, Testing Policies with the Policy Simulator.