SetManualDiscrepancy
Creates or updates manual discrepancy (operator comment) information for the response in the Oracle Clinical internal structure. This information includes the original comment and information about whether or not the issue has been resolved. If the issue has been resolved, the resolution is described. If unresolved, the new comment replaces the existing comment (which is retained in the DISCREPANCY_ENTRY_REVIEW_HIST table).
Syntax
short int SetManualDiscrepancy(ResponseId*response_identifier,
DiscInfo*discrepancy_info);
Parameters
response_identifier (in) The ResponseId definition containing the unique identifier for this response.
discrepancy_info (in) The DiscInfo definition containing the discrepancy information for this response.
Return Value
SUCCESS or FAILURE.
Comments
The response_identifier parameter uniquely identifies the response that is being processed by the external system. Upon calling SetManualDiscrepancy, Oracle Clinical locates the response in its internal structure and updates the manual discrepancy (operator comment) information for this response from the input variables provided for holding this information. These input variables should be allocated and initialized before calling the routine.
If the user has the privilege to create operator comments in browse mode and the document was fetched in locked mode, SetManualDiscrepancy may be invoked even in browse mode. In this respect it differs from other functions that set response and/or discrepancy values which may not be called in browse mode.
Error Messages
Table 7-31 Error Messages for SetManualDiscrepancy
| Number | Severity | Message |
|---|---|---|
|
284800 |
ERR |
Function not available in this mode. |
|
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. |
|
297000 |
ERR |
Null or invalid input pointers provided. |
|
302800 |
ERR |
Invalid discrepancy review status code. |
|
302900 |
ERR |
Invalid discrepancy resolution type code. |
|
303000 |
ERR |
Resolution type code cannot be null for RESOLVED review status. |
|
303100 |
ERR |
Resolution type code should be null if review status is not RESOLVED. |
|
312500 |
ERR |
Can not update repeating defaults when repeat sn is less than the maximum repeats expected for DCM question group. |
Related Functions
Parent topic: Data Capture API Functions