-
Notifications
You must be signed in to change notification settings - Fork 23
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #719 from catenax-ng/main
remove tooltip on dashboard page
- Loading branch information
Showing
11 changed files
with
161 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
151 changes: 151 additions & 0 deletions
151
...nnected-to-twin-generic/#435-display-aspect-models-connected-to-twin-generic.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,151 @@ | ||
# #435 Display-Aspect-Models-connected-to-twin-generic | ||
|
||
| Key | Value | | ||
|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ||
| Author | @ds-mkanal | | ||
| Creation date | 28.02.2024 | | ||
| Ticket Id | [#435](https://github.com/eclipse-tractusx/traceability-foss/issues/435) [#710](https://github.com/eclipse-tractusx/traceability-foss/issues/710) [#711](https://github.com/eclipse-tractusx/traceability-foss/issues/711) | | ||
| State | DRAFT | | ||
|
||
# Table of Contents | ||
1. [Overview](#overview) | ||
2. [Summary](#summary) | ||
3. [Problem Statement](#problem-statement) | ||
4. [Requirements](#requirements) | ||
5. [NFR](#nfr) | ||
6. [Out of scope](#out-of-scope) | ||
7. [Assumptions](#assumptions) | ||
8. [Concept](#concept) | ||
9. [Glossary](#glossary) | ||
10. [References](#references) | ||
11. [Additional Details](#additional-details) | ||
|
||
|
||
# Overview | ||
Trace-X is an application in which quality issues can be processed. For the processing of these quality issues, both for the correct addressing of the quality incident and for a more in-depth search, a large number of semantic models must be accessed depending on the application. The information gained should not be regulated for Quality Expert working with Trace-X Busines App. All semantic models linked to a digital twin should be available for processing. | ||
|
||
# Summary | ||
Trace-X can currently display a defined number of semantic models of the BOMLifecyles asPlanned and asBuilt. | ||
In the future, it can be assumed that further as yet unspecified semantic models will be developed which will also be represented in Trace-X. | ||
Trace-X will be developed to generically handle different existing and planned semantic models. | ||
|
||
# Problem Statement | ||
- Trace-X can currently display a fixed number of semantic models. | ||
- This involves the well-known semantic models of BOMLifecyle asPlanned and asBuilt (SerialPart, SingleLevelUsage*, SingleLevelBOM, PartAsPlanned, PartSiteInformationAsPlanned, JustInSequence) | ||
- In addition, there is a further set of semantic models which are not currently part of the Trace-X domain model and therefore cannot be displayed at present. | ||
- To avoid having to map every available semantic model in the domain model, there is a requirement to display other semantic models in a more generic form. | ||
|
||
# Requirements | ||
- [ ] All semantic models connected to a digital twin can be viewed by a Trace-X user | ||
- [ ] Display of digital twin connected semantic models raw payload in Trace-X FE | ||
- [ ] Display of digital twin connected semantic models payload as graph view in Trace-X FE | ||
- [ ] Display of digital twin connected semantic models payload as tree view in Trace-X FE | ||
- [ ] Semantic Model is displayed with version of semantic model | ||
- [ ] Line numbering for raw and tree viewer | ||
- [ ] API endpoints response bodies are extended with required attributes version and payload for Semantic Model Detail View Panel | ||
|
||
# NFR | ||
- [ ] Panel with consistent UUX according to C-X Style Guide | ||
|
||
# Out of scope | ||
- Switching between viewer instances in full-screen-mode | ||
- Enabling and disabling of code highlighting (code highlighting is the default) | ||
|
||
# Assumptions | ||
There are further aspect models as the ones currently known (SerialPart, Batch, JiS, PartAsPlanned, PartSiteInformation) in the two BomLifecycle asPlanned and asBuilt which are currently implemented and will be relevant in the future. | ||
|
||
# Concept | ||
|
||
## BE API Extensions | ||
- API GET /assets/as-planned/{assetId} | ||
- add version attribute to detailAspectModels | ||
- add payload (link) of semantic models to detailAspectModels | ||
- add identification attribute to detailAspectModels | ||
- API GET /assets/as-planned/*/children/{childId} | ||
- add version attribute to detailAspectModels | ||
- add payload (link) of semantic models to detailAspectModels | ||
- add identification attribute to detailAspectModels | ||
- API GET /assets/as-built/{assetId} | ||
- add version attribute to detailAspectModels | ||
- add identification attribute to detailAspectModels | ||
- add payload (link) of semantic models to detailAspectModels | ||
- API GET /assets/as-built/*/children/{childId} | ||
- add version attribute to detailAspectModels | ||
- add identification attribute to detailAspectModels | ||
- add payload (link) of semantic models to detailAspectModels | ||
|
||
## UI Mocks | ||
Source: https://miro.com/app/board/uXjVO5JVoho=/?moveToWidget=3458764572353049533&cot=14 | ||
|
||
### Changes in DetailView Overlay | ||
|
||
- [ ] Detail View must be scrollable with vertical scrollbar | ||
- [ ] New Panel "Semantic Models" is added to Detail View (de: Semantische Modelle) | ||
- [ ] Panel "Semantic Models" contains table | ||
- [ ] Table contains all "Semantic Models" for selected asset | ||
- [ ] Table contains columns "Semantic Model Name" (de: refer to current translation) | ||
- [ ] Table contains columns "Version" of semantic model (de: Version) | ||
- [ ] Table contains columns "Semantic Model Id" of semantic model (de: ID Semantisches Modell) /== "Identification" of submodel in IRS response / | ||
- [ ] Table columns are sortable (Name alphanumeric, Version uses numeric, natural sorting!) | ||
- [ ] Table columns are NOT filterable | ||
- [ ] Table with vertical scrollbar (No pagination) | ||
- [ ] Viewer Panel has fixed size | ||
- [ ] User selection of Viewer Instance is stored in User Settings. Last selected Viewer Instance will be used for next semantic model selection. | ||
- [ ] User selected semantic model in table is highlighted in dark grey color | ||
|
||
![DetailView_With_Code_Viewer_Active.png](DetailView_With_Code_Viewer_Active.png) | ||
|
||
|
||
### Json Code Raw Viewer | ||
- Json Raw Viewer | ||
- Code Highlighting | ||
- Line Numbering | ||
- Vertical scrollbar | ||
- Extend Viewer Panel is extendable to full-screen | ||
|
||
![Detail_View_Json_Code_Viewer](Detail_View_Json_Code_Viewer.png) | ||
|
||
### Json Tree Viewer | ||
|
||
Json Tree Viewer is the visualization of a JSON structure in a hierarchical tree format. | ||
|
||
- Json Tree Viewer | ||
- Json is visualized in tree view | ||
- Code Highlighting | ||
- Line Numbering | ||
- Extend Viewer Panel is extendable to full-screen | ||
![Detail_View_Json_Tree_Viewer](Detail_View_Json_Tree_Viewer.png) | ||
|
||
### Json Graph Viewer | ||
- Json Tree Viewer | ||
- Json is visualized in graph view | ||
- Code Highlighting | ||
- Extend Viewer Panel is extendable to full-screen | ||
![Detail_View_Json_Graph_Viewer](Detail_View_Json_Graph_Viewer.png) | ||
|
||
|
||
## Viewer in full-screen mode | ||
![Viewer Full Screen](Viewer_Full_screen_mode.png) | ||
- Any viewer instance could be extended to full-screen mode | ||
- Full-screen mode is disabled via X button on the right upper side. | ||
- After closing, full-screen former detail view is shown | ||
|
||
## Error View | ||
- Viewer shows error icon | ||
- Viewer show initial message Semantic model cannot be displayed. | ||
- Standard error message: Semantic model cannot be displayed. With detailed user readable message | ||
|
||
![Error View](Error_View.png) | ||
|
||
# Glossary | ||
|
||
| Abbreviation | Name | Description | | ||
|--------------|------|---------------| | ||
| | | | | ||
| | | | | ||
|
||
# References | ||
- https://miro.com/app/board/uXjVO5JVoho=/?moveToWidget=3458764572353049533&cot=14 | ||
|
||
# Additional Details | ||
Given the dynamic nature of ongoing development, there might be variations between the conceptualization and the current implementation. For the latest status, refer to the documentation. |
Binary file added
BIN
+135 KB
...-aspect-models-connected-to-twin-generic/DetailView_With_Code_Viewer_Active.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+30.4 KB
...isplay-aspect-models-connected-to-twin-generic/Detail_View_Json_Code_Viewer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+67.9 KB
...splay-aspect-models-connected-to-twin-generic/Detail_View_Json_Graph_Viewer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+40.9 KB
...isplay-aspect-models-connected-to-twin-generic/Detail_View_Json_Tree_Viewer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+16.6 KB
docs/concept/#435-display-aspect-models-connected-to-twin-generic/Error_View.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+114 KB
...435-display-aspect-models-connected-to-twin-generic/Viewer_Full_screen_mode.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters