From 32053794f9343d8998917d52e379773d2571c2fa Mon Sep 17 00:00:00 2001 From: Luca Frosini Date: Fri, 12 May 2023 15:00:56 +0200 Subject: [PATCH] Improved documentation with cross reference --- docs/gcube-model-consistsof.rst | 822 ++++++++++++++-------------- docs/gcube-model-facet.rst | 892 ++++++++++++++++--------------- docs/gcube-model-isrelatedto.rst | 858 +++++++++++++++-------------- docs/gcube-model-property.rst | 26 +- docs/gcube-model-resource.rst | 726 +++++++++++++------------ 5 files changed, 1749 insertions(+), 1575 deletions(-) diff --git a/docs/gcube-model-consistsof.rst b/docs/gcube-model-consistsof.rst index 0d19c40..1cbdf4a 100644 --- a/docs/gcube-model-consistsof.rst +++ b/docs/gcube-model-consistsof.rst @@ -1,35 +1,39 @@ +.. _ConsistsOf: + ConsistsOf ========== +.. _HasAction: + HasAction --------- -Relation among a {@link Service} and its {@link ActionFacet} +Relation among a :ref:`Service ` and its :ref:`ActionFacet ` .. table:: **HasAction** ``extends`` **ConsistsOf** - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+==============================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | Service | HasAction | 0..n | ActionFacet | Relation among a {@link Service} and its {@link ActionFacet} | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ - | No specific known usage for this type. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+ + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================+==================+==================================+====================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`HasAction ` | 0..n | :ref:`ActionFacet ` | Relation among a :ref:`Service ` and its :ref:`ActionFacet ` | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ + | No specific known usage for this type. | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------+ The **HasAction** current version is 1.0.0. @@ -39,33 +43,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasAddAction: + HasAddAction ^^^^^^^^^^^^ -An action triggered when a {@link Service} is activated. +An action triggered when a :ref:`Service ` is activated. .. table:: **HasAddAction** ``extends`` **HasAction** - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+==========================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | Service | HasAddAction | 0..n | ActionFacet | An action triggered when a {@link Service} is activated. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ - | No specific known usage for this type. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+ + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | **Definition** | + +======================================================+====================================+==================+==================================+===================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`HasAddAction ` | 0..n | :ref:`ActionFacet ` | An action triggered when a :ref:`Service ` is activated. | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ + | No specific known usage for this type. | + +------------------------------------------------------+------------------------------------+------------------+----------------------------------+-------------------------------------------------------------------+ The **HasAddAction** current version is 1.0.0. @@ -75,33 +81,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasRemoveAction: + HasRemoveAction ^^^^^^^^^^^^^^^ -An action triggered when a {@link Service} is deactivated. +An action triggered when a :ref:`Service ` is deactivated. .. table:: **HasRemoveAction** ``extends`` **HasAction** - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | **Definition** | - +======================================================+=================+==================+=================+============================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | Service | HasRemoveAction | 0..n | ActionFacet | An action triggered when a {@link Service} is deactivated. | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ - | No specific known usage for this type. | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+ + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | **Definition** | + +======================================================+==========================================+==================+==================================+=====================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`HasRemoveAction ` | 0..n | :ref:`ActionFacet ` | An action triggered when a :ref:`Service ` is deactivated. | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ + | No specific known usage for this type. | + +------------------------------------------------------+------------------------------------------+------------------+----------------------------------+---------------------------------------------------------------------+ The **HasRemoveAction** current version is 1.0.0. @@ -111,37 +119,39 @@ Changelog: * **1.0.0**: First Version. +.. _HasContact: + HasContact ---------- -HasContact is a base relation type to capture the diverse points of contact associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target {@link ContactFacet}. Instead, every specialisation refines the reason of using the {@link ContactFacet} allowing to discriminate between two or more {@link ContactFacet} attached to the same resource.The identified specialisations are: {@link HasContributor}, {@link HasCreator}, {@link HasCurator}, {@link HasDeveloper}, {@link HasMaintainer}, {@link HasManager} and {@link HasOwner}. +HasContact is a base relation type to capture the diverse points of contact associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target :ref:`ContactFacet `. Instead, every specialisation refines the reason of using the :ref:`ContactFacet ` allowing to discriminate between two or more :ref:`ContactFacet ` attached to the same resource.The identified specialisations are: :ref:`HasContributor `, :ref:`HasCreator `, :ref:`HasCurator `, :ref:`HasDeveloper `, :ref:`HasMaintainer `, :ref:`HasManager ` and :ref:`HasOwner `. .. table:: **HasContact** ``extends`` **ConsistsOf** - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasContact | 0..n | ContactFacet | HasContact is a base relation type to capture the diverse points of contact associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target {@link ContactFacet}. Instead, every specialisation refines the reason of using the {@link ContactFacet} allowing to discriminate between two or more {@link ContactFacet} attached to the same resource.The identified specialisations are: {@link HasContributor}, {@link HasCreator}, {@link HasCurator}, {@link HasDeveloper}, {@link HasMaintainer}, {@link HasManager} and {@link HasOwner}. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasContact | 1..n | ContactFacet | The contact information of the entity responsible for the dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Schema | HasContact | 1..n | ContactFacet | | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | HasContact | 1..n | ContactFacet | The main contact for the Site. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+================================+==================+====================================+============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasContact ` | 0..n | :ref:`ContactFacet ` | HasContact is a base relation type to capture the diverse points of contact associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target :ref:`ContactFacet `. Instead, every specialisation refines the reason of using the :ref:`ContactFacet ` allowing to discriminate between two or more :ref:`ContactFacet ` attached to the same resource.The identified specialisations are: :ref:`HasContributor `, :ref:`HasCreator `, :ref:`HasCurator `, :ref:`HasDeveloper `, :ref:`HasMaintainer `, :ref:`HasManager ` and :ref:`HasOwner `. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the dataset. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | The main contact for the Site. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasContact** current version is 1.0.0. @@ -151,33 +161,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasContributor: + HasContributor ^^^^^^^^^^^^^^ -HasContributor indicates that the target {@link ContactFacet} contains the information related to a contributor to the source resource, e.g., the contact points of the contributor of software or the contributor of a dataset. +HasContributor indicates that the target :ref:`ContactFacet ` contains the information related to a contributor to the source resource, e.g., the contact points of the contributor of software or the contributor of a dataset. .. table:: **HasContributor** ``extends`` **HasContact** - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+================+==================+=================+==================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasContributor | 0..n | ContactFacet | HasContributor indicates that the target {@link ContactFacet} contains the information related to a contributor to the source resource, e.g., the contact points of the contributor of software or the contributor of a dataset. | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasContributor | 0..n | ContactFacet | The contact information on contributors supporting the creation and development of the Dataset. | - +------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+========================================+==================+====================================+================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasContributor ` | 0..n | :ref:`ContactFacet ` | HasContributor indicates that the target :ref:`ContactFacet ` contains the information related to a contributor to the source resource, e.g., the contact points of the contributor of software or the contributor of a dataset. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasContributor ` | 0..n | :ref:`ContactFacet ` | The contact information on contributors supporting the creation and development of the Dataset. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasContributor** current version is 1.0.0. @@ -187,33 +199,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasCreator: + HasCreator ^^^^^^^^^^ -HasCreator indicates that the target {@link ContactFacet} contains the information related to a creator of the source resource, e.g., the contact points of the creator of a dataset. +HasCreator indicates that the target :ref:`ContactFacet ` contains the information related to a creator of the source resource, e.g., the contact points of the creator of a dataset. .. table:: **HasCreator** ``extends`` **HasContact** - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=======================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasCreator | 0..n | ContactFacet | HasCreator indicates that the target {@link ContactFacet} contains the information related to a creator of the source resource, e.g., the contact points of the creator of a dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasCreator | 0..n | ContactFacet | The contact information of the creator of the Dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+================================+==================+====================================+=====================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasCreator ` | 0..n | :ref:`ContactFacet ` | HasCreator indicates that the target :ref:`ContactFacet ` contains the information related to a creator of the source resource, e.g., the contact points of the creator of a dataset. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCreator ` | 0..n | :ref:`ContactFacet ` | The contact information of the creator of the Dataset. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasCreator** current version is 1.0.0. @@ -223,33 +237,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasCurator: + HasCurator ^^^^^^^^^^ -HasCurator indicates that the target {@link ContactFacet} contains the information related to a curator of the source resource, e.g., the contact points of the curator of a dataset. +HasCurator indicates that the target :ref:`ContactFacet ` contains the information related to a curator of the source resource, e.g., the contact points of the curator of a dataset. .. table:: **HasCurator** ``extends`` **HasContact** - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=======================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasCurator | 0..n | ContactFacet | HasCurator indicates that the target {@link ContactFacet} contains the information related to a curator of the source resource, e.g., the contact points of the curator of a dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasCurator | 0..n | ContactFacet | The contact information of the entity responsible for the curation of the dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+================================+==================+====================================+=====================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasCurator ` | 0..n | :ref:`ContactFacet ` | HasCurator indicates that the target :ref:`ContactFacet ` contains the information related to a curator of the source resource, e.g., the contact points of the curator of a dataset. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCurator ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the curation of the dataset. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasCurator** current version is 1.0.0. @@ -259,33 +275,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasDeveloper: + HasDeveloper ^^^^^^^^^^^^ -HasDeveloper indicates that the target {@link ContactFacet} contains the information related to a developer of the source resource e.g., the contact points ofthe developer of a software. +HasDeveloper indicates that the target :ref:`ContactFacet ` contains the information related to a developer of the source resource e.g., the contact points ofthe developer of a software. .. table:: **HasDeveloper** ``extends`` **HasContact** - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+============================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasDeveloper | 0..n | ContactFacet | HasDeveloper indicates that the target {@link ContactFacet} contains the information related to a developer of the source resource e.g., the contact points ofthe developer of a software. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | No specific known usage for this type. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+====================================+==================+====================================+==========================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasDeveloper ` | 0..n | :ref:`ContactFacet ` | HasDeveloper indicates that the target :ref:`ContactFacet ` contains the information related to a developer of the source resource e.g., the contact points ofthe developer of a software. | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | No specific known usage for this type. | + +------------------------------------------------------+------------------------------------+------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasDeveloper** current version is 1.0.0. @@ -295,37 +313,39 @@ Changelog: * **1.0.0**: First Version. +.. _HasMaintainer: + HasMaintainer ^^^^^^^^^^^^^ -HasDeveloper indicates that the target {@link ContactFacet} contains the information related to a developer of the source resource, e.g., the contact points of the developer of a software. +HasDeveloper indicates that the target :ref:`ContactFacet ` contains the information related to a developer of the source resource, e.g., the contact points of the developer of a software. .. table:: **HasMaintainer** ``extends`` **HasContact** - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+===============+==================+=================+==============================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasMaintainer | 0..n | ContactFacet | HasDeveloper indicates that the target {@link ContactFacet} contains the information related to a developer of the source resource, e.g., the contact points of the developer of a software. | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | ConcreteDataset | HasMaintainer | 1..n | ContactFacet | The contact information of the entity responsible for the maintenance of the concrete dataset | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasMaintainer | 0..n | ContactFacet | The contact information of the entity responsible for the maintenance of the dataset. | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | HasMaintainer | 1..n | ContactFacet | Contact information of the maintainer of the Site. | - +------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+======================================+==================+====================================+============================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasMaintainer ` | 0..n | :ref:`ContactFacet ` | HasDeveloper indicates that the target :ref:`ContactFacet ` contains the information related to a developer of the source resource, e.g., the contact points of the developer of a software. | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`HasMaintainer ` | 1..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the maintenance of the concrete dataset | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasMaintainer ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the maintenance of the dataset. | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`HasMaintainer ` | 1..n | :ref:`ContactFacet ` | Contact information of the maintainer of the Site. | + +------------------------------------------------------+--------------------------------------+------------------+------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasMaintainer** current version is 1.0.0. @@ -335,33 +355,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasManager: + HasManager ^^^^^^^^^^ -HasManager indicates that the target {@link ContactFacet} contains the information related to a manager of the source resource, e.g., the contact points of the manager of a research infrastructure or a data centre. +HasManager indicates that the target :ref:`ContactFacet ` contains the information related to a manager of the source resource, e.g., the contact points of the manager of a research infrastructure or a data centre. .. table:: **HasManager** ``extends`` **HasContact** - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+========================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasManager | 0..n | ContactFacet | HasManager indicates that the target {@link ContactFacet} contains the information related to a manager of the source resource, e.g., the contact points of the manager of a research infrastructure or a data centre. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | HasManager | 1..n | ContactFacet | Contact information of the Site Manager. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+================================+==================+====================================+======================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasManager ` | 0..n | :ref:`ContactFacet ` | HasManager indicates that the target :ref:`ContactFacet ` contains the information related to a manager of the source resource, e.g., the contact points of the manager of a research infrastructure or a data centre. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`HasManager ` | 1..n | :ref:`ContactFacet ` | Contact information of the Site Manager. | + +------------------------------------------------------+--------------------------------+------------------+------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasManager** current version is 1.0.0. @@ -371,33 +393,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasOwner: + HasOwner ^^^^^^^^ -HasOwner indicates that the target {@link ContactFacet} contains the information related to the owner of the source resource, e.g., the contact points of the owner of dataset. +HasOwner indicates that the target :ref:`ContactFacet ` contains the information related to the owner of the source resource, e.g., the contact points of the owner of dataset. .. table:: **HasOwner** ``extends`` **HasContact** - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasOwner | 0..n | ContactFacet | HasOwner indicates that the target {@link ContactFacet} contains the information related to the owner of the source resource, e.g., the contact points of the owner of dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasOwner | 0..n | ContactFacet | The contact information of the entity having the ownership of the dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+============================+==================+====================================+===============================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasOwner ` | 0..n | :ref:`ContactFacet ` | HasOwner indicates that the target :ref:`ContactFacet ` contains the information related to the owner of the source resource, e.g., the contact points of the owner of dataset. | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasOwner ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity having the ownership of the dataset. | + +------------------------------------------------------+----------------------------+------------------+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasOwner** current version is 1.0.0. @@ -407,33 +431,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasCoverage: + HasCoverage ----------- -HasCoverage represents the type of coverage that is provided by the CoverageFacet.Let consider a dataset containing information regarding the salinity of a specific ocean area in a certain amount of time. What is essential in the Information System isnot representing the data of the salinity. Instead, to specify the temporal period and the ocean area the dataset is valid. This information is captured using the same schema, i.e., the {@link CoverageFacet} but using different relations to distinguish between them with no need to understand the value or the schema of the coverage. For such a reason it has been defined the abstract HasCoverage relation and the specialisation {@link HasTemporalCoverage} and {@link HasSpatialCoverage} have been defined to refines the reason of using the {@link CoverageFacet}. +HasCoverage represents the type of coverage that is provided by the CoverageFacet.Let consider a dataset containing information regarding the salinity of a specific ocean area in a certain amount of time. What is essential in the Information System isnot representing the data of the salinity. Instead, to specify the temporal period and the ocean area the dataset is valid. This information is captured using the same schema, i.e., the :ref:`CoverageFacet ` but using different relations to distinguish between them with no need to understand the value or the schema of the coverage. For such a reason it has been defined the abstract HasCoverage relation and the specialisation :ref:`HasTemporalCoverage ` and :ref:`HasSpatialCoverage ` have been defined to refines the reason of using the :ref:`CoverageFacet `. .. table:: **HasCoverage** ``extends`` **ConsistsOf** - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasCoverage | 0..n | CoverageFacet | HasCoverage represents the type of coverage that is provided by the CoverageFacet.Let consider a dataset containing information regarding the salinity of a specific ocean area in a certain amount of time. What is essential in the Information System isnot representing the data of the salinity. Instead, to specify the temporal period and the ocean area the dataset is valid. This information is captured using the same schema, i.e., the {@link CoverageFacet} but using different relations to distinguish between them with no need to understand the value or the schema of the coverage. For such a reason it has been defined the abstract HasCoverage relation and the specialisation {@link HasTemporalCoverage} and {@link HasSpatialCoverage} have been defined to refines the reason of using the {@link CoverageFacet}. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasCoverage | 1..n | CoverageFacet | Any coverage related information (e.g. topic, species) characterising the content of the dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==================================+==================+======================================+=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasCoverage ` | 0..n | :ref:`CoverageFacet ` | HasCoverage represents the type of coverage that is provided by the CoverageFacet.Let consider a dataset containing information regarding the salinity of a specific ocean area in a certain amount of time. What is essential in the Information System isnot representing the data of the salinity. Instead, to specify the temporal period and the ocean area the dataset is valid. This information is captured using the same schema, i.e., the :ref:`CoverageFacet ` but using different relations to distinguish between them with no need to understand the value or the schema of the coverage. For such a reason it has been defined the abstract HasCoverage relation and the specialisation :ref:`HasTemporalCoverage ` and :ref:`HasSpatialCoverage ` have been defined to refines the reason of using the :ref:`CoverageFacet `. | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCoverage ` | 1..n | :ref:`CoverageFacet ` | Any coverage related information (e.g. topic, species) characterising the content of the dataset. | + +------------------------------------------------------+----------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasCoverage** current version is 1.0.0. @@ -443,33 +469,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasSpatialCoverage: + HasSpatialCoverage ^^^^^^^^^^^^^^^^^^ -HasSpatialCoverage indicates that the target {@link CoverageFacet} indicates a spatial coverage information, e.g., the geographic area indication for the dataset. +HasSpatialCoverage indicates that the target :ref:`CoverageFacet ` indicates a spatial coverage information, e.g., the geographic area indication for the dataset. .. table:: **HasSpatialCoverage** ``extends`` **HasCoverage** - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+====================+==================+=================+====================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasSpatialCoverage | 0..n | CoverageFacet | HasSpatialCoverage indicates that the target {@link CoverageFacet} indicates a spatial coverage information, e.g., the geographic area indication for the dataset. | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasSpatialCoverage | 0..n | CoverageFacet | Any geo-spatial coverage information characterising the content of the dataset, e.g. the area covered by the dataset. | - +------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+================================================+==================+======================================+===================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasSpatialCoverage ` | 0..n | :ref:`CoverageFacet ` | HasSpatialCoverage indicates that the target :ref:`CoverageFacet ` indicates a spatial coverage information, e.g., the geographic area indication for the dataset. | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasSpatialCoverage ` | 0..n | :ref:`CoverageFacet ` | Any geo-spatial coverage information characterising the content of the dataset, e.g. the area covered by the dataset. | + +------------------------------------------------------+------------------------------------------------+------------------+--------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasSpatialCoverage** current version is 1.0.0. @@ -479,33 +507,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasTemporalCoverage: + HasTemporalCoverage ^^^^^^^^^^^^^^^^^^^ -HasTemporalCoverage indicates that the target {@link CoverageFacet} indicates a temporal coverage information e.g., the temporal period indication for the dataset. +HasTemporalCoverage indicates that the target :ref:`CoverageFacet ` indicates a temporal coverage information e.g., the temporal period indication for the dataset. .. table:: **HasTemporalCoverage** ``extends`` **HasCoverage** - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+=====================+==================+=================+=====================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasTemporalCoverage | 0..n | CoverageFacet | HasTemporalCoverage indicates that the target {@link CoverageFacet} indicates a temporal coverage information e.g., the temporal period indication for the dataset. | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasTemporalCoverage | 0..n | CoverageFacet | Any temporal coverage information characterising the content of the dataset, e.g. the time-span covered by the dataset. | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==================================================+==================+======================================+====================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasTemporalCoverage ` | 0..n | :ref:`CoverageFacet ` | HasTemporalCoverage indicates that the target :ref:`CoverageFacet ` indicates a temporal coverage information e.g., the temporal period indication for the dataset. | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasTemporalCoverage ` | 0..n | :ref:`CoverageFacet ` | Any temporal coverage information characterising the content of the dataset, e.g. the time-span covered by the dataset. | + +------------------------------------------------------+--------------------------------------------------+------------------+--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasTemporalCoverage** current version is 1.0.0. @@ -515,33 +545,35 @@ Changelog: * **1.0.0**: First Version. +.. _HasMemory: + HasMemory --------- -HasMemory is a base relation type to capture the diverse type of memories associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target {@link MemoryFacet}. It is in charge of the specialisation {@link HasVolatileMemory} and {@link HasPersistentMemory} to clarify the semantics of the memory (any resource describing a computing machine must have at least two types of memories, i.e., persistent and volatile).We do not exclude other specialisation required by services to select the appropriated memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. +HasMemory is a base relation type to capture the diverse type of memories associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target :ref:`MemoryFacet `. It is in charge of the specialisation :ref:`HasVolatileMemory ` and :ref:`HasPersistentMemory ` to clarify the semantics of the memory (any resource describing a computing machine must have at least two types of memories, i.e., persistent and volatile).We do not exclude other specialisation required by services to select the appropriated memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. .. table:: **HasMemory** ``extends`` **ConsistsOf** - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasMemory | 0..n | MemoryFacet | HasMemory is a base relation type to capture the diverse type of memories associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target {@link MemoryFacet}. It is in charge of the specialisation {@link HasVolatileMemory} and {@link HasPersistentMemory} to clarify the semantics of the memory (any resource describing a computing machine must have at least two types of memories, i.e., persistent and volatile).We do not exclude other specialisation required by services to select the appropriated memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | No specific known usage for this type. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================+==================+==================================+============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasMemory ` | 0..n | :ref:`MemoryFacet ` | HasMemory is a base relation type to capture the diverse type of memories associated with a resource. This relation is abstract because if not specialised it does not add any semantic of relating the resource with the target :ref:`MemoryFacet `. It is in charge of the specialisation :ref:`HasVolatileMemory ` and :ref:`HasPersistentMemory ` to clarify the semantics of the memory (any resource describing a computing machine must have at least two types of memories, i.e., persistent and volatile).We do not exclude other specialisation required by services to select the appropriated memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | No specific known usage for this type. | + +------------------------------------------------------+------------------------------+------------------+----------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasMemory** current version is 1.0.0. @@ -551,35 +583,37 @@ Changelog: * **1.0.0**: First Version. +.. _HasPersistentMemory: + HasPersistentMemory ^^^^^^^^^^^^^^^^^^^ -HasPersistentMemory indicates that the target {@link MemoryFacet} indicates a non-volatile memory, i.e., a memory which does not lose the data when the device is powered down. This type of memory is also known as secondary memory, external memory, auxiliary storage, or secondary storage. Of course more than one MemoryFacet related with HasPersistentMemory can be attached to the same resource, but actually from an infrastructure management point of view, we did not find any reason to further specialise the HasPersistentMemory relation. Anyway, we do not exclude other specialisation required by services to select the appropriated persistent memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. +HasPersistentMemory indicates that the target :ref:`MemoryFacet ` indicates a non-volatile memory, i.e., a memory which does not lose the data when the device is powered down. This type of memory is also known as secondary memory, external memory, auxiliary storage, or secondary storage. Of course more than one MemoryFacet related with HasPersistentMemory can be attached to the same resource, but actually from an infrastructure management point of view, we did not find any reason to further specialise the HasPersistentMemory relation. Anyway, we do not exclude other specialisation required by services to select the appropriated persistent memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. .. table:: **HasPersistentMemory** ``extends`` **HasMemory** - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+=====================+==================+=================+=====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasPersistentMemory | 0..n | MemoryFacet | HasPersistentMemory indicates that the target {@link MemoryFacet} indicates a non-volatile memory, i.e., a memory which does not lose the data when the device is powered down. This type of memory is also known as secondary memory, external memory, auxiliary storage, or secondary storage. Of course more than one MemoryFacet related with HasPersistentMemory can be attached to the same resource, but actually from an infrastructure management point of view, we did not find any reason to further specialise the HasPersistentMemory relation. Anyway, we do not exclude other specialisation required by services to select the appropriated persistent memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | HasPersistentMemory | 1..n | MemoryFacet | The Disk Space Capacity of the Hosting Node. | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | HasPersistentMemory | 1..n | MemoryFacet | The Disk Space Capacity of the Virtual Machine. | - +------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==================================================+==================+==================================+==================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasPersistentMemory ` | 0..n | :ref:`MemoryFacet ` | HasPersistentMemory indicates that the target :ref:`MemoryFacet ` indicates a non-volatile memory, i.e., a memory which does not lose the data when the device is powered down. This type of memory is also known as secondary memory, external memory, auxiliary storage, or secondary storage. Of course more than one MemoryFacet related with HasPersistentMemory can be attached to the same resource, but actually from an infrastructure management point of view, we did not find any reason to further specialise the HasPersistentMemory relation. Anyway, we do not exclude other specialisation required by services to select the appropriated persistent memory better. For example, to discriminate between Solid State Disk and Magnetic Rotative. | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`HasPersistentMemory ` | 1..n | :ref:`MemoryFacet ` | The Disk Space Capacity of the Hosting Node. | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`HasPersistentMemory ` | 1..n | :ref:`MemoryFacet ` | The Disk Space Capacity of the Virtual Machine. | + +------------------------------------------------------+--------------------------------------------------+------------------+----------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasPersistentMemory** current version is 1.0.0. @@ -589,35 +623,37 @@ Changelog: * **1.0.0**: First Version. +.. _HasVolatileMemory: + HasVolatileMemory ^^^^^^^^^^^^^^^^^ -HasVolatileMemory indicates that the target {@link MemoryFacet} is a volatile memory, i.e., a memory which requires power to maintain the stored information. Volatile memory is also known as main memory, internal memory or primary storage. +HasVolatileMemory indicates that the target :ref:`MemoryFacet ` is a volatile memory, i.e., a memory which requires power to maintain the stored information. Volatile memory is also known as main memory, internal memory or primary storage. .. table:: **HasVolatileMemory** ``extends`` **HasMemory** - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+===================+==================+=================+=================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | HasVolatileMemory | 0..n | MemoryFacet | HasVolatileMemory indicates that the target {@link MemoryFacet} is a volatile memory, i.e., a memory which requires power to maintain the stored information. Volatile memory is also known as main memory, internal memory or primary storage. | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | HasVolatileMemory | 1..n | MemoryFacet | The RAM Capacity of the Hosting Node. | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | HasVolatileMemory | 1..n | MemoryFacet | The RAM Capacity of the Virtual Machine. | - +------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================================+==================+==================================+==============================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`HasVolatileMemory ` | 0..n | :ref:`MemoryFacet ` | HasVolatileMemory indicates that the target :ref:`MemoryFacet ` is a volatile memory, i.e., a memory which requires power to maintain the stored information. Volatile memory is also known as main memory, internal memory or primary storage. | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`HasVolatileMemory ` | 1..n | :ref:`MemoryFacet ` | The RAM Capacity of the Hosting Node. | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`HasVolatileMemory ` | 1..n | :ref:`MemoryFacet ` | The RAM Capacity of the Virtual Machine. | + +------------------------------------------------------+----------------------------------------------+------------------+----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HasVolatileMemory** current version is 1.0.0. @@ -627,53 +663,55 @@ Changelog: * **1.0.0**: First Version. +.. _IsIdentifiedBy: + IsIdentifiedBy -------------- -Each {@link GCubeResource} has been defined to have at least a facet linked with an IsIdentifiedBy relation. IsIdentifiedBy indicates that the target facet represents a sort of identification for the source resource. For instance, a software can consist of one or more {@link SoftwareFacet} but the one related with IsIdentifiedBy represents the identify of the software. +Each :ref:`GCubeResource ` has been defined to have at least a facet linked with an IsIdentifiedBy relation. IsIdentifiedBy indicates that the target facet represents a sort of identification for the source resource. For instance, a software can consist of one or more :ref:`SoftwareFacet ` but the one related with IsIdentifiedBy represents the identify of the software. .. table:: **IsIdentifiedBy** ``extends`` **ConsistsOf** - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+================+==================+=================+=====================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Resource | IsIdentifiedBy | 0..n | Facet | Each {@link GCubeResource} has been defined to have at least a facet linked with an IsIdentifiedBy relation. IsIdentifiedBy indicates that the target facet represents a sort of identification for the source resource. For instance, a software can consist of one or more {@link SoftwareFacet} but the one related with IsIdentifiedBy represents the identify of the software. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Actor | IsIdentifiedBy | 1..1 | ContactFacet | An Actor has at least a Contact Facet which permit to identify the Actor per se. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | ConfigurationTemplate | IsIdentifiedBy | 1..1 | IdentifierFacet | | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | IsIdentifiedBy | 1..1 | IdentifierFacet | The set of Identifiers associated with the Dataset instance. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | IsIdentifiedBy | 1..1 | SoftwareFacet | The main software enabling the EService capabilities. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | GCubeResource | IsIdentifiedBy | 1..1 | Facet | Any Resource has at least one Facet which in some way allow to identify the Resource per se. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | IsIdentifiedBy | 1..1 | NetworkingFacet | The Network ID characterising the Hosting Node. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Schema | IsIdentifiedBy | 1..1 | SchemaFacet | | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | IsIdentifiedBy | 1..1 | IdentifierFacet | The Site Identifier. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | IsIdentifiedBy | 1..1 | SoftwareFacet | Software coordinates which identify the Software per se. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | IsIdentifiedBy | 1..1 | NetworkingFacet | The Network ID characterising the Virtual Machine. | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualService | IsIdentifiedBy | 1..n | SoftwareFacet | | - +------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+========================================+==================+==========================================+===================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Resource ` | :ref:`IsIdentifiedBy ` | 0..n | :ref:`Facet ` | Each :ref:`GCubeResource ` has been defined to have at least a facet linked with an IsIdentifiedBy relation. IsIdentifiedBy indicates that the target facet represents a sort of identification for the source resource. For instance, a software can consist of one or more :ref:`SoftwareFacet ` but the one related with IsIdentifiedBy represents the identify of the software. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Actor ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`ContactFacet ` | An Actor has at least a Contact Facet which permit to identify the Actor per se. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ConfigurationTemplate ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | The set of Identifiers associated with the Dataset instance. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SoftwareFacet ` | The main software enabling the EService capabilities. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`GCubeResource ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`Facet ` | Any Resource has at least one Facet which in some way allow to identify the Resource per se. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`NetworkingFacet ` | The Network ID characterising the Hosting Node. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SchemaFacet ` | | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | The Site Identifier. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SoftwareFacet ` | Software coordinates which identify the Software per se. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`NetworkingFacet ` | The Network ID characterising the Virtual Machine. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualService ` | :ref:`IsIdentifiedBy ` | 1..n | :ref:`SoftwareFacet ` | | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **IsIdentifiedBy** current version is 1.0.0. diff --git a/docs/gcube-model-facet.rst b/docs/gcube-model-facet.rst index fb3b058..1a1b1bf 100644 --- a/docs/gcube-model-facet.rst +++ b/docs/gcube-model-facet.rst @@ -1,8 +1,12 @@ +.. _Facet: + Facet ===== +.. _AccessPointFacet: + AccessPointFacet ---------------- @@ -11,31 +15,31 @@ AccessPointFacet captures information on an 'access point' of a resource, i.e., .. table:: **AccessPointFacet** ``extends`` **Facet** - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Properties | - +=================+==============+==========================================================+=================================================================================================================================================================================================================+==================================================================================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | endpoint | String | ``Mandatory:true`` ``ReadOnly:true`` ``NotNull:true`` | The URI which characterises the specific endpoint instance. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | authorization | Property | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Contains authorisation information. e.g., a token, the couple username:password, etc. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | protocol | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The high-level protocol used by the access point. The String could contain the version if needed. e.g., Web Map Service (WMS) and not HyperText Transfer Protocol (HTTP) which is already contained in the URI. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | entryName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A distinguishing string to be used by clients to identify the access point of interest. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | description | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A human-oriented text accompanying the access point. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | ConcreteDataset | ConsistsOf | 1..n | AccessPointFacet | The access point to use for having access to the concrete dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | AccessPointFacet | The access point to use for having access to the dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 1..n | AccessPointFacet | Identify the endpoints of the EService. | - +-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Properties | + +==========================================+================================+==========================================================+=================================================================================================================================================================================================================+==================================================================================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | endpoint | String | ``Mandatory:true`` ``ReadOnly:true`` ``NotNull:true`` | The URI which characterises the specific endpoint instance. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | authorization | :ref:`Property ` | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Contains authorisation information. e.g., a token, the couple username:password, etc. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | protocol | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The high-level protocol used by the access point. The String could contain the version if needed. e.g., Web Map Service (WMS) and not HyperText Transfer Protocol (HTTP) which is already contained in the URI. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | entryName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A distinguishing string to be used by clients to identify the access point of interest. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A human-oriented text accompanying the access point. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`ConsistsOf ` | 1..n | :ref:`AccessPointFacet ` | The access point to use for having access to the concrete dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`AccessPointFacet ` | The access point to use for having access to the dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 1..n | :ref:`AccessPointFacet ` | Identify the endpoints of the EService. | + +------------------------------------------+--------------------------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **AccessPointFacet** current version is 1.0.0. @@ -45,6 +49,8 @@ Changelog: * **1.0.0**: First Version. +.. _ActionFacet: + ActionFacet ----------- @@ -53,25 +59,25 @@ This facet is expected to capture information on which action perform while a re .. table:: **ActionFacet** ``extends`` **Facet** - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | Properties | - +========================================+====================+==========================================================+======================================================+=================+ - | **Name** | **Type** | **Attributes** | **Description** | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | options | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The options/params to use when executing the action. | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | type | EnumStringProperty | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Type of action | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | command | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The command to execute. | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | source | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:true`` | From where to download the action. | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | **Known Usage** | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ - | No specific known usage for this type. | - +----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | Properties | + +========================================+================================================+==========================================================+======================================================+=================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | options | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The options/params to use when executing the action. | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | type | :ref:`EnumStringProperty ` | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Type of action | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | command | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The command to execute. | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | source | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:true`` | From where to download the action. | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | **Known Usage** | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | No specific known usage for this type. | + +----------------------------------------+------------------------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ The **ActionFacet** current version is 1.0.0. @@ -81,33 +87,35 @@ Changelog: * **1.0.0**: First Version. +.. _CPUFacet: + CPUFacet -------- -CPUFacet captures information on the Central Processing Unit (CPU) of the resource it is associated with. A resource which needs to indicate a multi-processor/multi-core CPU will consist of more than one CPUFacet. Even if more than one CPUFacet is associated with a resource (i.e., an {@link HostingNode}), we did not find any reason to differentiate the CPUs. +CPUFacet captures information on the Central Processing Unit (CPU) of the resource it is associated with. A resource which needs to indicate a multi-processor/multi-core CPU will consist of more than one CPUFacet. Even if more than one CPUFacet is associated with a resource (i.e., an :ref:`HostingNode `), we did not find any reason to differentiate the CPUs. .. table:: **CPUFacet** ``extends`` **Facet** - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | Properties | - +=================+==============+========================================================+===================================================+========================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | clockSpeed | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Clock speed expressed with the unit, e.g., 1 GHz. | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | model | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | CPU Model | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | vendor | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | CPU Vendor | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | **Known Usage** | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | HostingNode | ConsistsOf | 1..n | CPUFacet | The CPU equipping the Hosting Node. | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ - | VirtualMachine | ConsistsOf | 1..n | CPUFacet | The CPU equipping the Virtual Machine. | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | Properties | + +========================================+================================+========================================================+===================================================+========================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | clockSpeed | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Clock speed expressed with the unit, e.g., 1 GHz. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | model | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | CPU Model | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | vendor | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | CPU Vendor | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | **Known Usage** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 1..n | :ref:`CPUFacet ` | The CPU equipping the Hosting Node. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 1..n | :ref:`CPUFacet ` | The CPU equipping the Virtual Machine. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+ The **CPUFacet** current version is 1.0.0. @@ -117,6 +125,8 @@ Changelog: * **1.0.0**: First Version. +.. _CapabilityFacet: + CapabilityFacet --------------- @@ -125,25 +135,25 @@ CapabilityFacet captures a defined facility for performing a specified task supp .. table:: **CapabilityFacet** ``extends`` **Facet** - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | Properties | - +=================+==============+==========================================================+=================================================+================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The distinguishing name of the capability. | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | qualifier | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A string used to specialise the capability. | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | description | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A human oriented description of the capability. | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | Service | ConsistsOf | 0..n | CapabilityFacet | Any facility supported/offered by the Service. | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ - | Software | ConsistsOf | 0..n | CapabilityFacet | | - +-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | Properties | + +============================+================================+==========================================================+=================================================+================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The distinguishing name of the capability. | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | qualifier | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A string used to specialise the capability. | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | description | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A human oriented description of the capability. | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | **Known Usage** | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | :ref:`Service ` | :ref:`ConsistsOf ` | 0..n | :ref:`CapabilityFacet ` | Any facility supported/offered by the Service. | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ + | :ref:`Software ` | :ref:`ConsistsOf ` | 0..n | :ref:`CapabilityFacet ` | | + +----------------------------+--------------------------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+ The **CapabilityFacet** current version is 1.0.0. @@ -153,6 +163,8 @@ Changelog: * **1.0.0**: First Version. +.. _ContactFacet: + ContactFacet ------------ @@ -161,49 +173,49 @@ ContactFacet captures information on a point of contact for the resource, i.e., .. table:: **ContactFacet** ``extends`` **Facet** - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Properties | - +=================+================+===========================================================================================================+================================================================================================+=================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | eMail | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` ``Regex:^[a-z0-9._%+-]{1,128}@[a-z0-9.-]{1,128}$`` | Email address | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | First Name | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | surname | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Surname | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | middleName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Middle Name | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | title | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A name describing the profession or marital status of the point of contact. e.g., Dr, Mrs, Mr. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Actor | IsIdentifiedBy | 1..1 | ContactFacet | An Actor has at least a Contact Facet which permit to identify the Actor per se. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | ConcreteDataset | HasMaintainer | 1..n | ContactFacet | The contact information of the entity responsible for the maintenance of the concrete dataset | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Dataset | HasContact | 1..n | ContactFacet | The contact information of the entity responsible for the dataset. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Dataset | HasContributor | 0..n | ContactFacet | The contact information on contributors supporting the creation and development of the Dataset. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Dataset | HasCreator | 0..n | ContactFacet | The contact information of the creator of the Dataset. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Dataset | HasCurator | 0..n | ContactFacet | The contact information of the entity responsible for the curation of the dataset. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Dataset | HasMaintainer | 0..n | ContactFacet | The contact information of the entity responsible for the maintenance of the dataset. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Dataset | HasOwner | 0..n | ContactFacet | The contact information of the entity having the ownership of the dataset. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Schema | HasContact | 1..n | ContactFacet | | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Site | HasContact | 1..n | ContactFacet | The main contact for the Site. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Site | HasMaintainer | 1..n | ContactFacet | Contact information of the maintainer of the Site. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ - | Site | HasManager | 1..n | ContactFacet | Contact information of the Site Manager. | - +-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | Properties | + +==========================================+========================================+===========================================================================================================+================================================================================================+=================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | eMail | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` ``Regex:^[a-z0-9._%+-]{1,128}@[a-z0-9.-]{1,128}$`` | Email address | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | First Name | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | surname | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Surname | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | middleName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Middle Name | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | title | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A name describing the profession or marital status of the point of contact. e.g., Dr, Mrs, Mr. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Actor ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`ContactFacet ` | An Actor has at least a Contact Facet which permit to identify the Actor per se. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`HasMaintainer ` | 1..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the maintenance of the concrete dataset | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the dataset. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasContributor ` | 0..n | :ref:`ContactFacet ` | The contact information on contributors supporting the creation and development of the Dataset. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCreator ` | 0..n | :ref:`ContactFacet ` | The contact information of the creator of the Dataset. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCurator ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the curation of the dataset. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasMaintainer ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the maintenance of the dataset. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasOwner ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity having the ownership of the dataset. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | The main contact for the Site. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`HasMaintainer ` | 1..n | :ref:`ContactFacet ` | Contact information of the maintainer of the Site. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`HasManager ` | 1..n | :ref:`ContactFacet ` | Contact information of the Site Manager. | + +------------------------------------------+----------------------------------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+ The **ContactFacet** current version is 1.0.0. @@ -213,6 +225,8 @@ Changelog: * **1.0.0**: First Version. +.. _ContactReferenceFacet: + ContactReferenceFacet --------------------- @@ -221,23 +235,23 @@ ContactReferenceFacet captures information on the primary and authoritative cont .. table:: **ContactReferenceFacet** ``extends`` **Facet** - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ - | Properties | - +=================+==============+==========================================================+=======================+=================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ - | address | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A physical address | - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ - | phoneNumber | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A phone number | - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ - | website | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The main website | - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ - | **Known Usage** | - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ - | Actor | ConsistsOf | 0..n | ContactReferenceFacet | | - +-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+ + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | Properties | + +======================+================================+==========================================================+======================================================+=================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | address | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A physical address | + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | phoneNumber | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A phone number | + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | website | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The main website | + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | **Known Usage** | + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ + | :ref:`Actor ` | :ref:`ConsistsOf ` | 0..n | :ref:`ContactReferenceFacet ` | | + +----------------------+--------------------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+ The **ContactReferenceFacet** current version is 1.0.0. @@ -247,6 +261,8 @@ Changelog: * **1.0.0**: First Version. +.. _CoverageFacet: + CoverageFacet ------------- @@ -255,23 +271,23 @@ CoverageFacet captures information on the extent of the resource, i.e., any aspe .. table:: **CoverageFacet** ``extends`` **Facet** - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ - | Properties | - +=================+=====================+========================================================+===============================================================================+=========================================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ - | coverage | ValueSchema | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value indicates the 'area' covered by the dataset according to the schema | - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasCoverage | 1..n | CoverageFacet | Any coverage related information (e.g. topic, species) characterising the content of the dataset. | - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasSpatialCoverage | 0..n | CoverageFacet | Any geo-spatial coverage information characterising the content of the dataset, e.g. the area covered by the dataset. | - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasTemporalCoverage | 0..n | CoverageFacet | Any temporal coverage information characterising the content of the dataset, e.g. the time-span covered by the dataset. | - +-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | Properties | + +==========================+==================================================+========================================================+===============================================================================+=========================================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | coverage | :ref:`ValueSchema ` | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value indicates the 'area' covered by the dataset according to the schema | + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCoverage ` | 1..n | :ref:`CoverageFacet ` | Any coverage related information (e.g. topic, species) characterising the content of the dataset. | + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasSpatialCoverage ` | 0..n | :ref:`CoverageFacet ` | Any geo-spatial coverage information characterising the content of the dataset, e.g. the area covered by the dataset. | + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasTemporalCoverage ` | 0..n | :ref:`CoverageFacet ` | Any temporal coverage information characterising the content of the dataset, e.g. the time-span covered by the dataset. | + +--------------------------+--------------------------------------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ The **CoverageFacet** current version is 1.0.0. @@ -281,6 +297,8 @@ Changelog: * **1.0.0**: First Version. +.. _DescriptiveMetadataFacet: + DescriptiveMetadataFacet ------------------------ @@ -289,23 +307,23 @@ DescriptiveMetadataFacet captures information on descriptive metadata to be asso .. table:: **DescriptiveMetadataFacet** ``extends`` **Facet** - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ - | Properties | - +=====================+==============+========================================================+=================================================================================+=======================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ - | descriptiveMetadata | ValueSchema | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | A metadata record representing the descriptive metadata according to the schema | - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ - | **Known Usage** | - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | DescriptiveMetadataFacet | Any descriptive information associated with the dataset, e.g. for discovery purposes. | - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ - | Schema | ConsistsOf | 0..n | DescriptiveMetadataFacet | | - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ - | Service | ConsistsOf | 0..n | DescriptiveMetadataFacet | Any descriptive information associated with the service, e.g. for discovery purposes. | - +---------------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + | Properties | + +==========================+==================================+========================================================+=================================================================================+=======================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + | descriptiveMetadata | :ref:`ValueSchema ` | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | A metadata record representing the descriptive metadata according to the schema | + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + | **Known Usage** | + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`DescriptiveMetadataFacet ` | Any descriptive information associated with the dataset, e.g. for discovery purposes. | + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`ConsistsOf ` | 0..n | :ref:`DescriptiveMetadataFacet ` | | + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`ConsistsOf ` | 0..n | :ref:`DescriptiveMetadataFacet ` | Any descriptive information associated with the service, e.g. for discovery purposes. | + +--------------------------+----------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+ The **DescriptiveMetadataFacet** current version is 1.0.0. @@ -315,6 +333,8 @@ Changelog: * **1.0.0**: First Version. +.. _EventFacet: + EventFacet ---------- @@ -323,27 +343,27 @@ EventFacet captures information on a certain event/happening characterising the .. table:: **EventFacet** ``extends`` **Facet** - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | Properties | - +=================+==============+========================================================+========================================+=============================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | date | Date | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The time the event took place/occurred | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | event | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The typology of event | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | EventFacet | Any 'event' characterising the lifecycle of the dataset, e.g. collection date, last collection date. | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 1..n | EventFacet | Events characterising the current status and lifecycle of the service, e.g. ActivationTime, DeploymentTime. | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 1..n | EventFacet | Every event characterizing the life cycle of the Hosting Node, e.g. the activation time. | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | ConsistsOf | 1..n | EventFacet | Every event characterizing the life cycle of the Virtual Machine, e.g. the activation time. | - +-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | Properties | + +========================================+================================+========================================================+========================================+=============================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | date | Date | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The time the event took place/occurred | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | event | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The typology of event | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`EventFacet ` | Any 'event' characterising the lifecycle of the dataset, e.g. collection date, last collection date. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 1..n | :ref:`EventFacet ` | Events characterising the current status and lifecycle of the service, e.g. ActivationTime, DeploymentTime. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 1..n | :ref:`EventFacet ` | Every event characterizing the life cycle of the Hosting Node, e.g. the activation time. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 1..n | :ref:`EventFacet ` | Every event characterizing the life cycle of the Virtual Machine, e.g. the activation time. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+ The **EventFacet** current version is 1.0.0. @@ -353,6 +373,8 @@ Changelog: * **1.0.0**: First Version. +.. _IdentifierFacet: + IdentifierFacet --------------- @@ -361,27 +383,27 @@ IdentifierFacet captures information on identifiers (other than the ones automat .. table:: **IdentifierFacet** ``extends`` **Facet** - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | Properties | - +=======================+================+======================================================================================================+=========================================================+==============================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | identificationType | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` ``Regex:^(URI|DOI|IRI|URL|URN|UUID|STRING)$`` | The typology of identifier | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The identifier | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | perstent | Boolean | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | To indicate whether the identifier is persistent or not | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | **Known Usage** | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | ConfigurationTemplate | IsIdentifiedBy | 1..1 | IdentifierFacet | | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | Dataset | IsIdentifiedBy | 1..1 | IdentifierFacet | The set of Identifiers associated with the Dataset instance. | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ - | Site | IsIdentifiedBy | 1..1 | IdentifierFacet | The Site Identifier. | - +-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | Properties | + +======================================================+========================================+======================================================================================================+=========================================================+==============================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | identificationType | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` ``Regex:^(URI|DOI|IRI|URL|URN|UUID|STRING)$`` | The typology of identifier | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The identifier | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | perstent | Boolean | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | To indicate whether the identifier is persistent or not | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | :ref:`ConfigurationTemplate ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | The set of Identifiers associated with the Dataset instance. | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ + | :ref:`Site ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | The Site Identifier. | + +------------------------------------------------------+----------------------------------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+ The **IdentifierFacet** current version is 1.0.0. @@ -391,6 +413,8 @@ Changelog: * **1.0.0**: First Version. +.. _LicenseFacet: + LicenseFacet ------------ @@ -399,23 +423,23 @@ LicenseFacet captures information on any license associated with the resource t .. table:: **LicenseFacet** ``extends`` **Facet** - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ - | Properties | - +=================+==============+========================================================+=================================================================================================================================================================================+=================================================================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ - | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The common name of the license. e.g., European Union Public Licence (EUPL) 1.1, GNU General Public License (GPL) 2, Berkeley Software Distribution (BSD), Common Creative (CC). | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ - | textURL | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The URL to the actual text of the license. | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | LicenseFacet | The licence governing dataset exploitation. The duration of license (if any) is captured by the expiry date defined in the consistsOf relation. | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 0..n | LicenseFacet | The specific terms of use governing the exploitation of the EService. | - +-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | Properties | + +============================+================================+========================================================+=================================================================================================================================================================================+=================================================================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The common name of the license. e.g., European Union Public Licence (EUPL) 1.1, GNU General Public License (GPL) 2, Berkeley Software Distribution (BSD), Common Creative (CC). | + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | textURL | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The URL to the actual text of the license. | + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`LicenseFacet ` | The licence governing dataset exploitation. The duration of license (if any) is captured by the expiry date defined in the consistsOf relation. | + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 0..n | :ref:`LicenseFacet ` | The specific terms of use governing the exploitation of the EService. | + +----------------------------+--------------------------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ The **LicenseFacet** current version is 1.0.0. @@ -425,33 +449,35 @@ Changelog: * **1.0.0**: First Version. +.. _LocationFacet: + LocationFacet ------------- -LocationFacet captures information on a physical area characterising the resource it is associated with. This should not be confused with {@link CoverageFacet}. The LocationFacet provides information of a location (eventually using latitude and longitude), instead {@link CoverageFacet} provide a way to to define the spatial or the temporal extent the resource represent. It is mainly used to locate a data centre or to the geographic references of a legal body playing the role of an actor in the infrastructure. +LocationFacet captures information on a physical area characterising the resource it is associated with. This should not be confused with :ref:`CoverageFacet `. The LocationFacet provides information of a location (eventually using latitude and longitude), instead :ref:`CoverageFacet ` provide a way to to define the spatial or the temporal extent the resource represent. It is mainly used to locate a data centre or to the geographic references of a legal body playing the role of an actor in the infrastructure. .. table:: **LocationFacet** ``extends`` **Facet** - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | Properties | - +=================+==============+==========================================================+=================================+=================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | longitude | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Longitude | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | latitude | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Latitude | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | location | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The City name | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | country | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The English name of the country | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | **Known Usage** | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ - | Site | ConsistsOf | 1..n | LocationFacet | | - +-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+ + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | Properties | + +====================+================================+==========================================================+======================================+=================+ + | **Name** | **Type** | **Attributes** | **Description** | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | longitude | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Longitude | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | latitude | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Latitude | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | location | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The City name | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | country | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The English name of the country | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | **Known Usage** | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ + | :ref:`Site ` | :ref:`ConsistsOf ` | 1..n | :ref:`LocationFacet ` | | + +--------------------+--------------------------------+----------------------------------------------------------+--------------------------------------+-----------------+ The **LocationFacet** current version is 1.0.0. @@ -461,37 +487,39 @@ Changelog: * **1.0.0**: First Version. +.. _MemoryFacet: + MemoryFacet ----------- -MemoryFacet captures information on computer memory equipping the resource and its usage. Any resource describing a computing machine must have at least two types of memories i.e., persistent and volatile. For such a reason, it has been identified the ConsistsOf relation called {@link HasMemory}. It is in charge of the specialisation {@link HasVolatileMemory} and {@link HasPersistentMemory} to clarify the semantics of the memory. +MemoryFacet captures information on computer memory equipping the resource and its usage. Any resource describing a computing machine must have at least two types of memories i.e., persistent and volatile. For such a reason, it has been identified the ConsistsOf relation called :ref:`HasMemory `. It is in charge of the specialisation :ref:`HasVolatileMemory ` and :ref:`HasPersistentMemory ` to clarify the semantics of the memory. .. table:: **MemoryFacet** ``extends`` **Facet** - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | Properties | - +=================+=====================+=====================================================================================================+=================+=================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | used | Long | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | unit | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` ``Regex:^(Byte|kB|MB|GB|TB|PB|EB|ZB|YB)$`` | | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | size | Long | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | **Known Usage** | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | HostingNode | HasPersistentMemory | 1..n | MemoryFacet | The Disk Space Capacity of the Hosting Node. | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | HostingNode | HasVolatileMemory | 1..n | MemoryFacet | The RAM Capacity of the Hosting Node. | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | VirtualMachine | HasPersistentMemory | 1..n | MemoryFacet | The Disk Space Capacity of the Virtual Machine. | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ - | VirtualMachine | HasVolatileMemory | 1..n | MemoryFacet | The RAM Capacity of the Virtual Machine. | - +-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+ + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | Properties | + +========================================+==================================================+=====================================================================================================+==================================+=================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | used | Long | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | unit | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` ``Regex:^(Byte|kB|MB|GB|TB|PB|EB|ZB|YB)$`` | | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | size | Long | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | **Known Usage** | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`HasPersistentMemory ` | 1..n | :ref:`MemoryFacet ` | The Disk Space Capacity of the Hosting Node. | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`HasVolatileMemory ` | 1..n | :ref:`MemoryFacet ` | The RAM Capacity of the Hosting Node. | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`HasPersistentMemory ` | 1..n | :ref:`MemoryFacet ` | The Disk Space Capacity of the Virtual Machine. | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`HasVolatileMemory ` | 1..n | :ref:`MemoryFacet ` | The RAM Capacity of the Virtual Machine. | + +----------------------------------------+--------------------------------------------------+-----------------------------------------------------------------------------------------------------+----------------------------------+-------------------------------------------------+ The **MemoryFacet** current version is 1.0.0. @@ -501,39 +529,41 @@ Changelog: * **1.0.0**: First Version. +.. _NetworkingFacet: + NetworkingFacet --------------- -NetworkingFacet captures information on any (computer) network interface associated with the resource.It is mainly used to describe the network interface of a host. It should not be confused with the {@link AccessPointFacet} which instead describes the protocol and the endpoint of a web-based service. +NetworkingFacet captures information on any (computer) network interface associated with the resource.It is mainly used to describe the network interface of a host. It should not be confused with the :ref:`AccessPointFacet ` which instead describes the protocol and the endpoint of a web-based service. .. table:: **NetworkingFacet** ``extends`` **Facet** - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | Properties | - +==================+================+==========================================================+================================+====================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | IPAddress | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Internet Protocol (IP) Address | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | broadcastAddress | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Broadcast Address | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | hostName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Host Name | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | domainName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Domain Name | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | mask | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Network Mask | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | **Known Usage** | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | HostingNode | IsIdentifiedBy | 1..1 | NetworkingFacet | The Network ID characterising the Hosting Node. | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | Site | ConsistsOf | 1..n | NetworkingFacet | | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ - | VirtualMachine | IsIdentifiedBy | 1..1 | NetworkingFacet | The Network ID characterising the Virtual Machine. | - +------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+ + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | Properties | + +========================================+========================================+==========================================================+==========================================+====================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | IPAddress | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Internet Protocol (IP) Address | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | broadcastAddress | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Broadcast Address | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | hostName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Host Name | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | domainName | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Domain Name | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | mask | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Network Mask | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | **Known Usage** | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`NetworkingFacet ` | The Network ID characterising the Hosting Node. | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`ConsistsOf ` | 1..n | :ref:`NetworkingFacet ` | | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`NetworkingFacet ` | The Network ID characterising the Virtual Machine. | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------+----------------------------------------------------+ The **NetworkingFacet** current version is 1.0.0. @@ -543,6 +573,8 @@ Changelog: * **1.0.0**: First Version. +.. _ProvenanceFacet: + ProvenanceFacet --------------- @@ -551,23 +583,23 @@ ProvenanceFacet captures information on provenance/lineage of the entire resourc .. table:: **ProvenanceFacet** ``extends`` **Facet** - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ - | Properties | - +=================+==============+======================================================================================================+===========================================================================================================================================================================================================================================+====================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ - | document | ValueSchema | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Provenance Document, e.g., an XML according to the reference schema. | - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ - | reference | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The ID of the referenced resource. | - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ - | relationship | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` ``Regex:^(wasDerivedFrom|wasGeneratedBy)$`` | Relationship with the resource indicated by ID. Please note that the provenance has not been modelled as IsRelatedTo specialization, because the source resource is not necessarly in the IS or could be deleted from the IS at any time. | - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | ProvenanceFacet | Any provenance record associated with the dataset. | - +-----------------+--------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + | Properties | + +==========================+==================================+======================================================================================================+===========================================================================================================================================================================================================================================+====================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + | document | :ref:`ValueSchema ` | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Provenance Document, e.g., an XML according to the reference schema. | + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + | reference | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The ID of the referenced resource. | + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + | relationship | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` ``Regex:^(wasDerivedFrom|wasGeneratedBy)$`` | Relationship with the resource indicated by ID. Please note that the provenance has not been modelled as IsRelatedTo specialization, because the source resource is not necessarly in the IS or could be deleted from the IS at any time. | + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + | **Known Usage** | + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`ProvenanceFacet ` | Any provenance record associated with the dataset. | + +--------------------------+----------------------------------+------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------+ The **ProvenanceFacet** current version is 1.0.0. @@ -577,6 +609,8 @@ Changelog: * **1.0.0**: First Version. +.. _SchemaFacet: + SchemaFacet ----------- @@ -585,23 +619,23 @@ SchemaFacet captures information on any schema, i.e., a vocabulary used to valid .. table:: **SchemaFacet** ``extends`` **Facet** - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ - | Properties | - +=================+================+==========================================================+===========================================================================================================================================================================================================================================================================================================================+=================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ - | description | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Schema Description | - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ - | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Schema Name | - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ - | schema | ValueSchema | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The 'value' property contains the defined 'schema' that in turn is validated by the schema available at the URL indicated in the ’schema’ property. An example could be an XSD schema instantiation as 'value' and the URL of the DTD defining the XSD as 'schema' i.e., https://www.w3.org/2009/XMLSchema/XMLSchema.dtd. | - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ - | **Known Usage** | - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ - | Schema | IsIdentifiedBy | 1..1 | SchemaFacet | | - +-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + | Properties | + +========================+========================================+==========================================================+===========================================================================================================================================================================================================================================================================================================================+=================+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + | description | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Schema Description | + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Schema Name | + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + | schema | :ref:`ValueSchema ` | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | The 'value' property contains the defined 'schema' that in turn is validated by the schema available at the URL indicated in the ’schema’ property. An example could be an XSD schema instantiation as 'value' and the URL of the DTD defining the XSD as 'schema' i.e., https://www.w3.org/2009/XMLSchema/XMLSchema.dtd. | + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + | **Known Usage** | + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ + | :ref:`Schema ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SchemaFacet ` | | + +------------------------+----------------------------------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+ The **SchemaFacet** current version is 1.0.0. @@ -611,6 +645,8 @@ Changelog: * **1.0.0**: First Version. +.. _SimpleFacet: + SimpleFacet ----------- @@ -641,6 +677,8 @@ Changelog: * **1.0.0**: First Version. +.. _SimplePropertyFacet: + SimplePropertyFacet ------------------- @@ -649,21 +687,21 @@ Collect name-value property .. table:: **SimplePropertyFacet** ``extends`` **Facet** - +-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+ - | Properties | - +=================+==============+========================================================+=====================+===================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+ - | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | | - +-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+ - | value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | | - +-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 0..n | SimplePropertyFacet | Any pair property worth associating with the Hosting Node, e.g. Environment Variables | - +-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+ + +----------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------------------------+ + | Properties | + +==================================+================================+========================================================+==================================================+===================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------------------------+ + | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | | + +----------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------------------------+ + | value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | | + +----------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +----------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 0..n | :ref:`SimplePropertyFacet ` | Any pair property worth associating with the Hosting Node, e.g. Environment Variables | + +----------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------------------------+---------------------------------------------------------------------------------------------------+ The **SimplePropertyFacet** current version is 1.0.0. @@ -673,6 +711,8 @@ Changelog: * **1.0.0**: First Version. +.. _SoftwareFacet: + SoftwareFacet ------------- @@ -681,41 +721,41 @@ SoftwareFacet captures information on any software associated with the resource. .. table:: **SoftwareFacet** ``extends`` **Facet** - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Properties | - +=================+================+==========================================================+==========================================================================================================================================================================================+=====================================================================================================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | group | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The name of 'group' the software artifact belongs to, e.g., groupId in maven coordinates, company name for retail software software such as 'Microsoft™' (in Microsoft™ Office 2013-SP2) | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The name of the software artifact being described, e.g., artifactId in maven coordinates, the software name for retail software such as 'Office' (in Microsoft™ Office 2013-SP2) | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | version | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The particular release of the software artifact, e.g., version in maven coordinates, the software version for retail software such as '2013-SP2' (in Microsoft™ Office 2013-SP2) | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | optional | Boolean | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Used to indicate the software optionality, e.g., optional in maven coordinates | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | description | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A human oriented description of the software artifact being described | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | qualifier | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A qualifier for the software, e.g., packaging or scope in maven coordinates, target architecture for retail software such as x86 or amd64 | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 0..n | SoftwareFacet | Software available in the EService environment that characterizes the specific EService instance. | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | IsIdentifiedBy | 1..1 | SoftwareFacet | The main software enabling the EService capabilities. | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 0..n | SoftwareFacet | Any Software characterising the Hosting Node. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | ConsistsOf | 1..n | SoftwareFacet | Apart the one connected by the IsIdentifiedBy relation (gCube coordinates) the others identify the software in other way e.g. (Maven coordinates). | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | IsIdentifiedBy | 1..1 | SoftwareFacet | Software coordinates which identify the Software per se. | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | ConsistsOf | 0..n | SoftwareFacet | Any Software characterising the Virtual Machine. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualService | IsIdentifiedBy | 1..n | SoftwareFacet | | - +-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Properties | + +========================================+========================================+==========================================================+==========================================================================================================================================================================================+=====================================================================================================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | group | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The name of 'group' the software artifact belongs to, e.g., groupId in maven coordinates, company name for retail software software such as 'Microsoft™' (in Microsoft™ Office 2013-SP2) | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | name | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The name of the software artifact being described, e.g., artifactId in maven coordinates, the software name for retail software such as 'Office' (in Microsoft™ Office 2013-SP2) | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | version | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The particular release of the software artifact, e.g., version in maven coordinates, the software version for retail software such as '2013-SP2' (in Microsoft™ Office 2013-SP2) | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | optional | Boolean | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Used to indicate the software optionality, e.g., optional in maven coordinates | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | description | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A human oriented description of the software artifact being described | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | qualifier | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | A qualifier for the software, e.g., packaging or scope in maven coordinates, target architecture for retail software such as x86 or amd64 | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 0..n | :ref:`SoftwareFacet ` | Software available in the EService environment that characterizes the specific EService instance. | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SoftwareFacet ` | The main software enabling the EService capabilities. | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 0..n | :ref:`SoftwareFacet ` | Any Software characterising the Hosting Node. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`ConsistsOf ` | 1..n | :ref:`SoftwareFacet ` | Apart the one connected by the IsIdentifiedBy relation (gCube coordinates) the others identify the software in other way e.g. (Maven coordinates). | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SoftwareFacet ` | Software coordinates which identify the Software per se. | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 0..n | :ref:`SoftwareFacet ` | Any Software characterising the Virtual Machine. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualService ` | :ref:`IsIdentifiedBy ` | 1..n | :ref:`SoftwareFacet ` | | + +----------------------------------------+----------------------------------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **SoftwareFacet** current version is 1.0.0. @@ -725,6 +765,8 @@ Changelog: * **1.0.0**: First Version. +.. _StateFacet: + StateFacet ---------- @@ -733,23 +775,23 @@ StateFacet captures information on state to be associated with the resource. The .. table:: **StateFacet** ``extends`` **Facet** - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ - | Properties | - +=================+==============+========================================================+========================+======================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ - | value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value of the state | - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 1..1 | StateFacet | The current status of the EService, e.g. STARTED, ready, down, failed. | - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 1..1 | StateFacet | The current state of the Hosting Node, e.g. started, ready, certified, down, failed. | - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ - | VirtualMachine | ConsistsOf | 1..1 | StateFacet | The current state of the Virtual Machine, e.g. started, ready, down, unreachable. | - +-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+ + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ + | Properties | + +========================================+================================+========================================================+================================+======================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ + | value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value of the state | + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ + | **Known Usage** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 1..1 | :ref:`StateFacet ` | The current status of the EService, e.g. STARTED, ready, down, failed. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 1..1 | :ref:`StateFacet ` | The current state of the Hosting Node, e.g. started, ready, certified, down, failed. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 1..1 | :ref:`StateFacet ` | The current state of the Virtual Machine, e.g. started, ready, down, unreachable. | + +----------------------------------------+--------------------------------+--------------------------------------------------------+--------------------------------+--------------------------------------------------------------------------------------+ The **StateFacet** current version is 1.0.0. @@ -759,6 +801,8 @@ Changelog: * **1.0.0**: First Version. +.. _SubjectFacet: + SubjectFacet ------------ @@ -767,23 +811,23 @@ SubjectFacet captures information on subjects associated with the resource for d .. table:: **SubjectFacet** ``extends`` **Facet** - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | Properties | - +=================+==============+========================================================+==================================================+==================================================================================================+ - | **Name** | **Type** | **Attributes** | **Description** | - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | subject | ValueSchema | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value of the subject according to the schema | - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | SubjectFacet | Any subject/tag associated with the dataset for descriptive and discovery purposes. | - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | Schema | ConsistsOf | 0..n | SubjectFacet | | - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | Service | ConsistsOf | 0..n | SubjectFacet | Any subject/tag associated with the service for descriptive, cataloguing and discovery purposes. | - +-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | Properties | + +==========================+==================================+========================================================+==================================================+==================================================================================================+ + | **Name** | **Type** | **Attributes** | **Description** | + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | subject | :ref:`ValueSchema ` | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value of the subject according to the schema | + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`SubjectFacet ` | Any subject/tag associated with the dataset for descriptive and discovery purposes. | + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`ConsistsOf ` | 0..n | :ref:`SubjectFacet ` | | + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`ConsistsOf ` | 0..n | :ref:`SubjectFacet ` | Any subject/tag associated with the service for descriptive, cataloguing and discovery purposes. | + +--------------------------+----------------------------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+ The **SubjectFacet** current version is 1.0.0. diff --git a/docs/gcube-model-isrelatedto.rst b/docs/gcube-model-isrelatedto.rst index e8e10c6..65e7034 100644 --- a/docs/gcube-model-isrelatedto.rst +++ b/docs/gcube-model-isrelatedto.rst @@ -1,35 +1,39 @@ +.. _IsRelatedTo: + IsRelatedTo =========== +.. _Activates: + Activates --------- -Activates has a {@link Service} instance both as source and target as well as {@link CallsFor} but with a complete different semantic. Activates is used to indicates that the source {@link Service} of the relation enable the operation of the target Service. Examples are between a {@link VirtualMachine} and an {@link HostingNode} to capture the {@link VirtualMachine} is operating the {@link HostingNode}. Another example is between a {@link VirtualMachine} and an {@link EService}, e.g., between a {@link VirtualMachine} and a database instance. This relation can be created also between an {@link HostingNode} and one {@link EService}, e.g., to represent a container e.g., Tomcat and the web-service(s) is operating. Activates is also used between an {@link EService} and a {@link RunningPlugin} which enrich the functionality offered by the source service. +Activates has a :ref:`Service ` instance both as source and target as well as :ref:`CallsFor ` but with a complete different semantic. Activates is used to indicates that the source :ref:`Service ` of the relation enable the operation of the target Service. Examples are between a :ref:`VirtualMachine ` and an :ref:`HostingNode ` to capture the :ref:`VirtualMachine ` is operating the :ref:`HostingNode `. Another example is between a :ref:`VirtualMachine ` and an :ref:`EService `, e.g., between a :ref:`VirtualMachine ` and a database instance. This relation can be created also between an :ref:`HostingNode ` and one :ref:`EService `, e.g., to represent a container e.g., Tomcat and the web-service(s) is operating. Activates is also used between an :ref:`EService ` and a :ref:`RunningPlugin ` which enrich the functionality offered by the source service. .. table:: **Activates** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+==============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Activates | 0..n | Service | Activates has a {@link Service} instance both as source and target as well as {@link CallsFor} but with a complete different semantic. Activates is used to indicates that the source {@link Service} of the relation enable the operation of the target Service. Examples are between a {@link VirtualMachine} and an {@link HostingNode} to capture the {@link VirtualMachine} is operating the {@link HostingNode}. Another example is between a {@link VirtualMachine} and an {@link EService}, e.g., between a {@link VirtualMachine} and a database instance. This relation can be created also between an {@link HostingNode} and one {@link EService}, e.g., to represent a container e.g., Tomcat and the web-service(s) is operating. Activates is also used between an {@link EService} and a {@link RunningPlugin} which enrich the functionality offered by the source service. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Activates | 0..n | Service | The source Service enables the target Service to be running. Examples are an Hosting Node which enables an EService; A VirtualMachine enabling an EService or an HostingNode; An EService enabling a RunningPlugin; A VirtualMachine enabling an HostingNode etc | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================+==================+==========================+==============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Activates ` | 0..n | :ref:`Service ` | Activates has a :ref:`Service ` instance both as source and target as well as :ref:`CallsFor ` but with a complete different semantic. Activates is used to indicates that the source :ref:`Service ` of the relation enable the operation of the target Service. Examples are between a :ref:`VirtualMachine ` and an :ref:`HostingNode ` to capture the :ref:`VirtualMachine ` is operating the :ref:`HostingNode `. Another example is between a :ref:`VirtualMachine ` and an :ref:`EService `, e.g., between a :ref:`VirtualMachine ` and a database instance. This relation can be created also between an :ref:`HostingNode ` and one :ref:`EService `, e.g., to represent a container e.g., Tomcat and the web-service(s) is operating. Activates is also used between an :ref:`EService ` and a :ref:`RunningPlugin ` which enrich the functionality offered by the source service. | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Activates ` | 0..n | :ref:`Service ` | The source Service enables the target Service to be running. Examples are an Hosting Node which enables an EService; A VirtualMachine enabling an EService or an HostingNode; An EService enabling a RunningPlugin; A VirtualMachine enabling an HostingNode etc | + +------------------------------------------------------+------------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Activates** current version is 1.0.0. @@ -39,33 +43,35 @@ Changelog: * **1.0.0**: First Version. +.. _BelongsTo: + BelongsTo --------- -BelongsTo indicates that a {@link Person} belong to the target {@link LegalBody}. +BelongsTo indicates that a :ref:`Person ` belong to the target :ref:`LegalBody `. .. table:: **BelongsTo** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+===================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | Person | BelongsTo | 0..n | LegalBody | BelongsTo indicates that a {@link Person} belong to the target {@link LegalBody}. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ - | Person | BelongsTo | 0..n | LegalBody | | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================+==================+==============================+======================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | :ref:`Person ` | :ref:`BelongsTo ` | 0..n | :ref:`LegalBody ` | BelongsTo indicates that a :ref:`Person ` belong to the target :ref:`LegalBody `. | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ + | :ref:`Person ` | :ref:`BelongsTo ` | 0..n | :ref:`LegalBody ` | | + +------------------------------------------------------+------------------------------+------------------+------------------------------+------------------------------------------------------------------------------------------------------+ The **BelongsTo** current version is 1.0.0. @@ -75,33 +81,35 @@ Changelog: * **1.0.0**: First Version. +.. _CallsFor: + CallsFor -------- -A {@link Service} instance can require another {@link Service} instance to properly operate and this is indicated with CallsFor. Motivations similar to the ones for {@link Requires} relation conducted to the definition for this relation. +A :ref:`Service ` instance can require another :ref:`Service ` instance to properly operate and this is indicated with CallsFor. Motivations similar to the ones for :ref:`Requires ` relation conducted to the definition for this relation. .. table:: **CallsFor** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+===============================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | CallsFor | 0..n | Service | A {@link Service} instance can require another {@link Service} instance to properly operate and this is indicated with CallsFor. Motivations similar to the ones for {@link Requires} relation conducted to the definition for this relation. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | CallsFor | 0..n | Service | A reference to the Services needed by the target instance to work. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+============================+==================+==========================+===========================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`CallsFor ` | 0..n | :ref:`Service ` | A :ref:`Service ` instance can require another :ref:`Service ` instance to properly operate and this is indicated with CallsFor. Motivations similar to the ones for :ref:`Requires ` relation conducted to the definition for this relation. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`CallsFor ` | 0..n | :ref:`Service ` | A reference to the Services needed by the target instance to work. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **CallsFor** current version is 1.0.0. @@ -111,33 +119,35 @@ Changelog: * **1.0.0**: First Version. +.. _Discovers: + Discovers ^^^^^^^^^ -Any {@link EService} or its specialisations can be related with another {@link EService} with Discovers relation. Discovers relation inform that the source {@link EService} discovers the target through the information system.Discovers relation specialise the semantic of {@link CallsFor}. +Any :ref:`EService ` or its specialisations can be related with another :ref:`EService ` with Discovers relation. Discovers relation inform that the source :ref:`EService ` discovers the target through the information system.Discovers relation specialise the semantic of :ref:`CallsFor `. .. table:: **Discovers** ``extends`` **CallsFor** - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+==================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | Discovers | 0..n | EService | Any {@link EService} or its specialisations can be related with another {@link EService} with Discovers relation. Discovers relation inform that the source {@link EService} discovers the target through the information system.Discovers relation specialise the semantic of {@link CallsFor}. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | Discovers | 0..n | EService | A reference to any other EService, the EService instance is discovering through query on IS. | - +------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================+==================+============================+==========================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`Discovers ` | 0..n | :ref:`EService ` | Any :ref:`EService ` or its specialisations can be related with another :ref:`EService ` with Discovers relation. Discovers relation inform that the source :ref:`EService ` discovers the target through the information system.Discovers relation specialise the semantic of :ref:`CallsFor `. | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`Discovers ` | 0..n | :ref:`EService ` | A reference to any other EService, the EService instance is discovering through query on IS. | + +------------------------------------------------------+------------------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Discovers** current version is 1.0.0. @@ -147,33 +157,35 @@ Changelog: * **1.0.0**: First Version. +.. _Uses: + Uses ^^^^ -Uses relation inform regarding the network invocation of the target{@link EService} by the source. Uses relation specialises the semantic of {@link CallsFor}. +Uses relation inform regarding the network invocation of the target:ref:`EService ` by the source. Uses relation specialises the semantic of :ref:`CallsFor `. .. table:: **Uses** ``extends`` **CallsFor** - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | Uses | 0..n | EService | Uses relation inform regarding the network invocation of the target{@link EService} by the source. Uses relation specialises the semantic of {@link CallsFor}. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | EService | Uses | 0..n | EService | A reference to any other EService, the EService instance is invoking. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+====================+==================+============================+====================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`Uses ` | 0..n | :ref:`EService ` | Uses relation inform regarding the network invocation of the target:ref:`EService ` by the source. Uses relation specialises the semantic of :ref:`CallsFor `. | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`Uses ` | 0..n | :ref:`EService ` | A reference to any other EService, the EService instance is invoking. | + +------------------------------------------------------+--------------------+------------------+----------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Uses** current version is 1.0.0. @@ -183,33 +195,35 @@ Changelog: * **1.0.0**: First Version. +.. _Demands: + Demands ------- -Demands is used to properly support to share a {@link VirtualService} with another context. +Demands is used to properly support to share a :ref:`VirtualService ` with another context. .. table:: **Demands** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=============================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | VirtualService | Demands | 0..n | Software | Demands is used to properly support to share a {@link VirtualService} with another context. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ - | VirtualService | Demands | 0..n | Software | | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==========================+==================+============================+=============================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualService ` | :ref:`Demands ` | 0..n | :ref:`Software ` | Demands is used to properly support to share a :ref:`VirtualService ` with another context. | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualService ` | :ref:`Demands ` | 0..n | :ref:`Software ` | | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------+ The **Demands** current version is 1.0.0. @@ -219,33 +233,35 @@ Changelog: * **1.0.0**: First Version. +.. _DependsOn: + DependsOn --------- -DependsOn indicates that a {@link Software} requires another one to work. This relation must not be confused with {@link Requires}. +DependsOn indicates that a :ref:`Software ` requires another one to work. This relation must not be confused with :ref:`Requires `. .. table:: **DependsOn** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=====================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | Software | DependsOn | 0..n | Software | DependsOn indicates that a {@link Software} requires another one to work. This relation must not be confused with {@link Requires}. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ - | Software | DependsOn | 0..n | Software | To capture any dependency between two software artifacts. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================+==================+============================+=========================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`DependsOn ` | 0..n | :ref:`Software ` | DependsOn indicates that a :ref:`Software ` requires another one to work. This relation must not be confused with :ref:`Requires `. | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`DependsOn ` | 0..n | :ref:`Software ` | To capture any dependency between two software artifacts. | + +------------------------------------------------------+------------------------------+------------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ The **DependsOn** current version is 1.0.0. @@ -255,35 +271,37 @@ Changelog: * **1.0.0**: First Version. +.. _IsPluginOf: + IsPluginOf ^^^^^^^^^^ -A {@link Plugin} is a piece of Software extending the capabilities of another {@link Software} (main) and requiring the main {@link Software} to be executed. The relation between the main {@link Software} and the {@link Plugin} is expressed by IsPluginOf relation. IsPluginOf is an extension of {@link DependsOn}. +A :ref:`Plugin ` is a piece of Software extending the capabilities of another :ref:`Software ` (main) and requiring the main :ref:`Software ` to be executed. The relation between the main :ref:`Software ` and the :ref:`Plugin ` is expressed by IsPluginOf relation. IsPluginOf is an extension of :ref:`DependsOn `. .. table:: **IsPluginOf** ``extends`` **DependsOn** - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+============================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Plugin | IsPluginOf | 0..n | Software | A {@link Plugin} is a piece of Software extending the capabilities of another {@link Software} (main) and requiring the main {@link Software} to be executed. The relation between the main {@link Software} and the {@link Plugin} is expressed by IsPluginOf relation. IsPluginOf is an extension of {@link DependsOn}. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Plugin | IsPluginOf | 0..n | Software | A reference to the Software this Plugin is conceived to extend the capabilities. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Plugin | IsPluginOf | 0..n | Software | To capture the relation between a Software and its Plugins. | - +------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+================================+==================+============================+=====================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Plugin ` | :ref:`IsPluginOf ` | 0..n | :ref:`Software ` | A :ref:`Plugin ` is a piece of Software extending the capabilities of another :ref:`Software ` (main) and requiring the main :ref:`Software ` to be executed. The relation between the main :ref:`Software ` and the :ref:`Plugin ` is expressed by IsPluginOf relation. IsPluginOf is an extension of :ref:`DependsOn `. | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Plugin ` | :ref:`IsPluginOf ` | 0..n | :ref:`Software ` | A reference to the Software this Plugin is conceived to extend the capabilities. | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Plugin ` | :ref:`IsPluginOf ` | 0..n | :ref:`Software ` | To capture the relation between a Software and its Plugins. | + +------------------------------------------------------+--------------------------------+------------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **IsPluginOf** current version is 1.0.0. @@ -293,33 +311,35 @@ Changelog: * **1.0.0**: First Version. +.. _Enables: + Enables ------- -Any {@link Service} representing running code of a specific software has the relation Enables targeted to the corresponding {@link Software}. Enables is used for example by {@link EService} to indicates the running software; from {@link HostingNode} to indicate the running software container; within {@link RunningPlugin} and the software represented as {@link Plugin}. +Any :ref:`Service ` representing running code of a specific software has the relation Enables targeted to the corresponding :ref:`Software `. Enables is used for example by :ref:`EService ` to indicates the running software; from :ref:`HostingNode ` to indicate the running software container; within :ref:`RunningPlugin ` and the software represented as :ref:`Plugin `. .. table:: **Enables** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+====================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Enables | 0..n | Software | Any {@link Service} representing running code of a specific software has the relation Enables targeted to the corresponding {@link Software}. Enables is used for example by {@link EService} to indicates the running software; from {@link HostingNode} to indicate the running software container; within {@link RunningPlugin} and the software represented as {@link Plugin}. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Enables | 0..n | Software | A reference to any Software the Service is enabling (i.e. the Software is running throught the EService). | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==========================+==================+============================+=====================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Enables ` | 0..n | :ref:`Software ` | Any :ref:`Service ` representing running code of a specific software has the relation Enables targeted to the corresponding :ref:`Software `. Enables is used for example by :ref:`EService ` to indicates the running software; from :ref:`HostingNode ` to indicate the running software container; within :ref:`RunningPlugin ` and the software represented as :ref:`Plugin `. | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Enables ` | 0..n | :ref:`Software ` | A reference to any Software the Service is enabling (i.e. the Software is running throught the EService). | + +------------------------------------------------------+--------------------------+------------------+----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Enables** current version is 1.0.0. @@ -329,33 +349,35 @@ Changelog: * **1.0.0**: First Version. +.. _Hosts: + Hosts ----- -Hosts relation is used from a {@link Site} a {@link Service} instance. The target of the Hosts relation depends on the service offered by the Site. When the resources provided by a site are virtual machines, Hosts relation is created from a {@link Site} to a {@link VirtualMachine}. When, instead a Site provides web-services, Hosts relation is created with {@link EService}. If a site provides container facilities Hosts relation is created with {@link HostingNode}. By defining Hosts relation with target {@link Service}, the model is capable of representing the diverse type of federated systems and service. +Hosts relation is used from a :ref:`Site ` a :ref:`Service ` instance. The target of the Hosts relation depends on the service offered by the Site. When the resources provided by a site are virtual machines, Hosts relation is created from a :ref:`Site ` to a :ref:`VirtualMachine `. When, instead a Site provides web-services, Hosts relation is created with :ref:`EService `. If a site provides container facilities Hosts relation is created with :ref:`HostingNode `. By defining Hosts relation with target :ref:`Service `, the model is capable of representing the diverse type of federated systems and service. .. table:: **Hosts** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=====================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | Hosts | 0..n | Service | Hosts relation is used from a {@link Site} a {@link Service} instance. The target of the Hosts relation depends on the service offered by the Site. When the resources provided by a site are virtual machines, Hosts relation is created from a {@link Site} to a {@link VirtualMachine}. When, instead a Site provides web-services, Hosts relation is created with {@link EService}. If a site provides container facilities Hosts relation is created with {@link HostingNode}. By defining Hosts relation with target {@link Service}, the model is capable of representing the diverse type of federated systems and service. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | Hosts | 0..n | Service | | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+======================+==================+==========================+==========================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`Hosts ` | 0..n | :ref:`Service ` | Hosts relation is used from a :ref:`Site ` a :ref:`Service ` instance. The target of the Hosts relation depends on the service offered by the Site. When the resources provided by a site are virtual machines, Hosts relation is created from a :ref:`Site ` to a :ref:`VirtualMachine `. When, instead a Site provides web-services, Hosts relation is created with :ref:`EService `. If a site provides container facilities Hosts relation is created with :ref:`HostingNode `. By defining Hosts relation with target :ref:`Service `, the model is capable of representing the diverse type of federated systems and service. | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`Hosts ` | 0..n | :ref:`Service ` | | + +------------------------------------------------------+----------------------+------------------+--------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Hosts** current version is 1.0.0. @@ -365,33 +387,35 @@ Changelog: * **1.0.0**: First Version. +.. _Involves: + Involves -------- -Involves is used to indicate that and {@link Actor} is involved in a {@link Dataset}. +Involves is used to indicate that and :ref:`Actor ` is involved in a :ref:`Dataset `. .. table:: **Involves** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=======================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | Dataset | Involves | 0..n | Actor | Involves is used to indicate that and {@link Actor} is involved in a {@link Dataset}. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ - | Dataset | Involves | 0..n | Actor | | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+============================+==================+======================+=======================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`Involves ` | 0..n | :ref:`Actor ` | Involves is used to indicate that and :ref:`Actor ` is involved in a :ref:`Dataset `. | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`Involves ` | 0..n | :ref:`Actor ` | | + +------------------------------------------------------+----------------------------+------------------+----------------------+-------------------------------------------------------------------------------------------------------+ The **Involves** current version is 1.0.0. @@ -401,33 +425,35 @@ Changelog: * **1.0.0**: First Version. +.. _IsCompliantWith: + IsCompliantWith --------------- -IsCompliantWith is used to indicated a {@link Dataset} compliant with a {@link Schema}. +IsCompliantWith is used to indicated a :ref:`Dataset ` compliant with a :ref:`Schema `. .. table:: **IsCompliantWith** ``extends`` **IsRelatedTo** - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+=================+==================+=================+========================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | Dataset | IsCompliantWith | 0..n | Schema | IsCompliantWith is used to indicated a {@link Dataset} compliant with a {@link Schema}. | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ - | Dataset | IsCompliantWith | 0..n | Schema | Any schema characterising the content of the dataset, e.g. the schema describing the 'columns' of a CSV-based dataset. | - +------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==========================================+==================+========================+========================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsCompliantWith ` | 0..n | :ref:`Schema ` | IsCompliantWith is used to indicated a :ref:`Dataset ` compliant with a :ref:`Schema `. | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsCompliantWith ` | 0..n | :ref:`Schema ` | Any schema characterising the content of the dataset, e.g. the schema describing the 'columns' of a CSV-based dataset. | + +------------------------------------------------------+------------------------------------------+------------------+------------------------+------------------------------------------------------------------------------------------------------------------------+ The **IsCompliantWith** current version is 1.0.0. @@ -437,33 +463,35 @@ Changelog: * **1.0.0**: First Version. +.. _IsConfiguredBy: + IsConfiguredBy -------------- -The relation IsConfiguredBy indicates that the source {@link Software} requires a configuration when it is instantiated. +The relation IsConfiguredBy indicates that the source :ref:`Software ` requires a configuration when it is instantiated. .. table:: **IsConfiguredBy** ``extends`` **IsRelatedTo** - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+================+==================+=======================+==========================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | Software | IsConfiguredBy | 0..n | ConfigurationTemplate | The relation IsConfiguredBy indicates that the source {@link Software} requires a configuration when it is instantiated. | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ - | Software | IsConfiguredBy | 0..n | ConfigurationTemplate | | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+========================================+==================+======================================================+====================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`IsConfiguredBy ` | 0..n | :ref:`ConfigurationTemplate ` | The relation IsConfiguredBy indicates that the source :ref:`Software ` requires a configuration when it is instantiated. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`IsConfiguredBy ` | 0..n | :ref:`ConfigurationTemplate ` | | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ The **IsConfiguredBy** current version is 1.0.0. @@ -473,33 +501,35 @@ Changelog: * **1.0.0**: First Version. +.. _IsCorrelatedTo: + IsCorrelatedTo -------------- -IsCorrelatedTo relates a {@link Dataset} to another. +IsCorrelatedTo relates a :ref:`Dataset ` to another. .. table:: **IsCorrelatedTo** ``extends`` **IsRelatedTo** - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | **Definition** | - +======================================================+================+==================+=================+======================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | Dataset | IsCorrelatedTo | 0..n | Dataset | IsCorrelatedTo relates a {@link Dataset} to another. | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ - | Dataset | IsCorrelatedTo | 0..n | Dataset | | - +------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | **Definition** | + +======================================================+========================================+==================+==========================+===============================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsCorrelatedTo ` | 0..n | :ref:`Dataset ` | IsCorrelatedTo relates a :ref:`Dataset ` to another. | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsCorrelatedTo ` | 0..n | :ref:`Dataset ` | | + +------------------------------------------------------+----------------------------------------+------------------+--------------------------+---------------------------------------------------------------+ The **IsCorrelatedTo** current version is 1.0.0. @@ -509,33 +539,35 @@ Changelog: * **1.0.0**: First Version. +.. _IsPartOf: + IsPartOf ^^^^^^^^ -IsPartOf is used when a {@link ConcreteDataset} is part of a {@link Dataset}. +IsPartOf is used when a :ref:`ConcreteDataset ` is part of a :ref:`Dataset `. .. table:: **IsPartOf** ``extends`` **IsCorrelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | ConcreteDataset | IsPartOf | 0..n | Dataset | IsPartOf is used when a {@link ConcreteDataset} is part of a {@link Dataset}. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ - | ConcreteDataset | IsPartOf | 0..n | Dataset | The reference to the 'incarnations'/'manifestations' contributing to a dataset. | - +------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+============================+==================+==========================+=========================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`IsPartOf ` | 0..n | :ref:`Dataset ` | IsPartOf is used when a :ref:`ConcreteDataset ` is part of a :ref:`Dataset `. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`IsPartOf ` | 0..n | :ref:`Dataset ` | The reference to the 'incarnations'/'manifestations' contributing to a dataset. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+---------------------------------------------------------------------------------------------------------+ The **IsPartOf** current version is 1.0.0. @@ -545,35 +577,37 @@ Changelog: * **1.0.0**: First Version. +.. _IsCustomizedBy: + IsCustomizedBy -------------- -IsCustomizedBy evidences that any {@link Service} can be customised by a {@link ConfigurationTemplate}. +IsCustomizedBy evidences that any :ref:`Service ` can be customised by a :ref:`ConfigurationTemplate `. .. table:: **IsCustomizedBy** ``extends`` **IsRelatedTo** - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+================+==================+=======================+=========================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | Service | IsCustomizedBy | 0..n | ConfigurationTemplate | IsCustomizedBy evidences that any {@link Service} can be customised by a {@link ConfigurationTemplate}. | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | Service | IsCustomizedBy | 0..n | ConfigurationTemplate | | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ - | Service | IsCustomizedBy | 0..n | ConfigurationTemplate | A reference to any configuration characterising the Service behaviour. | - +------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+========================================+==================+======================================================+=========================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`IsCustomizedBy ` | 0..n | :ref:`ConfigurationTemplate ` | IsCustomizedBy evidences that any :ref:`Service ` can be customised by a :ref:`ConfigurationTemplate `. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`IsCustomizedBy ` | 0..n | :ref:`ConfigurationTemplate ` | | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`IsCustomizedBy ` | 0..n | :ref:`ConfigurationTemplate ` | A reference to any configuration characterising the Service behaviour. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ The **IsCustomizedBy** current version is 1.0.0. @@ -583,33 +617,35 @@ Changelog: * **1.0.0**: First Version. +.. _IsDerivationOf: + IsDerivationOf -------------- -IsDerivationOf indicate that the source {@link Configuration} is an instantiation of the target {@link ConfigurationTemplate}. +IsDerivationOf indicate that the source :ref:`Configuration ` is an instantiation of the target :ref:`ConfigurationTemplate `. .. table:: **IsDerivationOf** ``extends`` **IsRelatedTo** - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+================+==================+=======================+================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | Configuration | IsDerivationOf | 0..n | ConfigurationTemplate | IsDerivationOf indicate that the source {@link Configuration} is an instantiation of the target {@link ConfigurationTemplate}. | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ - | Configuration | IsDerivationOf | 0..n | ConfigurationTemplate | | - +------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+========================================+==================+======================================================+======================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Configuration ` | :ref:`IsDerivationOf ` | 0..n | :ref:`ConfigurationTemplate ` | IsDerivationOf indicate that the source :ref:`Configuration ` is an instantiation of the target :ref:`ConfigurationTemplate `. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Configuration ` | :ref:`IsDerivationOf ` | 0..n | :ref:`ConfigurationTemplate ` | | + +------------------------------------------------------+----------------------------------------+------------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **IsDerivationOf** current version is 1.0.0. @@ -619,33 +655,35 @@ Changelog: * **1.0.0**: First Version. +.. _IsOwnedBy: + IsOwnedBy --------- -Any {@link Site} is owned by an {@link Actor} and this is captured by the IsOwnedBy relation. The referenced {@link Actor} can be used as a contact point during an emergency, to agree on the scheduling of a site downtime and to request additional resources during the downtime of another site. +Any :ref:`Site ` is owned by an :ref:`Actor ` and this is captured by the IsOwnedBy relation. The referenced :ref:`Actor ` can be used as a contact point during an emergency, to agree on the scheduling of a site downtime and to request additional resources during the downtime of another site. .. table:: **IsOwnedBy** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=======================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | IsOwnedBy | 0..n | Actor | Any {@link Site} is owned by an {@link Actor} and this is captured by the IsOwnedBy relation. The referenced {@link Actor} can be used as a contact point during an emergency, to agree on the scheduling of a site downtime and to request additional resources during the downtime of another site. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | IsOwnedBy | 0..n | Actor | | - +------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==============================+==================+======================+===========================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`IsOwnedBy ` | 0..n | :ref:`Actor ` | Any :ref:`Site ` is owned by an :ref:`Actor ` and this is captured by the IsOwnedBy relation. The referenced :ref:`Actor ` can be used as a contact point during an emergency, to agree on the scheduling of a site downtime and to request additional resources during the downtime of another site. | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`IsOwnedBy ` | 0..n | :ref:`Actor ` | | + +------------------------------------------------------+------------------------------+------------------+----------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **IsOwnedBy** current version is 1.0.0. @@ -655,35 +693,37 @@ Changelog: * **1.0.0**: First Version. +.. _Manages: + Manages ------- -Manages indicates that of the source {@link Service} manages the target {@link Dataset}, e.g. read, manipulate, etc. +Manages indicates that of the source :ref:`Service ` manages the target :ref:`Dataset `, e.g. read, manipulate, etc. .. table:: **Manages** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+=========================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Manages | 0..n | Dataset | Manages indicates that of the source {@link Service} manages the target {@link Dataset}, e.g. read, manipulate, etc. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Manages | 0..n | Dataset | A reference to any Dataset resource managed by the Service instance. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Manages | 0..n | Dataset | The link between the service that 'manages' the dataset and the dataset, e.g. the service that hosts the dataset and give access to it. | - +------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+==========================+==================+==========================+=========================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Manages ` | 0..n | :ref:`Dataset ` | Manages indicates that of the source :ref:`Service ` manages the target :ref:`Dataset `, e.g. read, manipulate, etc. | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Manages ` | 0..n | :ref:`Dataset ` | A reference to any Dataset resource managed by the Service instance. | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Manages ` | 0..n | :ref:`Dataset ` | The link between the service that 'manages' the dataset and the dataset, e.g. the service that hosts the dataset and give access to it. | + +------------------------------------------------------+--------------------------+------------------+--------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+ The **Manages** current version is 1.0.0. @@ -693,35 +733,37 @@ Changelog: * **1.0.0**: First Version. +.. _Requires: + Requires -------- -Requires is used to indicate that the source {@link Software} when activated requires to interact with a specific {@link Service} instance, i.e., the target of the relation. This relation usually reflects an administrative constraint than a technological limitation. When there are no constraint on the instance the relation is instead {@link DependsOn} which is between two {@link Software}.Not necessarily all the {@link Software} running in the infrastructure are represented as resources. Only the {@link Software} required for infrastructure administration or the ones to be managed with specific policies are represented. Indeed, Requires relation is normally used as policy constraint. Let imagine an open source software which uses a MySQL database as backend. In many cases, what characterises the software instance is the data present in the backend. The infrastructure manager could stipulate an agreement with a provider having a particular set of data which is not for public domain. The software once deployed, giving the business agreement, is entitled to use the instance of the provider and not a generic MySQL database instance. The infrastructure manager imposes the use of such a particular instance because of the data it contains. +Requires is used to indicate that the source :ref:`Software ` when activated requires to interact with a specific :ref:`Service ` instance, i.e., the target of the relation. This relation usually reflects an administrative constraint than a technological limitation. When there are no constraint on the instance the relation is instead :ref:`DependsOn ` which is between two :ref:`Software `.Not necessarily all the :ref:`Software ` running in the infrastructure are represented as resources. Only the :ref:`Software ` required for infrastructure administration or the ones to be managed with specific policies are represented. Indeed, Requires relation is normally used as policy constraint. Let imagine an open source software which uses a MySQL database as backend. In many cases, what characterises the software instance is the data present in the backend. The infrastructure manager could stipulate an agreement with a provider having a particular set of data which is not for public domain. The software once deployed, giving the business agreement, is entitled to use the instance of the provider and not a generic MySQL database instance. The infrastructure manager imposes the use of such a particular instance because of the data it contains. .. table:: **Requires** ``extends`` **IsRelatedTo** - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Definition** | - +======================================================+==============+==================+=================+======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | Requires | 0..n | Service | Requires is used to indicate that the source {@link Software} when activated requires to interact with a specific {@link Service} instance, i.e., the target of the relation. This relation usually reflects an administrative constraint than a technological limitation. When there are no constraint on the instance the relation is instead {@link DependsOn} which is between two {@link Software}.Not necessarily all the {@link Software} running in the infrastructure are represented as resources. Only the {@link Software} required for infrastructure administration or the ones to be managed with specific policies are represented. Indeed, Requires relation is normally used as policy constraint. Let imagine an open source software which uses a MySQL database as backend. In many cases, what characterises the software instance is the data present in the backend. The infrastructure manager could stipulate an agreement with a provider having a particular set of data which is not for public domain. The software once deployed, giving the business agreement, is entitled to use the instance of the provider and not a generic MySQL database instance. The infrastructure manager imposes the use of such a particular instance because of the data it contains. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Properties** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Name** | **Type** | **Attributes** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | This type does not define any additional attributes. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Known Usage** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Requires | 0..n | Service | A reference to any Service needed by a Software to properly operate, e.g. this can be used to capture a sort of run-time requirements between a software component and the Service it needs. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | Requires | 0..n | Service | To capture any dependency between a software artifact and a Service, e.g. A software requiring a specific database instance. | - +------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Definition** | + +======================================================+============================+==================+==========================+==================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`Requires ` | 0..n | :ref:`Service ` | Requires is used to indicate that the source :ref:`Software ` when activated requires to interact with a specific :ref:`Service ` instance, i.e., the target of the relation. This relation usually reflects an administrative constraint than a technological limitation. When there are no constraint on the instance the relation is instead :ref:`DependsOn ` which is between two :ref:`Software `.Not necessarily all the :ref:`Software ` running in the infrastructure are represented as resources. Only the :ref:`Software ` required for infrastructure administration or the ones to be managed with specific policies are represented. Indeed, Requires relation is normally used as policy constraint. Let imagine an open source software which uses a MySQL database as backend. In many cases, what characterises the software instance is the data present in the backend. The infrastructure manager could stipulate an agreement with a provider having a particular set of data which is not for public domain. The software once deployed, giving the business agreement, is entitled to use the instance of the provider and not a generic MySQL database instance. The infrastructure manager imposes the use of such a particular instance because of the data it contains. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Properties** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Name** | **Type** | **Attributes** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | This type does not define any additional attributes. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Known Usage** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Source** | **Relation** | **Multiplicity** | **Target** | **Description** | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Requires ` | 0..n | :ref:`Service ` | A reference to any Service needed by a Software to properly operate, e.g. this can be used to capture a sort of run-time requirements between a software component and the Service it needs. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`Requires ` | 0..n | :ref:`Service ` | To capture any dependency between a software artifact and a Service, e.g. A software requiring a specific database instance. | + +------------------------------------------------------+----------------------------+------------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Requires** current version is 1.0.0. diff --git a/docs/gcube-model-property.rst b/docs/gcube-model-property.rst index 58552ed..b473c96 100644 --- a/docs/gcube-model-property.rst +++ b/docs/gcube-model-property.rst @@ -1,8 +1,12 @@ +.. _Property: + Property ======== +.. _GCubeProperty: + GCubeProperty ------------- @@ -25,6 +29,8 @@ Changelog: * **1.0.0**: First Version. +.. _AccessPolicy: + AccessPolicy ^^^^^^^^^^^^ @@ -33,13 +39,13 @@ AccessPolicy information .. table:: **AccessPolicy** ``extends`` **GCubeProperty** - +--------+-------------+----------------------------------------------------------+-------------+ - | Name | Type | Attributes | Description | - +========+=============+==========================================================+=============+ - | note | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | - +--------+-------------+----------------------------------------------------------+-------------+ - | policy | ValueSchema | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | - +--------+-------------+----------------------------------------------------------+-------------+ + +--------+----------------------------------+----------------------------------------------------------+-------------+ + | Name | Type | Attributes | Description | + +========+==================================+==========================================================+=============+ + | note | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | + +--------+----------------------------------+----------------------------------------------------------+-------------+ + | policy | :ref:`ValueSchema ` | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | | + +--------+----------------------------------+----------------------------------------------------------+-------------+ The **AccessPolicy** current version is 1.0.0. @@ -49,6 +55,8 @@ Changelog: * **1.0.0**: First Version. +.. _EnumStringProperty: + EnumStringProperty ^^^^^^^^^^^^^^^^^^ @@ -71,6 +79,8 @@ Changelog: * **1.0.0**: First Version. +.. _RegexProperty: + RegexProperty ^^^^^^^^^^^^^ @@ -95,6 +105,8 @@ Changelog: * **1.0.0**: First Version. +.. _ValueSchema: + ValueSchema ^^^^^^^^^^^ diff --git a/docs/gcube-model-resource.rst b/docs/gcube-model-resource.rst index f044d47..ffa1831 100644 --- a/docs/gcube-model-resource.rst +++ b/docs/gcube-model-resource.rst @@ -1,8 +1,12 @@ +.. _Resource: + Resource ======== +.. _GCubeResource: + GCubeResource ------------- @@ -11,17 +15,17 @@ Marker type for any gCube Resource extended in the gCube model. .. table:: **GCubeResource** ``extends`` **Resource** - +-------------------------------------------------------+----------------+--------------+--------+----------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +=======================================================+================+==============+========+==============================================================================================+ - | **Facets** | - +-------------------------------------------------------+----------------+--------------+--------+----------------------------------------------------------------------------------------------+ - | GCubeResource | IsIdentifiedBy | 1..1 | Facet | Any Resource has at least one Facet which in some way allow to identify the Resource per se. | - +-------------------------------------------------------+----------------+--------------+--------+----------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +-------------------------------------------------------+----------------+--------------+--------+----------------------------------------------------------------------------------------------+ - | No specific Resource relations defined for this type. | - +-------------------------------------------------------+----------------+--------------+--------+----------------------------------------------------------------------------------------------+ + +-------------------------------------------------------+----------------------------------------+--------------+----------------------+----------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +=======================================================+========================================+==============+======================+==============================================================================================+ + | **Facets** | + +-------------------------------------------------------+----------------------------------------+--------------+----------------------+----------------------------------------------------------------------------------------------+ + | :ref:`GCubeResource ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`Facet ` | Any Resource has at least one Facet which in some way allow to identify the Resource per se. | + +-------------------------------------------------------+----------------------------------------+--------------+----------------------+----------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +-------------------------------------------------------+----------------------------------------+--------------+----------------------+----------------------------------------------------------------------------------------------+ + | No specific Resource relations defined for this type. | + +-------------------------------------------------------+----------------------------------------+--------------+----------------------+----------------------------------------------------------------------------------------------+ The **GCubeResource** current version is 1.0.0. @@ -31,29 +35,31 @@ Changelog: * **1.0.0**: First Version. +.. _Actor: + Actor ^^^^^ -Actor (Abstract) is any entity (human or machine) playing an active role in the infrastructure. Actor has two specialisations, {@link LegalBody} which represent any legal entity, and {@link Person} which is any human playing the role of Actor. An Actor can belong to a {@link LegalBody} and this is expressed using the defined {@link BelongsTo} relation. +Actor (Abstract) is any entity (human or machine) playing an active role in the infrastructure. Actor has two specialisations, :ref:`LegalBody ` which represent any legal entity, and :ref:`Person ` which is any human playing the role of Actor. An Actor can belong to a :ref:`LegalBody ` and this is expressed using the defined :ref:`BelongsTo ` relation. .. table:: **Actor** ``extends`` **GCubeResource** - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+================+==============+=======================+====================================================================================+ - | **Facets** | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------------------+ - | Actor | ConsistsOf | 0..n | ContactReferenceFacet | | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------------------+ - | Actor | IsIdentifiedBy | 1..1 | ContactFacet | An Actor has at least a Contact Facet which permit to identify the Actor per se. | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------------------+ - | Dataset | Involves | 0..n | Actor | | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------------------+ - | Site | IsOwnedBy | 0..n | Actor | | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------------------+ + +--------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +==========================+========================================+==============+======================================================+====================================================================================+ + | **Facets** | + +--------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------------------+ + | :ref:`Actor ` | :ref:`ConsistsOf ` | 0..n | :ref:`ContactReferenceFacet ` | | + +--------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------------------+ + | :ref:`Actor ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`ContactFacet ` | An Actor has at least a Contact Facet which permit to identify the Actor per se. | + +--------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------------------+ + | **Resource Relations** | + +--------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`Involves ` | 0..n | :ref:`Actor ` | | + +--------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`IsOwnedBy ` | 0..n | :ref:`Actor ` | | + +--------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------------------+ The **Actor** current version is 1.0.0. @@ -63,6 +69,8 @@ Changelog: * **1.0.0**: First Version. +.. _LegalBody: + LegalBody """"""""" @@ -71,17 +79,17 @@ LegalBody represents any legal entity playing the role of an Actor. .. table:: **LegalBody** ``extends`` **Actor** - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | Source | Relation | Multiplicity | Target | Description | - +=================================================+===========+==============+===========+=============+ - | **Facets** | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | No specific facets usage defined for this type. | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | **Resource Relations** | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | Person | BelongsTo | 0..n | LegalBody | | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | Source | Relation | Multiplicity | Target | Description | + +=================================================+==============================+==============+==============================+=============+ + | **Facets** | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | No specific facets usage defined for this type. | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | **Resource Relations** | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | :ref:`Person ` | :ref:`BelongsTo ` | 0..n | :ref:`LegalBody ` | | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ The **LegalBody** current version is 1.0.0. @@ -91,6 +99,8 @@ Changelog: * **1.0.0**: First Version. +.. _Person: + Person """""" @@ -99,17 +109,17 @@ Person represents any human playing the role of Actor. .. table:: **Person** ``extends`` **Actor** - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | Source | Relation | Multiplicity | Target | Description | - +=================================================+===========+==============+===========+=============+ - | **Facets** | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | No specific facets usage defined for this type. | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | **Resource Relations** | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ - | Person | BelongsTo | 0..n | LegalBody | | - +-------------------------------------------------+-----------+--------------+-----------+-------------+ + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | Source | Relation | Multiplicity | Target | Description | + +=================================================+==============================+==============+==============================+=============+ + | **Facets** | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | No specific facets usage defined for this type. | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | **Resource Relations** | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ + | :ref:`Person ` | :ref:`BelongsTo ` | 0..n | :ref:`LegalBody ` | | + +-------------------------------------------------+------------------------------+--------------+------------------------------+-------------+ The **Person** current version is 1.0.0. @@ -119,6 +129,8 @@ Changelog: * **1.0.0**: First Version. +.. _ConfigurationTemplate: + ConfigurationTemplate ^^^^^^^^^^^^^^^^^^^^^ @@ -127,23 +139,23 @@ Configuration Template represents a template for a configuration. It describes h .. table:: **ConfigurationTemplate** ``extends`` **GCubeResource** - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+================+==============+=======================+========================================================================+ - | **Facets** | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ - | ConfigurationTemplate | IsIdentifiedBy | 1..1 | IdentifierFacet | | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ - | Configuration | IsDerivationOf | 0..n | ConfigurationTemplate | | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ - | Service | IsCustomizedBy | 0..n | ConfigurationTemplate | | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ - | Service | IsCustomizedBy | 0..n | ConfigurationTemplate | A reference to any configuration characterising the Service behaviour. | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ - | Software | IsConfiguredBy | 0..n | ConfigurationTemplate | | - +------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+ + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +======================================================+========================================+==============+======================================================+========================================================================+ + | **Facets** | + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ + | :ref:`ConfigurationTemplate ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | | + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ + | **Resource Relations** | + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ + | :ref:`Configuration ` | :ref:`IsDerivationOf ` | 0..n | :ref:`ConfigurationTemplate ` | | + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`IsCustomizedBy ` | 0..n | :ref:`ConfigurationTemplate ` | | + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`IsCustomizedBy ` | 0..n | :ref:`ConfigurationTemplate ` | A reference to any configuration characterising the Service behaviour. | + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`IsConfiguredBy ` | 0..n | :ref:`ConfigurationTemplate ` | | + +------------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+------------------------------------------------------------------------+ The **ConfigurationTemplate** current version is 1.0.0. @@ -153,25 +165,27 @@ Changelog: * **1.0.0**: First Version. +.. _Configuration: + Configuration """"""""""""" -Configuration is a specialisation of {@link ConfigurationTemplate} and is an instance of a configuration template characterising the behaviour and shape of the resource it is attached to. The Configuration can be related to the template it derives using {@link IsDerivationOf}. +Configuration is a specialisation of :ref:`ConfigurationTemplate ` and is an instance of a configuration template characterising the behaviour and shape of the resource it is attached to. The Configuration can be related to the template it derives using :ref:`IsDerivationOf `. .. table:: **Configuration** ``extends`` **ConfigurationTemplate** - +-------------------------------------------------+----------------+--------------+-----------------------+-------------+ - | Source | Relation | Multiplicity | Target | Description | - +=================================================+================+==============+=======================+=============+ - | **Facets** | - +-------------------------------------------------+----------------+--------------+-----------------------+-------------+ - | No specific facets usage defined for this type. | - +-------------------------------------------------+----------------+--------------+-----------------------+-------------+ - | **Resource Relations** | - +-------------------------------------------------+----------------+--------------+-----------------------+-------------+ - | Configuration | IsDerivationOf | 0..n | ConfigurationTemplate | | - +-------------------------------------------------+----------------+--------------+-----------------------+-------------+ + +-------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+-------------+ + | Source | Relation | Multiplicity | Target | Description | + +=================================================+========================================+==============+======================================================+=============+ + | **Facets** | + +-------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+-------------+ + | No specific facets usage defined for this type. | + +-------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+-------------+ + | **Resource Relations** | + +-------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+-------------+ + | :ref:`Configuration ` | :ref:`IsDerivationOf ` | 0..n | :ref:`ConfigurationTemplate ` | | + +-------------------------------------------------+----------------------------------------+--------------+------------------------------------------------------+-------------+ The **Configuration** current version is 1.0.0. @@ -181,65 +195,67 @@ Changelog: * **1.0.0**: First Version. +.. _Dataset: + Dataset ^^^^^^^ -A Dataset is a set of digital objects representing data and treated collectively as a unit. It is the key resource of a HDI, even more, it is the reason the HDI exists. A Dataset can be correlated to another Dataset by using {@link IsCorrelatedTo} relation. +A Dataset is a set of digital objects representing data and treated collectively as a unit. It is the key resource of a HDI, even more, it is the reason the HDI exists. A Dataset can be correlated to another Dataset by using :ref:`IsCorrelatedTo ` relation. .. table:: **Dataset** ``extends`` **GCubeResource** - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+=====================+==============+==========================+=========================================================================================================================================================+ - | **Facets** | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | AccessPointFacet | The access point to use for having access to the dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | DescriptiveMetadataFacet | Any descriptive information associated with the dataset, e.g. for discovery purposes. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | EventFacet | Any 'event' characterising the lifecycle of the dataset, e.g. collection date, last collection date. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | LicenseFacet | The licence governing dataset exploitation. The duration of license (if any) is captured by the expiry date defined in the consistsOf relation. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | ProvenanceFacet | Any provenance record associated with the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | ConsistsOf | 0..n | SubjectFacet | Any subject/tag associated with the dataset for descriptive and discovery purposes. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasContact | 1..n | ContactFacet | The contact information of the entity responsible for the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasContributor | 0..n | ContactFacet | The contact information on contributors supporting the creation and development of the Dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasCoverage | 1..n | CoverageFacet | Any coverage related information (e.g. topic, species) characterising the content of the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasCreator | 0..n | ContactFacet | The contact information of the creator of the Dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasCurator | 0..n | ContactFacet | The contact information of the entity responsible for the curation of the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasMaintainer | 0..n | ContactFacet | The contact information of the entity responsible for the maintenance of the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasOwner | 0..n | ContactFacet | The contact information of the entity having the ownership of the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasSpatialCoverage | 0..n | CoverageFacet | Any geo-spatial coverage information characterising the content of the dataset, e.g. the area covered by the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | HasTemporalCoverage | 0..n | CoverageFacet | Any temporal coverage information characterising the content of the dataset, e.g. the time-span covered by the dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | IsIdentifiedBy | 1..1 | IdentifierFacet | The set of Identifiers associated with the Dataset instance. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | ConcreteDataset | IsPartOf | 0..n | Dataset | The reference to the 'incarnations'/'manifestations' contributing to a dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | Involves | 0..n | Actor | | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | IsCompliantWith | 0..n | Schema | Any schema characterising the content of the dataset, e.g. the schema describing the 'columns' of a CSV-based dataset. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Dataset | IsCorrelatedTo | 0..n | Dataset | | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Manages | 0..n | Dataset | A reference to any Dataset resource managed by the Service instance. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Manages | 0..n | Dataset | The link between the service that 'manages' the dataset and the dataset, e.g. the service that hosts the dataset and give access to it. | - +------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +==========================================+==================================================+==============+============================================================+=========================================================================================================================================================+ + | **Facets** | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`AccessPointFacet ` | The access point to use for having access to the dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`DescriptiveMetadataFacet ` | Any descriptive information associated with the dataset, e.g. for discovery purposes. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`EventFacet ` | Any 'event' characterising the lifecycle of the dataset, e.g. collection date, last collection date. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`LicenseFacet ` | The licence governing dataset exploitation. The duration of license (if any) is captured by the expiry date defined in the consistsOf relation. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`ProvenanceFacet ` | Any provenance record associated with the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`ConsistsOf ` | 0..n | :ref:`SubjectFacet ` | Any subject/tag associated with the dataset for descriptive and discovery purposes. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasContributor ` | 0..n | :ref:`ContactFacet ` | The contact information on contributors supporting the creation and development of the Dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCoverage ` | 1..n | :ref:`CoverageFacet ` | Any coverage related information (e.g. topic, species) characterising the content of the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCreator ` | 0..n | :ref:`ContactFacet ` | The contact information of the creator of the Dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasCurator ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the curation of the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasMaintainer ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the maintenance of the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasOwner ` | 0..n | :ref:`ContactFacet ` | The contact information of the entity having the ownership of the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasSpatialCoverage ` | 0..n | :ref:`CoverageFacet ` | Any geo-spatial coverage information characterising the content of the dataset, e.g. the area covered by the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`HasTemporalCoverage ` | 0..n | :ref:`CoverageFacet ` | Any temporal coverage information characterising the content of the dataset, e.g. the time-span covered by the dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | The set of Identifiers associated with the Dataset instance. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`IsPartOf ` | 0..n | :ref:`Dataset ` | The reference to the 'incarnations'/'manifestations' contributing to a dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`Involves ` | 0..n | :ref:`Actor ` | | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsCompliantWith ` | 0..n | :ref:`Schema ` | Any schema characterising the content of the dataset, e.g. the schema describing the 'columns' of a CSV-based dataset. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsCorrelatedTo ` | 0..n | :ref:`Dataset ` | | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Manages ` | 0..n | :ref:`Dataset ` | A reference to any Dataset resource managed by the Service instance. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Manages ` | 0..n | :ref:`Dataset ` | The link between the service that 'manages' the dataset and the dataset, e.g. the service that hosts the dataset and give access to it. | + +------------------------------------------+--------------------------------------------------+--------------+------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Dataset** current version is 1.0.0. @@ -249,27 +265,29 @@ Changelog: * **1.0.0**: First Version. +.. _ConcreteDataset: + ConcreteDataset """"""""""""""" -ConcreteDataset is any incarnation/manifestation of a dataset or part of it. The relation {@link IsPartOf} is used when a ConcreteDataset is part of a {@link Dataset}. +ConcreteDataset is any incarnation/manifestation of a dataset or part of it. The relation :ref:`IsPartOf ` is used when a ConcreteDataset is part of a :ref:`Dataset `. .. table:: **ConcreteDataset** ``extends`` **Dataset** - +------------------------+---------------+--------------+------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+===============+==============+==================+==================================================================================================================================================================+ - | **Facets** | - +------------------------+---------------+--------------+------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | ConcreteDataset | ConsistsOf | 1..n | AccessPointFacet | The access point to use for having access to the concrete dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | - +------------------------+---------------+--------------+------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | ConcreteDataset | HasMaintainer | 1..n | ContactFacet | The contact information of the entity responsible for the maintenance of the concrete dataset | - +------------------------+---------------+--------------+------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+---------------+--------------+------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | ConcreteDataset | IsPartOf | 0..n | Dataset | The reference to the 'incarnations'/'manifestations' contributing to a dataset. | - +------------------------+---------------+--------------+------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------+--------------------------------------+--------------+--------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +==========================================+======================================+==============+============================================+==================================================================================================================================================================+ + | **Facets** | + +------------------------------------------+--------------------------------------+--------------+--------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`ConsistsOf ` | 1..n | :ref:`AccessPointFacet ` | The access point to use for having access to the concrete dataset. The embargoState can be modeled through the access policy defined in the consistsOf relation. | + +------------------------------------------+--------------------------------------+--------------+--------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`HasMaintainer ` | 1..n | :ref:`ContactFacet ` | The contact information of the entity responsible for the maintenance of the concrete dataset | + +------------------------------------------+--------------------------------------+--------------+--------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +------------------------------------------+--------------------------------------+--------------+--------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ConcreteDataset ` | :ref:`IsPartOf ` | 0..n | :ref:`Dataset ` | The reference to the 'incarnations'/'manifestations' contributing to a dataset. | + +------------------------------------------+--------------------------------------+--------------+--------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **ConcreteDataset** current version is 1.0.0. @@ -279,31 +297,33 @@ Changelog: * **1.0.0**: First Version. +.. _Schema: + Schema ^^^^^^ -Schema is any reference schema used to specify compliant values. Examples include controlled vocabularies, ontologies, and others. This resource is mainly used by {@link Dataset} to evidence that is compliant with a Schema by using {@link IsCompliantWith} relation. +Schema is any reference schema used to specify compliant values. Examples include controlled vocabularies, ontologies, and others. This resource is mainly used by :ref:`Dataset ` to evidence that is compliant with a Schema by using :ref:`IsCompliantWith ` relation. .. table:: **Schema** ``extends`` **GCubeResource** - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+=================+==============+==========================+========================================================================================================================+ - | **Facets** | - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ - | Schema | ConsistsOf | 0..n | DescriptiveMetadataFacet | | - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ - | Schema | ConsistsOf | 0..n | SubjectFacet | | - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ - | Schema | HasContact | 1..n | ContactFacet | | - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ - | Schema | IsIdentifiedBy | 1..1 | SchemaFacet | | - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ - | Dataset | IsCompliantWith | 0..n | Schema | Any schema characterising the content of the dataset, e.g. the schema describing the 'columns' of a CSV-based dataset. | - +------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+ + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +==========================+==========================================+==============+============================================================+========================================================================================================================+ + | **Facets** | + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`ConsistsOf ` | 0..n | :ref:`DescriptiveMetadataFacet ` | | + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`ConsistsOf ` | 0..n | :ref:`SubjectFacet ` | | + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | | + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Schema ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SchemaFacet ` | | + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dataset ` | :ref:`IsCompliantWith ` | 0..n | :ref:`Schema ` | Any schema characterising the content of the dataset, e.g. the schema describing the 'columns' of a CSV-based dataset. | + +--------------------------+------------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------+ The **Schema** current version is 1.0.0. @@ -313,47 +333,49 @@ Changelog: * **1.0.0**: First Version. +.. _Service: + Service ^^^^^^^ -Service (Abstract) represents any typology of service worth registering in the infrastructure. Service has relations with quite all other resources. If on one side, an Hybrid Data Infrastructure (HDI) is created to manage datasets, on the other side the HDI born to manage such datasets digitally. We could affirm that datasets and services are the two pillar resources around which revolves the entire infrastructure. It is important to highlight that Service has a general meaning and must not be intended as a network-callable service which is represented instead by one of its specialisation called {@link EService}.Giving that Service is abstract no {@link IsIdentifiedBy} association with a facet is provided which in turns is responsibility of the specialisation. +Service (Abstract) represents any typology of service worth registering in the infrastructure. Service has relations with quite all other resources. If on one side, an Hybrid Data Infrastructure (HDI) is created to manage datasets, on the other side the HDI born to manage such datasets digitally. We could affirm that datasets and services are the two pillar resources around which revolves the entire infrastructure. It is important to highlight that Service has a general meaning and must not be intended as a network-callable service which is represented instead by one of its specialisation called :ref:`EService `.Giving that Service is abstract no :ref:`IsIdentifiedBy ` association with a facet is provided which in turns is responsibility of the specialisation. .. table:: **Service** ``extends`` **GCubeResource** - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+================+==============+==========================+==================================================================================================================================================================================================================================================================+ - | **Facets** | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | ConsistsOf | 0..n | CapabilityFacet | Any facility supported/offered by the Service. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | ConsistsOf | 0..n | DescriptiveMetadataFacet | Any descriptive information associated with the service, e.g. for discovery purposes. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | ConsistsOf | 0..n | SubjectFacet | Any subject/tag associated with the service for descriptive, cataloguing and discovery purposes. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Activates | 0..n | Service | The source Service enables the target Service to be running. Examples are an Hosting Node which enables an EService; A VirtualMachine enabling an EService or an HostingNode; An EService enabling a RunningPlugin; A VirtualMachine enabling an HostingNode etc | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | CallsFor | 0..n | Service | A reference to the Services needed by the target instance to work. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Enables | 0..n | Software | A reference to any Software the Service is enabling (i.e. the Software is running throught the EService). | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | IsCustomizedBy | 0..n | ConfigurationTemplate | | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | IsCustomizedBy | 0..n | ConfigurationTemplate | A reference to any configuration characterising the Service behaviour. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Manages | 0..n | Dataset | A reference to any Dataset resource managed by the Service instance. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Manages | 0..n | Dataset | The link between the service that 'manages' the dataset and the dataset, e.g. the service that hosts the dataset and give access to it. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Requires | 0..n | Service | A reference to any Service needed by a Software to properly operate, e.g. this can be used to capture a sort of run-time requirements between a software component and the Service it needs. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Site | Hosts | 0..n | Service | | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | Requires | 0..n | Service | To capture any dependency between a software artifact and a Service, e.g. A software requiring a specific database instance. | - +------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +============================+========================================+==============+============================================================+==================================================================================================================================================================================================================================================================+ + | **Facets** | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`ConsistsOf ` | 0..n | :ref:`CapabilityFacet ` | Any facility supported/offered by the Service. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`ConsistsOf ` | 0..n | :ref:`DescriptiveMetadataFacet ` | Any descriptive information associated with the service, e.g. for discovery purposes. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`ConsistsOf ` | 0..n | :ref:`SubjectFacet ` | Any subject/tag associated with the service for descriptive, cataloguing and discovery purposes. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Activates ` | 0..n | :ref:`Service ` | The source Service enables the target Service to be running. Examples are an Hosting Node which enables an EService; A VirtualMachine enabling an EService or an HostingNode; An EService enabling a RunningPlugin; A VirtualMachine enabling an HostingNode etc | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`CallsFor ` | 0..n | :ref:`Service ` | A reference to the Services needed by the target instance to work. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Enables ` | 0..n | :ref:`Software ` | A reference to any Software the Service is enabling (i.e. the Software is running throught the EService). | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`IsCustomizedBy ` | 0..n | :ref:`ConfigurationTemplate ` | | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`IsCustomizedBy ` | 0..n | :ref:`ConfigurationTemplate ` | A reference to any configuration characterising the Service behaviour. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Manages ` | 0..n | :ref:`Dataset ` | A reference to any Dataset resource managed by the Service instance. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Manages ` | 0..n | :ref:`Dataset ` | The link between the service that 'manages' the dataset and the dataset, e.g. the service that hosts the dataset and give access to it. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Requires ` | 0..n | :ref:`Service ` | A reference to any Service needed by a Software to properly operate, e.g. this can be used to capture a sort of run-time requirements between a software component and the Service it needs. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Site ` | :ref:`Hosts ` | 0..n | :ref:`Service ` | | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`Requires ` | 0..n | :ref:`Service ` | To capture any dependency between a software artifact and a Service, e.g. A software requiring a specific database instance. | + +----------------------------+----------------------------------------+--------------+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **Service** current version is 1.0.0. @@ -363,6 +385,8 @@ Changelog: * **1.0.0**: First Version. +.. _EService: + EService """""""" @@ -371,29 +395,29 @@ EService is any running service that is registered in the infrastructure and mad .. table:: **EService** ``extends`` **Service** - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+================+==============+==================+=============================================================================================================+ - | **Facets** | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 1..n | AccessPointFacet | Identify the endpoints of the EService. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 1..n | EventFacet | Events characterising the current status and lifecycle of the service, e.g. ActivationTime, DeploymentTime. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 0..n | LicenseFacet | The specific terms of use governing the exploitation of the EService. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 0..n | SoftwareFacet | Software available in the EService environment that characterizes the specific EService instance. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | ConsistsOf | 1..1 | StateFacet | The current status of the EService, e.g. STARTED, ready, down, failed. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | IsIdentifiedBy | 1..1 | SoftwareFacet | The main software enabling the EService capabilities. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | Discovers | 0..n | EService | A reference to any other EService, the EService instance is discovering through query on IS. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ - | EService | Uses | 0..n | EService | A reference to any other EService, the EService instance is invoking. | - +------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+ + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +============================+========================================+==============+============================================+=============================================================================================================+ + | **Facets** | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 1..n | :ref:`AccessPointFacet ` | Identify the endpoints of the EService. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 1..n | :ref:`EventFacet ` | Events characterising the current status and lifecycle of the service, e.g. ActivationTime, DeploymentTime. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 0..n | :ref:`LicenseFacet ` | The specific terms of use governing the exploitation of the EService. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 0..n | :ref:`SoftwareFacet ` | Software available in the EService environment that characterizes the specific EService instance. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`ConsistsOf ` | 1..1 | :ref:`StateFacet ` | The current status of the EService, e.g. STARTED, ready, down, failed. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SoftwareFacet ` | The main software enabling the EService capabilities. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`Discovers ` | 0..n | :ref:`EService ` | A reference to any other EService, the EService instance is discovering through query on IS. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ + | :ref:`EService ` | :ref:`Uses ` | 0..n | :ref:`EService ` | A reference to any other EService, the EService instance is invoking. | + +----------------------------+----------------------------------------+--------------+--------------------------------------------+-------------------------------------------------------------------------------------------------------------+ The **EService** current version is 1.0.0. @@ -403,6 +427,8 @@ Changelog: * **1.0.0**: First Version. +.. _RunningPlugin: + RunningPlugin """"""""""""" @@ -431,39 +457,41 @@ Changelog: * **1.0.0**: First Version. +.. _HostingNode: + HostingNode """"""""""" -The HostingNode represent a container capable of managing the lifecycle of an electronic service, i.e., being capable to host and operate an {@link EService}. Examples are docker, tomcat. A container is a service which is conceived to enable any services respecting the container rules to be operative. The container does not typically provide any functionality rather than allowing the hosted service to operate. The HostingNode characterisation in terms of facets reflects the one presented for {@link VirtualMachine}. In particular, facets representing memory, CPU and networking interface are used to describe the HostingNode when the {@link VirtualMachine} enabling the HostingNode is not represented. Federated systems can provide virtual machines as resource or containers as resources. In some cases, the description of a container includes (virtual) hardware information. It is important to highlight that HostingNode is not a subclass of {@link VirtualMachine}. +The HostingNode represent a container capable of managing the lifecycle of an electronic service, i.e., being capable to host and operate an :ref:`EService `. Examples are docker, tomcat. A container is a service which is conceived to enable any services respecting the container rules to be operative. The container does not typically provide any functionality rather than allowing the hosted service to operate. The HostingNode characterisation in terms of facets reflects the one presented for :ref:`VirtualMachine `. In particular, facets representing memory, CPU and networking interface are used to describe the HostingNode when the :ref:`VirtualMachine ` enabling the HostingNode is not represented. Federated systems can provide virtual machines as resource or containers as resources. In some cases, the description of a container includes (virtual) hardware information. It is important to highlight that HostingNode is not a subclass of :ref:`VirtualMachine `. .. table:: **HostingNode** ``extends`` **Service** - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +=======================================================+=====================+==============+=====================+==================================================================================================================================================================================+ - | **Facets** | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 1..n | CPUFacet | The CPU equipping the Hosting Node. | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 1..n | EventFacet | Every event characterizing the life cycle of the Hosting Node, e.g. the activation time. | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 0..n | SimplePropertyFacet | Any pair property worth associating with the Hosting Node, e.g. Environment Variables | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 0..n | SoftwareFacet | Any Software characterising the Hosting Node. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | ConsistsOf | 1..1 | StateFacet | The current state of the Hosting Node, e.g. started, ready, certified, down, failed. | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | HasPersistentMemory | 1..n | MemoryFacet | The Disk Space Capacity of the Hosting Node. | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | HasVolatileMemory | 1..n | MemoryFacet | The RAM Capacity of the Hosting Node. | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | HostingNode | IsIdentifiedBy | 1..1 | NetworkingFacet | The Network ID characterising the Hosting Node. | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | No specific Resource relations defined for this type. | - +-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +=======================================================+==================================================+==============+==================================================+==================================================================================================================================================================================+ + | **Facets** | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 1..n | :ref:`CPUFacet ` | The CPU equipping the Hosting Node. | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 1..n | :ref:`EventFacet ` | Every event characterizing the life cycle of the Hosting Node, e.g. the activation time. | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 0..n | :ref:`SimplePropertyFacet ` | Any pair property worth associating with the Hosting Node, e.g. Environment Variables | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 0..n | :ref:`SoftwareFacet ` | Any Software characterising the Hosting Node. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`ConsistsOf ` | 1..1 | :ref:`StateFacet ` | The current state of the Hosting Node, e.g. started, ready, certified, down, failed. | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`HasPersistentMemory ` | 1..n | :ref:`MemoryFacet ` | The Disk Space Capacity of the Hosting Node. | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`HasVolatileMemory ` | 1..n | :ref:`MemoryFacet ` | The RAM Capacity of the Hosting Node. | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`HostingNode ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`NetworkingFacet ` | The Network ID characterising the Hosting Node. | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | No specific Resource relations defined for this type. | + +-------------------------------------------------------+--------------------------------------------------+--------------+--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **HostingNode** current version is 1.0.0. @@ -473,6 +501,8 @@ Changelog: * **1.0.0**: First Version. +.. _VirtualMachine: + VirtualMachine """""""""""""" @@ -481,29 +511,29 @@ VirtualMachine (VM) is the typical resource represented in a cloud infrastructur .. table:: **VirtualMachine** ``extends`` **Service** - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +=======================================================+=====================+==============+=================+=====================================================================================================================================================================================+ - | **Facets** | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | ConsistsOf | 1..n | CPUFacet | The CPU equipping the Virtual Machine. | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | ConsistsOf | 1..n | EventFacet | Every event characterizing the life cycle of the Virtual Machine, e.g. the activation time. | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | ConsistsOf | 0..n | SoftwareFacet | Any Software characterising the Virtual Machine. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | ConsistsOf | 1..1 | StateFacet | The current state of the Virtual Machine, e.g. started, ready, down, unreachable. | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | HasPersistentMemory | 1..n | MemoryFacet | The Disk Space Capacity of the Virtual Machine. | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | HasVolatileMemory | 1..n | MemoryFacet | The RAM Capacity of the Virtual Machine. | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualMachine | IsIdentifiedBy | 1..1 | NetworkingFacet | The Network ID characterising the Virtual Machine. | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | No specific Resource relations defined for this type. | - +-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +=======================================================+==================================================+==============+==========================================+=====================================================================================================================================================================================+ + | **Facets** | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 1..n | :ref:`CPUFacet ` | The CPU equipping the Virtual Machine. | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 1..n | :ref:`EventFacet ` | Every event characterizing the life cycle of the Virtual Machine, e.g. the activation time. | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 0..n | :ref:`SoftwareFacet ` | Any Software characterising the Virtual Machine. Useful to report the hosted software that are not registered in the Resource Registry as Software Resource, e.g. Operating System | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`ConsistsOf ` | 1..1 | :ref:`StateFacet ` | The current state of the Virtual Machine, e.g. started, ready, down, unreachable. | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`HasPersistentMemory ` | 1..n | :ref:`MemoryFacet ` | The Disk Space Capacity of the Virtual Machine. | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`HasVolatileMemory ` | 1..n | :ref:`MemoryFacet ` | The RAM Capacity of the Virtual Machine. | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualMachine ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`NetworkingFacet ` | The Network ID characterising the Virtual Machine. | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | No specific Resource relations defined for this type. | + +-------------------------------------------------------+--------------------------------------------------+--------------+------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ The **VirtualMachine** current version is 1.0.0. @@ -513,25 +543,27 @@ Changelog: * **1.0.0**: First Version. +.. _VirtualService: + VirtualService """""""""""""" -VirtualService is an abstract service (non-physically existing service) worth being represented as an existing Service for management purposes. Examples of usage include cases where classes or set of services have to be managed like an existing unit. This resource is essential from infrastructure management point of view because it allows easily share a pool of services across VREs as a single unit. VirtualService mainly consist of a service definition which uses relations to {@link ConfigurationTemplate}, {@link EService}, {@link Software} (using {@link Demands} relation) to properly support the sharing across VREs. The correct sharing is feasible thanks to the {@link PropagationConstraint} of the model. The IS provides only the support for resource sharing as a bundle. Instead, the actions required to deploy a {@link Software} are a responsibility of the service invoking the sharing operation. This resource emerged thank to the experience maturated with gCube IS V.1 (gCore Based IS) where this resource was represented as a Generic Resource containing the list of the resource’s id forming the bundle which often lead to inconsistency. +VirtualService is an abstract service (non-physically existing service) worth being represented as an existing Service for management purposes. Examples of usage include cases where classes or set of services have to be managed like an existing unit. This resource is essential from infrastructure management point of view because it allows easily share a pool of services across VREs as a single unit. VirtualService mainly consist of a service definition which uses relations to :ref:`ConfigurationTemplate `, :ref:`EService `, :ref:`Software ` (using :ref:`Demands ` relation) to properly support the sharing across VREs. The correct sharing is feasible thanks to the :ref:`PropagationConstraint ` of the model. The IS provides only the support for resource sharing as a bundle. Instead, the actions required to deploy a :ref:`Software ` are a responsibility of the service invoking the sharing operation. This resource emerged thank to the experience maturated with gCube IS V.1 (gCore Based IS) where this resource was represented as a Generic Resource containing the list of the resource’s id forming the bundle which often lead to inconsistency. .. table:: **VirtualService** ``extends`` **Service** - +------------------------+----------------+--------------+---------------+-------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+================+==============+===============+=============+ - | **Facets** | - +------------------------+----------------+--------------+---------------+-------------+ - | VirtualService | IsIdentifiedBy | 1..n | SoftwareFacet | | - +------------------------+----------------+--------------+---------------+-------------+ - | **Resource Relations** | - +------------------------+----------------+--------------+---------------+-------------+ - | VirtualService | Demands | 0..n | Software | | - +------------------------+----------------+--------------+---------------+-------------+ + +----------------------------------------+----------------------------------------+--------------+--------------------------------------+-------------+ + | Source | Relation | Multiplicity | Target | Description | + +========================================+========================================+==============+======================================+=============+ + | **Facets** | + +----------------------------------------+----------------------------------------+--------------+--------------------------------------+-------------+ + | :ref:`VirtualService ` | :ref:`IsIdentifiedBy ` | 1..n | :ref:`SoftwareFacet ` | | + +----------------------------------------+----------------------------------------+--------------+--------------------------------------+-------------+ + | **Resource Relations** | + +----------------------------------------+----------------------------------------+--------------+--------------------------------------+-------------+ + | :ref:`VirtualService ` | :ref:`Demands ` | 0..n | :ref:`Software ` | | + +----------------------------------------+----------------------------------------+--------------+--------------------------------------+-------------+ The **VirtualService** current version is 1.0.0. @@ -541,6 +573,8 @@ Changelog: * **1.0.0**: First Version. +.. _Site: + Site ^^^^ @@ -549,29 +583,29 @@ Site is a resource representing the location (physical or virtual) hosting the r .. table:: **Site** ``extends`` **GCubeResource** - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+================+==============+=================+====================================================+ - | **Facets** | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | ConsistsOf | 1..n | LocationFacet | | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | ConsistsOf | 1..n | NetworkingFacet | | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | HasContact | 1..n | ContactFacet | The main contact for the Site. | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | HasMaintainer | 1..n | ContactFacet | Contact information of the maintainer of the Site. | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | HasManager | 1..n | ContactFacet | Contact information of the Site Manager. | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | IsIdentifiedBy | 1..1 | IdentifierFacet | The Site Identifier. | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | **Resource Relations** | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | Hosts | 0..n | Service | | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ - | Site | IsOwnedBy | 0..n | Actor | | - +------------------------+----------------+--------------+-----------------+----------------------------------------------------+ + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +========================+========================================+==============+==========================================+====================================================+ + | **Facets** | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`ConsistsOf ` | 1..n | :ref:`LocationFacet ` | | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`ConsistsOf ` | 1..n | :ref:`NetworkingFacet ` | | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`HasContact ` | 1..n | :ref:`ContactFacet ` | The main contact for the Site. | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`HasMaintainer ` | 1..n | :ref:`ContactFacet ` | Contact information of the maintainer of the Site. | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`HasManager ` | 1..n | :ref:`ContactFacet ` | Contact information of the Site Manager. | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`IdentifierFacet ` | The Site Identifier. | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | **Resource Relations** | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`Hosts ` | 0..n | :ref:`Service ` | | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ + | :ref:`Site ` | :ref:`IsOwnedBy ` | 0..n | :ref:`Actor ` | | + +------------------------+----------------------------------------+--------------+------------------------------------------+----------------------------------------------------+ The **Site** current version is 1.0.0. @@ -581,41 +615,43 @@ Changelog: * **1.0.0**: First Version. +.. _Software: + Software ^^^^^^^^ -Software is an entity worth being represented for management purposes. The relation {@link DependsOn} indicates dependencies between two Software captured for management purposes. +Software is an entity worth being represented for management purposes. The relation :ref:`DependsOn ` indicates dependencies between two Software captured for management purposes. .. table:: **Software** ``extends`` **GCubeResource** - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +========================+================+==============+=======================+====================================================================================================================================================+ - | **Facets** | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | ConsistsOf | 0..n | CapabilityFacet | | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | ConsistsOf | 1..n | SoftwareFacet | Apart the one connected by the IsIdentifiedBy relation (gCube coordinates) the others identify the software in other way e.g. (Maven coordinates). | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | IsIdentifiedBy | 1..1 | SoftwareFacet | Software coordinates which identify the Software per se. | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | **Resource Relations** | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Plugin | IsPluginOf | 0..n | Software | A reference to the Software this Plugin is conceived to extend the capabilities. | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Plugin | IsPluginOf | 0..n | Software | To capture the relation between a Software and its Plugins. | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Service | Enables | 0..n | Software | A reference to any Software the Service is enabling (i.e. the Software is running throught the EService). | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | DependsOn | 0..n | Software | To capture any dependency between two software artifacts. | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | IsConfiguredBy | 0..n | ConfigurationTemplate | | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | Software | Requires | 0..n | Service | To capture any dependency between a software artifact and a Service, e.g. A software requiring a specific database instance. | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ - | VirtualService | Demands | 0..n | Software | | - +------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +========================================+========================================+==============+======================================================+====================================================================================================================================================+ + | **Facets** | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`ConsistsOf ` | 0..n | :ref:`CapabilityFacet ` | | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`ConsistsOf ` | 1..n | :ref:`SoftwareFacet ` | Apart the one connected by the IsIdentifiedBy relation (gCube coordinates) the others identify the software in other way e.g. (Maven coordinates). | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`IsIdentifiedBy ` | 1..1 | :ref:`SoftwareFacet ` | Software coordinates which identify the Software per se. | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | **Resource Relations** | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Plugin ` | :ref:`IsPluginOf ` | 0..n | :ref:`Software ` | A reference to the Software this Plugin is conceived to extend the capabilities. | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Plugin ` | :ref:`IsPluginOf ` | 0..n | :ref:`Software ` | To capture the relation between a Software and its Plugins. | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Service ` | :ref:`Enables ` | 0..n | :ref:`Software ` | A reference to any Software the Service is enabling (i.e. the Software is running throught the EService). | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`DependsOn ` | 0..n | :ref:`Software ` | To capture any dependency between two software artifacts. | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`IsConfiguredBy ` | 0..n | :ref:`ConfigurationTemplate ` | | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Software ` | :ref:`Requires ` | 0..n | :ref:`Service ` | To capture any dependency between a software artifact and a Service, e.g. A software requiring a specific database instance. | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`VirtualService ` | :ref:`Demands ` | 0..n | :ref:`Software ` | | + +----------------------------------------+----------------------------------------+--------------+------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ The **Software** current version is 1.0.0. @@ -625,6 +661,8 @@ Changelog: * **1.0.0**: First Version. +.. _Plugin: + Plugin """""" @@ -633,19 +671,19 @@ Collect Plugin information through the list of its facets. .. table:: **Plugin** ``extends`` **Software** - +-------------------------------------------------+------------+--------------+----------+----------------------------------------------------------------------------------+ - | Source | Relation | Multiplicity | Target | Description | - +=================================================+============+==============+==========+==================================================================================+ - | **Facets** | - +-------------------------------------------------+------------+--------------+----------+----------------------------------------------------------------------------------+ - | No specific facets usage defined for this type. | - +-------------------------------------------------+------------+--------------+----------+----------------------------------------------------------------------------------+ - | **Resource Relations** | - +-------------------------------------------------+------------+--------------+----------+----------------------------------------------------------------------------------+ - | Plugin | IsPluginOf | 0..n | Software | A reference to the Software this Plugin is conceived to extend the capabilities. | - +-------------------------------------------------+------------+--------------+----------+----------------------------------------------------------------------------------+ - | Plugin | IsPluginOf | 0..n | Software | To capture the relation between a Software and its Plugins. | - +-------------------------------------------------+------------+--------------+----------+----------------------------------------------------------------------------------+ + +-------------------------------------------------+--------------------------------+--------------+----------------------------+----------------------------------------------------------------------------------+ + | Source | Relation | Multiplicity | Target | Description | + +=================================================+================================+==============+============================+==================================================================================+ + | **Facets** | + +-------------------------------------------------+--------------------------------+--------------+----------------------------+----------------------------------------------------------------------------------+ + | No specific facets usage defined for this type. | + +-------------------------------------------------+--------------------------------+--------------+----------------------------+----------------------------------------------------------------------------------+ + | **Resource Relations** | + +-------------------------------------------------+--------------------------------+--------------+----------------------------+----------------------------------------------------------------------------------+ + | :ref:`Plugin ` | :ref:`IsPluginOf ` | 0..n | :ref:`Software ` | A reference to the Software this Plugin is conceived to extend the capabilities. | + +-------------------------------------------------+--------------------------------+--------------+----------------------------+----------------------------------------------------------------------------------+ + | :ref:`Plugin ` | :ref:`IsPluginOf ` | 0..n | :ref:`Software ` | To capture the relation between a Software and its Plugins. | + +-------------------------------------------------+--------------------------------+--------------+----------------------------+----------------------------------------------------------------------------------+ The **Plugin** current version is 1.0.0.