Issue 18801: ActivityParameterNode notation (uml25-ftf) Source: No Magic, Inc. (Mr. Nerijus Jankevicius, nerijus(at)nomagic.com) Nature: Uncategorized Issue Severity: Summary: Customers are constantly asking for the ability to show parameter direction on ActivityParameterNode symbol. UML spec says: An ActivityParameterNode is notated as an ObjectNode, except that the full textual specification of the associated Parameter (see sub clause 9.4) may be used to label the ActivityParameterNode instead of the normal name/type label. However, I can't find Parameter BNF. Could you please help me to find/define a "standard" notation and don't you think it should be clarified in the spec? Resolution: Revised Text: Actions taken: July 4, 2013: received issue Discussion: End of Annotations:===== ted-NM: yes From: Nerijus Jankevicius Subject: ActivityParameterNode notation Date: Thu, 4 Jul 2013 17:36:10 +0300 To: Steve Cook , Ed Seidewitz , Conrad Bock , "" X-Mailer: Apple Mail (2.1085) X-Virus-Scanned: amavisd-new at omg.org Customers are constantly asking for the ability to show parameter direction on ActivityParameterNode symbol. UML spec says: An ActivityParameterNode is notated as an ObjectNode, except that the full textual specification of the associated Parameter (see sub clause 9.4) may be used to label the ActivityParameterNode instead of the normal name/type label. However, I can't find Parameter BNF. Could you please help me to find/define a "standard" notation and don't you think it should be clarified in the spec? Thanks, -- Nerijus Jankevicius SysML Product Manager OMG-Certified UML Professional No Magic Europe Savanoriu pr. 363, LT 49425 Kaunas, Lithuania P.O. box 2166, LT- 3000, Kaunas Phone: +370-37-324032 Fax: +370-37-320670 e-mail: nerijus@magicdraw.com WWW: http://www.magicdraw.com -- MagicDraw - UML made simple! X-Virus-Scanned: OK From: Ed Seidewitz To: Nerijus Jankevicius CC: Steve Cook , Conrad Bock , "" Subject: RE: ActivityParameterNode notation Thread-Topic: ActivityParameterNode notation Thread-Index: AQHOeMPW4940VBxjyUO4zaUPfrJI9JlUr2TA Date: Thu, 4 Jul 2013 16:10:48 +0000 Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [71.178.85.7] X-Virus-Scanned: amavisd-new at omg.org Nerijus . You.re right. The ability to use the .full textual specification of the associated Parameter. as the label of an ActivityParameterNode comes from UML 2.4.1, but I added the cross-reference in the UML 2.5 spec (there was no reference in the 2.4.1 spec). Subclause 9.4 is, indeed, where Parameter is first introduced, but under 9.4.4 Notation is says .There is no general notation for Parameter. Specific subclasses of BehavioralFeature define notation for their Parameters.. The only subclass of BehavioralFeature for which I can find that a .full textual specification. of parameters is defined is Operation. The BNF for is given within the BNF for the textual specification of an Operation in 9.6.4. I believe this is the .full textual specification. that was intended to be usable as an ActivityParameterNode, but this is certainly far from clear in the spec as it is. So, this should be an issue. -- Ed From: Nerijus Jankevicius [mailto:nerijus@nomagic.com] Sent: Thursday, July 04, 2013 10:36 AM To: Steve Cook; Ed Seidewitz; Conrad Bock; Subject: ActivityParameterNode notation Customers are constantly asking for the ability to show parameter direction on ActivityParameterNode symbol. UML spec says: An ActivityParameterNode is notated as an ObjectNode, except that the full textual specification of the associated Parameter (see sub clause 9.4) may be used to label the ActivityParameterNode instead of the normal name/type label. However, I can't find Parameter BNF. Could you please help me to find/define a "standard" notation and don't you think it should be clarified in the spec? Thanks, -- Nerijus Jankevicius SysML Product Manager OMG-Certified UML Professional No Magic Europe Savanoriu pr. 363, LT 49425 Kaunas, Lithuania P.O. box 2166, LT- 3000, Kaunas Phone: +370-37-324032 Fax: +370-37-320670 e-mail: nerijus@magicdraw.com WWW: http://www.magicdraw.com -- MagicDraw - UML made simple! X-Trusted-NM: yes Subject: Re: ActivityParameterNode notation From: Nerijus Jankevicius Date: Tue, 9 Jul 2013 11:13:07 +0300 Cc: Steve Cook , Ed Seidewitz , Conrad Bock , "" To: Nerijus Jankevicius X-Mailer: Apple Mail (2.1085) X-Virus-Scanned: amavisd-new at omg.org Any response on this? What is the "full textual specification of the Parameter"? Is Parameter direction included? Is it optional? How Diagram Interchange deal with this? Thanks, Nerijus On Jul 4, 2013, at 5:36 PM, Nerijus Jankevicius wrote: Customers are constantly asking for the ability to show parameter direction on ActivityParameterNode symbol. UML spec says: An ActivityParameterNode is notated as an ObjectNode, except that the full textual specification of the associated Parameter (see sub clause 9.4) may be used to label the ActivityParameterNode instead of the normal name/type label. However, I can't find Parameter BNF. Could you please help me to find/define a "standard" notation and don't you think it should be clarified in the spec? Thanks, -- Nerijus Jankevicius SysML Product Manager OMG-Certified UML Professional No Magic Europe Savanoriu pr. 363, LT 49425 Kaunas, Lithuania P.O. box 2166, LT- 3000, Kaunas Phone: +370-37-324032 Fax: +370-37-320670 e-mail: nerijus@magicdraw.com WWW: http://www.magicdraw.com -- MagicDraw - UML made simple! X-Trusted-NM: yes Subject: Re: ActivityParameterNode notation From: Nerijus Jankevicius Date: Tue, 9 Jul 2013 15:50:53 +0300 Cc: "" To: "Bock, Conrad" X-Mailer: Apple Mail (2.1085) X-Virus-Scanned: amavisd-new at omg.org Conrad, Parameter is not subtype of a Property. Nerijus On Jul 9, 2013, at 2:54 PM, Bock, Conrad wrote: > Nerijus, > >> What is the "full textual specification of the Parameter"? > > It's given by the BNF in the notation subclause of Property > (9.5.4). > > Conrad > X-Virus-Scanned: OK From: Ed Seidewitz To: Nerijus Jankevicius CC: Steve Cook , Conrad Bock , "" Subject: RE: ActivityParameterNode notation Thread-Topic: ActivityParameterNode notation Thread-Index: AQHOfHwrLoKwJnnWPEi1xJM9W6Kh5plcTYZQ Date: Tue, 9 Jul 2013 12:53:14 +0000 Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [71.178.85.7] X-Virus-Scanned: amavisd-new at omg.org Nerijus . I believe I responded to this. -- Ed From: Nerijus Jankevicius [mailto:nerijus@nomagic.com] Sent: Tuesday, July 09, 2013 4:13 AM To: Nerijus Jankevicius Cc: Steve Cook; Ed Seidewitz; Conrad Bock; Subject: Re: ActivityParameterNode notation Any response on this? What is the "full textual specification of the Parameter"? Is Parameter direction included? Is it optional? How Diagram Interchange deal with this? Thanks, Nerijus On Jul 4, 2013, at 5:36 PM, Nerijus Jankevicius wrote: Customers are constantly asking for the ability to show parameter direction on ActivityParameterNode symbol. UML spec says: An ActivityParameterNode is notated as an ObjectNode, except that the full textual specification of the associated Parameter (see sub clause 9.4) may be used to label the ActivityParameterNode instead of the normal name/type label. However, I can't find Parameter BNF. Could you please help me to find/define a "standard" notation and don't you think it should be clarified in the spec? Thanks, -- Nerijus Jankevicius SysML Product Manager OMG-Certified UML Professional No Magic Europe Savanoriu pr. 363, LT 49425 Kaunas, Lithuania P.O. box 2166, LT- 3000, Kaunas Phone: +370-37-324032 Fax: +370-37-320670 e-mail: nerijus@magicdraw.com WWW: http://www.magicdraw.com -- MagicDraw - UML made simple! From: "Bock, Conrad" To: "" Date: Tue, 9 Jul 2013 10:32:01 -0400 Subject: RE: ActivityParameterNode notation Thread-Topic: ActivityParameterNode notation Thread-Index: Ac58ovXo7pubXKgcR9+MR+8UZ6nhRQAAW2Ng Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: acceptlanguage: en-US X-Virus-Scanned: amavisd-new at omg.org Nerijus, > Parameter is not subtype of a Property. Sorry, you're right, the intent was to use the BNF specified for parameter (seems like the spec could generalize from just parameters on operations). Conrad From: Steve Cook To: Ed Seidewitz , "Nerijus Jankevicius (nerijus@nomagic.com)" CC: "uml25-ftf@omg.org" Subject: RE: ActivityParameterNode notation Thread-Topic: ActivityParameterNode notation Thread-Index: AQHOeMPtjWSnhgoZXUCxrv0ARAPTYJlUsI8AgAekxACAABy8YA== Date: Tue, 9 Jul 2013 14:42:27 +0000 Accept-Language: en-GB, en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.166.18.102] X-Forefront-Antispam-Report: CIP:131.107.125.37;CTRY:US;IPV:CAL;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(69234005)(164054003)(377454003)(199002)(53474002)(189002)(252514010)(54316002)(16406001)(74706001)(71186001)(51856001)(4396001)(512954002)(81342001)(77096001)(55846006)(77982001)(49866001)(47446002)(47736001)(59766001)(74876001)(79102001)(74502001)(31966008)(16236675002)(56776001)(221733001)(76796001)(74662001)(81542001)(46102001)(20776003)(63696002)(69226001)(16601075003)(65816001)(50986001)(19300405004)(80022001)(54356001)(47976001)(53806001)(83072001)(76786001)(74366001)(56816003)(76482001)(33656001)(6806003)(15202345003);DIR:OUT;SFP:;SCL:1;SRVR:BN1BFFO11HUB021;H:TK5EX14HUBC104.redmond.corp.microsoft.com;CLIP:131.107.125.37;RD:InfoDomainNonexistent;A:1;MX:1;LANG:en; X-OriginatorOrg: microsoft.onmicrosoft.com X-O365ENT-EOP-Header: Message processed by - O365_ENT: Allow from ranges (Engineering ONLY) X-Forefront-PRVS: 0902222726 X-Virus-Scanned: amavisd-new at omg.org The statement .Specific subclasses of BehavioralFeature define notation for their Parameters. can only refer to Operation and Reception. Operation gives the notation in detail and Reception says .Receptions are shown in the receptions compartment using the same notation as for Operations with the keyword «signal».. So the notation should be moved up to Parameter. This would also help with the readability of the BNF for Operation, the complexity of which is the topic of another issue 17906. Juergen will raise an issue for this. Thanks -- Steve From: Ed Seidewitz [mailto:eseidewitz@ivarjacobson.com] Sent: 09 July 2013 13:54 To: Nerijus Jankevicius (nerijus@nomagic.com) Cc: uml25-ftf@omg.org Subject: FW: ActivityParameterNode notation Resend, FYI. From: Ed Seidewitz [mailto:eseidewitz@ivarjacobson.com] Sent: Thursday, July 04, 2013 12:11 PM To: Nerijus Jankevicius Cc: Steve Cook; Conrad Bock; Subject: RE: ActivityParameterNode notation Nerijus . You.re right. The ability to use the .full textual specification of the associated Parameter. as the label of an ActivityParameterNode comes from UML 2.4.1, but I added the cross-reference in the UML 2.5 spec (there was no reference in the 2.4.1 spec). Subclause 9.4 is, indeed, where Parameter is first introduced, but under 9.4.4 Notation is says .There is no general notation for Parameter. Specific subclasses of BehavioralFeature define notation for their Parameters.. The only subclass of BehavioralFeature for which I can find that a .full textual specification. of parameters is defined is Operation. The BNF for is given within the BNF for the textual specification of an Operation in 9.6.4. I believe this is the .full textual specification. that was intended to be usable as an ActivityParameterNode, but this is certainly far from clear in the spec as it is. So, this should be an issue. -- Ed From: Nerijus Jankevicius [mailto:nerijus@nomagic.com] Sent: Thursday, July 04, 2013 10:36 AM To: Steve Cook; Ed Seidewitz; Conrad Bock; Subject: ActivityParameterNode notation Customers are constantly asking for the ability to show parameter direction on ActivityParameterNode symbol. UML spec says: An ActivityParameterNode is notated as an ObjectNode, except that the full textual specification of the associated Parameter (see sub clause 9.4) may be used to label the ActivityParameterNode instead of the normal name/type label. However, I can't find Parameter BNF. Could you please help me to find/define a "standard" notation and don't you think it should be clarified in the spec? Thanks, -- Nerijus Jankevicius SysML Product Manager OMG-Certified UML Professional No Magic Europe Savanoriu pr. 363, LT 49425 Kaunas, Lithuania P.O. box 2166, LT- 3000, Kaunas Phone: +370-37-324032 Fax: +370-37-320670 e-mail: nerijus@magicdraw.com WWW: http://www.magicdraw.com -- MagicDraw - UML made simple!