Date   

Statement of Use for the OSLC Core Version 3.0 PS 02

François-Régis Jaunatre <frjaunatre@...>
 

Dear OSLC Members,

 

SodiusWillert is pleased to provide the following statement of use to the OASIS OSLC Open Project specifications.

 

SodiusWillert has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with independent implementations from other implementors including IBM and Siemens. These OSLC domain specifications support Change, Requirement, Quality, and Architecture Management. This was implemented in:

  • OSLC Connect for Jira: a native Jira plugin which enables end-to-end traceability of real-time data across IBM ELM (including DOORS Classic, DOORS Next, Test Management and Workflow Management), PTC Windchill, Siemens Polarion and SECollab. This product supports the OSLC Tracked Resource Set publication and OSLC Configuration Management specification.
  • OSLC Connect for Windchill: a PTC Windchill plugin which enables end-to-end traceability across IBM ELM (including DOORS Classic, DOORS Next, Test Management and Workflow Management) and, Atlassian Jira. This product supports the OSLC Tracked Resource Set publication and OSLC Configuration Management specification.
  • SECollab: an intuitive and powerful web-based review platform that federates engineering design, requirement, and change data across the entire project lifecycle, which enables traceability to IBM EWM and Atlassian Jira.

 

Best regards, Sincères salutations,

François-Régis Jaunatre
OSLC Lab
34, Boulevard du Maréchal Alphonse Juin, 44100 Nantes, France
Ph: +33 (0) 2 28 23 55 23 |
sodiuswillert.com

Check out OSLC Connect for Jira & OSLC Connect for Windchill

 


Re: Statement of Use for the OSLC Query Version 3.0 PS 01

Martin Törngren <martint@...>
 

Thank you Andrii,

I am also pleased to approve the following proposed statement.

 

Best regards
Martin

 

 

From: Andrii Berezovskyi <andriib@...>
Sent: den 24 april 2021 20:40
To: Martin Törngren <martint@...>
Cc: oslc-op@...
Subject: Statement of Use for the OSLC Query Version 3.0 PS 01

 

Dear Martin,

 

Would you kindly approve the following Statement as well, please?

 

KTH Royal Institute of Technology has successfully implemented the OSLC Query Version 3.0 Project Specification 01 (https://docs.oasis-open-projects.org/oslc-op/query/v3.0/ps01/oslc-query.html dated 01 October 2020), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

Best regards,
Andrew

 


Re: Implementation of OSLC Query Version 3.0

Andrii Berezovskyi
 

Dear Axel,

I would like to deeply thank you and Koneksys for continued investment in the OSLC community and helping to move the OSLC Query Version 3.0 specification forward!

–Andrew

On 2021-04-16, at 23:03, Axel Reichwein <axel.reichwein@...> wrote:

Koneksys has successfully implemented the OSLC Query Version 3.0 Project Specification 01 (https://docs.oasis-open-projects.org/oslc-op/query/v3.0/ps01/oslc-query.html dated 01 October 2020), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

Best regards,
Axel Reichwein


Re: Soliciting Statements of Use for Core 3.0 PS 02

Andrii Berezovskyi
 

Thank you, Martin!

–Andrew

On 2021-04-24, at 20:33, Martin Törngren <martint@...> wrote:

Thank you Andrii,
I am pleased to approve the proposed statement.
 
Mvh - Best regards - Cordiali saluti - Aloha
/Martin Törngren
Professor and Center Director, Division of Mechatronics, Dept. of Machine Design,
School of Industrial Engineering and Management, KTH Royal Institute of Technology
 
 
 
From: Andrii Berezovskyi <andriib@...> 
Sent: den 23 april 2021 01:10
To: Martin Törngren <martint@...>
Cc: oslc-op@...
Subject: Fwd: [oslc-op] Soliciting Statements of Use for Core 3.0 PS 02
 
Dear Martin,
 
Would you please kindly approve sending the following statement from the KTH side to OASIS:
 
KTH Royal Institute of Technology has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.
 
Best regard,
Andrew



Statement of Use for the OSLC Query Version 3.0 PS 01

Andrii Berezovskyi
 

Dear Martin,

Would you kindly approve the following Statement as well, please?

KTH Royal Institute of Technology has successfully implemented the OSLC Query Version 3.0 Project Specification 01 (https://docs.oasis-open-projects.org/oslc-op/query/v3.0/ps01/oslc-query.html dated 01 October 2020), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

Best regards,
Andrew


Re: Soliciting Statements of Use for Core 3.0 PS 02

Martin Törngren <martint@...>
 

Thank you Andrii,

I am pleased to approve the proposed statement.

 

Mvh - Best regards - Cordiali saluti - Aloha

/Martin Törngren

Professor and Center Director, Division of Mechatronics, Dept. of Machine Design,

School of Industrial Engineering and Management, KTH Royal Institute of Technology

ICES: www.ices.kth.se

TECoSA: www.tecosa.center.kth.se

Personal page www.kth.se/profile/martint

Visiting address: https://www.kth.se/en/itm/inst/mmk/kontakt

 

 

 

From: Andrii Berezovskyi <andriib@...>
Sent: den 23 april 2021 01:10
To: Martin Törngren <martint@...>
Cc: oslc-op@...
Subject: Fwd: [oslc-op] Soliciting Statements of Use for Core 3.0 PS 02

 

Dear Martin,

 

Would you please kindly approve sending the following statement from the KTH side to OASIS:

 

KTH Royal Institute of Technology has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

 

Best regard,
Andrew



Begin forwarded message:

 

From: Andrii Berezovskyi <andriib@...>

Subject: Re: [oslc-op] Soliciting Statements of Use for Core 3.0 PS 02

Date: 23 April 2021 at 01:08:10 CEST

To: "oslc-op@..." <oslc-op@...>, Andrii Berezovskyi <andriib@...>

 

Dear OSLC OP contributors,

 

We have all the necessary votes and the ballot will be closed today. I now kindly ask the implementers to send in their Statements of Use for the OSLC Core Version 3.0 Project Specification 02. Please find the template below

 

%Company% has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

 

--
Cheers,
Andrew



On 2021-04-02 , at 16:03, Andrii Berezovskyi <andriib@...> wrote:

 

Dear OSLC members,

 

We just started the publication process for Core 3.0 PS02. We need your statements of use to be submitted again. You should not submit them before the vote is concluded, but you can already inspect the ZIP of the package for the new version of the spec (proposed) and prepare your statements and get your management to approve them in the meantime.

 

Core 3.0 PS 02 highlights:

 

  • /.well-known/oslc/ URI prefix is now registered with IANA
    • Bootstrap section of the spec now suggests providing OSLC SP Catalog and/or Jazz RootServices resources under standard URIs for even easier bootstrapping.
  • OSLC-Core-Version header is now registered with IANA and ABNF has been defined for it.
    • Versioning expectations from Core 2.0 and Core 3.0 PS 01 were merged and clarified
  • OSLC Error support was enhanced (nested errors + identifiers)
  • Recommendation to follow CSP best practices for OSLC Delegated dialogs was added.
  • Recommendation for OSLC Servers to follow CORS best practices to allow browser based OSLC clients without unexpected errors.
  • All shapes gathered on a single page in addition to the parts where they were originally defined.
  • Broken and outdated references updated, e.g., to WHATWG HTML Living Standard.
  • Other non-breaking improvements and clarifications

 

All changes listed under https://github.com/oslc-op/oslc-specs/milestone/25?closed=1. No breaking MUST clauses were added compared to Core 2.0. We expect all conformant Core 2.0 servers to conform to Core 3.0 PS 02 (proposed) without changes.

 

Proposed template (you are free to add more text, e.g., describing product features its OSLC capabilities):

 

%Company% has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

 

Thank you for your efforts! We will send the actual request soliciting these SoUs to be submitted to this mailing list after the vote is concluded.

 

--

–Andrew.

 


The ballot to approve OSLC Core Version 3.0 as Project Specification 02 has passed

Chet Ensign
 

Members of the OSLC OP,

The Special Majority ballot to approve OSLC Core Version 3.0 as Project Specification 02 has closed and passed. You can find the ballot result at https://lists.oasis-open-projects.org/g/oslc-op-pgb/message/133.

TC Administration will now publish the Project Specification and announce it. TC Admin JIRA ticket https://issues.oasis-open.org/browse/TCADMIN-3968 has been opened to manage this work.

We'll let you know when the PS is ready. Please let me know if you have any questions and congratulations on reaching this milestone.

/chet

--

Chet Ensign

Chief Technical Community Steward

OASIS Open

   
+1 201-341-1393
chet.ensign@...
www.oasis-open.org


Soliciting Statements of Use for Core 3.0 PS 02

Andrii Berezovskyi
 

Dear Martin,

Would you please kindly approve sending the following statement from the KTH side to OASIS:

KTH Royal Institute of Technology has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

Best regard,
Andrew

Begin forwarded message:

From: Andrii Berezovskyi <andriib@...>
Subject: Re: [oslc-op] Soliciting Statements of Use for Core 3.0 PS 02
Date: 23 April 2021 at 01:08:10 CEST
To: "oslc-op@..." <oslc-op@...>, Andrii Berezovskyi <andriib@...>

Dear OSLC OP contributors,

We have all the necessary votes and the ballot will be closed today. I now kindly ask the implementers to send in their Statements of Use for the OSLC Core Version 3.0 Project Specification 02. Please find the template below

%Company% has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

--
Cheers,
Andrew

On 2021-04-02 , at 16:03, Andrii Berezovskyi <andriib@...> wrote:

Dear OSLC members,
 
We just started the publication process for Core 3.0 PS02. We need your statements of use to be submitted again. You should not submit them before the vote is concluded, but you can already inspect the ZIP of the package for the new version of the spec (proposed) and prepare your statements and get your management to approve them in the meantime.
 
Core 3.0 PS 02 highlights:
 
  • /.well-known/oslc/ URI prefix is now registered with IANA
    • Bootstrap section of the spec now suggests providing OSLC SP Catalog and/or Jazz RootServices resources under standard URIs for even easier bootstrapping.
  • OSLC-Core-Version header is now registered with IANA and ABNF has been defined for it.
    • Versioning expectations from Core 2.0 and Core 3.0 PS 01 were merged and clarified
  • OSLC Error support was enhanced (nested errors + identifiers)
  • Recommendation to follow CSP best practices for OSLC Delegated dialogs was added.
  • Recommendation for OSLC Servers to follow CORS best practices to allow browser based OSLC clients without unexpected errors.
  • All shapes gathered on a single page in addition to the parts where they were originally defined.
  • Broken and outdated references updated, e.g., to WHATWG HTML Living Standard.
  • Other non-breaking improvements and clarifications
 
All changes listed under https://github.com/oslc-op/oslc-specs/milestone/25?closed=1. No breaking MUST clauses were added compared to Core 2.0. We expect all conformant Core 2.0 servers to conform to Core 3.0 PS 02 (proposed) without changes.
 
Proposed template (you are free to add more text, e.g., describing product features its OSLC capabilities):
 
%Company% has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.
 
Thank you for your efforts! We will send the actual request soliciting these SoUs to be submitted to this mailing list after the vote is concluded.
 
--
–Andrew.


Re: Soliciting Statements of Use for Core 3.0 PS 02

Andrii Berezovskyi
 

Dear OSLC OP contributors,

We have all the necessary votes and the ballot will be closed today. I now kindly ask the implementers to send in their Statements of Use for the OSLC Core Version 3.0 Project Specification 02. Please find the template below

%Company% has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

--
Cheers,
Andrew

On 2021-04-02 , at 16:03, Andrii Berezovskyi <andriib@...> wrote:

Dear OSLC members,
 
We just started the publication process for Core 3.0 PS02. We need your statements of use to be submitted again. You should not submit them before the vote is concluded, but you can already inspect the ZIP of the package for the new version of the spec (proposed) and prepare your statements and get your management to approve them in the meantime.
 
Core 3.0 PS 02 highlights:
 
  • /.well-known/oslc/ URI prefix is now registered with IANA
    • Bootstrap section of the spec now suggests providing OSLC SP Catalog and/or Jazz RootServices resources under standard URIs for even easier bootstrapping.
  • OSLC-Core-Version header is now registered with IANA and ABNF has been defined for it.
    • Versioning expectations from Core 2.0 and Core 3.0 PS 01 were merged and clarified
  • OSLC Error support was enhanced (nested errors + identifiers)
  • Recommendation to follow CSP best practices for OSLC Delegated dialogs was added.
  • Recommendation for OSLC Servers to follow CORS best practices to allow browser based OSLC clients without unexpected errors.
  • All shapes gathered on a single page in addition to the parts where they were originally defined.
  • Broken and outdated references updated, e.g., to WHATWG HTML Living Standard.
  • Other non-breaking improvements and clarifications
 
All changes listed under https://github.com/oslc-op/oslc-specs/milestone/25?closed=1. No breaking MUST clauses were added compared to Core 2.0. We expect all conformant Core 2.0 servers to conform to Core 3.0 PS 02 (proposed) without changes.
 
Proposed template (you are free to add more text, e.g., describing product features its OSLC capabilities):
 
%Company% has successfully implemented the OSLC Core Version 3.0 Project Specification 02 (https://docs.oasis-open-projects.org/oslc-op/core/v3.0/ps02/oslc-core.html dated 23 April 2021), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.
 
Thank you for your efforts! We will send the actual request soliciting these SoUs to be submitted to this mailing list after the vote is concluded.
 
--
–Andrew.


Re: oslc-op Weekly Contributors Meeting - Thu, 04/22/2021 #cal-notice

Andrii Berezovskyi
 

On 2021-04-22 , at 16:00, oslc-op@... Calendar <noreply@...> wrote:

oslc-op Weekly Contributors Meeting

When:
Thursday, 22 April 2021
10:00am to 11:00am
(GMT-04:00) America/New York

Where:
https://meet.jit.si/oslc-op

Organizer:
jamsden@...

Description:
oslc-op contributors weekly telecon. 


One tap audio Dial In: +15124022718,,,,2979764690# (US) or +498938038719,,,,2979764690# (Germany) Looking for a different dial in number? Please see: https://meet.jit.si/static/dialInInfo.html?room=oslc-op
Meeting ID: 2979764690#
 

OASIS OSLC Open Project group home: https://lists.oasis-open-projects.org/g/oslc-op 
oslc-op GitHub Organization: https://github.com/oslc-op
Mailing list: oslc-op@... (archives: https://lists.oasis-open-projects.org/g/oslc-op)



oslc-op Weekly Contributors Meeting - Thu, 04/22/2021 #cal-notice

oslc-op@lists.oasis-open-projects.org Calendar <noreply@...>
 

oslc-op Weekly Contributors Meeting

When:
Thursday, 22 April 2021
10:00am to 11:00am
(GMT-04:00) America/New York

Where:
https://meet.jit.si/oslc-op

Organizer:
jamsden@...

Description:
oslc-op contributors weekly telecon. 


One tap audio Dial In: +15124022718,,,,2979764690# (US) or +498938038719,,,,2979764690# (Germany) Looking for a different dial in number? Please see: https://meet.jit.si/static/dialInInfo.html?room=oslc-op
Meeting ID: 2979764690#
 
The meeting minutes are edited in https://hackmd.io/@driib/oslc-op-minutes/edit
Previous minutes can be found under https://github.com/oslc-op/oslc-admin/tree/master/minutes/2019 

OASIS OSLC Open Project group home: https://lists.oasis-open-projects.org/g/oslc-op 
oslc-op GitHub Organization: https://github.com/oslc-op
Mailing list: oslc-op@... (archives: https://lists.oasis-open-projects.org/g/oslc-op)


Implementation of OSLC Query Version 3.0

Axel Reichwein
 

Koneksys has successfully implemented the OSLC Query Version 3.0 Project Specification 01 (https://docs.oasis-open-projects.org/oslc-op/query/v3.0/ps01/oslc-query.html dated 01 October 2020), in accordance with the conformance clauses defined in Section "Conformance" of the specification. This use of the specification includes interoperation with other similar independent implementations, as well as integration with tools supporting other OSLC domain specifications.

Best regards,
Axel Reichwein


Agenda item for next week - OSLC paging

David Honey1 <DavidHoney@...>
 

Please review the following issues in preparation for next week's OSLC-OP meeting:

Issue Title
https://github.com/oslc-op/oslc-specs/issues/169 OSLC Paging, splitting a resource across pages
https://github.com/oslc-op/oslc-specs/issues/170 Meaning of oslc.pageSize
https://github.com/oslc-op/oslc-specs/issues/159 Server response options to pageSize=value are too vague
https://github.com/oslc-op/oslc-specs/issues/136 Resources in the paged results are not ordered within a page


I'd like to start by discussing use cases where the current OSLC paging is inadequate. Use of OSLC query seems to provide the most complete coverage of potential requirements, but similar issues also relate to paging of containers such as LDPCs.

Potential requirements extracted and adapted from my comment of 11th May 2020 from the above issues:
  1.  A client performing a query shall be able to consume each paged response as a consistent and complete part of the whole query results:
    1. All the data to be displayed by a client for that page shall be available, including nested properties.
    2. The ordering of data across pages is well-defined so that a user can meaningfully navidate to the next page.
    3. The ordering of data within a page should be defined so that a client can present the data correctly ordered for that page.
  2. A client shall be able to consume a subset of paged responses and not be required to process all of them.
  3. A client shall be able to specify the number of primary items in a request for a page so that they have a defined set of items to display for that page.

Note that none of the above requirements are satisfied by current OSLC Core paging.
I'd like see the ability for a client to discover whether this enhanced paging support is available, apriori. For example, allow a server to provide additional meta data for each
oslc:QueryCapability.

Let's start the discussion in next week's OSLC OP meeting.

Best regards,
David


Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU


oslc-op Weekly Contributors Meeting - Thu, 04/15/2021 #cal-notice

oslc-op@lists.oasis-open-projects.org Calendar <noreply@...>
 

oslc-op Weekly Contributors Meeting

When:
Thursday, 15 April 2021
10:00am to 11:00am
(GMT-04:00) America/New York

Where:
https://meet.jit.si/oslc-op

Organizer:
jamsden@...

Description:
oslc-op contributors weekly telecon. 


One tap audio Dial In: +15124022718,,,,2979764690# (US) or +498938038719,,,,2979764690# (Germany) Looking for a different dial in number? Please see: https://meet.jit.si/static/dialInInfo.html?room=oslc-op
Meeting ID: 2979764690#
 
The meeting minutes are edited in https://hackmd.io/@driib/oslc-op-minutes/edit
Previous minutes can be found under https://github.com/oslc-op/oslc-admin/tree/master/minutes/2019 

OASIS OSLC Open Project group home: https://lists.oasis-open-projects.org/g/oslc-op 
oslc-op GitHub Organization: https://github.com/oslc-op
Mailing list: oslc-op@... (archives: https://lists.oasis-open-projects.org/g/oslc-op)


Re: OSLC specification for SysML v2

Jad El-Khoury
 

Hi

 

I updated the PSM now as agreed during our last meeting. There are 3 query parameters that remain to be defined for a complete table.

 

@all! In short, we agreed for now to simply provide this PSM table. We can then later discuss and decide if a OSLC SysML domain Specs is also relevant.

https://mms.openmbee.org/alfresco/mmsapp/mms.html#/projects/PROJECT-6b2e436d-1f8c-4b06-8cd9-a8f89df02bb5/master/documents/_18_5_3_64a0213_1551820456659_246715_17754/views/_19_0_2_16560409_1568974927815_802412_698

 

@Manas Bajaj! I will unfortunately not be able to attend the meeting on Thursday (Will be on sick leave towards end of the week) But am happy to organise a separate meeting earlier to discuss if necessary.

 

regards

______________________________

Jad El-khoury, PhD

KTH Royal Institute of Technology

School of Industrial Engineering and Management, Mechatronics Division

Brinellvägen 83, SE-100 44 Stockholm, Sweden

Phone: +46(0)8 790 6877 Mobile: +46(0)70 773 93 45

jad@..., www.kth.se

 

From: Jim Amsden <jamsden@...>
Sent: Thursday, 8 April 2021 15:03
To: oslc-op@...; Jad El-Khoury <jad@...>
Cc: Manas Bajaj <manas.bajaj@...>
Subject: Re: [oslc-op] OSLC specification for SysML v2

 

Jad,

The primary purpose of the PIM/PSM models is to separate the logical specification of a system from its implementation so that the two can evolve more independently. 

 

The PIM is suppose to represents the full functional definition of a system in terms that are independent of any particular implementation. In the case of the SysML v2 Services PIM, that should include a definition of all the functions provided including creating, accessing, updating, deleting searching, versioning, discovering, etc. SysML v5 model resources. The PIM is suppose to make it easier for someone who is trying to understand what the services are, separate from how they are implemented. 

 

The PSM is a model of an implementation technical architecture, the capabilities of some underlying system enabling it to support applications running in some execution environment. 

 

In MDA, a mapping between the PIM and PSM describes how the business functions of the PIM are implemented using that technical architecture in order to produce PIM instances capable of being deployed to and run in an execution environment (perhaps with some additional manual contribution). 

 

The goal is separation of concerns so the business logic and platform technical architecture can evolve separately, and by updating the transformation mapping, new application implementations can be created.

 

OSLC is a combination of a PIM expressed in RDF vocabularies and resource shapes (constraints) and REST services. Its a PIM, but not one that is expressed in UML. Lyo Designer captures mappings from the OSLC PIM to specific platform implementations PSMs through the generation of servers that adapt the capabilities of some existing system to provide OSLC services. 

 

For SysML Services, ideally what would happen is the current PIM would be extended to capture a UML representation of the OSLC services: discovery, delegated dialogs, resource preview, configuration management, query, the vocabularies, and the typical CRUD operations. That would provide a full UML representation of the capabilities.

 

Then different mappings could be created to translate that PIM into implementations specified by the SysML v2 REST Services API and the SysML v2 OSLC Services API - two similar, but different implementations. With suitable use of cardinalities in the PIM to indicate optional features, this would likely be possible.

 

But is it worth the effort? The current SysML v2 Services PIM appears to be a UML abstraction of the REST Services API as it has evolved. So there is a very close mapping between the two. This is good because the PIM is based on something that has been proven to be implementable and usable. 

 

Whether its worth it to extend the PIM to include OSLC capabilities depends on how we think SysML v2 will be used in practice, and how vendors will build tools to support that practice. Of course these two are co-dependent based on the interaction/gap between what customers demand and what vendors supply. 

 

But if you think SysML v2 models are wholly contained universes of discourse that would be supported by a choice of tools, then integration with other tools might not be that important to you. 

 

If on the other hand, you think SysML v2 models are representations of systems that are to be built and evolve over time, then OSLC integration with other lifecycle tools to support that evolution might be very important.

 

I had originally hoped that we would not create a situation where it was necessary to make a choice between these two views, that one could be build on the other by simply adding the lifecycle management capabilities. This is why I had hoped that the SysML REST Services API could be a minimal OSLC API - leveraging HTTP, REST, open-wold assumptions and RDF resource representations to provide a simple REST API that can be extended with other OSLC capabilities to support lifecycle tool integration, without creating yet another incompatable REST API. 

 

As this did not seem to be something everyone agreed with, we decided to take a more independent development approach which has resulted in the question about what to put in the PIM. If we should decide that OSLC services should be added to the PIM, I suspect it would be relatively easy to transform the OSLC REST services, and RDF vocabularies and constraints into an XMI representation of the corresponding UML model of those services. However, that opens some key questions:

 

1. What part of these extended PIM would the SysML v2 REST Services API be required to implement?

2. How would the existing PIM have to change because of incompatible representations of overlapping services such as configuration management and query?

3. What is the value proposition of having two overlapping but incompatible implementations of the the PIM?

 

I personally think there's little value in addressing these questions at this point. Rather I think the best thing to do is to provide a mapping between the current SysML v2 Services PIM to OSLC, and leave the specification of the rest of the OSLC services in OSLC. 

 

An effective way to do that would be to split the SysML v2 OSLC specification into two parts - the mapping from the existing PIM to OSLC REST API would be in the OMG spec, and the rest of the OSLC capabilities for SysML would be in an OASIS SysML v2 OSLC Domain Specification as you suggest.

 

Vendors and users will now have a choice on how they want to access their SysML v2 models. If they want simple REST services with JSON resource representations, then either API will provide that capability, although in incompatible ways. If they want lifecycle integration with other tools, then they can implement the OSLC SysML v2 Domain Specification. 

 

I think ultimately the success of SysML v2 will depend on the ability of systems engineers being able to create useful models of their systems, that can be built for and with reuse, that can integrate with systems and tools created by others, and can rapidly evolve to meet changing demands. So I think OSLC integration capabilities are a must and minimum for SysML v2 - we already know that from industry experience.

 

 

 



-----oslc-op@... wrote: -----

To: Manas Bajaj <manas.bajaj@...>, "Jim Amsden (jamsden@...)" <jamsden@...>
From: "Jad El-Khoury"
Sent by: oslc-op@...
Date: 04/07/2021 05:40PM
Cc: "OASIS OSLC Open Project (oslc-op@...)" <oslc-op@...>
Subject: [EXTERNAL] [oslc-op] OSLC specification for SysML v2

Hi Manas, @Jim! would of course appreciate your input in my thoughts below. This goes for the whole OSLC community as well. In our last discussions on the OSLC PSM, we concluded that I should give some explanations of certain OSLC concepts ZjQcmQRYFpfptBannerStart

This Message Is From an External Sender

This message came from outside your organization.

ZjQcmQRYFpfptBannerEnd

Hi Manas,

 

@Jim! would of course appreciate your input in my thoughts below. This goes for the whole OSLC community as well.

 

In our last discussions on the OSLC PSM, we concluded that I should give some explanations of certain OSLC concepts (such as discovery, Service Providers, etc). This was necessary to clarify the mapping to the PIM.

We also agreed that the Resource Shapes and Vocabulary Terms are a necessary part of the specification, and need to be published somehow.

I also started thinking how we can specify versioning/configuration in this mapping.

 

I am now coming to the realisation that maybe a specification based on such a mapping to the PIM is not so optimal after all for a useful OSLC specification.

 

Before I detail even more, what do you think if we instead work on an “SysML2 Domain Specification”, similar in structure – as an example - to the following for “Requirements Management”.

https://oslc-op.github.io/oslc-specs/specs/rm/requirements-management-spec.html

(Detail: will this be an OASIS OSLC specs, or an OMG Sysml2 spec? But let’s leave that for later)

 

A PSM-PIM mapping seems natural for the REST API, and will be very useful when implementing such an API for a SysML tool.

 

But for someone wanting to build an OSLC-compliant API, I am worried that the current format of an OSLC PSM will not be so complete, nor clear.

An OSLC integration may require OSLC-specific mechanisms that are currently not covered in the PIM. For example, Delegated UIs, Query and Discovery capabilities. Instead of (re)explaining such things in the PSM, the proposed Sysml Domain specification can be more strict in specifying them.

Note also that a core part of an OSLC Domain Specification is the Shapes and Vocabularies of the domain.  Such a specification can also better relate to other aspects such as Configuration Management.

 

From an OSLC integrator perspective, the language and structure of the Domain Spec would be a more familiar document. It (including the shapes) would contain all the needed information, given that it will be read in the context of OSLC Core.

So, I’m arguing that it would be more important that the OSLC specification is made consistent with other OSLC specifications for useful integrations with other tools.

 

 

One advantage of a common PIM for both the REST and OSLC APIs is that one can easily relate to both.

But practically, I am not sure about the purpose of this mapping. This may come at the cost of less clear and complete OSLC specification.

The REST and OSLC APIs won’t be compatible, nor integrate anyway. What is more important is that the OSLC API integrates with other OSLC-compliant tools.

 

regards

______________________________

Jad El-khoury, PhD

KTH Royal Institute of Technology

School of Industrial Engineering and Management, Mechatronics Division

Brinellvägen 83, SE-100 44 Stockholm, Sweden

Phone: +46(0)8 790 6877 Mobile: +46(0)70 773 93 45

jad@..., www.kth.se

 

 


TRS WD review

Jim Amsden
 

Its great to see progress on the TRS spec. Here's some notes I took in my initial review. I have yet to read the guidance.

The cutoff point in the change log identifies the point in the change log at which processing of change events by TRS clients can be cut off because the changes are already included in the base resources.



Other specs have had separate shapes and vocab documents. TRS has the shapes with the main document. What should TRS do?


TRS client/consumer isn't defined.


Access context is only referenced in the guidance. Should we factor out access control into a separate spec. It is somewhat unique to TRS because TRS exposes TRS Server resources to TRS Client resources in potentially different security domain.



Discovery section needs work. Defining a property, trs:trackedResourceSet without describing what it is a property of and how to access that resource doesn't seem very useful. We have references to rootservices in the discovery document. Might be useful to use that again here.


How is ldp:hasMemberRelation helpful? Do we need it?


Creation properties trs:changed should have description The resource that has been created. Seme for Modification and deletion events.


Why the overlap between modification adn creation events [cc-24] and [cc-25]? Seems confusing with no value.


How do we quantify "rapid succession". Are servers at liberty to decide it could be 3 days based on the expected change rate of their resources?


For cc-29, what is meant by "at some point" the server must provide the corrective action? How long can the gap be between inconsistency between the actual resources and what is represented in the base + change log?


For change log truncation - what do we mean by "a suitable point in the chain"? 


"TRS Servers should take care to handle clients that are currently processing the older Base and Change Log" is imprecise. The conformance clauses are actually the following bullets.




TRS 3.0 WD out for review!

Andrii Berezovskyi
 

Hello everyone,

 

Thanks to hard work by Nick, we have the first TRS 3.0 draft under the OP for your review: https://oslc-op.github.io/oslc-specs/specs/trs/tracked-resource-set.html

 

You are welcome to leave the feedback on the mailing list or through Github issues.

 

--

–Andrew.


Re: oslc-op Weekly Contributors Meeting - Thu, 04/08/2021 #cal-notice

Andrii Berezovskyi
 

Minutes: https://github.com/oslc-op/oslc-admin/blob/master/minutes/2021/2021-04-08.md

 

From: <oslc-op@...> on behalf of "oslc-op@... Calendar" <noreply@...>
Reply to: "oslc-op@..." <oslc-op@...>, "noreply@..." <noreply@...>
Date: Thursday, 8 April 2021, W14 at 16:00
To: "oslc-op@..." <oslc-op@...>
Subject: [oslc-op] oslc-op Weekly Contributors Meeting - Thu, 04/08/2021 #cal-notice

 

oslc-op Weekly Contributors Meeting

When:
Thursday, 8 April 2021
10:00am to 11:00am
(GMT-04:00) America/New York

Where:
https://meet.jit.si/oslc-op

Organizer:
jamsden@...

Description:
oslc-op contributors weekly telecon. 


One tap audio Dial In: +15124022718,,,,2979764690# (US) or +498938038719,,,,2979764690# (Germany) Looking for a different dial in number? Please see: https://meet.jit.si/static/dialInInfo.html?room=oslc-op

Meeting ID: 2979764690#

 

The meeting minutes are edited in https://hackmd.io/@driib/oslc-op-minutes/edit
Previous minutes can be found under https://github.com/oslc-op/oslc-admin/tree/master/minutes/2019 


OASIS OSLC Open Project group home: https://lists.oasis-open-projects.org/g/oslc-op 
oslc-op GitHub Organization: https://github.com/oslc-op
Mailing list: oslc-op@... (archives: https://lists.oasis-open-projects.org/g/oslc-op)


oslc-op Weekly Contributors Meeting - Thu, 04/08/2021 #cal-notice

oslc-op@lists.oasis-open-projects.org Calendar <noreply@...>
 

oslc-op Weekly Contributors Meeting

When:
Thursday, 8 April 2021
10:00am to 11:00am
(GMT-04:00) America/New York

Where:
https://meet.jit.si/oslc-op

Organizer:
jamsden@...

Description:
oslc-op contributors weekly telecon. 


One tap audio Dial In: +15124022718,,,,2979764690# (US) or +498938038719,,,,2979764690# (Germany) Looking for a different dial in number? Please see: https://meet.jit.si/static/dialInInfo.html?room=oslc-op
Meeting ID: 2979764690#
 
The meeting minutes are edited in https://hackmd.io/@driib/oslc-op-minutes/edit
Previous minutes can be found under https://github.com/oslc-op/oslc-admin/tree/master/minutes/2019 

OASIS OSLC Open Project group home: https://lists.oasis-open-projects.org/g/oslc-op 
oslc-op GitHub Organization: https://github.com/oslc-op
Mailing list: oslc-op@... (archives: https://lists.oasis-open-projects.org/g/oslc-op)


Re: OSLC specification for SysML v2

Jim Amsden
 

Jad,
The primary purpose of the PIM/PSM models is to separate the logical specification of a system from its implementation so that the two can evolve more independently. 

The PIM is suppose to represents the full functional definition of a system in terms that are independent of any particular implementation. In the case of the SysML v2 Services PIM, that should include a definition of all the functions provided including creating, accessing, updating, deleting searching, versioning, discovering, etc. SysML v5 model resources. The PIM is suppose to make it easier for someone who is trying to understand what the services are, separate from how they are implemented. 

The PSM is a model of an implementation technical architecture, the capabilities of some underlying system enabling it to support applications running in some execution environment. 

In MDA, a mapping between the PIM and PSM describes how the business functions of the PIM are implemented using that technical architecture in order to produce PIM instances capable of being deployed to and run in an execution environment (perhaps with some additional manual contribution). 

The goal is separation of concerns so the business logic and platform technical architecture can evolve separately, and by updating the transformation mapping, new application implementations can be created.

OSLC is a combination of a PIM expressed in RDF vocabularies and resource shapes (constraints) and REST services. Its a PIM, but not one that is expressed in UML. Lyo Designer captures mappings from the OSLC PIM to specific platform implementations PSMs through the generation of servers that adapt the capabilities of some existing system to provide OSLC services. 

For SysML Services, ideally what would happen is the current PIM would be extended to capture a UML representation of the OSLC services: discovery, delegated dialogs, resource preview, configuration management, query, the vocabularies, and the typical CRUD operations. That would provide a full UML representation of the capabilities.

Then different mappings could be created to translate that PIM into implementations specified by the SysML v2 REST Services API and the SysML v2 OSLC Services API - two similar, but different implementations. With suitable use of cardinalities in the PIM to indicate optional features, this would likely be possible.

But is it worth the effort? The current SysML v2 Services PIM appears to be a UML abstraction of the REST Services API as it has evolved. So there is a very close mapping between the two. This is good because the PIM is based on something that has been proven to be implementable and usable. 

Whether its worth it to extend the PIM to include OSLC capabilities depends on how we think SysML v2 will be used in practice, and how vendors will build tools to support that practice. Of course these two are co-dependent based on the interaction/gap between what customers demand and what vendors supply. 

But if you think SysML v2 models are wholly contained universes of discourse that would be supported by a choice of tools, then integration with other tools might not be that important to you. 

If on the other hand, you think SysML v2 models are representations of systems that are to be built and evolve over time, then OSLC integration with other lifecycle tools to support that evolution might be very important.

I had originally hoped that we would not create a situation where it was necessary to make a choice between these two views, that one could be build on the other by simply adding the lifecycle management capabilities. This is why I had hoped that the SysML REST Services API could be a minimal OSLC API - leveraging HTTP, REST, open-wold assumptions and RDF resource representations to provide a simple REST API that can be extended with other OSLC capabilities to support lifecycle tool integration, without creating yet another incompatable REST API. 

As this did not seem to be something everyone agreed with, we decided to take a more independent development approach which has resulted in the question about what to put in the PIM. If we should decide that OSLC services should be added to the PIM, I suspect it would be relatively easy to transform the OSLC REST services, and RDF vocabularies and constraints into an XMI representation of the corresponding UML model of those services. However, that opens some key questions:

1. What part of these extended PIM would the SysML v2 REST Services API be required to implement?
2. How would the existing PIM have to change because of incompatible representations of overlapping services such as configuration management and query?
3. What is the value proposition of having two overlapping but incompatible implementations of the the PIM?

I personally think there's little value in addressing these questions at this point. Rather I think the best thing to do is to provide a mapping between the current SysML v2 Services PIM to OSLC, and leave the specification of the rest of the OSLC services in OSLC. 

An effective way to do that would be to split the SysML v2 OSLC specification into two parts - the mapping from the existing PIM to OSLC REST API would be in the OMG spec, and the rest of the OSLC capabilities for SysML would be in an OASIS SysML v2 OSLC Domain Specification as you suggest.

Vendors and users will now have a choice on how they want to access their SysML v2 models. If they want simple REST services with JSON resource representations, then either API will provide that capability, although in incompatible ways. If they want lifecycle integration with other tools, then they can implement the OSLC SysML v2 Domain Specification. 

I think ultimately the success of SysML v2 will depend on the ability of systems engineers being able to create useful models of their systems, that can be built for and with reuse, that can integrate with systems and tools created by others, and can rapidly evolve to meet changing demands. So I think OSLC integration capabilities are a must and minimum for SysML v2 - we already know that from industry experience.





-----oslc-op@... wrote: -----
To: Manas Bajaj <manas.bajaj@...>, "Jim Amsden (jamsden@...)" <jamsden@...>
From: "Jad El-Khoury"
Sent by: oslc-op@...
Date: 04/07/2021 05:40PM
Cc: "OASIS OSLC Open Project (oslc-op@...)" <oslc-op@...>
Subject: [EXTERNAL] [oslc-op] OSLC specification for SysML v2

Hi Manas, @Jim! would of course appreciate your input in my thoughts below. This goes for the whole OSLC community as well. In our last discussions on the OSLC PSM, we concluded that I should give some explanations of certain OSLC concepts ZjQcmQRYFpfptBannerStart
This Message Is From an External Sender
This message came from outside your organization.
ZjQcmQRYFpfptBannerEnd

Hi Manas,

 

@Jim! would of course appreciate your input in my thoughts below. This goes for the whole OSLC community as well.

 

In our last discussions on the OSLC PSM, we concluded that I should give some explanations of certain OSLC concepts (such as discovery, Service Providers, etc). This was necessary to clarify the mapping to the PIM.

We also agreed that the Resource Shapes and Vocabulary Terms are a necessary part of the specification, and need to be published somehow.

I also started thinking how we can specify versioning/configuration in this mapping.

 

I am now coming to the realisation that maybe a specification based on such a mapping to the PIM is not so optimal after all for a useful OSLC specification.

 

Before I detail even more, what do you think if we instead work on an “SysML2 Domain Specification”, similar in structure – as an example - to the following for “Requirements Management”.

https://oslc-op.github.io/oslc-specs/specs/rm/requirements-management-spec.html

(Detail: will this be an OASIS OSLC specs, or an OMG Sysml2 spec? But let’s leave that for later)

 

A PSM-PIM mapping seems natural for the REST API, and will be very useful when implementing such an API for a SysML tool.

 

But for someone wanting to build an OSLC-compliant API, I am worried that the current format of an OSLC PSM will not be so complete, nor clear.

An OSLC integration may require OSLC-specific mechanisms that are currently not covered in the PIM. For example, Delegated UIs, Query and Discovery capabilities. Instead of (re)explaining such things in the PSM, the proposed Sysml Domain specification can be more strict in specifying them.

Note also that a core part of an OSLC Domain Specification is the Shapes and Vocabularies of the domain.  Such a specification can also better relate to other aspects such as Configuration Management.

 

From an OSLC integrator perspective, the language and structure of the Domain Spec would be a more familiar document. It (including the shapes) would contain all the needed information, given that it will be read in the context of OSLC Core.

So, I’m arguing that it would be more important that the OSLC specification is made consistent with other OSLC specifications for useful integrations with other tools.

 

 

One advantage of a common PIM for both the REST and OSLC APIs is that one can easily relate to both.

But practically, I am not sure about the purpose of this mapping. This may come at the cost of less clear and complete OSLC specification.

The REST and OSLC APIs won’t be compatible, nor integrate anyway. What is more important is that the OSLC API integrates with other OSLC-compliant tools.

 

regards

______________________________

Jad El-khoury, PhD

KTH Royal Institute of Technology

School of Industrial Engineering and Management, Mechatronics Division

Brinellvägen 83, SE-100 44 Stockholm, Sweden

Phone: +46(0)8 790 6877 Mobile: +46(0)70 773 93 45

jad@..., www.kth.se