Data Masking Components: Dictionary Substitution

{TOC}

"Dictionary Substitution"

API Reference, CLR Reference (links)

Usage Instructions:

Purpose

The purpose of the component is to mask such values as Account or Patient Numbers that often consist of the combination of Alpha and Numeric characters and are not formed by a specific rule.

Algorithm

Variation of Preserving Referential Integrity Substitution SUBSTITUTION PRESERVING REFERENTIAL INTEGRITY

Description

Mask Dictionary Substitution component uses a custom dictionary defined by the user for substitution values. It substitutes based on an indicated key and in such manner preserves the referential integrity.

API Reference, CLR Reference

Usage Instructions:

1. Configure the source component that you want to mask with your custom data in the variable.
2. DragOpen Mask Dictionary Substitution component’s editor, by either double clicking on the component or right-click and Dropchoose Genericedit. AlhaNumeric Dynamic masking component, connectSelect the sourcevariable andthat contains the genericdictionary alpha numeric component withfrom the source'sdrop precedence constraint:down:
3. Now,In Input Columns Tab, select the precedencecolumn constraintyou (thewant blueto arrow)mask passes proper meta-data towith the Genericvalues AlphaNumericin component.the If you click on constraint, you will see: dictionary.
4. Now that the metadata for the GANMasking Dictionary Substitution exists, andin valuesShuffle areColumns passedTab, intomap input column from the datasource masking component, please opento the componentone editor:in the Dictionary Substitution component. :
5. InThe the second tab, there are input columns. Please check-mark only one column, the one that you will be masking with Generic Alpha Numeric algorithm:
6. This will create an extra column with the prefix “Masked_”.
7. Create a connection manager for the destination and configure source component for the destination. In the connection manager, in the tab “Mappings”, specify that you want newly created Field_Masked to be a field replacing the original value. For that, just click on the available input columns, choose the masked value, and map to the “Available Destination Columns”
8. Now, all the configurations are complete for the valid values. You can run the package with the Generic AlphaNumeric Dynamic Data Masking component, and see the results of data masking:

Error Handling

9. If, however, there are invalid values in the package's source, one would need to configure error handling. Invalid values are those that are not conforming to the rules of the entity. To handle invalid values, each data masking component has error handling precedence constraint. One needs to create error destination connection and connect red arrow (error handling constraint) with this destination. As the connection is made, one needs to configure the state of failure: “Fail”,”Ignore” or “Redirect”.
10. It is recommended that one re-directs thecomponent’s output intocolumns thenow errorcontain destination, so that later one be able to analyze and process data for quality purposes. The Generic Alpha Numeric components errors are the only ones not recommended for further processing as it is truly hard to break their format. Masked_
11. It is our suggestion that with Generic Alpha Numeric component one should not process erroneous data without further analysis at all.

Download Example ###**