GLEIF-IT / lei-rdf

RDF LEI Project
MIT License
8 stars 4 forks source link

Restrictions on LegalEntityRelationship limit further, non-accounting-consolidation, types of relationship #140

Closed rivettp closed 5 years ago

rivettp commented 5 years ago

Emailed comment from GLEIF

I see that hasSource and hasTarget have been defined in Base.ttl, but hasParent and hasChild are still used as the property class definition in L2.ttl.

As there will be other relationship types that can or will be added in the future that are not Parent/Child (which was the point of my original recommendation), I think that relationships defined in L2.ttl should not be restricted to only the parent/child relationships associated with accounting consolidation.

The scope of ‘Level 2’ is, after all, any number of relationship types between two Level 1 LEI entities. To think of ‘Level 2’ as only the relationship types that have currently been implemented for accounting consolidation will cause problems in the future when additional relationship types are introduced.

Adding new relationship types in the future under the current L2 semantics could be done in one of two ways:

1) Another sub-ontology for new relationship types would be created (e.g., “Level2 B”, or L2B.ttl), in which the ’new’ relationship sub-type (i.e., NOT parent/child), or

2) The new relationship types would be incorporated in the existing L2.ttl

In the first case, semantic properties common to level 2 relationship semantics would need to be replicated in the new sub-ontology, but this redundancy could introduce either conflicts or unnecessary replication of relationship fundamentals defined in the existing L2.ttl

In the second case (if I understand it correctly) ,all new relationship types would be defined as inheriting the parent/child relationship class currently defined in L2.ttl. This would obviate the need for a new sub-ontology for new relationship types, but it would perpetuate the incorrect semantic notion of parent/child for relationships that did not fit that paradigm.

I think the solution is quite straightforward: simply rename the hasParent and hasChild relationship type property in L2.ttl as hasSource and hasTarget. In order to clarify the parent/child nature of the accounting consolidation relationship types, the parent/child aspect of those relationship types can be added in an annotation if desired. This simple renaming should not affect the struture of any of the object or property class definitions in L2.ttl, and it would leave open the ability to add new relationship types in the future to L2.ttl that did not conform to a parent/child interpretation.

rivettp commented 5 years ago

That assumption that ",all new relationship types would be defined as inheriting the parent/child relationship class currently defined in L2.ttl. " is not correct. In fact the point of separating hasSource/Target from hasChild/Parent as part of issue #137 was that if new relationship types would be defined in L2 that are not parent/child relationships then they would inherit from hasSource/Target in Base. With that explanation it seems to me that a change is not needed. Especially since the original suggestion to use “parent” and “child” came from you as being more consistent with current L2-related descriptions.

One thing that could be changed is to loosen the restrictions on L2:LegalEntityRelationship that it must have a value for L2:hasParent and L2:hasChild, to refer instead to Base:hasSource and Base:hasTarget. We could do this now or in the future as and when further subtypes of relationship are added.

Please advise.

rivettp commented 5 years ago

Summary of update from @Christoph-Gleif

Loosening of the restriction on L2:LegalEntityRelationship to refer instead to Base:hasSource and Base:hasTarget would address the issue that was raised.

However, still on the topic of accounting consolidation dependencies in relationship definitions, there is also a requirement that L2:LegalEntityRelationshipRecord contain two properties that are specific to the AccountingConsolidation relationship type: hasAccountingPeriod and hasDocumentFilingPeriod.

Requiring these first two properties above that are specific to accounting consolidation to be part of every relationship record seems overly restrictive, These properties are not like the other, more operational, metadata properties defined for all Legal Entity Relationship records.

Might the appropriate place for these restrictions be in the definition of the L2:AccountingConsolidation subclass instead of the LegalEntityRelationshipRecord ?

The cardinality criteria could perhaps allow these properties to be optional and not mandatory in the relationship record, but the question then becomes how to require them as properties of relationship records for the accounting consolidation subclasses of relationships.

Is there a way to do this without requiring that these properties be part of every relationship record ? (This is why it seems more appropriate to make them properties of the L2:AccountingConsolidation subclass itself.)

This may be seem like a relatively minor issue, but it may be more difficult to address later when additional relationship types are added and there is a body of existing data that has already been ingested into this model.

rivettp commented 5 years ago

I’ve made the change for the restriction to apply to hasSource and hasTarget instead of hasParent and hasChild.

However the second point “there is also a requirement that L2:LegalEntityRelationshipRecord contain two properties that are specific to the AccountingConsolidation relationship type:” is not correct – the restriction merely controls the maxCardinality meaning the property is optional but can have no more than one value.

Even if we have other types of relationship they might still be based on some (non-accounting) document which has a filing period. The definition of the property states “The dates in this instance of Period indicate the validity period of a regulatory filing, accounting document, or other document demonstrating the relationship's validity”

You asked “but the question then becomes how to require them as properties of relationship records for the accounting consolidation subclasses of relationships. “ But these properties are not currently required either in the ontology or in the XML Schema. And in fact many L2 records in the data don’t have either period. So I think making them required would be going too far.

In summary, I don’t think any change is needed beyond changing the restriction from hasParent/hasChild to hasSource/hasTarget.

Christoph-Gleif commented 5 years ago

Hi Pete,

Thank you very much for the update of the model.

I will revert shortly with a comment on the 2 properties.

Best,

Christoph

Christoph Schneider

Head of IT Development & Operations

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Global Legal Entity Identifier Foundation (GLEIF)

Bleichstrasse 59, 60313, Frankfurt am Main, Germany

Phone: +49 69 9074999-31

Mobile: +49 175 15645-15

Email: Christoph.Schneider@Gleif.org

Web: www.gleif.org

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Global Legal Entity Identifier Foundation (GLEIF)

St. Alban-Vorstadt 5, PO Box, 4002 Basel, Switzerland Chairman of the Board: Gerard Hartsink CEO: Stephan Wolf

This message may contain confidential and/or privileged information. If you are not the intended recipient or if you have received this message in error, please notify the sender and delete this message. Any unauthorised copying, disclosure or distribution of this message is strictly forbidden.

Von: Pete Rivett notifications@github.com Antworten an: GLEIF-IT/lei-rdf reply@reply.github.com Datum: Mittwoch, 5. Juni 2019 um 17:10 An: GLEIF-IT/lei-rdf lei-rdf@noreply.github.com Cc: Christoph Schneider Christoph.Schneider@Gleif.org, Mention mention@noreply.github.com Betreff: Re: [GLEIF-IT/lei-rdf] Restrictions on LegalEntityRelationship limit further, non-accounting-consolidation, types of relationship (#140)

I’ve made the change for the restriction to apply to hasSource and hasTarget instead of hasParent and hasChild.

However the second point “there is also a requirement that L2:LegalEntityRelationshipRecord contain two properties that are specific to the AccountingConsolidation relationship type:” is not correct – the restriction merely controls the maxCardinality meaning the property is optional but can have no more than one value.

Even if we have other types of relationship they might still be based on some (non-accounting) document which has a filing period. The definition of the property states “The dates in this instance of Period indicate the validity period of a regulatory filing, accounting document, or other document demonstrating the relationship's validity”

You asked “but the question then becomes how to require them as properties of relationship records for the accounting consolidation subclasses of relationships. “ But these properties are not currently required either in the ontology or in the XML Schema. And in fact many L2 records in the data don’t have either period. So I think making them required would be going too far.

In summary, I don’t think any change is needed beyond changing the restriction from hasParent/hasChild to hasSource/hasTarget.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

rivettp commented 5 years ago

I had a good in-depth discussion with Jeff Braswell on this subject and we agreed the way forward was to remove the restrictions on the 2 properties that @Christoph-Gleif quoted: there is no real need for the restrictions (they’re not in the XML Schema) and it’s possible at some stage that we may want multiple periods associated even for Accounting Consolidation.

rivettp commented 5 years ago

Changes merged.