Generate items in random order

The Generate items in random order masking activity allows you to generate items of the selected type from the collection of items in the random order.

Table of contents
Usage
Example
Properties

Usage

To use the Generate items in random order masking activity, it must be placed inside a table masking activity or a similar activity that iterates over data. Once placed, select the property you want to mask and create a new instance of the generator that uses values from the collection of items, that are going to be assigned to the selected property in the order as they are written.

Additionally, you can set the EnforceUnique property to make sure every assigned item is unique. This option must be used with care so that the number of table records is not greater than the possible items in the defined range.

Example

In this example we want to assign an item from the defined collection to the first 8 table records of the Address table. First, we place the Address masking activity into opened Package.xaml and put the Generate items in random order masking activity within it. Then select the type of the items that are going to be used: Int32.

Figure 1: Select Type window

Once placed, we select the Number property that we want to mask with generated items. In Items field enter new int[]{1,2,3,4,5,6,7,8}.

Random number generator field is optional. Enter new RandomNumberGenerator(0,7).

Figure 2: Generating items in random order

Modify Filter property to mask only first 8 table records: x=>x.AddressID<=8.

Properties

Property group	Property name	Description	Example
Input properties	DataItemProperty	The property to mask.	Choose property from the dropdown list
	EnforceUnique	If true, random selection should select unique values.	`true` or `false`
	Items	Collection of items used to generate values.	`new int[]{1,2,3,4,5,6,7,8}`
	RandomNumberGenerator	Random number generator used to randomly generate values.	`new RandomNumberGenerator(0,7)`
Input: Filter	Filter	Expression used for filtering records - only filtered items will be masked.	`x=>x.AddressID<=8`
	SkipDefaultValues	If true, default values will be omitted in masking (i.e. null values are not masked).	`true` or `false`
Input: Repeating	RepeaterId	The ID of the repeater that will be used to detect repeating and save results when masking item key repeats.	`GenerateItemsRandomRepeater`
	RepeatingKey	Key to use for repeating detection.	Write `x => CompositeKey.Create(x.Items)` or choose properties from the pop-up window
Misc	DisplayName	Display name of the activity in the workflow.	`Generate items in random order`
	Result	Contains the masking definition object. It's a part of the masking infrastructure and should be ignored.	-