GetUnivDiscrepancy
Returns system-generated discrepancy information, if there is any, for the response. Use this function to query specific system-generated discrepancies.
Syntax
short int GetUnivDiscrepancy(ResponseId*response_identifier,
DiscInfo*return_discrepancy_info);
Parameters
response_identifier (in) The ResponseId definition containing the unique identifier for this response.
return_discrepancy_info (out) The DiscInfo containing the discrepancy information for this response.
Return Value
SUCCESS or FAILURE.
Comments
The response_identifier uniquely identifies the response that is being proceeded by the external system. Upon calling this function Oracle Clinical locates the response in its internal structure and gets the discrepancy information for this response into the input variables. The input variables, which are provided for holding the discrepancy information, should be allocated by the calling routine.
For existing documents, if a discrepancy has been previously added for this response, that information would be returned. The function returns FAILURE otherwise.
For new documents, if SetResponseData and/or SetUnivDiscrepancy has never been called for this response, the function returns FAILURE because no discrepancies exist. Otherwise, the discrepancy information created by the last SetResponseData and/or SetUnivDiscrepancy call would be returned. This applies also in the case of existing documents.
Error Messages
Table 7-23 Error Messages for GetUnivDiscrepancy
| Number | Severity | Message |
|---|---|---|
|
284900 |
ERR |
User does not have the privilege to call function in the current mode. |
|
285000 |
ERR |
Function called out of sequence. |
|
285900 |
ERR |
No current OCL database connection open. Use ConnectOCL to connect to OCL database. |
|
286600 |
ERR |
Audit reason required and not provided. |
|
286700 |
ERR |
Cannot locate the corresponding DCM question in the internal OCL buffers for the DCM question ID passed. |
|
286800 |
ERR |
No response in the internal buffers for the question. |
|
286900 |
ERR |
No existing univariate discrepancy for the question. |
|
287000 |
ERR |
DCM question and DCM question group combination does not exist in DCM. |
|
287100 |
ERR |
DCM question group does not exist in DCM. |
|
288000 |
ERR |
Repeat sn does not exist for DCM question group. |
Related Functions
InitializeRdcmResponses, SetResponseData, SetUnivDiscrepancy
Parent topic: Data Capture API Functions