GetManualDiscrepancy
Returns manual discrepancy information, if any, for the response. Manual discrepancies are also referred to as operator comments. Operator comments often consist of notes about data that appears to be incorrect even though Oracle Clinical has not flagged it for any potential errors. For example, an operator might add a comment that the handwriting for a data value must be reviewed by another person.
Syntax
short int GetManualDiscrepancy(ResponseId*response_identifier,
DiscInfo*return_discrepancy_info);
Parameters
response_identifier (in) contains the unique identifier for this response in a data structure of type ResponseId.
return_discrepancy_info (out) contains the manual discrepancy information for this response in a structure of type DiscInfo.
Return Value
SUCCESS or FAILURE.
Comments
The response_identifier uniquely identifies the response that is being processed by the external system. Upon calling this function Oracle Clinical locates the response in the database and places the manual discrepancy information for this response into the disc_info structure.
If this is an existing document, the buffers are populated with data from the database. If some manual discrepancy has been previously added for this response, that data would be returned. Otherwise NULL values would be used to populate the output structures.
If this is a new document, and SetManualDiscrepancy has never been called for this response, NULL values would be used to populate the input variable. Otherwise, the data from the last SetManualDiscrepancy call would be returned. This applies also in the case of existing documents.
Error Messages
Table 7-15 Error Messages for GetManualDiscrepancy
| 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. |
|
302700 |
ERR |
No existing manual discrepancy for the question. |
Related Functions
Parent topic: Data Capture API Functions