RxClass Members¶
Retrieves the drug members of a specified RxClass from RxNorm services. Returns the full API payload as JSON plus two convenience lists containing the member RxCUIs and names. Handles empty inputs and API errors and reports a status message for downstream nodes.
Usage¶
Use this node when you have an RxClass identifier and want to enumerate the drugs that belong to that class. Typical workflow: search or look up a class (e.g., via RxClass Search/Info), pass its class_id and the desired classification system (e.g., ATC) here, then feed the returned member RxCUIs or names into further analysis or filtering nodes.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| class_id | True | STRING | The RxClass identifier for the class whose members you want to retrieve. | 100 |
| class_system | True | CHOICE | The classification source/relationship system to query. Must be one of the supported RxClass source relations (e.g., ATC, ATCPROD, CDC, DAILYMED, FDASPL, FMTSME, MEDRT, RXNORM, SNOMEDCT, VA). | ATC |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| class_members | STRING | JSON string of the full response including the class_id and the data payload returned by RxNorm for the class members. | {"class_id":"100","data":{"drugMemberGroup":{"drugMember":[...]}}} |
| members_rxcui | STRING | JSON-encoded array of RxCUIs extracted from the member list for quick downstream use. | ["198211","617314","617318"] |
| members_name | STRING | JSON-encoded array of member drug names corresponding to the RxCUIs. | ["lisinopril","enalapril","ramipril"] |
| status | STRING | Human-readable status message indicating success or the error encountered. | Successfully retrieved RxClass members for class ID 100 |
Important Notes¶
- Input validation: If class_id is empty or whitespace, the node returns empty payloads and an error status.
- Classification system: class_system must be a supported RxClass relationship source (e.g., ATC, MEDRT, RXNORM). Using an unsupported value may return an API error.
- Output formats: All outputs are strings. class_members is a JSON string of an object; members_rxcui and members_name are JSON-encoded arrays as strings.
- Partial or empty results: If a class has no drug members, members_rxcui and members_name will be empty arrays (as JSON strings).
- Error propagation: On API error, class_members contains the error payload as JSON, and status includes an 'API Error:' message.
Troubleshooting¶
- Empty outputs with error status: Ensure class_id is provided and not blank.
- API Error in status: Verify class_system is one of the supported sources (e.g., ATC, ATCPROD, CDC, DAILYMED, FDASPL, FMTSME, MEDRT, RXNORM, SNOMEDCT, VA) and that the class_id exists for that system.
- members_rxcui or members_name are empty: The specified class may legitimately have no members for the chosen system. Try a different class_system or confirm the class_id.
- Downstream parsing issues: Remember members_rxcui and members_name are JSON strings; parse them as arrays before further processing if your workflow expects list types.