Difference between revisions of "Notation of Information Viewpoint Models"

From
Jump to: navigation, search
(State Diagrams)
(Evolution of information objects)
 
(One intermediate revision by the same user not shown)
Line 176: Line 176:
 
The evolution of information objects can also be represented using activity diagrams. Activity diagrams combine IV Object Instances and IV actions can also be combined into
 
The evolution of information objects can also be represented using activity diagrams. Activity diagrams combine IV Object Instances and IV actions can also be combined into
  
 +
{| class="wikitable sortable" style="width: 85%;"
 +
|+ Table 8 Notation for information object evolution with activity diagrams
 +
|-
 +
! style="padding: 7px"| <span style="color: #BBCE00">'''Figure'''</span>
 +
! <span style="color: #BBCE00">'''Description'''</span>
 +
|-
 +
| style="background-color:#ffffff;"| [[File:UML_Package.png]]
 +
| style="background-color:#ffffff;"| A package, in UML notation, is a grouping element. Package is used "to group elements, and to provide a namespace for the grouped elements".
 +
 +
A package may contain other packages, thus providing for a hierarchical organization of packages.
 +
 +
Classes, objects, use cases, components, nodes, node instances etc. can all be organized as packages, enabling a manageable organization of the elements of UML models.
 +
|-
 +
| style="background-color:#ffffff;"| [[File:UML_Activity.png]]
 +
| style="background-color:#ffffff;"| Activities are used to represent action in the RM.
 +
 +
Name tag indicates the name of the action. Actions are named using a short phrase that describes the event or action being represented.
 +
 +
The small decoration in the box indicates that the action is complex and can be subdivided into smaller tasks.
 +
 +
A stereotype can be used to indicate the namespace where the activity is grouped. Sometimes the stereotype can be an image. The stereotype image can be used in place of the figure. For ODP, the stereotype for information action is an arrow icon with a lowercase “i”:
 +
 +
[[File:Information-Information-action.jpg|right]]
 +
|-
 +
| style="background-color:#ffffff;"| [[File:UML_ObjectInstance.png]]
 +
| style="background-color:#ffffff;"| Objects are used to represent object instances in the RM.
 +
 +
Name tag indicates of the entity
 +
 +
The set of attributes with a value assigned characterises the state of the object.
 +
 +
The stereotype indicates the namespace where the object is grouped. Sometimes the stereotype can be an image. The image can be used in place of the figure. For ODP, the stereotype for information object instance is an “i” icon:
 +
 +
[[File:Information-Information-object.jpg|right]]
 +
|-
 +
| style="background-color:#ffffff;"| [[File:UML_Transition.png]]
 +
| style="background-color:#ffffff;"| The arcs connecting states represent transitions between information actions. Arcs can connect activities to information object instances, indicating the result of performing an action.  When linking an object to and action, the arc indicates that the object is part of the input used to perform that action.
 +
|-
 +
| style="background-color:#ffffff;"| [[File:UML_StartPseudostate.png]]
 +
| style="background-color:#ffffff;"| A filled circle is used to model the start of a set of actions.
 +
|-
 +
| style="background-color:#ffffff;"| [[File:UML_StopPseudostate.png]]
 +
| style="background-color:#ffffff;"| A circle with a smaller filled circle in the middle is used to model an end state.
 +
|}
 +
 +
[[File:IVEvolutionOverview04.png|none]]
 +
<div style='margin-left: 150px;'>Figure 8 Example of an IV Information Object Evolution using an activity diagram</div>
 +
 +
In the example diagram, an overview of the evolution of data in a RI is presented.
 
[[Category:Appendix C Notation]]
 
[[Category:Appendix C Notation]]

Latest revision as of 23:12, 29 March 2020

Information Objects[edit]

IV Objects are represented using a class diagram.

Table 4 Notation for information object diagrams
Figure Description
UML Package.png A package, in UML notation, is a grouping element. Package is used "to group elements, and to provide a namespace for the grouped elements".

A package may contain other packages, thus providing for a hierarchical organization of packages.

Classes, objects, use cases, components, nodes, node instances etc. can all be organized as packages, enabling a manageable organization of the elements of UML models.

UML Class.png Classes are used to represent information objects in the RM.

Classes can have additional compartments to express properties (called attributes) and behaviours (called methods). Leaving the compartments blank means that the behaviour and attributes are undefined at the time of creating the diagram.

Name tag indicates the name of the class. Typically, classes are named using no spaces in camelcase.

The stereotype indicates the namespace where the class is grouped. Sometimes the stereotype can be an image. The image can be used in place of the figure. For ODP, the stereotype for information object is an “i” icon with a tag on top:

Information-Type-object.jpg
UML Genearalisation.png Generalisation relationship indicates that one of the two related classes (the subclass) is considered to be a specialized form of the other (the super class).

Generalisation is represented with an arc with a blank triangle decoration. The blank triangle points to the super class and the undecorated end is connected to the subclass.

The generalization relationship is also known as the inheritance or "is a" relationship.

UML Aggregation.png Aggregation relationship indicates an association that represents a part-whole or part-of relationship.

Aggregation is represented with an arc with a blank rhombus decoration. The blank rhombus shape indicates the composite and the undecorated end of the arc is the component.

IVObjectTypes03.png
Figure 4 Example of an IV Object diagram

In the example diagram the package represents the collection of all information objects described by the ENVRI RM. The stereotype for the package is invariant schemata, which indicates that these are the parts of the model that are stable. The main objects are persistent data and metadata. The RM also provides a detailed description of each object in the text.

Information Actions[edit]

IV Actions are represented using an activity diagram with packages and activities

Table 5 Notation for action type diagrams
Figure Description
UML Package.png A package, in UML notation, is a grouping element. Package is used "to group elements, and to provide a namespace for the grouped elements".

A package may contain other packages, thus providing for a hierarchical organization of packages.

Classes, objects, use cases, components, nodes, node instances etc. can all be organized as packages, enabling a manageable organization of the elements of UML models.

UML Activity.png Activities are used to represent action in the RM.

Name tag indicates the name of the action. Actions are named using a short phrase that describes the event or action being represented.

The small decoration in the box indicates that the action is complex and can be subdivided into smaller tasks.

A stereotype can be used to indicate the namespace where the activity is grouped. Sometimes the stereotype can be an image. The stereotype image can be used in place of the figure. For ODP, the stereotype for information action is an arrow icon with a lowercase “i”:

Information-Information-action.jpg
IVActionTypes-2.png
Figure 5 Example of an IV Action Types diagram

In the example diagram the package represents the information action types described by the ENVRI RM. The stereotype for the package is invariant schemata, which indicates that these are the parts of the model that are stable. The RM also provides a detailed description of each action in text.

Information Object Instances[edit]

IV Objects instances are represented using an object diagram. The type of diagram is similar to the class diagram with the difference that the entities represented are objects not classes. Object instances have a specific state and this can change depending on the moment when the object is observed. Object instances are useful for representing the dynamic nature of the systems.

Table 6 Notation for information object instances diagrams
Figure Description
UML Package.png A package, in UML notation, is a grouping element. Package is used "to group elements, and to provide a namespace for the grouped elements".

A package may contain other packages, thus providing for a hierarchical organization of packages.

Classes, objects, use cases, components, nodes, node instances etc. can all be organized as packages, enabling a manageable organization of the elements of UML models.

UML Class.png Classes are used to represent information objects in the RM.

Classes can have additional compartments to express properties (called attributes) and behaviours (called methods). Leaving the compartments blank means that the behaviour and attributes are undefined at the time of creating the diagram.

Name tag indicates the name of the class. Classes are named using no spaces and capitalising the first letter of each word that makes up the name, camelcase.

The stereotype indicates the namespace where the class is grouped. Sometimes the stereotype can be an image. The image can be used in place of the figure. For ODP, the stereotype for information object is an “i” icon with a tag on top:

Information-Type-object.jpg
UML ObjectInstance.png Objects are used to represent object instances in the RM.

Name tag indicates of the entity

The set of attributes with a value assigned characterises the state of the object.

The stereotype indicates the namespace where the object is grouped. Sometimes the stereotype can be an image. The image can be used in place of the figure. For ODP, the stereotype for information object instance is an “i” icon:

Information-Information-object.jpg
UML Aggregation.png Aggregation indicates an association that represents a part-whole or part-of relationship.

Aggregation is represented with an arc with a blank rhombus decoration. The end with the blank rhombus indicates the composite and the other connects to the component.

IVObjectInstances-2.png
Figure 6 Example of an IV Object diagram

In the example diagram the package represents a collection of some information object instances. The stereotype for the package is dynamic schemata, which indicates that these are the parts of the model that can change depending on when the system is observed. The diagram presents four sample instances of persistent data objects and three examples of metadata objects. The diagram also includes the class definitions of persistent data and metadata objects for reference

State Diagrams[edit]

IV Object instances can have different states during their lifespan. The basic information objects persistent data and metadata have specific sets of states associated to them. The state changes, together with the IV Activities can be used to model the behaviour of data as it is managed by the RI. For this we use a state machine diagram. The main components of state machine diagrams are activity frames, states, activities, and pseudo-states.

Table 7 Notation for information object instances diagrams
Figure Description
UML ActivityFrame.png Frames are used to indicate the information object instance being represented.

The name indicates the information object instance being modelled

UML State.png States are used to represent the state of an information object resulting from the effects of an IV action

The name tag indicates the state reached by the information object

The small decoration in the box can be included to indicate that the state is complex and can be subdivided into sub-states

UML Action.png The arcs connecting states represent information actions applied to objects at a given state. The arrow end indicates the resulting state, the undecorated end indicates the initial state
UML StartPseudostate.png A filled circle is a pseudo-state, it can be used to model a start state or an intermediate connecting state
UML StopPseudostate.png A circle with a smaller filled circle in the middle is a pseudo -state to model an end state
UML DecisionPseudostate.png Decision pseudo-state, is used to model an exclusive fork in the execution of activities. It can also be used to model exclusive joins after forks.
UML ForkJoinPseudostate.png Fork/merge pseudo-state, is used to model a forks and joints in the execution of activities.
IVDataStates04-2.png
Figure 7 Example of an IV Information Object Evolution diagram

In the example diagram, five information object instances are presented. The possible transitions between states are indicated with arcs labelled using the names of IV actions.

Evolution of information objects[edit]

The evolution of information objects can also be represented using activity diagrams. Activity diagrams combine IV Object Instances and IV actions can also be combined into

Table 8 Notation for information object evolution with activity diagrams
Figure Description
UML Package.png A package, in UML notation, is a grouping element. Package is used "to group elements, and to provide a namespace for the grouped elements".

A package may contain other packages, thus providing for a hierarchical organization of packages.

Classes, objects, use cases, components, nodes, node instances etc. can all be organized as packages, enabling a manageable organization of the elements of UML models.

UML Activity.png Activities are used to represent action in the RM.

Name tag indicates the name of the action. Actions are named using a short phrase that describes the event or action being represented.

The small decoration in the box indicates that the action is complex and can be subdivided into smaller tasks.

A stereotype can be used to indicate the namespace where the activity is grouped. Sometimes the stereotype can be an image. The stereotype image can be used in place of the figure. For ODP, the stereotype for information action is an arrow icon with a lowercase “i”:

Information-Information-action.jpg
UML ObjectInstance.png Objects are used to represent object instances in the RM.

Name tag indicates of the entity

The set of attributes with a value assigned characterises the state of the object.

The stereotype indicates the namespace where the object is grouped. Sometimes the stereotype can be an image. The image can be used in place of the figure. For ODP, the stereotype for information object instance is an “i” icon:

Information-Information-object.jpg
UML Transition.png The arcs connecting states represent transitions between information actions. Arcs can connect activities to information object instances, indicating the result of performing an action. When linking an object to and action, the arc indicates that the object is part of the input used to perform that action.
UML StartPseudostate.png A filled circle is used to model the start of a set of actions.
UML StopPseudostate.png A circle with a smaller filled circle in the middle is used to model an end state.
IVEvolutionOverview04.png
Figure 8 Example of an IV Information Object Evolution using an activity diagram

In the example diagram, an overview of the evolution of data in a RI is presented.