A verbatim is one free-text answer an investigator typed into the eCRF, waiting to be given a standardized term. Your job is to read each one, with the context around it, and assign the right code from the dictionary.
Everything you need is on this one screen. You never need access to the eCRF itself.
š Prerequisite: at least one mapping must exist in the study, otherwise the section reads Mappings need to be created to retrieve verbatims and there is nothing to work on. Ask your data manager.
On your role, Study add-ons > Medical Coding Coder. Access lets you see the verbatims and search the dictionary; Edit is what makes Apply code work. With Access alone the lookup and its results are visible but the button stays disabled.
Find your way around
Open your study, then Medical coding. Each mapping has its own tab, in alphabetical order, with the Mappings tab last. You land on the first mapping tab, not on the configuration.
Each tab offers two views:
Uncoded, your working queue, showing only what is left to do.
All, every verbatim whatever its status.
Both show the same columns: Verbatim, Code, Status, Subject, then one column per supporting item. Verbatim and Code stay visible while you scroll sideways. Rows are kept to a single line and truncated, so as many verbatims as possible fit on screen.
Clicking a verbatim opens a full-height side panel with the complete text, however long it is. The supporting items are listed there and open by default, because that is the context you need to choose a term. Subject, site, visit, form, item, mapping and dictionary sit in a collapsed section below.
š” Tip: four things about the queue that are easy to misread.
One verbatim per answer, never deduplicated. The same text reported by three subjects gives three verbatims, each with its own context, each coded on its own. That is deliberate.
Withdrawn and screen-failed subjects stay in the list. Their adverse events still have to be coded.
The list reflects the state at load time. A correction made in the eCRF while you were working appears after a reload or a tab switch.
Verbatims are sorted alphabetically and the order is fixed in this version. Filtering beyond the two views and re-sorting are not available yet, so the search bar, behind the filter icon, is how you narrow a long list. It searches the verbatim text of the current tab only.
Search the dictionary
The lookup sits next to the verbatim list and stays available whether or not a verbatim is selected. You can start from either end, depending on how you work.
Start from | What happens |
A verbatim | Click the verbatim text. Its details open and the search bar is pre-filled with that text, in the dictionary of its mapping. The search stays editable. |
The dictionary | Type in the lookup to find a term first, then pick the verbatim to attach it to. Only verbatims whose mapping uses that same dictionary can be selected. |
Searching MedDRA
MedDRA terms are organized in a hierarchy, from the Lowest Level Term (LLT) at the bottom up to the System Organ Class (SOC) at the top. You always pick an LLT, and every result is displayed with its full path, LLT to PT to HLT to HLGT to SOC, so you can check the branch before applying it.
The search matches LLTs only, so typing the name of a level above returns nothing. It works in contains mode, so partial words are enough and usually faster: ven recan proce finds Venous recanalization procedure.
Some terms sit under more than one branch of the hierarchy. All their paths are shown, color-coded blue for primary and white for secondary. The path you select is the one stored, and analyses group on it, so choose deliberately rather than taking the first row.
š” Tip: type a few partial words rather than the whole sentence. The search matches dictionary terms, not the investigator's phrasing, so severe headache since yesterday rarely matches anything, while headache does.
Apply a code
Selecting a result only pre-selects it. Nothing is attached to the verbatim until you click Apply code. You can select several results one after another, give each one an optional interpretation note explaining your choice, and apply them all in one go.
The status then turns Coded, and Datacapt stores the whole path along with the dictionary and its version, the mapping name, who coded it and when. The badge and the counts update straight away, and the row keeps its place in the list until the view is refreshed.
Removing a code is possible too. Removing the last one sends the verbatim back to Uncoded.
š” Tip: a verbatim can carry several codes, one per distinct medical concept. "Headache and vomiting" gets two. They all come from the mapping's dictionary and none takes precedence over the others. The verbatim stays a single row in the list whatever the number of codes.
ā ļø Warning: three things the system will refuse, and why.
A verbatim with no text cannot be coded. It needs text before a term can be attached to it.
If the answer changed in the eCRF while you were working on it, the assignment is refused and the verbatim keeps its current status. Reload to see the new text, then code it again.
The same code cannot be applied twice to one verbatim, not even reached through a different path. The duplicate is blocked as you select it.
Separately, only current MedDRA terms can be selected. Terms MedDRA has retired are excluded from the search, so an obsolete code cannot be assigned by accident.
Assigning and removing a code are both traced in the audit trail, with the previous and the new value.
What this version does not do yet
Coding stops at Coded. Review, approval and export of the codes come in a next iteration.
Blinded studies are out of scope for now.
No filtering beyond the two views, and no re-sorting. Use the search bar to narrow a long list.
šš» Next step
Set up medical coding for your study
Upload and manage medical dictionaries
What medical coding is, and how it works in Datacapt