sdaiValidateUniquenessBN

Note: This function can only be used with the EDMmodelChecker^ license key fully installed.
This operation validates the specified uniqueness rule. The scope for this validation will be the data model that holds the instance specified by the <instance> argument.
This operation is applicable only to application instances.
The model that holds the actual instance must be open before this operation can be successfully performed.
Related functions: sdaiValidateInstance , edmiValidateInstance , edmiValidateInstanceType , edmiValidateInstanceTypeBN , edmiValidateModel , edmiValidateModelBN .
Header:
#include "sdai.h"
Prototype:
SdaiLogical sdaiValidateUniquenessBN(SdaiAppInstance instance,
SdaiString ruleName);
Arguments:

instance

A numeric instanceID that uniquely identifies the instance of interest in the EDMdatabase^. This instanceID and the argument <ruleName> uniquely identifies the actual uniqueness rule in EDMdatabase^.
The instanceID also defines the data model to be validated for violation of the specified uniqueness rule <rule>.
The instanceID is defined by a sdaiCreateInstance or a sdaiCreateInstanceBN function.

ruleName

The name of the actual uniqueness rule. Uniqueness rule names are case insensitive.

Returns:
A SdaiLogical value that has the following value:
sdaiTRUE : No violation of the specified uniqueness rule..
sdaiFALSE: The specified uniqueness rule is violated in the actual model.
sdaiUNKNOWN: Use sdaiErrorQuery to check for error in operation.
EXAMPLE
SdaiAppInstance anInst;
SdaiLogical result;
. . .
result = sdaiValidateUniquenessBN (anInst, "Part_Identifier");
switch (result) {
case sdaiTRUE:
. . . /* No violation in operation */
break;
case sdaiFALSE:
. . . /* Violation detected */
break;
default:
. . . /* Unpredictable result */
break;
}
. . .