Deduplication

Definition

A deduplication Feature allows to check for duplicates before creating a new object.

Usage

	Steps	Preview
1	Fill in values for at least mandatory Attributes.
2	Click on the "Create" button. This button is not configurable and is displayed automatically if the Feature's type is DEDUPLICATION.
3	2 cases are possible: If the new entry is not a duplicate, you will be redirected to the Feature that is configured on the <createFeature> tag.
4	If the new entry is a duplicate, you will be redirected to the list of duplicates:
5	A duplicate is found. 3 cases are possible: Create anyway (only if the <forceCreation> tag is set to true). By clicking on the "Create anyway" button, the user is redirected to the Feature that is configured in the <createFeature> tag, in order to force the creation of the new element. The user is reintegrated in a classic create feature process.
6	Add as sibling (only if the <allowSiblingCreation> tag is set to true). The user must choose a duplicate and click on "Add as sibling" button.
7	The user is redirected to the Feature that is configured in the <createFeature> tag. A banner (not configurable) reminds that the user is creating a sibling. The new entries have the same Attribute's values as the element chosen on the previous screen. Click on the "Create" button to validate the sibling creation.
8	The execution preview is displayed (according to the submit configuration). Click on the "Confirm" button to validate. You can cancel the creation by clicking on the "Cancel" button.
9	The execution is displayed (according to the submit configuration). Click on the "Close" button to validate.
10	Update (always available). The user must choose a duplicate and click on the "Update" button. By clicking on the "Update" button, the user is redirected to the Feature that is configured in the <updateFeature> tag, in order to update the element. The user is reintegrated in a classic update feature process.

Configuration

Prerequisite

The following prerequisites are mandatory before configuring a deduplication Feature:

Have configured an object type (Identity, Organization, Resource, Role or Role Publication).
All attributes definition listed in the deduplication Feature must be created and linked to the object type.
Have configured a deduplication policy.
Have created a object in order to check it.

Properties

Mandatory configuration elements

Global configuration elements are detailed on the Feature page.

Configuring the Deduplication option is also mandatory in a Deduplication Feature, if not, the Feature will not be usable.

Deduplication option

Property name	Type	Mandatory	Description	Values (default value in bold)
forceCreation	`Boolean`	YES	Used to indicate if the user can create the Object even if a duplicate was found. In this case, a "Create anyway" button is displayed. Note that this will just result in allowing the user to navigate to a CREATE Feature and ask the deduplication process to be ignored. By default the deduplication will be ignored but one can forbid it on the OPERATION configuration of type CREATE by specifying a "bypassDeduplication" flag to false in its requestOptions.	true, false
allowSiblingCreation	`Boolean`	YES	Used to indicate if the user can create a sibling if a duplicate was found. In that case, an "Add as sibling" button is displayed (only if an Object is selected).	true, false
columns	-	YES	Used to display the configured Attributes when a duplicate is found. If you do not configure a column, the default value is created. You must add <dataKey> and <type> values in order to specify which Attribute(s) will be displayed.	-
updateFeature	`String`	YES	Used to indicate the id of the update Feature to redirect the user if the chosen option is “Update”.	-
createFeature	`String`	YES	Used to indicate the id of the create Feature to redirect the user if the chosen option is “Add as sibling” or “Create anyway”.	-

Recommended configuration elements

The following requirements are recommended to build the XML configuration:

Options:
- Initialization
Views: define a unified set of elements placed in tab.
Sections: define related elements inside a View.
Columns: define Columns to display duplicates.
Frame: define a frame around the Screen or Section.
Authentication: define the authentication level to access Features.
OperationOnSelf: non-functional on a deduplication Feature
HomeTile: use to access a Feature from the home page.

If attributes are configured as mandatory in the Object Type, they must be configured in the Feature.

Example

Sample_Deduplication.xml