This wiki has undergone a migration to Confluence found Here
Difference between revisions of "Requirements-Value Set Conformance"
Jump to navigation
Jump to search
Line 94: | Line 94: | ||
| ''MIF'' | | ''MIF'' | ||
| mif-core-base.xsd/VocabularyValueSetBinding/@revisionFrequency | | mif-core-base.xsd/VocabularyValueSetBinding/@revisionFrequency | ||
+ | |} | ||
+ | |||
+ | |||
+ | {| border="2" cellspacing="0" cellpadding="3" width="600" | ||
+ | | '''Requirement''' | ||
+ | | When binding to value sets whose definition can change and/or which references code systems whose content can change, there's sometimes a need to lock the binding to a static set of codes "as the value set was" at a particular time. | ||
+ | |- | ||
+ | | ''Rationale'' | ||
+ | | Using valuesets whose resolution to an enumeration of codes is constantly changing value sets makes things more difficult for implementers and can cause interoperability issues as two applications rarely have exactly the same version of the value set and code systems at the same time. While sometimes this difficult is unavoidable, if it can be avoided, that is useful. Freezing the enumeration as of a particular time is the easiest way to fix the enumeration without having to explicitly list all of the codes (when there may be 100s or 1000s). | ||
+ | |- | ||
+ | | ''Methodology'' | ||
+ | | When a static binding date is specified, the value set versions and code system versions are set to be the "most recent available" as of that date, unless they are already hard-coded in the definition of the value set. | ||
+ | |- | ||
+ | | ''MIF'' | ||
+ | | mif-core-base.xsd/VocabularyValueSetBinding/@staticBindingDate | ||
|} | |} |
Revision as of 04:45, 26 November 2009
When defining the set of codes allowed for a given element there's actually more to do than just referencing the set of codes. There's also a question of defining the conformance expectations for how the referenced set of codes are expected to be used. I.e. Are implementations restricted to the set of codes specified, must they support all of the codes, etc.
Requirement | When identifying the set of codes associated with an element, there's a need to identify the total set of codes (Value Set) that are potentially allowed to be sent, regardless of whether all implementations will support all codes. |
Rationale |
|
MIF | mif-core-base.xsd/VocabularyValueSetBinding/baseValueSet |
Requirement | When defining a set of codes for use in a specification, there's a need to differentiate whether the set of codes (Value Set) is considered exhaustive (i.e. all codes must come from the specified value set) or as the base preferred set that must be used if an appropriate code is available. |
Rationale |
|
Methodology |
Coding Strength is a conformance assertion that indicates whether the base set of codes referenced represents the complete set of codes allowed to be used or whether the set of codes can be supplemented with local codes or original text in circumstances where the concept can't be appropriately represented with one of the codes in the approved set. Allowed values are:
|
MIF | mif-core-staticBase.xsd/VocabularyValueSetBinding/@codingStrength |
Requirement | When identifying the set of codes associated with an element, there's a need to know what subset of those (Value Set) must be fully supported by implementations. |
Rationale |
|
MIF | mif-core-base.xsd/VocabularyValueSetBinding/minimumValueSet |
Requirement | When defining a constraint on an existing set of vocabulary, there's a need to differentiate between codes that are not supported (those outside the base value set) and will likely raise an error if transmitted and those that simply won't be processed but will not result in an error. |
Rationale |
|
MIF | mif-core-base.xsd/VocabularyValueSetBinding/ignoredValueSet |
Requirement | There is a need to define re-usable "sets" of codes that can be referenced as part of bindings |
Rationale |
|
Methodology | Value Set |
Requirement | When defining support for a particular set of codes, there's a need for an implementer to know how frequently they're expected to keep up-to-date with changes to the set of codes |
Rationale |
|
Methodology | There are two categories of coded attributes:
|
MIF | mif-core-base.xsd/VocabularyValueSetBinding/@revisionFrequency |
Requirement | When binding to value sets whose definition can change and/or which references code systems whose content can change, there's sometimes a need to lock the binding to a static set of codes "as the value set was" at a particular time. |
Rationale | Using valuesets whose resolution to an enumeration of codes is constantly changing value sets makes things more difficult for implementers and can cause interoperability issues as two applications rarely have exactly the same version of the value set and code systems at the same time. While sometimes this difficult is unavoidable, if it can be avoided, that is useful. Freezing the enumeration as of a particular time is the easiest way to fix the enumeration without having to explicitly list all of the codes (when there may be 100s or 1000s). |
Methodology | When a static binding date is specified, the value set versions and code system versions are set to be the "most recent available" as of that date, unless they are already hard-coded in the definition of the value set. |
MIF | mif-core-base.xsd/VocabularyValueSetBinding/@staticBindingDate |