| 20 | | 2. '''Description/Definition''' -- sometimes this is missing or almost the same as the label. A good description is very helpful in clarifying the meaning of the RDL class. Search should be expanded to include the description as a future enhancement. |
| 21 | | |
| 22 | | 3. '''Note''' -- some RDL classes have a Note which can provide additional context. Sometimes this is just a supplemental Description. |
| 23 | | |
| 24 | | 4. '''Entity Type''' -- it is important to check that the class found is of the correct level and type. |
| 25 | | |
| 26 | | * '''Level''' -- the entity type must be the correct "level", i.e. individual, class, or class of class. Most commonly a class is being searched for, and inexperienced users will find a class of class and not realize that it is not what they need. For example INSTRUMENT CLASS. By convention classes of class normally have the word CLASS at the end of the label so that is a good first check. |
| 27 | | |
| 28 | | * '''Type''' -- if the RDL item is the correct level you should check that the type is correct. Unfortunately this requires a basic understanding of the Part 2 entity types. Sometimes the label and description seem like a perfect match but the type is not at all what is needed. For example, TAG NAME has a label, description, and note that indicate it is what we want as a class representing component tags. However, the entity type is DocumentDefinition so it can’t be used for that purpose. |
| 29 | | |
| 30 | | 5. '''Taxonomy''' -- a class should have specialization parents and children that make sense. The tools make it easy to browse this hierarchy. Browsing the taxonomy is also useful when a label search does not locate the desired result. You may be able to find a parent or child class and navigate to the desired class from there, or at least better understand what is there. Unfortunately sometimes the taxonomy is incomplete, or at least not what one would expect. |
| 31 | | |
| 32 | | 6. '''Classifications''' -- membership in a class could in some cases be a useful criterion. For example you might want to find classes with a particular provenance or certification. Unfortunately the current tools only show "upwards" classification, they show the classes that a class is a member of, but they don’t show the members of a class. This would be a simple enhancement. |
| 33 | | |
| 34 | | 7. '''Templates''' -- specialized templates are very useful for class identification and navigation. Right now this is of limited use because there are few templates in the reference data, but it should become increasingly valuable. But this does require the use of specialized templates or some alternate way of defining OIMs. |
