Commit bb2f518d authored by Andreas Bayha's avatar Andreas Bayha
Browse files

YELLOW

Issue-Ref: 4204
Issue-URL: af3#4204



Signed-off-by: Andreas Bayha's avatarAndreas Bayha <bayha@fortiss.org>
parent d2a7c421
......@@ -79,7 +79,7 @@
<img src="./pictures/reuse_add_to_lib_complete.PNG"/>
<br><br>
Finally, a deep copy of your element should be stored in the selected library and the original element should have a reference to it.
Finally, a deep copy of your element will be stored in the selected library and the original element should have a reference to it.
You can check that by looking into the model elements view or the <u><a href="#reuse_manage_libs">reuse view</a></u> and see if the new element appears there in the correct library. Maybe you need to refresh the views first.
To check the reuse reference/specification of the original element, you can open again the context menu of this element in the model navigator and control if it has new entries for <u><a href="#reuse_update_lib_elem">updating its referenced library element</a></u> and <u><a href="#reuse_update_model_elem">updating itself via the library element</a></u>.
......@@ -89,7 +89,7 @@
<h2 id="reuse_use_elem">Reusing an element from a reuse library</h2>
As soon as you have saved a <u><a href="../reuse/reuse-elements.html">reuse element</a></u> in a <u><a href="../reuse/reuse-library.html">reuse library</a></u> (or received a library with reuse elements from other developers), you can reuse it everywhere as long as its type fits to the target place (e.g. a component can be reused in a component architecture but not in a requirement list).
In order to reuse the element, you just select it in the model elements view (usually in the right side). With a drag and drop you can then place it where you want it like the standard elements.
In order to reuse the element, you just select it in the model elements view (usually in the right side). With a drag and drop you can then place it where you want it in the same way as for any standard model elements.
However, in contrast to the standard elements, the placed element will have already all the content of the original element that was reused, and it will have a reuse reference/specification to its origin in the reuse library.
Through this reference, it is now always possible to <u><a href="#reuse_update_lib_elem">get all updates/modifications of the original reuse element</a></u> and also to <u><a href="#reuse_update_model_elem">update the origin yourself</a></u>.
......@@ -143,7 +143,7 @@
<h2 id="reuse_manage_libs">Managing the reuse libraries and their element</h2>
To be able to manage easily the <u><a href="../reuse/reuse-library.html">reuse libraries</a></u> and <u><a href="../reuse/reuse-elements.html">elements</a></u> and not force any manual changes in the library files, we have implemented a completely new view/editor for the reuse feature.
To be able to easily manage the <u><a href="../reuse/reuse-library.html">reuse libraries</a></u> and <u><a href="../reuse/reuse-elements.html">elements</a></u>, we have implemented a dedicated view/editor for the reuse feature.
As it is shown in the pictures in the <u><a href="../reuse/reuse-library.html">section about reuse libraries</a></u> and below, this editor is a table containing (in separate rows) all found reuse libraries in the current workspace. The library rows can be unfolded and will then also present the contained reuse elements in sub-rows.
<br><br>
......
......@@ -34,14 +34,14 @@
A reuse library is an own structure and serves as container for <u><a href="../reuse/reuse-elements.html">reuse elements</a></u>. It can be seen as storage of model elements that might get reused in the future.
<br><br>
Multiple reuse libraries can exist in a AF3 environment. Although we are using UUIDs to differentiate between them, we suggest to always have different names for the libraries and hence we are preventing name duplicates as far as we can.
Multiple reuse libraries can exist in an AF3 environment. Although we are using UUIDs to differentiate between them, we suggest to always have different names for the libraries and hence we are preventing name duplicates as far as we can.
<br><br>
Several reuse libraries represented inside the reuse view as containers for reuse elements:
The following example shows several reuse libraries represented inside the reuse view as containers for reuse elements:
<img src="./pictures/reuse_view.PNG"/>
<br><br>
The reuse libraries from above with their reuse elements in drag&drop panels for different views:
The reuse libraries from above with their reuse elements is also available for drag&drop from the model elements view:
<img src="./pictures/reuse_libraries_in_views.PNG"/>
<br><br>
......@@ -52,8 +52,8 @@
<img src="./pictures/workspace_structure.PNG"/>
<br><br>
Inside this reuse directory, each reuse library has its own folder (with its name and UUID as folder name). This makes it easy to just move or copy&paste whole reuse libraries from one AF3 workspace to another one (also on different devices).
Inside a reuse library folder, we have placed the whole content of the library as files. Currently, it mainly contains one AF3 file which represents the reuse library in AF3 with all of its AF3 elements, and ends with af3_lib.
Inside this reuse directory, each reuse library has its own folder (with its name and UUID as folder name). This makes it easy to move complete reuse libraries from one AF3 workspace to another one (also on different devices).
Inside a reuse library folder, we have placed the whole content of the library with all of its AF3 elements as one AF3 file with the file ending .af3_lib.
This af3_lib file is based on the XML format (like the standard af3 model file), what makes manual changes possible. However, we recommend to only change the reuse libraries and its elements from within AF3 (see <u><a href="../reuse/reuse-functionality.html">reuse functionality</a></u>).
</div>
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment