RxClass Members¶
Retrieves the drug members of a specified RxClass. Given a class ID and a classification system/source, the node calls the RxNorm service to return the full member payload and also extracts parallel lists of member RxCUIs and names.
Usage¶
Use this node when you need to enumerate the drugs that belong to a specific RxClass (e.g., all members of an ATC class). It fits into workflows where you first identify or search for a class, then gather its member drugs for downstream analysis, filtering, or display.
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 system/source to query for class membership. Select from the provided options (e.g., ATC, MEDRT, RXNORM, SNOMEDCT, VA, etc.). | ATC |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| class_members | STRING | JSON string containing the full API response for members of the specified class, wrapped with the provided class_id. | { "class_id": "100", "data": { "drugMemberGroup": { "drugMember": [ { "minConcept": { "rxcui": "12345", "name": "ExampleDrug" } } ] } } } |
| members_rxcui | STRING | JSON-encoded array (as a string) of member RxCUIs extracted from the response. | ["12345", "67890"] |
| members_name | STRING | JSON-encoded array (as a string) of member drug names extracted from the response. | ["ExampleDrug", "AnotherDrug"] |
| status | STRING | Status message indicating success or describing the encountered error. | Successfully retrieved RxClass members for class ID 100 |
Important Notes¶
- Input validation: If class_id is empty or only whitespace, the node returns class_members = "{}", members_rxcui = "[]", members_name = "[]", and an error status.
- API errors: If the RxNorm service returns an error, class_members contains the error JSON, members_rxcui and members_name are "[]", and status includes the API error message.
- Output formats: members_rxcui and members_name are JSON-encoded arrays returned as strings. Parse them to arrays before further processing.
- Class system options: The class_system must be selected from the provided list of supported sources (e.g., ATC, ATCPROD, CDC, DAILYMED, FDASPL, FMTSME, MEDRT, RXNORM, SNOMEDCT, VA).
- Data shape: Member extraction relies on the presence of data.drugMemberGroup.drugMember[].minConcept.rxcui/name. If this structure is absent, members lists will be empty.
Troubleshooting¶
- Empty members with success status: The class may have no members in the selected class_system or the structure drugMemberGroup.drugMember is missing. Try a different class_system or verify the class_id.
- "Error: Class ID cannot be empty": Provide a non-empty class_id.
- API Error in status: The upstream RxNorm service returned an error. Check the class_id and class_system, wait and retry in case of transient issues, or switch to a different source.
- Members lists are strings: If downstream nodes expect arrays, parse members_rxcui and members_name from JSON strings into arrays first.
- Unexpected data fields: If the member fields differ (e.g., missing minConcept), confirm the class_system and the available fields for that source; behavior depends on the RxNorm API response.