Flows

Flow Description

Apply data quality rules on data quality assessment

You can run a data quality assessment project to examine the quality of existing data.

You can do a data quality assessment, for example, if you:

  • Have implemented a change in the Data quality studio configuration and want to make sure existing data is in line with this change.
  • Have imported data without applying data quality policies.
  • Want to periodically check the quality level of your data.

As a data owner, you can review and process data quality assessment results. A data owner can be a:

  • General data owner who can review and process quality assessment results for all companies.
  • Company-specific data owner who can review and process quality assessment results only for an assigned company.

For each failed validation rule or duplicate check rule, a separate entry is created in the Quality assessment exceptions log.

The options you must review and solve quality assessment results depend on the origin of the found issues:

  • Validation rule not met.
  • Duplicate check finds possible duplicate records.

Manage data quality policy changes

With data quality policy change management, you can manage changes on your data quality policies and all related components. This includes all data quality policy details and components, like configurable lookups, web service configurations, data patterns, or duplicate checks.

Activate data quality policy change management in the Data quality studio parameters.

Changes to data quality policy details and related components are stored by data quality policy change set. Each data quality policy change set is stored as a file in the file storage folder as defined in the Data quality studio parameters.

You can use data quality policy change management to synchronize data quality policies between several D365 F&SCM environments. For change management, the file storage folder, as defined in the Data quality studio parameters, must be the same for all environments between which data quality policy change sets must be synchronized. So, the change set files are stored centrally and can be accessed by all applicable environments.
In Data Quality Studio, if change management is active, you:
  • Manage changes on data quality policy level only, including all data quality policy components and settings.
  • Must check out a data quality policy to make changes to the data quality policy or its components.
  • Must check in a data quality policy to make changes generally available for other environments.
  • Can restore a data quality policy change set or get the latest data quality policy change set.
This picture shows an example of a typical environment setup. For each environment, data quality policy change management is active, using the same Azure Storage Account and folder to store data quality policy change set files. In this case, the data quality policy is checked out on the Development environment, changes are made, and the data quality policy is checked in. Because the changes are required in the Acceptance environment, Get latest is done here.
You can use data quality policy change management, for example, for these scenarios:
  • Data quality policy changes: A change to a data quality policy component in an environment can be easily applied to other environments.
  • Issue solving: During testing, you can find and solve an issue in a data quality policy component in one environment. The solution to the issue can be easily applied to other environments.
  • Updates in the test environment: In a test environment, data quality policy components are often changed. Using data quality policy change sets, you make sure that changes are saved, and you can always restore a previous data quality policy change set.

Note:

Data quality policy versions and data quality policy change sets are separate but related entities.

A version represents a specific state of a data quality policy. A change set tracks and applies changes made to that policy.

For example:

To activate a specific data quality policy version:

  1. Check out the data quality policy.
  2. Activate the desired version.
  3. Check in the data quality policy to apply the active version through a change set.

The change set records the version activation as part of the data quality policy’s tracked changes.

Manage data quality policy changes - Advanced

Data quality policy change management offers several advanced options. For example, to solve issues related to data quality policy change sets.

Set up action rule conditions

For each action rule, you can set up conditions. The action rule is only applied if the conditions are met.

To define an action rule condition, you use a query. The action rule is applied only to the records that are found by the query.
You can use these types of queries:
  • Inquiry: Use the standard D365 F&SCM Inquiry (SysQueryForm) page to define the records to which the action rule applies. The inquiry only queries the table as defined for the action rule.
  • Dynamic query: Use a dynamic query to define the records to which the action rule applies. Before you can set up a condition with a dynamic query, set up the dynamic query to be applied. You can use a dynamic query, for example, to query other tables than the action rule table, to define table relations, and to have only one record returned.

Set up action rule of type Custom

Use action rules to set field values in D365 F&SCM.
To set a field value, you can use several action types. This topic explains how to set up an action rule of type Custom.

Use a custom action rule to set a field value using a custom class.
Before you can set up a custom action rule, ensure that the custom class is developed.
 

Set up action rule of type Data query

Use action rules to set field values in D365 F&SCM.
To set a field value, you can use several action types. This topic explains how to set up an action rule of type Data query.

Use a data query action rule to find a value using a query and set the found value in the target field of the action rule.
You can use these types of queries:
  • Inquiry: Use the standard D365 F&SCM Inquiry (SysQueryForm) page to define the query that is used to find the value to be set in the target field. The inquiry only queries the table as defined for the action rule.
  • Dynamic query: Use a dynamic query to define the query that is used to find the value to be set in the target field. Before you can set up an action rule with a dynamic query, set up the dynamic query to be applied. You can use a dynamic query, for example, to query other tables than the action rule table, to define table relations, and to have only one record or value returned.

Set up action rule of type Transformation list

Use action rules to set field values in D365 F&SCM.

To set a field value, you can use several action types. This topic explains how to set up an action rule of type Transformation list.
Use a transformation list action rule to find a value using a transformation list and set the found value in the target field of the action rule.
Before set up a transformation list action rule, set up the transformation list to be used.

Set up action rule of type Web service

Use action rules to set field values in D365 F&SCM.

To set a field value, you can use several action types. This topic explains how to set up an action rule of type Web service.
Use a web service action rule to get a field value from another internal or external source, using a web service, and set this value in the target field of the action rule.
Before you can set up a web service action rule, set up the web service to be used.

Set up action rules

Use action rules to set field values in a target field in D365 F&SCM.
To fill in data, you can use these action types:

  • Fixed value: Sets a pre-defined fixed value in the target field.
  • Data query: Uses an inquiry or dynamic query to find a value and set it in the target field.
  • Transformation list: Uses a transformation list to find a value and set it in the target field.
  • Number sequence: Uses a number sequence to set a value in the target field.
  • Web service: Uses a web service to get a field value from another internal or external source and set it in the target field.
  • Custom: Uses a custom action class to set the target field value.

For each action rule, you can set up conditions to define the data to which the rule applies.

Set up configurable lookup

You can set up a configurable lookup to define the possible options in a field.

You can define the possible options for a configurable lookup in these ways:

  • User defined list: Set up the desired options manually.
  • Dynamic query: Apply a dynamic query to define the desired options.
  • Web service: Use a web service to get the desired options.

To apply a configurable lookup, set up a validation rule of type Configurable lookup. You can use a configurable lookup on several validation rules.

This topic explains how to set up a configurable lookup.

Set up data quality policy versions

A data quality policy has one or more versions. A data quality policy version contains all elements of a data quality policy, except for the data quality policy header.
These data quality policy elements are version-specific:
  • Validation rule: Checks if the data is in line with the defined standards.
  • Duplicate check rule: Checks if the data doesn't already exist in the table.
  • Enrichment rule: Sets a value to complete or enrich data in the same table or in a related table.
  • Action rule: Sets a value to complete or enrich data in the same table.
  • Organization assignment: Defines to which organizations the data quality policy applies.
Element-specific setup:
  • For each rule, you can use conditions to define the data to which the rule applies.
  • For each validation rule, you can define a validation message that is shown if the validation rule is not met.
  • To define the organization association, you can use legal entities or an organization hierarchy.

Set up duplicate check

You can use duplicate check rules to check if data doesn't already exist in D365 F&SCM.

Before you can set up a duplicate check rule, set up the duplicate check to be applied.

You can apply these types of duplicate checks:

  • Basic matching: Checks which combination of table fields has duplicate values. So, the combination of field values must be unique in the table.
  • Fuzzy matching: Checks for duplicates applying fuzzy logic. A fuzzy duplicate check compares values from several fields. Based on the comparison, a duplicate score is calculated.

Set up duplicate check rule conditions

For each duplicate check rule, you can set up conditions. The duplicate check rule is only applied if the conditions are met.

To define a duplicate check rule condition, you use a query. The duplicate check rule is applied only to the records that are found by the query.
You can use these types of queries:
  • Inquiry: Use the standard D365 F&SCM Inquiry (SysQueryForm) page to define the records to which the duplicate check rule applies. The inquiry only queries the table as defined for the duplicate check rule.
  • Dynamic query: Use a dynamic query to define the records to which the duplicate check rule applies. Before you can set up a condition with a dynamic query, set up the dynamic query to be applied. You can use a dynamic query, for example, to query other tables than the duplicate check rule table, to define table relations, and to have only one record returned.
 

Set up duplicate check rules

Use a duplicate check rule to check if the data doesn't already exist in D365 F&SCM.

Before you can set up a duplicate check rule, set up the duplicate check to be applied.

You can apply these types of duplicate checks:

  • Basic matching: Checks which combination of table fields has duplicate values. So, the combination of field values must be unique in the table.
  • Fuzzy matching: Checks for duplicates applying fuzzy logic. A fuzzy duplicate check compares values from several fields. Based on the comparison, a duplicate score is calculated. You can start a duplicate check rule of type 'fuzzy matching' only manually. Therefore, define from which forms you can start duplicate checks of type 'Fuzzy matching'.

Set up dynamic queries

Use a dynamic query to find one or more records in the database. The found records are the input for further processing.

You can use a dynamic query on:

  • An enrichment rule of type Data query.
  • An action rule of type Data query.
  • A condition that is applied to a validation rule, duplicate check rule, or action rule.
  • A configurable lookup of type Dynamic query. You can apply the configurable lookup on a validation rule of type Configurable lookup.

To define a query range, you can use a function.

Set up enrichment rule conditions

For each enrichment rule, you can set up conditions. The enrichment rule is only applied if the conditions are met.

To define an enrichment rule condition, you use a query. The enrichment rule is applied only to the records that are found by the query.
You can use these types of queries:
  • Inquiry: Use the standard D365 F&SCM Inquiry (SysQueryForm) page to define the records to which the enrichment rule applies. The inquiry only queries the table as defined for the enrichment rule.
  • Dynamic query: Use a dynamic query to define the records to which the enrichment rule applies. Before you can set up a condition with a dynamic query, set up the dynamic query to be applied. You can use a dynamic query, for example, to query other tables than the enrichment rule table, to define table relations, and to have only one record returned.

Set up enrichment rule of type Custom

Use enrichment rules to set field values in D365 F&SCM.

To set a field value, you can use several value types. This topic explains how to set up an enrichment rule line of type Custom.

Use a custom enrichment rule line to set a field value using a custom class.

Before you can set up a custom enrichment rule line, ensure that the custom class is developed.

Set up enrichment rule of type Data query

Use enrichment rules to set field values in D365 F&SCM.
To set a field value, you can use several value types. This topic explains how to set up an enrichment rule line of type Data query.

Use a data query enrichment rule line to find a value using a query and set the found value in the target field of the enrichment rule line.

Use a dynamic query to define the query that is used to find the value to be set in the target field. Before you can set up an enrichment rule line with a dynamic query, set up the dynamic query to be applied. You can use a dynamic query, for example, to query other tables than the enrichment source rule table, to define table relations, and to have only one record or value returned.

Set up enrichment rule of type Enable/Disable

Use enrichment rules to set field values and behavior in D365 F&SCM.

To set a field value or behavior, you can use several value types. This topic explains how to set up an enrichment rule line of type Enable/Disable.

Use an Enable/Disable enrichment rule line to disable or enable a field based on the value of another field.

Usually, for an enrichment rule of type Enable/Disable, you apply:

  • The 'Source field modified' event.
  • A condition to define for which value of another a field is enabled or disabled.

Note:

  • For a specific field, you can only set up one enrichment rule line for each enrichment rule.
  • If you set up an enrichment rule with a line to disable a field, you must also set up an enrichment rule with a line to enable the field.

Example:

This example explains how you can apply an enrichment rule line of type Enable/Disable. As an example, the credit rating of a customer is used.

Credit ratingCredit limit (value)Credit limit (enabled/disabled?)
'Poor'Default set to '1000'Disabled
Other than 'Poor'Not setEnabled

For this example, three enrichment rules are required, each with an enrichment rule line on the Credit limit field:

Enrichment ruleEnrichment rule lineCondition
TableEventSource fieldTarget datasourceTarget fieldValue typeValueFormEnable field 
CustTableSource field modifiedCredit ratingCustTableCredit limitFixed value1000--Enrichment rule is applied only if the Credit rating field is set to 'Poor'.
CustTableSource field modifiedCredit ratingCustTableCredit limitEnable/Disable-CustTableNoEnrichment rule is applied only if the Credit rating field is set to 'Poor'.
CustTableSource field modifiedCredit ratingCustTableCredit limitEnable/Disable-CustTableYesEnrichment rule is applied only if the Credit rating field is set to another value than 'Poor'.

Set up enrichment rule of type Fixed value

Use enrichment rules to set field values in D365 F&SCM.

To set a field value, you can use several value types. This topic explains how to set up an enrichment rule line of type Fixed value.

Use a fixed value enrichment rule line to set a pre-defined fixed value in the target field of the enrichment rule line.

Set up enrichment rule of type Number sequence

Use enrichment rules to set field values in D365 F&SCM.

To set a field value, you can use several value types. This topic explains how to set up an enrichment rule line of type Number sequence.

Use a number sequence enrichment rule line to set the value of the target field of the enrichment rule line based on a number sequence.

Set up enrichment rule of type Transformation list

Use enrichment rules to set field values in D365 F&SCM.

To set a field value, you can use several value types. This topic explains how to set up an enrichment rule line of type 'Transformation list'.
Use a transformation list enrichment rule line to find a value using a transformation list and set the found value in the target field of the enrichment rule line.
Before you can set up a transformation list enrichment rule line, set up the transformation list to be used.
Note: You can set up an enrichment rule line of type 'Transformation list' only if the enrichment rule event is 'Source field modified'.

Set up enrichment rule of type Web service response

Use enrichment rules to set field values in D365 F&SCM.

To set a field value, you can use several value types. This topic explains how to set up an enrichment rule line of type Web service response.
Use a web service response enrichment rule line to get a field value from another internal or external source, using a web service, and set this value in the target field of the enrichment rule line.
Before you can set up a web service response enrichment rule line, set up the web service to be used.
Note: You can set up an enrichment rule line of type 'Web service response' only if the enrichment rule event is 'Source field modified' or 'Save record'.

Set up enrichment rules

Use enrichment rules to set field values in a target field in D365 F&SCM.
To fill in data, you can use these enrichment types:

  • Fixed value: Sets a pre-defined fixed value in the target field.
  • Data query: Uses an inquiry or dynamic query to find a value and set it in the target field.
  • Transformation list: Uses a transformation list to find a value and set it in the target field.
  • Number sequence: Uses a number sequence to set a value in the target field.
  • Web service: Uses a web service to get a field value from another internal or external source and set it in the target field.
  • Custom: Uses a custom action class to set the target field value.

For each enrichment rule, you can set up conditions to define the data to which the rule applies.

Note: You can only use enrichment rules if Data enrichment is turned on in the Data quality studio parameters, on the Enable data enrichment tab.

Set up organization assignment for Data quality policy

By default, a data quality policy version is applied to all organizations as defined in the current D365 F&SCM environment. If a data quality policy version must be applied only to specific organizations, set up the organization assignment.

You can apply a data quality policy version to (a part of) an organization hierarchy. Before you can do so, assign the desired organization hierarchy to the 'Data quality' organization hierarchy purpose.

Set up validation rule conditions

For each validation rule, you can set up conditions. The validation rule is only applied if the conditions are met.

To define a validation rule condition, you use a query. The validation rule is applied only to the records that are found by the query.
You can use these types of queries:
  • Inquiry: Use the standard D365 F&SCM Inquiry (SysQueryForm) page to define the records to which the validation rule applies. The inquiry only queries the table as defined for the validation rule.
  • Dynamic query: Use a dynamic query to define the records to which the validation rule applies. Before you can set up a condition with a dynamic query, set up the dynamic query to be applied. You can use a dynamic query, for example, to query other tables than the validation rule table, to define table relations, and to have only one record returned.

Set up validation rule of type Configurable lookup

Use validation rules to check if the data is in line with the defined standards.
To validate data, you can use several validation types. This topic explains how to set up the Configurable lookup validation type.

Use a configurable lookup validation to add a custom lookup to a field and to validate if the field value matches a value as defined by the configurable lookup.

Note: If the field, to which the configurable lookup is applied, already has a lookup, the configurable lookup overwrites the existing lookup.

Before you can set up a configurable lookup validation rule, set up the configurable lookup to be used.

For each validation rule, you can set up:
  • A validation message that is shown if the validation rule is not met.
  • Conditions to define the data to which the rule applies. For example, you can apply a configurable lookup based on the value of another field. So, depending on the value entered for the other field, a different configurable lookup is shown. To do so, set up a separate validation rule for each condition.

Set up validation rule of type Custom

Use validation rules to check if the data is in line with the defined standards.
To validate data, you can use several validation types. This topic explains how to set up the Custom validation type.
Use a custom validation to validate a field value using a custom validation class.
Before you can set up a custom validation rule, ensure that the custom validation class is developed.
For each validation rule, you can set up:
  • A validation message that is shown if the validation rule is not met.
  • Conditions to define the data to which the rule applies.

Set up validation rule of type Data pattern

Use validation rules to check if the data is in line with the defined standards.
To validate data, you can use several validation types. This flow explains how to set up the Data pattern validation type.

Use a data pattern validation to validate if a field value matches a defined pattern.
Before you can set up a data pattern validation rule, set up the data pattern to be applied.
For each validation rule, you can set up:
  • A validation message that is shown if the validation rule is not met.
  • Conditions to define the data to which the rule applies.

Set up validation rule of type Mandatory or Blank

Use validation rules to check if the data is in line with the defined standards.

To validate data, you can use several validation types. This topic explains how to set up validation rules of these types:

  • Mandatory: Makes it mandatory to fill the defined field.
  • Blank: Validates if no value is entered in a field.
For each validation rule, you can set up:
  • A validation message that is shown if the validation rule is not met.
  • Conditions to define the data to which the rule applies.

Set up validation rule of type Query

Use validation rules to check if the data is in line with the defined standards.
To validate data, you can use several validation types. This flow explains how to set up a validation rule of type 'Query'. 

Use a query validation rule to validate if an entered field value is allowed using a dynamic query. Using a dynamic query, you can validate the field value based on one or more field values in another table. 

Examples of validations where you can apply a query validation rule:

  • On creating a sales order, check if address information or contact information is defined for the selected customer. If no address or contact information is defined, the customer cannot be used on a sales order.

  • On the worker setup, for the worker position, a cost center can be defined in the 'Cost center' financial dimension. Validate if the defined cost center is active. If not active, a warning or error message is given for the worker.

  • On terminating an employee, check if positions are reporting to the employee. If positions are still reporting to the employee, you cannot terminate the employee.

Before you can set up a query validation rule, set up the dynamic query to be used.

For each validation rule, you can set up:
  • A validation message that is shown if the validation rule is not met.
  • Conditions to define the data to which the rule applies.

Set up validation rule of type Range expression

Use validation rules to check if the data is in line with the defined standards.
To validate data, you can use several validation types. This topic explains how to set up a validation rule of type Range expression.
Use a range expression validation rule to validate if a field value is within a defined range. To define a range expression, you can use a:
  • Fixed value or a range of values using the advanced query syntax.
  • Static method that defines the range. For example, you can use the SysQueryRangeUtil class to apply advanced date queries.
For each validation rule, you can set up:
  • A validation message that is shown if the validation rule is not met.
  • Conditions to define the data to which the rule applies.

Set up validation rule of type Web service

Use validation rules to check if the data is in line with the defined standards.
To validate data, you can use several validation types. This topic explains how to set up the Web service validation type.

Use a web service validation to validate if a field value matches a value in another internal or external source, using a web service.
Before you can set up a web service validation rule, set up the web service to be used.
For each validation rule, you can set up:
  • A validation message that is shown if the validation rule is not met.
  • Conditions to define the data to which the rule applies.

Set up validation rules

Use validation rules to check if the data is in line with the defined standards.

To validate data, you can use these validation types:
  • Mandatory: Makes it mandatory to fill a field.
  • Blank: Validates if no value is entered in a field.
  • Range expression: Validates if a field value is within a defined range.
  • Data pattern: Validates if a field value matches a data pattern.
  • Web service: Validates if a field value matches a value in another internal or external source, using a web service.
  • Configurable lookup: Adds a custom lookup to a field and validates if the field value matches a value as defined by the configurable lookup.
  • Custom: Validates a field value using a custom validation class.

Set up web service configuration

You can set up data quality policy rules that use a web service.

You can use a web service:

  • Validation rule to validate if a field value matches a value in another internal or external source, using a web service.
  • Enrichment rule to get a field value from another internal or external source, using a web service, and set this value in the target field of the enrichment rule.
  • Action rule to get a field value from another internal or external source, using a web service, and set this value in the target field of the enrichment rule.
Before you can set up a web service rule, set up the web service configuration to be used.

Provide feedback