UML 2.6 RTF Avatar
  1. OMG Issue

UMLR — Lack of clarity about meaning of package shapes containing elements with fully qualified names

  • Key: UMLR-159
  • Legacy Issue Number: 13466
  • Status: open  
  • Source: Model Driven Solutions ( Mr. Steve Cook)
  • Summary:

    The UML specification is not clear what it means for an element with a fully qualified name to appear within a package shape on a package diagram.

    7.3.37 says “The members of the package may be shown within the large rectangle”. So it seems to rest on the definition of members, which is the union of owned members and imported members.

    This is somewhat reinforced by “elements that become available for use in an importing package through a package import or element import may have a distinct color or be dimmed to indicate that they cannot be modified”. Note that the definition of ElementImport says “identifies an element in another package, and allows the element to be referenced using its name without a qualifier”. So we’d expect imported elements to be dimmed, but not have a name qualification (a poor user experience if I may say so).

    Subsidiary issue: Why does it say that they cannot be modified? This is a matter for tool implementers, and has no place in the UML spec.

    But elsewhere it says “The public contents of a package are always accessible outside the package through the use of qualified names”;

    So how should I interpret the appearance of an element shape within a package shape when the element has its fully-qualified name (as frequently appears in the UML spec itself)? Does this imply the existence of an import or not? According to “The public contents of a package are always accessible outside the package through the use of qualified names” no import is necessary; according to “The members of the package may be shown within the large rectangle” an import is necessary. At the very least this should be clarified.

    More deeply perhaps the issue is that the definition of the term “referencing an element” is very dubious. Does appearing on a diagram involve referencing? How about appearing in tool windows, type pickers, etc?

  • Reported: UML 2.5 — Mon, 9 Feb 2009 05:00 GMT
  • Updated: Fri, 6 Mar 2015 20:57 GMT