Mask Component

Introduction

A Mask Component can be thought of as a mask template.

It is defined much as a normal DataVeil mask except that instead of being assigned directly to a column to be masked, it is saved to the Component Home directory as an XML text file.

The file name that the user gives the XML file becomes the name of the Mask Component and is then listed under the Components tab in the DataVeil UI. These Components will always appear and be available in this tab for every project that is created by the user.

Create a Mask Component

To create a Mask Component, either click on the 'Create...' button in the Components->Masks tab or double-click on an empty space in the table.

A dialog showing available masks is displayed.

For this example, let's choose the Randomize mask and click OK.
 

The chosen mask definition dialog appears and the required parameters can be configured as shown below:

To save the Mask Component, click on OK and the Save dialog shall appear:

As shown above, the name we have given this Mask Component is 'my_randomize'.

Now click 'Save' and the Mask Component shall be saved in the Component Home directory and the component shall now appear in the Masks Component table. It is now ready for use by any DataVeil masking project.

Create a Mask Using the Mask Component

The Mask Component can now be used to mask a column in the same way as a regular built-in DataVeil mask.

As usual, select the column to be masked, right-click and 'Add Mask...'

From the masks selection dialog, choose 'Component':

The Component selection dialog will open:

After making the selection, click 'Open' and then 'OK'. A Component Mask shall be created that references the Mask Component definition (XML file). The Component Mask shall now be displayed for review.

Note that the masking details of the Mask Component (XML file) are summarized in the 'Linked Mask Details' field.

The Determinism, Where and Join tabs allow the user to override settings of the XML component in this mask instance only. i.e. The actual referenced component (XML) is not altered.

Click OK to accept the mask.

The Component Mask is added to the project just like any other mask. The Mask Description shows "MASK COMPONENT" followed by the name of the Mask Component "(my_randomize)" followed by a summary description of the actual component "RANDOMIZE, ...".