The Evaluate Data Quality step allows you to evaluate the quality of the data used in jobs using the ArcGIS Validation Service's Evaluate operation. When the step runs, it evaluates the rules associated with the data source configured in the workflow diagram and identifies errors.
When the step is run, the following actions can be performed:
- The step can be cancelled by clicking Cancel.
Note:
If the step isn't optional, the step must be run before it can finish.
Configure the step
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- Drag Evaluate Data Quality from the Step Library panel to a connection arrow of a step on the workflow canvas.
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- In the Evaluation Type section, check the check boxes for the type of evaluation you want to perform.
- Validation Rules—Check features in a dataset based on specific requirements or constraints.
- Calculation Rules—Automatically populate attribute configurations for features.
- Topology Rules—Compare feature geometry against all topology rules defined in the source geodatabase.
- In the Data Sources section, choose one of the following options:
- All—Choose this option to evaluate all data sources configured in the workflow diagram.
- Select Sources—Choose this option and click Add Data Source to choose the data sources that you want to evaluate.
Tip:
To delete a data source, click the Delete button
.
- In the Data to Evaluate section, choose one of the following options:
- Job Location—Choose this option to only evaluate data in the defined job location.
- Entire Dataset—Choose this option to evaluate all data in the dataset.
- In the Version section, choose one of the following options:
- Job Version—Evaluate the job-specific version of the data.
- Default—Evaluate the default version of the data.
- Optionally, uncheck the Run as asynchronous job check box to run the evaluations sequentially.
- Optionally, check the Run on changes in version only check box to only run the evaluation on changes that are made to the job-specific version of the data.
- Click the Options tab.
- Configure Step Options as necessary.
- Manual—Run the step manually.
- Optional—Allow the step to be finished without being run.
- Automatic—Run the step as soon as it becomes active.
Note:
If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.
- Run on a Schedule—Run the step according to a schedule you set.
- Manual—Run the step manually.
- Optionally, provide help text for the step in the Step Help text box.
You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:
'For further assistance, please contact ' + jobCreator($job) + '.' - Optionally, click the Style tab to change the shape and color of the step.
- Optionally, click the About tab and provide a description for the step in the Step Description text box.
Note:
The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.
Return value
When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:
| Return values | Description |
|---|---|
| S000001 | The step completed successfully. |
F000001 | The step failed to complete successfully. |
Output value
When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table lists the step's output values:
| Output | Description | ArcGIS Arcade expression syntax |
|---|---|---|
| moment | Returns the date and time of the response. | jobOutputValue($job, '<step_id>', 'moment') |
errorsIdentified | Returns the number of errors identified. | jobOutputValue($job, '<step_id>', 'errorsIdentified') |
success | Returns true if the step completes successfully or false if the step fails to complete successfully. | jobOutputValue($job, '<step_id>', 'success') |