Action sets

Overview

Action sets are groups of actions that appear together in a business view menu to modify one or more records.

Action types

Possible actions, depending on the entity type, include:

  • Create master or golden records.

  • Edit master, golden, or erroneous records.

  • Import to create or update master or golden records from Excel or CSV files.

  • Copy records.

  • Mass-Update master, golden or erroneous records.

  • Confirm Duplicates to directly confirm groups of fuzzy matching records.

  • Review and Confirm Duplicates to confirm groups of fuzzy matching records after reviewing these groups in detail.

  • Merge or Split Duplicates to reorganize groups of fuzzy matching records.

  • Review Duplicates Suggestions to accept, reject, or reorganize suggestions made on groups of fuzzy matching records.

  • Delete golden or master records.

  • Export records to Excel or CSV files.

  • Browse Graph for a given record to graphically navigate the relationships from and to this record.

  • Explain Record for a fuzzy matched record to graphically view the matches and consolidated values.

Actions that create or modify records (Create, Edit, Import, Copy and Mass-Update) require a stepper or a workflow to perform the operation.

Import actions process records sequentially and execute enrichers, validations, and triggers based on the selected stepper’s configuration. Therefore, they are not suitable for importing massive files in the range of 10,000 rows or more. For such use cases, it is recommended to use ETL/ELT tools designed for bulk imports.

Similarly, actions that manage duplicate records (Merge or Split Duplicates and Review Duplicates Suggestions) require a duplicate manager and are available only for fuzzy-matched entities.

Create action sets

To create an action set:

  1. Right-click the Action Sets node under an entity and select Add Action set. The Create Action Set wizard opens.

  2. In the Create New Action Set wizard, enter the following values:

    • Name: Internal name of the object.

    • Label: User-friendly label for this action that appears in the action menu.

  3. Select the Create Default Action to have the wizard seed default actions in the action set.

  4. Click Finish to close the wizard.

The Action Set editor opens, optionally with default actions created.

Add actions to action sets

To add new actions:

  1. In the Action Set editor, scroll down to the Actions table.

  2. Click the Add action Add Action button in the table toolbar.
    The Create New Action wizard opens.

  3. In the wizard:

    • Select a Stepper or a Workflow if you want to add data authoring actions. Note that stepper and workflow selections are mutually exclusive.

    • Select a Duplicate Manager if you want to add duplicate management actions.

    • Select the actions (Create, Edit, Import, etc). you want to add. Note that some actions may be unavailable if their requirements are not met.

  4. Click Finish to close the wizard.
    The selected actions are added to the action set.

  5. Use the Move Up and Move Down buttons to reorder the actions in the action set. The items in the action menu will appear in that order.

Action requirements

Actions are available under certain conditions:

  • Duplicate Management and Explain Record actions are not available for basic or ID-matched entities.

  • Delete is only available for entities with Delete Enabled

  • Copy is only available for entities with an ID Generation set to UUID or Sequence.

  • Authoring actions require that you select a stepper that is valid for the action:

    • Create: The root collection step must have one child step enabled on parent create.

    • Edit and Mass-Update: The root collection step must have one child step enabled on parent edit.

    • Import: The root collection step must enable child import on parent create.

    • Copy: The root collection step must enable child copy on parent edit.

Configure actions

To configure actions:

  1. In the Action Set editor, scroll down to the Actions table.

  2. Select an action in the table.

  3. In the Properties view, configure the action properties:

    • Name and Definition

      • Name, Label, and Description.

      • Required Role: Optionally select a role required to perform this action.

      • Icon: Icon representing the action in the menu.

    • In the Action Configuration tab, configure how the action should behave depending on the record selection:

      • Condition (available for Edit, Copy, Mass Update, Delete, and all duplicate management actions): the SemQL condition that must be met by all select records for this action to be available in the menu. Note that when a large number of records is selected (using Select All), the action is available in the menu and this condition is processed when the action is started.

      • Support Multiple Selection (available for Edit, Copy or Delete): Select this option to support this action when multiple records are selected.

      • Items Limit (available for Edit, Copy, Mass Update, Delete, and all duplicate management actions): Set the maximum number of records that can be processed by the action simultaneously. Above that limit, users will be prompted to confirm the action. Leave this property empty for no limit.

Configure data authoring actions

If configuring a data authoring action, in the Action Configuration tab, set the following properties:

  • Stepper/Workflow (only for authoring actions): Stepper or workflow used to perform the action.

  • Support Multiple Creation (available for Create): Select this option to support cyclic record creation.

  • Created Record Type (available for Create): Select the type of records that should be created. See Data authoring patterns for more information about master and golden data creation.

    • Golden Records creates new golden records that only exist in the MDM and are unrelated to source publishers.

    • Master Records (only for ID- and fuzzy-matched entities) creates master records on behalf of publishers. These records require that you provide the publisher, and they are matched and merged. They may be updated later on by records pushed by publishers with the same source ID.

  • Imported Record Type (available for Import): Select the type of records that should be handled by the import. See Data authoring patterns for more information about golden and master data import.

    • Golden Records imports new golden records or changes to existing golden records that only exist in the MDM. If importing golden data on a record consolidated from publishers, such an import is considered an override.

    • Master Records (only for ID and fuzzy matched entities) imports new or change existing master records on behalf of publishers. These records require that you provide the publisher, and they are matched and merged. They may be updated later on by records pushed by publishers with the same source ID.

  • Default Publisher (only for Import and Create): This option is available for an ID matched of a fuzzy-matched entity when importing or creating master records. This is the publisher on behalf of which the master records are imported or created by default.

  • Allow Other Publishers: (only for Import and Create): This option is available for an ID matched of a fuzzy-matched entity when importing or creating master records. It allows the user to select the publisher on behalf of which the records are created, or load the publisher from a column when importing.

  • Available For Golden Data (available for Mass-Update and Edit): Select this option to support this action when browsing golden data. See Data authoring patterns for more information about golden data authoring.

  • Available for Master Data (available for Mass-Update and Edit): Select this option to support this action when browsing master data. See Data authoring patterns for more information about master data authoring.

  • Available for Erroneous Data (available for Mass-Update and Edit): Select this option to support this action when browsing errors. See Data authoring patterns for more information about erroneous data authoring.

  • Import Mode (available for Import): Defines if records can be created and/or updated with the action:

    • Create and Update (default): Create and update records.

    • Create: Only create new records. Existing records cannot be updated with the action.

    • Update: Only update existing records. New records cannot be created with the action.

Configure duplicate management actions

If configuring a duplicate management action, in the Action Configuration tab, set the following properties:

  • Duplicate Manager (available for duplicate management actions): Duplicate Manager used to perform this action.

  • Enable Edit (available for Review and Confirm Duplicates, Merge or Split Duplicates and Review Duplicates Suggestions): Select this option to allow editing the values merged into the golden records while managing the duplicates.

  • Mandate Confirm All (available for Review and Confirm Duplicates): Select this option to force the user to confirm all the duplicates he has to review.

  • Mandate Resolve All Suggestion (available for Review Duplicates Suggestions): Select this option to force the user to confirm all the suggestions he has to review.

  • Prompt Golden ID (available for Review Duplicates Suggestions): Select this option to prompt the user for the surviving Golden ID when he merges two golden records while processing duplicates suggestion.

  • On Finish Job (available for Confirm Duplicates): Select the job to run when the duplicates confirmation is submitted. Note that if you leave this property empty, Semarchy xDM automatically generates a job for you.

Configure a delete actions

If configuring a delete action, in the Action Configuration tab, set the following properties:

  • Delete Type (available for Delete): Define the type of delete applied with this action. See Record deletion for more information.

  • Available For Golden Data: Select this option to support deleting golden data. See Record deletion for more information about golden data deletion.

  • Available for Master Data: Select this option to support deleting master data. See Record deletion for more information about master data deletion.

  • On Finish Job (available for Delete): Select the job to run when record deletion is submitted. Note that if you leave this property empty, Semarchy xDM automatically generates a job for you.

  • If configuring an explain record action, in the Action Configuration tab, set the following properties:

  • Display Card: Select the display card used to represent the records in the graph.

  • Form Tab: Select the form tab used to show the values of a record.

Once the action sets are created, you can use them in business views to start data management operations, possibly using steppers or workflows.