Description
Compare unique form fields with source values and verification flags.
Clinical research distinguishes supplied protocol metadata, participant/event records, allocation bookkeeping and an analysis target. A local count, permission flag or denominator choice can help reconcile records without establishing valid consent, randomization, regulatory compliance or a reliable treatment-effect estimate.
Compare unique form fields with source values and verification flags.
When to use this tool
Use Research Form Source Gap when checking the stated clinical-research record, allocation, timing, analysis or evidence-basis convention.
How to use the tool and how it works
- Enter fieldIds, formValues, sourceValues, sourceVerified. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read fields, valueMismatches, verifiedMatches. Use the output convention below.
Compare unique form fields with source values and verification flags. Require aligned arrays and unique fieldIds; count fields, literal value mismatches and matches whose sourceVerified flag is true.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| fieldIds | Field Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| formValues | Form Values | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| sourceValues | Source Values | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| sourceVerified | Supplied source-verification flags; the tool does not authenticate records. | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| fields | Fields | Required. Safe integer. |
| valueMismatches | Value Mismatches | Required. Safe integer. |
| verifiedMatches | Verified Matches | Required. Safe integer. |
{
"input": {
"fieldIds": [
"a",
"b"
],
"formValues": [
"1",
"2"
],
"sourceValues": [
"1",
"3"
],
"sourceVerified": [
true,
true
]
},
"output": {
"fields": 2,
"valueMismatches": 1,
"verifiedMatches": 1
}
}Limitations and assumptions
- Supplied matches and verification flags do not authenticate source documents, validate clinical data or establish regulatory compliance.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Use the complete approved protocol, authenticated source records and qualified clinical/statistical oversight for actual trial design, conduct and interpretation.
References
Similar or alternative tools
- Research Form Branch One Condition
Evaluate one supplied form-branch condition.
- Form Version Source Gap
Compare expected and actual form source/version labels.