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 RandomPreserving CharacterReferential PermutationIntegrity AlgorithmSubstitution SUBSTITUTION PRESERVING REFERENTIAL INTEGRITY

Description

Mask Dictionary Substitution component replacesuses lettersa withcustom letters,dictionary whiledefined maintaining capitalization,by andthe replacesuser numbersfor withsubstitution numbers.values. It retains the non-alphanumeric characters, such as dashes, slashes, dots and comas, exactly at the position at which the non-alphanumeric characters presented themselves at the source value. It currently only replaces characters from alphabets that use English characters. The component will replace stringssubstitutes based on lettersan onlyindicated with letter stringskey and stringsin basedsuch onmanner numericpreserves characters,the onlyreferential with numeric characters. For example, "Abc" will become "Zyx" and "123" will become "987" after component execution.integrity.

API Reference, CLR Reference (links)

Usage Instructions:

1. Configure athe source component that containsyou thewant columnto mask with alphabeticalyour and numeric characters. Thecustom data in the column may also include any other character that will be treated as a separator.variable.
2. Drag and Drop Generic AlhaNumeric Dynamic masking component, connect the source and the generic alpha numeric component with the source's precedence constraint:
3. Now, the precedence constraint (the blue arrow) passes proper meta-data to the Generic AlphaNumeric component. If you click on constraint, you will see:
4. Now that the metadata for the GAN exists, and values are passed into the data masking component, please open the component editor:
5. In 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 the output into the error 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.
11. It is our suggestion that with Generic Alpha Numeric component one should not process erroneous data without further analysis at all.

Download Example ###**