Administration Guide › Mapping and Parsing › How to Create a Data Mapping File › Set Block Mappings

Set Block Mappings

Block mappings link a selected condition to a defined series of mappings, allowing you to create a cascade of mappings triggered by that condition. A given block mapping can use any combination of direct or function mappings. Both types of internal block mapping work exactly as they would for stand-alone mappings.

You can create as many blocks as you need for a single mapping file. Each one includes a name and a condition.

If there are duplicate mappings in a given block, the DM file will use the first one it finds, and consider no further mappings. To improve performance, you should place more common conditions first.

To set block mappings

1. Open the mapping file wizard, enter a name and select a Logname for the mapping file, and advance to the Block Mappings step.

   The Block Mappings screen appears, displaying any current block mappings.

2. Click Add Block Mapping in the Block Mappings pane.

   A new block appears in the Block Mappings list.

3. Select the New Block text.

   The Block Definition pane opens, displaying Step 1. Define a Condition

4. Enter a block name, and construct a filter to define the condition for this block. For example, you could define event_result to equal "S" which would invoke the block mappings when a success is detected for the event process.
5. Click the Step 2 bar, and enter any direct mappings you want, using the same process as the stand-alone mapping step.
6. Click the Step 3 bar, and enter any function mappings you want, using the same process as the stand-alone mapping step.
7. When you have added all the block mappings you want, click the appropriate arrow to advance to the wizard step you want to complete next, or click Save and Close.

   If you click Save and Close, the new file appears in the Mapping File User folder, otherwise the step you choose appears.

More information:

Using Advanced Filters