Implementation of aspect model SingleLevelBomAsBuilt 2.0.0

[mkanal]

As business app I want to receive SLBAB 2.0.0 aspects over the data chain so that get results over the specific relationships defined by SLBAB 2.0.0

Hints / Details

• child of eclipse-tractusx/sig-release#218
• Concept #212
• https://github.com/catenax-ng/tx-item-relationship-service/blob/main/docs/concept/%23212-Update-of-aspect-model-SingleLevelBomAsBuilt-2_0_0/%23212-Update-SingleLevelBomAsBuilt-2-0-0.md

Outcome / Acceptance Criteria

Outcome

• ...

  Acceptance Criteria

Implementation

• [x] relationships objects in JobResponse is extended with property "hasAlternatives"

Testdata

• [x] Testdata: Extend irs test data
• [x] Testdata: update ticket in test data management and add miro charts https://jira.catena-x.net/browse/TDG-34

Testing

• [ ] Testing: Multiple INT Test cases covering
  • [ ] SLBAB2.0.0 contains multiple asBuilt twins with hasAlternatives=false (Invalid collection)
  • [ ] SLBAB2.0.0 contains multiple asBuilt twins with hasAlternatives=true >> Semantic Models Batches
  • [ ] SLBAB2.0.0 contains multiple AsPlanned twins with hasAlternatives=true >> Semantic Models PartAsPlanned
  • [ ] SLBAB2.0.0 contains single AsPlanned twins with hasAlternatives=true >> Semantic Models PartAsPlanned
• [ ] Testcases for multiple cases covering happy and incorrect suitution

Documentation

• [ ] Update documentation for the multi lifecycle case: In case of receiving multi bomLifecycle the aspect array MUST contain semantic models of different bomLifecycles e.g. PartAsPlanned and SerialPart. !! IRS has the capability to switch bomLifeCyle (only for asBuilt) to provide asPlanned parts in a mixed stucture.

Out of Scope

• ...

[mkanal]

@ds-ext-kmassalski and @ds-alexander-bulgakov Will have a alignment on this issue and calrify what is necessary to resolve this ticekt including testing. The necessary experts Jon and Tomasz will be contacted to clarify the cases for testdata https://jira.catena-x.net/browse/TDG-34. @ds-alexander-bulgakov will add the information to the ticekt: There will be an update according to new insights in daily on 6.12.2023-

[ds-alexander-bulgakov]

After a call with Tomasz Jacewski following informations are important:

• The described four cases can not be reproduced in the testdata because
  • hasAlternatives=false is just theoretical and does not change anything
  • hasAlternatives=true is not possible to track since we can not assume a correlation between the marked parts and the lifecycle context of child parts

Therefore theoretically it is possible to have random "hasAlternatives=true" in the dataset and there is no chance to prove whether this is correct or not. There is no must to have several bomlifecycles in the aspects. This means the whole "Testing"-description is not possible to realize, we can only check if the response contains "hasAlternatives=true/(false)". One more function would be to set parameter in the IRS to filter "hasAlternatives" in the response, but this seems not to be a requirement of this ticket. For more information please see Tomaszs comment in TDG-34.

[jzbmw]

@ds-alexander-bulgakov is it possible to built all variants of that value "hasAlternative=true" in combination with the types of the child items into the testdataset.

hasAlternative = true asBuilt --> batch asBuilt --> asPlanned asBuilt --> JIS

Then we would have a specific Testdataset with these setups, to which we can test.

[mkanal]

One more function would be to set a parameter in the IRS to filter "hasAlternatives" in the response, but this seems not to be a requirement of this ticket. >> This is not a requirement we have.

[jzbmw]

reviewed and accepted

[ds-alexander-bulgakov]

Requested testdata has been created, see TDG-34.