Data selection

Anything related to data selection can be addressed by strategy :

Selection
Filters
Security (authentication) specific to a node
Data rotation
Allowing user to add elements

It is also possible to give the user the ability to add items to the selection in addition of those injected by the strategy.

Data selection

Key	Parameters	Control
Configuration.Node.Selection	include < path > [in set < set >] \| exclude < path > [from set < set >] \| include all {documents\|desktops} [in set < set >]	Add/remove a node from selection

Possible values for these keys are :

include : to include a node to the selection
exclude : to exclude a node to the selection
< path > : node's path. If the path leads to a directory, it can end with the "\" caracter. Can also contain :
- * : to select/deselect entire paths, like "c:\users*\documents"
- all documents : to select/deselect the documents directory for all the users
- all desktops : to select/deselect the desktop directory for all the users

Data filtering

Key	Parameters	Control
Configuration.Node.Filters	[at < path >] include < filter > \| [at < path >} exclude < filter >	Allows you to force the inclusion or exclusion of certain files, file types or directories. Filters are applied to the specified node, otherwise to the entire selection.

Possible values for these keys are :

< path > : optional parameter. Node's path.
include : to include data matching the filter
exclude : to exclude data matching the filter
< filter > : data to filter. Can be an extension (.extension), a file name or a path (c:\users or c:\users\\cookies)

Security

Key	Parameters	Control
Configuration.Node.Security	[at < path >] authenticate with login < login > and password < password >	Lets you specify authentication on a node or on the entire selection

The parameters have the following roles and values :

path : optional parameter. Path node requiring specific authentication. Authentication applies on the node itself if it is specified, otherwise to the entire selection.
login : ID to be used for authentication
password : password associated to the ID

Data rotation

Key	Parameters	Control
Configuration.Node.Rotation	[at < path >] after < period > {days\|weeks} keep {every < value > {hours\|days\|weeks}\|none}	Specify a retention policy on a node or on the entire selection

The parameters have the following roles and values :

path : optional parameter. Path node requiring a specific retention. The retention policy applies on the specified node, otherwise to the entire selection.
period : numeric value associated with unity (days or weeks) to specify when to filter the data versions
value : numeric value associated with unity (hours, days or weeks) to define the new periods during which maintain maximum data versions.

Possibility of adding items by user

By default, the user can not intervene within the selection if the selection itself, filters, retention policies and authentication are injected with a strategy. The key below allows the user to add items in addition to the one injected by the strategy.

Key	Control
Configuration.Node.Selection.MergeUser	Allows the user to add nodes to the selection
Configuration.Node.Filters.MergeUser	Allows the user to add filters to the selection
Configuration.Node.Security.MergeUser	Allows the user to add IDs to the selection
Configuration.Node.Rotation.MergeUser	Allows the user to add rotation rules to the selection

Possible values for these keys are :

true to allow adding items
false to deny adding items (default)

Example

You want to backup user profiles on workstations. However, you want to exclude the browser cookies and the administrator profile.

File types "avi", "mkv" and "mp3" should not be saved.

Backup hystory should be kept for a week.

Users can add additional directories to the selection.

Here is what to do:

Select users profiles
Exclude the administrator profile
Exclude the cookies directory
Exclude avi, mkv and mp3 files
Keep the file history for 7 days
Allow users to add nodes in the selection
Allow users to add filters on their selection

Resulting strategy:

Configuration.Node.Selection: include "C:\users\"
Configuration.Node.Filters: exclude "C:\Users\Administrator"
Configuration.Node.Filters: exclude "C:\Users\*\Cookies"
Configuration.Node.Filters: exclude "*.avi"
Configuration.Node.Filters: exclude "*.mkv"
Configuration.Node.Filters: exclude "*.mp3"
Configuration.Node.Rotation: at "C:\users\" after 7 days keep none
Configuration.Node.Selection.MergeUser: true
Configuration.Node.Selection.Filters: true

Example

You wish to backup the "Documents" and "Desktop" folders for every user on a Windows PC.

You will therefore have to :

Select the user profiles
Include the Documents folder
Include the Desktop folder

Resulting strategy:

Configuration.Node.Selection: include "C:\users\"
Configuration.Node.Filters: include "C:\Users\*\Documents\"
Configuration.Node.Filters: include "C:\Users\*\Desktop\"