Product Concept Structure & Examples
Structure Overview
Every product concept is made up of the same basic pieces. A product concept has many properties which will always be present, as well as some properties which may be null. Although many of the properties of a product concept are related directly to the products it represents, there are a few metadata fields which are more only indirectly related to products. Below is an example product concept, Tamoxifen citrate 10mg Oral Tablet. It has the unique identifier DBPC0104266.
{
"name": "Tamoxifen citrate 10 mg Oral Tablet",
"display_name": null,
"drugbank_pcid": "DBPC0104226",
"level": 5,
"brand": null,
"route": "Oral",
"form": "Tablet",
"strengths": "10 mg",
"ingredients": [
{
"name": "Tamoxifen as Tamoxifen citrate",
"drug": {
"name": "Tamoxifen",
"drugbank_id": "DB00675"
},
"exact_ingredient": {
"name": "Tamoxifen citrate",
"drugbank_id": "DBSALT000168"
},
"strength": {
"amount": "10.0",
"per": "1.0",
"units": "mg"
}
}
],
"standing": "active",
"standing_updated_at": "2018-09-12",
"standing_active_since": "1989-12-31",
"regions": {
"us": true,
"canada": false,
"eu": false
},
"rxnorm_concepts": [],
}Product Derived Fields
The fields in the table below are derived from directly from the products the product concept represents. When a field is present, the product concept will match only products with the same value in the corresponding product field.
| Field | Can be blank? | Description | Example |
|---|---|---|---|
| Brand | yes | The brand of the product concept | Advil |
| Route | yes | The route of the product | Oral |
| Form | yes | The form of the product | Tablet |
| Strength(s) | yes | The strength of each ingredient. | 10 mg |
| Ingredient(s) | no | The Drug form of the ingredients in the product concept. | DB00675 Tamoxifen |
| Exact Ingredient(s) | yes | The exact form in which each ingredient is found in the product concept. | DBSALT00168 Tamoxifen citrate |
Other fields
In addition to the fields listed in the table above, product concepts include additional information which is less directly related to products.
| Field | Can be blank? | Description | Example |
|---|---|---|---|
| Title | no | A description of the (exact) ingredients, brand, route, form and strength that make up the product concept. | Tamoxifen citrate 10 mg Oral Tablet |
| Display Name | yes | For branded product concepts, an alternative to the title which replaces ingredient names with the brand name. | Advil 5mg |
| DrugBank PCID | no | A unique, stable identifier for this product concept. | DBPC0104266 |
| Level | no | A number from 1 to 5 which indicates the number of product-derived properties which are set on the product concept. | 5 |
| Standing | no | One of "active", "inactive", or "archived". See the section below on standings. | active |
| Standing updated at | no | The last date on which the standing changed. | 2018-09-12 |
| Standing active since | no | The first date that any product matched by this product concept was available for marketing in its jurisdiction. | 2018-09-12 |
| Regions | no | For each region, true if there is a product in that region which is matched by this product concept. | |
| RxNorm Concepts | yes | Some concepts correspond to RxNorm concepts. For these, the RxNorm Concept name and unique identifiers are available. |
Standing
Under certain rare circumstances, a product concept which was linked to one or more products may no longer be linked to any. This could occur if a change is made in a drug product label (correcting an error, for example) or a formerly-linked product is removed from DrugBank (such as a homeopathic product which was mislabeled as non-homeopathic).
When all products are removed from a product concept, the product concept's standing is set to "inactive". After sufficient time has passed without the product concept being reconnected to any products, it will be marked as "archived".
Finally, if a product concept corresponds to an RxNorm Concept, it will not be marked as "inactive", even if it has no products. A product concept will remain active as long as it has products or matched RxNorm concepts.