Multiple Vocabulary Facility Avatar
  1. OMG Specification

Multiple Vocabulary Facility — All Issues

  • Acronym: MVF
  • Issues Count: 25
  • Description: All Issues
Open Closed All
All Issues

Issues Summary

Key Issue Reported Fixed Disposition Status
MVF11-13 The restriction on MVF Element stating that it can only have one textual name is overly constrained MVF 1.0 open
MVF11-11 Need an extension in the terminology science ontology for numeric ordering MVF 1.0b2 open
MVF11-10 Incorrect label on mvf-tsc;TermFormation MVF 1.0 open
MVF11-9 In the mapping ontology between SKOS-XL and MVF, the mappings need adjustment MVF 1.0b2 open
MVF11-8 Consider adding more contextual properties to vocabulary entry MVF 1.0b2 open
MVF11-6 Include a note to explain the use of generalization and context between MVFEntries MVF 1.0b2 open
MVF11-12 The mapping from SKOS Concept to MVF Entry may need further review MVF 1.0b2 open
MVF-21 Property 'currentMVFEntry' changes the multiplicity, so it should be redefines not subsets MVF 1.0b1 MVF 1.0 Deferred closed
MVF11-3 Property 'currentMVFEntry' changes the multiplicity, so it should be redefines not subsets MVF 1.0b1 open
COMMONS12-5 Several properties in the quantities and units ontology are overly constrained MVF 1.0b2 open
COMMONS12-3 The quantities and units ontology is missing the concept of a measurement reference MVF 1.0b2 open
MVF11-7 Additional mapping capabilities between MVF entries would be useful MVF 1.0b2 open
MVF-12 The MVF ontology is missing the class "MVFElement" MVF 1.0a1 MVF 1.0 Resolved closed
MVF-1 The property, isRelatedTo, on which the MVF ontology depends has been removed from Commons and must be re-created in the MVF ontology MVF 1.0a1 MVF 1.0 Resolved closed
MVF-2 The property, hasMVFEntry, is used too broadly in the MVF ontology MVF 1.0a1 MVF 1.0 Resolved closed
MVF-4 Need a profile for the MVF metamodel in order to better integrate with various other UML profiles and tools MVF 1.0b1 MVF 1.0 Resolved closed
MVF-7 UML Profile for MVF MVF 1.0a1 MVF 1.0 Duplicate or Merged closed
MVF-15 anyURI should not be a class MVF 1.0a1 MVF 1.0 Resolved closed
MVF-6 Clarify uri vs refrence vs externalReference MVF 1.0b1 MVF 1.0 Resolved closed
MVF-3 More examples are needed to demonstrate how to use MVF MVF 1.0a1 MVF 1.0 Deferred closed
MVF-8 The published XMI should be generated as Canonical XMI MVF 1.0a1 MVF 1.0 Deferred closed
MVF-5 XMI document is missing class "MVFEntry" MVF 1.0a1 MVF 1.0 Resolved closed
MVF11-4 The MVF ontology does not reflect the addition of a descriptive reference property MVF 1.0 open
MVF11-2 The published XMI should be generated as Canonical XMI MVF 1.0a1 open
MVF11-1 More examples are needed to demonstrate how to use MVF MVF 1.0a1 open

Issues Descriptions

The restriction on MVF Element stating that it can only have one textual name is overly constrained

  • Key: MVF11-13
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    MVF element is the parent class of both MVF entry and vocabulary entry. A given term, which is a vocabulary entry may be used in various ways, and in some cases may have multiple textual names. This isn't common, but does happen in practice, especially in cases involving legacy data.

    One case we have found on the IDMP-O project is that there are two sources for the same term. The European Medicines Agency publishes controlled vocabularies are specified in the EMA SPOR reference ontology (RMS). That ontology includes not only EMA SPOR controlled vocabularies but duplicates a subset of the controlled vocabularies from MEDdra (Medical Dictionary For Regulatory Activities). In the IDMP representation of various pharmaceutical products, both controlled vocabularies are required for use in the EU. Thus we have the EMA SPOR version of the MEDdra term and the actual MEDdra term, which we map to one another using owl:sameAs. That results in a logical inconsistency because we have more than one term name for the same term. We have similar issues with certain FDA controlled vocabularies, where they have identifiers specified in the GSRS and UNII repositories, that are actually the same identifier, thus resulting in two textual names for the same thing.

    There may be a requirement for some implementations to use a SHACL shape for this, but for information content, such as the specifications for certain substance names, simply relaxing the restriction from exactly one to some values from would provide the semantics we need.

  • Reported: MVF 1.0 — Tue, 23 Apr 2024 16:49 GMT
  • Updated: Wed, 24 Apr 2024 18:25 GMT

Need an extension in the terminology science ontology for numeric ordering

  • Key: MVF11-11
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    A numeric ordering is a kind of systematic ordering, with a couple of important attributes: (1) what the origin is – zero or one, typically, and (2) whether it is from low to high or high to low. Typically numeric orderings of collections use positive integers, but there could be other kinds of ordering that use, for example, alphabetical with numerals and/or distinctions by rank, such as A.1.1.

    There may also be utility in having the notion of 'position', such as a position in an ordered list, or position of a term in a text.

    We have not captured this clearly in the ontology and should.

  • Reported: MVF 1.0b2 — Thu, 7 Mar 2024 20:09 GMT
  • Updated: Fri, 12 Apr 2024 18:20 GMT

Incorrect label on mvf-tsc;TermFormation

  • Key: MVF11-10
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    The label in the terminology science ontology reads 'term harmonization' and should be 'term formation'.

    This issue affects only that ontology, not the documentation for it.

  • Reported: MVF 1.0 — Wed, 28 Feb 2024 19:11 GMT
  • Updated: Fri, 12 Apr 2024 18:20 GMT

In the mapping ontology between SKOS-XL and MVF, the mappings need adjustment

  • Key: MVF11-9
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    Currently we've mapped MVFEntry to SKOS Concept, and it should be Vocabulary Entry to SKOS Concept. Likewise, the mapping between MVF Concept System to ConceptSystem should be to Vocabulary in MVF.

  • Reported: MVF 1.0b2 — Fri, 19 Jan 2024 19:44 GMT
  • Updated: Fri, 12 Apr 2024 18:20 GMT

Consider adding more contextual properties to vocabulary entry

  • Key: MVF11-8
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    Investigate whether this should be on vocabulary, vocabulary entry, both, and/or possibly on a more general element as well.

    There may also be an impact on the ontology, depending on the resolution.

  • Reported: MVF 1.0b2 — Fri, 19 Jan 2024 19:36 GMT
  • Updated: Fri, 12 Apr 2024 18:19 GMT

Include a note to explain the use of generalization and context between MVFEntries

  • Key: MVF11-6
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    This represents a generalization as in UML or OWL, at the metamodel level rather than at the UML model level. This may be confusing to users and so an explanatory note is needed to help. Note that the ramifications of this are at the instance level - one instance of an MVF entry may be a generalization of another instance of an MVF entry.

    The same is true of the additional relationship, which is context, where notes and examples would also be helpful.

  • Reported: MVF 1.0b2 — Fri, 19 Jan 2024 19:15 GMT
  • Updated: Fri, 12 Apr 2024 18:19 GMT

The mapping from SKOS Concept to MVF Entry may need further review

  • Key: MVF11-12
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    While the definition of MVF entry and that of SKOS concept appear to be the same, there are differences in how SKOS is used. That may, in fact mean we should consider mapping to MVF Vocabulary Entry instead.

    Regardless, it would be useful to provide a discussion in the specification about the possibility, depending on the application.

  • Reported: MVF 1.0b2 — Fri, 8 Mar 2024 19:18 GMT
  • Updated: Fri, 8 Mar 2024 19:18 GMT

Property 'currentMVFEntry' changes the multiplicity, so it should be redefines not subsets

  • Key: MVF-21
  • Status: closed  
  • Source: Coventry University ( Mr. Stephen Powley)
  • Summary:

    The property 'currentMVFEntry' on the association ElementCurrentEntry changes the multiplicity from 0..* to 0..1, so it should be redefines not subsets (or the parent multiplicity needs to be changed)

  • Reported: MVF 1.0b1 — Wed, 7 Jun 2023 22:54 GMT
  • Disposition: Deferred — MVF 1.0
  • Disposition Summary:

    This Issue was not resolved in this Task Force and was automatically deferred to the next Task Force

  • Updated: Sat, 2 Mar 2024 23:59 GMT

Property 'currentMVFEntry' changes the multiplicity, so it should be redefines not subsets

  • Key: MVF11-3
  • Status: open  
  • Source: Coventry University ( Mr. Stephen Powley)
  • Summary:

    The property 'currentMVFEntry' on the association ElementCurrentEntry changes the multiplicity from 0..* to 0..1, so it should be redefines not subsets (or the parent multiplicity needs to be changed)

  • Reported: MVF 1.0b1 — Wed, 7 Jun 2023 22:54 GMT
  • Updated: Sat, 2 Mar 2024 23:58 GMT

Several properties in the quantities and units ontology are overly constrained

  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    One example of this is hasNumericValue. It is currently declared to be functional, but could be the parent property for several properties of some class. In this case, the resulting ontology could be logically inconsistent if the values are not the same (and even if they are, by coincidence, that's still a problem). Other properties that are also declared as functional should be reviewed for the same issue.

  • Reported: MVF 1.0b2 — Sun, 18 Feb 2024 02:25 GMT
  • Updated: Sun, 18 Feb 2024 02:25 GMT

The quantities and units ontology is missing the concept of a measurement reference

  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    This would assist in alignment with SysML v2, but more importantly allows alignment of some quantity value with a more general measurement reference rather than only a measurement unit, for representation of IU in pharma, for example.

  • Reported: MVF 1.0b2 — Tue, 13 Feb 2024 22:01 GMT
  • Updated: Thu, 15 Feb 2024 21:01 GMT

Additional mapping capabilities between MVF entries would be useful

  • Key: MVF11-7
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    This might be a new area of exploration, and could apply beyond MVF entries in the context of MVF.

    Currently the metamodel reflects SKOS-like relations such as broader and narrower, but more is needed for certain applications.

    It would be useful to have a non-normative annex demonstrating how one could do this as a starting point for MVF users.

  • Reported: MVF 1.0b2 — Fri, 19 Jan 2024 19:21 GMT
  • Updated: Fri, 9 Feb 2024 19:26 GMT

The MVF ontology is missing the class "MVFElement"


The property, isRelatedTo, on which the MVF ontology depends has been removed from Commons and must be re-created in the MVF ontology

  • Key: MVF-1
  • Status: closed  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    This is an object property that was eliminated from the commons collections ontology, so in order to maintain consistency, it needs to be moved to the MVF ontology.

  • Reported: MVF 1.0a1 — Thu, 1 Sep 2022 16:28 GMT
  • Disposition: Resolved — MVF 1.0
  • Disposition Summary:

    Eliminate the property, isRelatedTo, which contributes no semantics

    The original Multiple Vocabulary Facility used a property from the beta version of the Commons Ontology Library, 'isRelatedTo', as a means of structuring other properties. It was removed from Commons and based on FTF discussion, should be removed altogether from MVF as well.

  • Updated: Mon, 2 Oct 2023 12:57 GMT
  • Attachments:

The property, hasMVFEntry, is used too broadly in the MVF ontology

  • Key: MVF-2
  • Status: closed  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    hasMVFEntry is a property used to relate an element in any model to a corresponding MVF entry. It corresponds to the property ElementEntry in the metamodel. That property has a UML Element in its domain, which cannot be modeled in the ontology, but a note is needed on the property hasMVFEntry to state as much. It should only have one subproperty, corresponding to the property ElementCurrentEntry in the metamodel, however. The property relating a vocabulary entry to an MVF entry should be a separate property, and the narrower/broader properties should not be subproperties of hasMVFEntry.

  • Reported: MVF 1.0a1 — Fri, 13 Jan 2023 19:28 GMT
  • Disposition: Resolved — MVF 1.0
  • Disposition Summary:

    Limit the usage of hasMVFEntry to correspond to its usage in the metamodel

    The resolution to this issue unwinds some circularity in restrictions and clarifies the meaning of hasMVFEntry to better reflect the metamodel.

  • Updated: Mon, 2 Oct 2023 12:57 GMT
  • Attachments:

Need a profile for the MVF metamodel in order to better integrate with various other UML profiles and tools

  • Key: MVF-4
  • Status: closed  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    As a convenience for UML modelers or modelers using other profiles, a profile for MVF would allow UML tool users to apply MVF without requiring other changes to tools.

    This would require both the profile itself as a machine readable file and documentation for it in the MVF specification. An optional compliance point should be added to cover the new profile.

  • Reported: MVF 1.0b1 — Fri, 27 Jan 2023 19:32 GMT
  • Disposition: Resolved — MVF 1.0
  • Disposition Summary:

    Added profile with MVEntry and MVFEnabledElement stereotypes

    The proposed UML profile includes two stereotypes

    MFEntry applies to any Element. Adds a 'semanticReference' anyUri that can be used to link the UML element to an external semantic descriptor. Useful for those models that need the MVF 'concepts' but not the MVF 'terms'

    MVFEnabledElement also applies to any Element. Adds an 'mvfEntry' reference which can be used to associate an (instance of) MVFEntry, which in turn can be linked to the other MVF entities

    See the attached document, MVF Profiles.odt, for the revised text of this resolution. The new clause should be included in the document immediately following the clause specifying the metamodel.

  • Updated: Mon, 2 Oct 2023 12:57 GMT
  • Attachments:

UML Profile for MVF

  • Key: MVF-7
  • Status: closed  
  • Source: Mayo Clinic ( Dr. Davide Sottara)
  • Summary:

    From a usability standpoint,
    at the date this issue is raised, not all UML tools support MVF natively.
    In particular, the tools would miss the mvf:ElementEntry and mvf:CurrentElementEntry links from a mof:Element to an mvf:MVFEntry

    As a workaround, one could define a UML profile that provides the necessary associations

  • Reported: MVF 1.0a1 — Fri, 31 Mar 2023 18:47 GMT
  • Disposition: Duplicate or Merged — MVF 1.0
  • Disposition Summary:

    The UML Profile for MVF issue is a duplicate of MVF-4

    This issue should be closed to the resolution of MVF-4 as a consequence.

  • Updated: Mon, 2 Oct 2023 12:57 GMT

anyURI should not be a class

  • Key: MVF-15
  • Status: closed  
  • Source: Adaptive ( Mr. Pete Rivett)
  • Summary:

    It should be a PrimitiveType with an xsdType of anyURI

  • Reported: MVF 1.0a1 — Mon, 15 May 2023 20:43 GMT
  • Disposition: Resolved — MVF 1.0
  • Disposition Summary:

    anyURI should not be a class

    Revised the XMI to change anyURI from uml:Class to uml:PrimitiveType.

  • Updated: Mon, 2 Oct 2023 12:57 GMT
  • Attachments:

Clarify uri vs refrence vs externalReference

  • Key: MVF-6
  • Status: closed  
  • Source: Mayo Clinic ( Dr. Davide Sottara)
  • Summary:

    The terms may be confusing, and implementers may 'misplace' important pieces of information

    'uri' is meant to be an 'individual/instance' URI, that identifies the entity represented by the MVF element
    (e.g. an individual Community - mapped by a mvf:Community, or an individual Concept - mapped by a mvf:MVFEntry)

    'externalReference', which only applies to MVFEntry, may be better called 'semanticReference', and be exepcted to resolve to a definitional resource such as an ontology (class/expression)

    'reference' seems to hold more descriptive/informative links such as web pages or other web resources.
    Maybe it could be called 'descriptiveReference' - in contrast with 'semanticReference'?

  • Reported: MVF 1.0b1 — Fri, 31 Mar 2023 18:42 GMT
  • Disposition: Resolved — MVF 1.0
  • Disposition Summary:

    Rename properties as proposed

    Rename MVFEntry::externalReference to semanticReference
    Rename MVFElement::reference to descriptiveReference

    Update the metamodel and ontology diagrams and document text referencing these names, as given below in Revised Text.

  • Updated: Mon, 2 Oct 2023 12:57 GMT
  • Attachments:

More examples are needed to demonstrate how to use MVF

  • Key: MVF-3
  • Status: closed  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    There is an example in Annex B that is quite useful, but is not multilingual. Since we have said that MVF can be used to support multiple natural languages, we need at least one additional example to cover that use case. We might also include a broader example showing how to represent a general vocabulary in MVF, such as the AI PTF emerging vocabulary for artificial intelligence, to show how this can be done.

  • Reported: MVF 1.0a1 — Fri, 13 Jan 2023 19:35 GMT
  • Disposition: Deferred — MVF 1.0
  • Disposition Summary:

    More examples are needed to demonstrate how to use MVF

    This is more involved than the FTF wanted to address in the moment, We intend to add more examples in RTF.

  • Updated: Mon, 2 Oct 2023 12:57 GMT

The published XMI should be generated as Canonical XMI

  • Key: MVF-8
  • Status: closed  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    MVF users have requested that the form of the XMI that is provided as a part of the MVF specification be canonical XMI.

  • Reported: MVF 1.0a1 — Fri, 14 Apr 2023 18:18 GMT
  • Disposition: Deferred — MVF 1.0
  • Disposition Summary:

    The published XMI should be generated as Canonical XMI

    This issue cannot be addressed until the validator is revised to support canonical XMI.

  • Updated: Mon, 2 Oct 2023 12:57 GMT

XMI document is missing class "MVFEntry"

  • Key: MVF-5
  • Status: closed  
  • Source: Mayo Clinic ( Dr. Davide Sottara)
  • Summary:

    According to the UML diagram in the spec (page 15), there should be a root abstract class "MVFEntry"

    This class is missing from the XMI document posted on the OMG website, though the XMI contains (dangling) Generalization references

  • Reported: MVF 1.0a1 — Fri, 31 Mar 2023 18:29 GMT
  • Disposition: Resolved — MVF 1.0
  • Disposition Summary:

    Regenerate Clean XMI from the latest metamodel .mdzip

    This does not change the metamodel content as depicted in the previous diagram.

    There are no changes to the specification document or other artifacts.

  • Updated: Mon, 2 Oct 2023 12:57 GMT
  • Attachments:

The MVF ontology does not reflect the addition of a descriptive reference property

  • Key: MVF11-4
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    Just prior to publication of the FTF report, a new property was added to the metamodel called descriptiveReference. This property, which is quite useful, was not added to the ontology, however, and may eliminate the need for restrictions using the Commons is defined by (cmns-dsg;isDefinedBy) property on VocabularyEntry.

  • Reported: MVF 1.0 — Fri, 28 Jul 2023 18:51 GMT
  • Updated: Fri, 28 Jul 2023 18:51 GMT

The published XMI should be generated as Canonical XMI

  • Key: MVF11-2
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    MVF users have requested that the form of the XMI that is provided as a part of the MVF specification be canonical XMI.

  • Reported: MVF 1.0a1 — Fri, 14 Apr 2023 18:18 GMT
  • Updated: Thu, 13 Jul 2023 14:15 GMT

More examples are needed to demonstrate how to use MVF

  • Key: MVF11-1
  • Status: open  
  • Source: Thematix Partners LLC ( Mrs. Elisa F. Kendall)
  • Summary:

    There is an example in Annex B that is quite useful, but is not multilingual. Since we have said that MVF can be used to support multiple natural languages, we need at least one additional example to cover that use case. We might also include a broader example showing how to represent a general vocabulary in MVF, such as the AI PTF emerging vocabulary for artificial intelligence, to show how this can be done.

  • Reported: MVF 1.0a1 — Fri, 13 Jan 2023 19:35 GMT
  • Updated: Thu, 13 Jul 2023 14:15 GMT