The ValidateDataSet Method transfers a dataset, complete when IsCompleteDataSet is True, to the underlying system and returns the result of the validation, i.e. verifying that the dataset is complete and can run in production.
When the ValidateDataSet Method is executed, the DataSet variable is not affected. If the validation is not passed, the identifiers of the datapoints that did not pass are provided with the ExecutionFeedback.
The validation of the DataSet normally occurs before the DataSet is required, i.e. while production is running and using a different dataset. As a matter of fact, the ValidateDataSet Method is used to validate a DataSet beforehand giving time to the higher-level systems in charge to correct mistakes. Thus the underlying system is required to provide all affordances to perform the validation without disrupting running production orders.
The signature of this Method is specified below. Table 48 specifies the Arguments representation.
Signature
ValidateDataSet (
[in] DataSetType DataSet,
[in] Boolean IsCompleteDataSet,
[out] DataSetEntryType[] FailedValidationEntries,
[out] MessageType[] FailedValidationMessages,
[out] MethodExecutionFeedbackTypeExecutionFeedback);
Table 48 – ValidateDataSet Method Arguments
Argument |
Description |
DataSet |
The dataset to be validated by the underlying system. |
IsCompleteDataSet |
When true, the DataSet argument is a complete dataset, meaning all DataSet entries are included. |
FailedValidationEntries |
The dataset items that failed the validation. |
FailedValidationMessages |
The detailed reasons the validation failed. |
ExecutionFeedback |
The extended feedback returning a detailed message in case of execution failure. |