Due to a ransomware attack, the wiki was reverted to a July 2022 version. . We apologize for the lack of a more recent valid backup.
Child pages
  • 2021-10-08 IISOMI Meeting Minutes

Date

Attendees

Apologies:

Agenda

  • Administrative
  • Discussion items in Wiki pages
  • Feature/condition
  • UML → YANG Mapping Tool update
    • O-RAN cooperation
  • Papyrus-Model2Doc further investigations?
  • Papyrus Releases
    • Consider a plan for convergence of ITU-T Q14/15, ONF Common IM and TAPI to 2020-06 (4.16) version
  • Private GitHub
  • Public GitHup
  • Gendoc Issues
    • Gendoc output for Interfaces, Operations, Associations, Abstractions
  • Agenda of next call
  • AOB

Discussion items

#

Time

Item

Who

Notes

15 minAdmin: Call planAll

 Leader: Nigel

 Leader: Scott (Not available: Andrea)

 Leader: Scott

 Leader: Kam (Not available: Andrea)

 Leader: Andrea (Not available: Martin)

 Leader: ? (Not available: Italo, Martin, Bernd)

210 min

Admin: IISOMI Action Items status

All

IISOMI Action Items review (every meeting)

Action items done

  • None

Refresh Action Items

  • Nigel Davis   Review proposal for "UML comments often include construct name formatted according to the UML guidelines. When the UML is converted to Yang the construct names are then incorrectly formatted." (in minutes 2021-07-30 IISOMI Meeting Minutes).
    • Current state: The Yang has UML formatted names in it. The user is required to simply deal with this. There have not been any specific complaints, but clearly the comments are confusing. It may be beneficial to add notes to the read-me or similar to explain the formatting transition.
      • "The 'description' text often includes names of properties, classes etc. that are in 'camel case' as opposed to 'hyphen-case' as used for yang labels. The names can be converted by simply ensuring the first letter is lower case and that any intermediate upper case letters are turned into lower case preceeded by a hyphen (e.g., HyphenCase → hyphen-case)."
  • Scott Mansfield   To take the gendoc examples from the guidelines and perform regression test. 
    • Work progressing
      • Scott Mansfield   To take the gendoc examples from the guidelines and perform regression test.
  • Scott Mansfield   To investigate why none of the <<cond>> is retrieved from the model.
    • Andrea indicated the had attempted to apply analogous rules to member-end to include other properties. Andrea tried various techniques to get client and supplier but with no success 
      • Probably need to review the UML metadata
    • Andrea was able to print the target string
      • Scott Mansfield   To investigate how to get client and server values for an abstraction.
  • Italo Busi  To verify and confirm that an "Extended composition" can also be used with Interfaces and Signals.
    • One extension class can be used to extend multiple base classes.
    • This is useful when considering Yang
    • Modeling guidelines force no operations in object classes and no attributes in interfaces
    • Italo discussed the ITU-T structure below

    • Bernd noted that there was no discussion on interfaces extending object classes. Bernd agreed that he would consider this during the update of guidelines.
    • Italo indicated that this is done by uses
    • Scott noted that the extension with notifications should be via an augment so an application could leave it out. if-feature may also be useful.
    • Italo noted that as the ITU-T usage is in the same model it is not an augment.

    • Nigel noted that the decision had been made to separate operations from object classes as the target was intent based interactions where there is no direct operation on an object. Bernd also noted that there is a to separate static and dynamic.
    • Italo noted that signal should also be considered
    • It was agreed that interface and signal could both extend object classes but object classes cannot extend signal or interface.
      • Bernd Zeuner  Update modeling guidelines with "interface and signal can both extend object classes but object classes cannot extend signal or interface."
  • Bernd Zeuner  Draft an example Wiki page that capture an discussion item
    • Bernd explained a discussion items page

    • The minute taker should copy the text from the minute into relevant pages of the wiki

  • Scott asked why we are not using Jira
  • Does ONF have a Jira license.
  • Scott also noted that there was a discussion on use of github for git issues.
  • If we need a better action tracking system, we should use Jira.
  • It was agreed that the current technique leaves the actions smeared and repeated across the minutes.
  • Use of git may be problematic as we have multiple repositories.
    • Nigel Davis determine whether ONF can create IISOMI Jira.
315 minDiscussion items in GitHub Issues

Bernd proposed to capture the discussion items in GitHub Issues than in the IISOMI Meeting Minutes and just provide a link to the GitHubIssue in the minutes. This prevents that the same discussion minutes appear many times in the minutes. Two draft Issues are contained in https://github.com/samans/iisomi-private/issues/1 and https://github.com/samans/iisomi-private/issues/2 and have been presented at the meeting.

At the discussion it was pointed out that

  • a private repository is not the appropriate place for the items since not everyone has access to this
  • the ONF GitHub is publicly available but not all participants are allowed to contribute to it
  • there is no single ONF repository which could host such Issues; IISOMI is spread over many repositories
  • it might be possible to cover the discussions in Wiki pages
  • new discussions should be captured in the Meeting Minutes and then copied to the Wiki pages
  • Bernd Zeuner  Draft an example Wiki page that capture an discussion item
3
Feature/condition

https://github.com/samans/iisomi-private/issues/1

Andrea highlighted the need to use yang feature/condition capabilities. MEF are planning on introducing updates to TAPI to allow isolation of specific MEF relevant parts.

There was a brief related non-IISOMI discussion on interworking between ONF TAPI and MEF.

There is a need for tooling support.

September 24, October 1: No discussion

410 minExtended composition in UML (including object classes and interfaces)

https://github.com/samans/iisomi-private/issues/2

Not discussed. Defer to next call

September 7, 24: No discussion

October 1:

Agreement: Extended composition should also be available for Interfaces and Signals.

Question: Can one extension class (Class, Interface, Signal) extend more than one base class (Class, Interface, Signal)? → Yes

  • Italo Busi  To verify and confirm that an "Extended composition" can also be used with Interfaces and Signals.
510 min

Convention of UML property names in document/comment/description

September 7, 24: No discussion

October 1:

Mentioning of UML artefact names (UCC) in YANG descriptions creates problems.
E.g., TerminationPoint (object class) is converted in YANG to termination-point (statement) but if "TerminationPoint" appears in the related YANG description it is remains TerminationPoint.

Agreement: The Mapping Tool should convert also the artefact names within the descriptions to YANG style (i.e., kebab-case). The list of names to be converted in the descriptions is limited to the UML artefact names.

  • Bernd Zeuner  Update the Mapping Guidelines with a rule that artefact names within the descriptions should be converted to YANG style.
6
Papyrus-Model2Doc feature

May 142021-05-14 IISOMI Meeting notes  

Scott Mansfield presented the Model2Doc feature from Papyrus

  • still in pre-release state
  • need to install Model2Doc tool integrated into Eclipse 2021-03 (nightly build) and Papyrus 5.1 (nightly) and Model2Doc (0.8.0 nightly)
  • requires Java version greater than 11
  • creates Word files
  • need to check if Model2Doc provides at least the functionality of Gendoc
  • Gendoc does not work with newer Papyrus versions (see below)
  • Further investigation is required
  • Work continues to create a model2doc template that produces the same material as the gendoc template (class/attribute/datatype/stereotype etc.)

GenDoc no longer work with Eclipse Papyrus 2020-06. 

May 282021-05-28 IISOMI Meeting notes

...

September 7, 24, October 1: No discussion

7

Papyrus Releases

All

Consider a plan for convergence of ITU-T Q14/15, ONF Common IM and TAPI to 2020-06 (4.16) version

September 24: Reaffirmed the need to explore 2020-06 (4.16) release

October 1: No discussion

8

Private GitHub

Just for information; was not discussed October 1:

Scott Mansfield created reengineer-private Github repository and added the reengineered IEEE and IETF YANG models from Februrary 12, 2020 to it.
People interested can ask Scott Mansfield for the access.

9

Cleanup of the existing public GitHub (ONF EAGLE), rationalize the forks/branches

September 7: No discussion

September 24: Scott Mansfield clarifies that without the involvement of key folks with authority on Github no progress can be performed. No administrators appear for ONF EAGLE Github.

October 1: No discussion

10

GenDoc Issues

Gendoc output for Interfaces, Operations, Associations, Abstractions

How to dump endpoints of abstractions?

Italo Busi Dump of Realizations possible?
Andrea Mazzini Given that Interface Realizations are dumped as Abstractions, maybe this is valid also for Realizations.

Other Gendoc Issues

May 142021-05-14 IISOMI Meeting notes

  • GenDoc didn't generate constraint
  • GenDoc didn't generate the Interface definitions
  • GenDoc didn't generate the Type of pointed external (imported) classes
  • GenDoc OstigOTtpSource::txti:EByte multiplicity [64] is not generated correctly
  • AI (5/28/2021): Scott Mansfield to look at all GenDoc issues above and try to find solutions

May 28:  2021-05-28 IISOMI Meeting notes

  • Discussed possible output formats of interfaces/operations.

September 7, 24, October 1:  No discussion

1110 min

UML → YANG Mapping Tool

O-RAN cooperation

October 1:

O-RAN policy has changed collaboration rules. (O-RAN Alliance is registered in Germany)

12
Agenda of next callAll
  • Administrative
  • Discussion items in Wiki pages
  • Feature/condition
  • UML → YANG Mapping Tool update
    • O-RAN cooperation
  • Papyrus-Model2Doc further investigations?
  • Papyrus Releases
    • Consider a plan for convergence of ITU-T Q14/15, ONF Common IM and TAPI to 2020-06 (4.16) version
  • Private GitHub
  • Public GitHup
  • Gendoc Issues
    • Gendoc output for Interfaces, Operations, Associations, Abstractions
  • Agenda of next call
  • AOB

Action items

  •