Child pages
  • Augmentation Issues in uml2yang

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Problem Statement:
Adress how to map the UML «Specify» relationship into YANG-Augmentation

Table of Contents


2022-05-20 IISOMI Meeting Minutes

TR-514 discussion

  • Discussed the issue of the <Specify> guideline below Figure 5.30 in the current draft text of TR-514:
  • Discussion will continue in the July 1 IISOMI call.

2022-10-28 IISOMI Meeting Minutes

  • Regarding abstract/concrete of the extending class in the «Specify» relationship:
    Abstract classes are not mapped to YANG container/list. The Mapping Guidelines need to be corrected in some places.
    The target text in Figure 5.31 of the Modelling Guidelines need to be corrected.

2022-12-16 IISOMI Meeting Minutes

specify-augment.pptx has been corrected during the discussion and will be presented again in the next meeting.
Remaining question: Should the UML Modelling Guidelines allow concrete specification classes like TAPI is using it?

2023-01-06 IISOMI Meeting Minutes

Bernd represented his slides from 2022-12-16.

The current guidelines shows abstract classes (TopologyContext and CepList)

Only abstract extending classes are allowed

On the previous call Italo had explained that in the yang tapi-topology:topology-context should not be present (as marked below)

Discussion on whether the tool is parsing the path.

Noted that the tool was elimination the green text above (consistently)

AI: Scott Mansfield Need to test to determine whether the tool can construct the path with no content in specify.

Not clear if the tool analyses the string or parses the model structure or some hybrid.

After some discussion it was agreed that the current guidelines were actually not correct and the target should also not include TapiTopology:TopologyContext:_topology (as highlighted below) when the augmenting class is abstract.

Tapi currently augments with concrete classes. In this case the path element "TapiTopology:TopologyContext:_topology" should be included (as below).

The current guidelines do not cover the case of augmentation with a concrete class.

It was agreed that the guidelines should be updated to recommend augmentation with an abstract class but allow augmentation with a concrete class.

  •  Bernd Zeuner  Upload corrected slides to cover path without "TapiTopology:TopologyContext:_topology" in target string for augmentation with an abstract class.
  •  Bernd Zeuner  Update guidelines to match slide update and to cover allowance for augmentation with concrete class.

2023-01-20 IISOMI Meeting notes

Draft_TR-514_UML_Modeling_Guidelines_v1.3.04.docx (1/2023) and Draft_TR-531_UML-YANG_Mapping_Gdls_v1.1.03.docx (1/2023)

Updates presented by Bernd Zeuner.

  •  Italo Busi  Participants are asked to check the updated «Specify» associations.