Editing Notation of Information Viewpoint Models

== <span style="color: #BBCE00">Information Objects</span> ==

IV Objects are represented using a class diagram.

{| class="wikitable sortable" style="width: 85%;"
|+ Table 4 Notation for information object 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_Class.png]]
| style="background-color:#ffffff;"| 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:

[[File:Information-Type-object.jpg|right]]
|-
| style="background-color:#ffffff;"| [[File:UML_Genearalisation.png]]
| style="background-color:#ffffff;"| 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.
|-
| style="background-color:#ffffff;"| [[File:UML_Aggregation.png]]
| style="background-color:#ffffff;"| 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.
|}

[[File:IVObjectTypes03.png|none]]
<div style='margin-left: 250px;'>Figure 4 Example of an IV Object diagram</div>

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.

== <span style="color: #BBCE00">Information Actions</span> ==

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

{| class="wikitable sortable" style="width: 85%;"
|+ Table 5 Notation for action type 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]]
|}

[[File:IVActionTypes-2.png|none]]
<div style='margin-left: 250px;'>Figure 5 Example of an IV Action Types diagram</div>

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.

== <span style="color: #BBCE00">Information Object Instances</span> ==

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.

{| class="wikitable sortable" style="width: 85%;"
|+ Table 6 Notation for information object instances 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_Class.png]]
| style="background-color:#ffffff;"| 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:

[[File:Information-Type-object.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_Aggregation.png]]
| style="background-color:#ffffff;"| 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.
|}

[[File:IVObjectInstances-2.png|none]]
<div style='margin-left: 200px;'>Figure 6 Example of an IV Object diagram</div>

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

== <span style="color: #BBCE00">State Diagrams</span> ==

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
[[Category:Appendix C Notation]]
@@ Line 131: / Line 131: @@
 == <span style="color: #BBCE00">State Diagrams</span> ==
-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.
+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
-{| class="wikitable sortable" style="width: 85%;"
-|+ Table 7 Notation for information object instances diagrams
-|-
-! style="padding: 7px"| <span style="color: #BBCE00">'''Figure'''</span>
-! <span style="color: #BBCE00">'''Description'''</span>
-|-
-| style="background-color:#ffffff;"| [[File:UML_ActivityFrame.png]]
-| style="background-color:#ffffff;"| Frames are used to indicate the information object instance being represented.
-The name indicates the information object instance being modelled
-|-
-| style="background-color:#ffffff;"| [[File:UML_State.png]]
-| style="background-color:#ffffff;"| 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
-|-
-| style="background-color:#ffffff;"| [[File:UML_Action.png]]
-| style="background-color:#ffffff;"| 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
-|-
-| style="background-color:#ffffff;"| [[File:UML_StartPseudostate.png]]
-| style="background-color:#ffffff;"| A filled circle is a pseudo-state, it can be used to model a start state or an intermediate connecting state
-|-
-| style="background-color:#ffffff;"| [[File:UML_StopPseudostate.png]]
-| style="background-color:#ffffff;"| A circle with a smaller filled circle in the middle is a pseudo -state to model an end state
-|-
-| style="background-color:#ffffff;"| [[File:UML_DecisionPseudostate.png]]
-| style="background-color:#ffffff;"| 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.
-|-
-| style="background-color:#ffffff;"| [[File:UML_ForkJoinPseudostate.png]]
-| style="background-color:#ffffff;"| Fork/merge pseudo-state, is used to model a forks and joints in the execution of activities.
-|}
-[[File:IVDataStates04-2.png|1200px|none]]
-<div style='margin-left: 450px;'>Figure 7 Example of an IV Information Object Evolution diagram</div>
-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.
-== <span style="color: #BBCE00">Evolution of information objects</span> ==
-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]]