Adding generated documentation files to track how the doc is generated

This commit is contained in:
Luca Frosini 2023-02-10 17:07:49 +01:00
parent cb5a7bfd70
commit 09828e8047
7 changed files with 3145 additions and 1 deletions

1
.gitignore vendored
View File

@ -1,3 +1,2 @@
/target/
/*.rst
/.classpath

686
gcube-model-consistsof.rst Normal file
View File

@ -0,0 +1,686 @@
ConsistsOf
==========
HasAction
---------
Relation among a {@link Service} and its {@link 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. |
+------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------+
The **HasAction** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
HasAddAction
^^^^^^^^^^^^
An action triggered when a {@link 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. |
+------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------+
The **HasAddAction** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
HasRemoveAction
^^^^^^^^^^^^^^^
An action triggered when a {@link 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. |
+------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------+
The **HasRemoveAction** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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** |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Actor | HasContact | 0..n | ContactFacet | An Actor can have other Contact Facets which provide secondary contact information. |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| 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. |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasContact** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+----------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasContributor** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasCreator** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasCurator** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasDeveloper** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+---------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasMaintainer** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasManager** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasOwner** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasCoverage** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
HasSpatialCoverage
^^^^^^^^^^^^^^^^^^
HasSpatialCoverage indicates that the target {@link 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. |
+------------------------------------------------------+--------------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasSpatialCoverage** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
HasTemporalCoverage
^^^^^^^^^^^^^^^^^^^
HasTemporalCoverage indicates that the target {@link 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. |
+------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasTemporalCoverage** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasMemory** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+---------------------+------------------+-----------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasPersistentMemory** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+-------------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HasVolatileMemory** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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 | |
+------------------------------------------------------+----------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **IsIdentifiedBy** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.

796
gcube-model-facet.rst Normal file
View File

@ -0,0 +1,796 @@
Facet
=====
AccessPointFacet
----------------
AccessPointFacet captures information on an 'access point' of a resource, i.e., any web-based endpoint to programmatically interact with the resource via a known protocol. For example, it is used to define the network endpoint to contact the service. The endpoint can expose a well-known high-level protocol.
.. 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. |
+-----------------+--------------+----------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **AccessPointFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
ActionFacet
-----------
This facet is expected to capture information on which action perform while a resource is added or removed from a context.
.. 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. |
+----------------------------------------+--------------------+----------------------------------------------------------+------------------------------------------------------+-----------------+
The **ActionFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+-----------------+--------------+--------------------------------------------------------+---------------------------------------------------+----------------------------------------+
The **CPUFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
CapabilityFacet
---------------
CapabilityFacet captures a defined facility for performing a specified task supported by a given Resource. It is mainly used to provide a human-readable description of the capabilities of a resource (e.g., the support for transactions of an electronic device or some non-functional properties of a service like its replicability to support High-Availability (HA)).
.. 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 | |
+-----------------+--------------+----------------------------------------------------------+-------------------------------------------------+------------------------------------------------+
The **CapabilityFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
ContactFacet
------------
ContactFacet captures information on a point of contact for the resource, i.e., a person or a department serving as the coordinator or focal point of information concerning the resource.
.. 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 | HasContact | 0..n | ContactFacet | An Actor can have other Contact Facets which provide secondary contact information. |
+-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+
| 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. |
+-----------------+----------------+-----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+
The **ContactFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
ContactReferenceFacet
---------------------
ContactReferenceFacet captures information on the primary and authoritative contact for the resource it is associated with.
.. 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 | |
+-----------------+--------------+----------------------------------------------------------+-----------------------+-----------------+
The **ContactReferenceFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
CoverageFacet
-------------
CoverageFacet captures information on the extent of the resource, i.e., any aspect aiming at capturing an indicator of the amount/area the resource covers be it a geospatial area, a temporal area, or any other 'area'. 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 is not representing the data of the salinity. Instead, to specify the temporal period and theocean area the dataset is valid. This information is captured by the CoverageFacet.
.. 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. |
+-----------------+---------------------+--------------------------------------------------------+-------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+
The **CoverageFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
DescriptiveMetadataFacet
------------------------
DescriptiveMetadataFacet captures information on descriptive metadata to be associated with the resource. This facet is mainly used to attach metadata to a Dataset.
.. table:: **DescriptiveMetadataFacet** ``extends`` **Facet**
+-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+
| Properties |
+=================+==============+========================================================+=================================================================================+=======================================================================================+
| **Name** | **Type** | **Attributes** | **Description** |
+-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+
| metadata | 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. |
+-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------------------+
The **DescriptiveMetadataFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
EventFacet
----------
EventFacet captures information on a certain event/happening characterising the life cycle of the resource. Examples of an event are the start time of a virtual machine or the activation time of an electronic service.
.. 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. |
+-----------------+--------------+--------------------------------------------------------+----------------------------------------+-------------------------------------------------------------------------------------------------------------+
The **EventFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IdentifierFacet
---------------
IdentifierFacet captures information on identifiers (other than the ones automatically generated by the system) that can be attached to a resource.
.. table:: **IdentifierFacet** ``extends`` **Facet**
+-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+
| Properties |
+=======================+================+======================================================================================================+=========================================================+==============================================================+
| **Name** | **Type** | **Attributes** | **Description** |
+-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+
| type | 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. |
+-----------------------+----------------+------------------------------------------------------------------------------------------------------+---------------------------------------------------------+--------------------------------------------------------------+
The **IdentifierFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
LicenseFacet
------------
LicenseFacet captures information on any license associated with the resource to capture the policies governing its exploitation and use. Example of use is the licence of a dataset e.g., Creative Commons Attribution (CC-BY) or the licence of software such as GPL. This facet is used to provide for human knowledge, but it is not excluded the usage by infrastructure services which enforces the respect of the licence e.g., a service which denies the usage of a dataset with Creative Commons Attribution No-Derivatives (CC-BY-ND)licence to produce a new dataset.
.. 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. |
+-----------------+--------------+--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
The **LicenseFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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 | |
+-----------------+--------------+----------------------------------------------------------+---------------------------------+-----------------+
The **LocationFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+-----------------+---------------------+-----------------------------------------------------------------------------------------------------+-----------------+-------------------------------------------------+
The **MemoryFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------+----------------+----------------------------------------------------------+--------------------------------+----------------------------------------------------+
The **NetworkingFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
ProvenanceFacet
---------------
ProvenanceFacet captures information on provenance/lineage of the entire resource. It is mainly used to describe provenance information of a Dataset.
.. table:: **ProvenanceFacet** ``extends`` **Facet**
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
| Properties |
+=================+==============+=======================================================================================================================================================+======================================================================+====================================================+
| **Name** | **Type** | **Attributes** | **Description** |
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
| relationship | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` ``Regex:^(wasDerivedFrom|wasGeneratedBy)$`` | Relationship with the resource indicated by UUID. |
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
| reference | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` ``Regex:^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}){1}$`` | UUID of the referenced resource. |
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
| document | ValueSchema | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | Provenance Document, e.g., an XML according to the reference schema. |
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
| **Known Usage** |
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
| **Source** | **Relation** | **Multiplicity** | **Target** | **Description** |
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
| Dataset | ConsistsOf | 0..n | ProvenanceFacet | Any provenance record associated with the dataset. |
+-----------------+--------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------+----------------------------------------------------+
The **ProvenanceFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
SchemaFacet
-----------
SchemaFacet captures information on any schema, i.e., a vocabulary used to validate a document associated with a resource. Examples of schema are JavaScript Object Notation (JSON) schema and XML schema. JSON schema "is a vocabulary that allows you to annotate and validate JSON documents". JSON schema is under standardisation by Internet Engineering Task force (IETF) (see references at https://json-schema.org/specification.html). XSD defines the legal building blocks of an XML document. DTD defines the structure and the legal elements and attributes of an XML document.
.. 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 | |
+-----------------+----------------+----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------+
The **SchemaFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
SimpleFacet
-----------
A sort of catch all. It does not define any property. It is mainly used to one or more arbitrary properties to the resource. Before using SimpleFacet a developer should evaluate if it is possible to identify a specific Facetto capture the particular aspect of the resource. The usage of SimpleFacet should be reduced to the maximum.
.. table:: **SimpleFacet** ``extends`` **Facet**
+------------------------------------------------------+--------------+------------------+-----------------+-----------------+
| 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 **SimpleFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
SimplePropertyFacet
-------------------
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 <key,value> pair property worth associating with the Hosting Node, e.g. Environment Variables |
+-----------------+--------------+--------------------------------------------------------+---------------------+---------------------------------------------------------------------------------------------------+
The **SimplePropertyFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
SoftwareFacet
-------------
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 | |
+-----------------+----------------+----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **SoftwareFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
StateFacet
----------
StateFacet captures information on state to be associated with the resource. The state is captured by any controlled vocabulary which is an integral part of the facet. Examples of usage are the state of service e.g., running or down or the state of a virtual machine e.g., activated or unreachable.
.. 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. |
+-----------------+--------------+--------------------------------------------------------+------------------------+--------------------------------------------------------------------------------------+
The **StateFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
SubjectFacet
------------
SubjectFacet captures information on subjects associated with the resource for description, classification and discovery purposes.
.. 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. |
+-----------------+--------------+--------------------------------------------------------+--------------------------------------------------+--------------------------------------------------------------------------------------------------+
The **SubjectFacet** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.

732
gcube-model-isrelatedto.rst Normal file
View File

@ -0,0 +1,732 @@
IsRelatedTo
===========
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.
.. 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 |
+------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Activates** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
BelongsTo
---------
BelongsTo indicates that a {@link Person} belong to the target {@link 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 | |
+------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------+
The **BelongsTo** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **CallsFor** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Discovers** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Uses
^^^^
Uses relation inform regarding the network invocation of the target{@link EService} by the source. Uses relation specialises the semantic of {@link 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. |
+------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Uses** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Demands
-------
Demands is used to properly support to share a {@link 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 | |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------------+
The **Demands** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
DependsOn
---------
DependsOn indicates that a {@link Software} requires another one to work. This relation must not be confused with {@link 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. |
+------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------+
The **DependsOn** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **IsPluginOf** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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). |
+------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Enables** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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 | |
+------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Hosts** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Involves
--------
Involves is used to indicate that and {@link Actor} is involved in a {@link 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 | |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------------+
The **Involves** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IsCompliantWith
---------------
IsCompliantWith is used to indicated a {@link Dataset} compliant with a {@link 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. |
+------------------------------------------------------+-----------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------+
The **IsCompliantWith** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IsConfiguredBy
--------------
The relation IsConfiguredBy indicates that the source {@link 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 | |
+------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------+
The **IsConfiguredBy** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IsCorrelatedTo
--------------
IsCorrelatedTo relates a {@link 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 | |
+------------------------------------------------------+----------------+------------------+-----------------+------------------------------------------------------+
The **IsCorrelatedTo** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IsPartOf
^^^^^^^^
IsPartOf is used when a {@link ConcreteDataset} is part of a {@link 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. |
+------------------------------------------------------+--------------+------------------+-----------------+---------------------------------------------------------------------------------+
The **IsPartOf** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IsCustomizedBy
--------------
IsCustomizedBy evidences that any {@link Service} can be customised by a {@link 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. |
+------------------------------------------------------+----------------+------------------+-----------------------+---------------------------------------------------------------------------------------------------------+
The **IsCustomizedBy** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IsDerivationOf
--------------
IsDerivationOf indicate that the source {@link Configuration} is an instantiation of the target {@link 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 | |
+------------------------------------------------------+----------------+------------------+-----------------------+--------------------------------------------------------------------------------------------------------------------------------+
The **IsDerivationOf** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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 | |
+------------------------------------------------------+--------------+------------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **IsOwnedBy** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Manages
-------
Manages indicates that of the source {@link Service} manages the target {@link 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. |
+------------------------------------------------------+--------------+------------------+-----------------+-----------------------------------------------------------------------------------------------------------------------------------------+
The **Manages** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------------------------------------+--------------+------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Requires** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.

120
gcube-model-property.rst Normal file
View File

@ -0,0 +1,120 @@
Property
========
GCubeProperty
-------------
Marker type for any properties extended in the gCube model.
.. table:: **GCubeProperty** ``extends`` **Property**
+------------------------------------------------------+------+------------+-------------+
| Name | Type | Attributes | Description |
+======================================================+======+============+=============+
| This type does not define any additional attributes. |
+------------------------------------------------------+------+------------+-------------+
The **GCubeProperty** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
AccessPolicy
^^^^^^^^^^^^
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`` | |
+--------+-------------+----------------------------------------------------------+-------------+
The **AccessPolicy** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
EnumStringProperty
^^^^^^^^^^^^^^^^^^
Enum String Property
.. table:: **EnumStringProperty** ``extends`` **GCubeProperty**
+------------------------------------------------------+------+------------+-------------+
| Name | Type | Attributes | Description |
+======================================================+======+============+=============+
| This type does not define any additional attributes. |
+------------------------------------------------------+------+------------+-------------+
The **EnumStringProperty** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
RegexProperty
^^^^^^^^^^^^^
A property validated with a regular expression.
.. table:: **RegexProperty** ``extends`` **GCubeProperty**
+--------+--------+----------------------------------------------------------+-------------+
| Name | Type | Attributes | Description |
+========+========+==========================================================+=============+
| value | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | |
+--------+--------+----------------------------------------------------------+-------------+
| schema | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | |
+--------+--------+----------------------------------------------------------+-------------+
The **RegexProperty** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
ValueSchema
^^^^^^^^^^^
This type aims at exposing a value which can be automatically managed by any client with no knowledge of its format.
.. table:: **ValueSchema** ``extends`` **GCubeProperty**
+--------+--------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Attributes | Description |
+========+========+==========================================================+=============================================================================================================================================================+
| value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value which schema is available at the URI provided in the schema property. |
+--------+--------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| schema | String | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | An URI containing a schema used to validate/interpret the content of the value. It is only an informative field. The validation is in charge of the client. |
+--------+--------+----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **ValueSchema** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.

658
gcube-model-resource.rst Normal file
View File

@ -0,0 +1,658 @@
Resource
========
GCubeResource
-------------
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. |
+-------------------------------------------------------+----------------+--------------+--------+----------------------------------------------------------------------------------------------+
The **GCubeResource** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. table:: **Actor** ``extends`` **GCubeResource**
+------------------------+----------------+--------------+-----------------------+---------------------------------------------------------------------------------------+
| Source | Relation | Multiplicity | Target | Description |
+========================+================+==============+=======================+=======================================================================================+
| **Facets** |
+------------------------+----------------+--------------+-----------------------+---------------------------------------------------------------------------------------+
| Actor | ConsistsOf | 0..n | ContactReferenceFacet | |
+------------------------+----------------+--------------+-----------------------+---------------------------------------------------------------------------------------+
| Actor | HasContact | 0..n | ContactFacet | An Actor can have other Contact Facets which provide secondary contact information. |
+------------------------+----------------+--------------+-----------------------+---------------------------------------------------------------------------------------+
| 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 | |
+------------------------+----------------+--------------+-----------------------+---------------------------------------------------------------------------------------+
The **Actor** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
LegalBody
"""""""""
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 | |
+-------------------------------------------------+-----------+--------------+-----------+-------------+
The **LegalBody** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Person
""""""
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 | |
+-------------------------------------------------+-----------+--------------+-----------+-------------+
The **Person** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
ConfigurationTemplate
^^^^^^^^^^^^^^^^^^^^^
Configuration Template represents a template for a configuration. It describes how a configuration has to be realised, e.g. used to define the catalogue configuration parameters template.
.. 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 | |
+------------------------+----------------+--------------+-----------------------+------------------------------------------------------------------------+
The **ConfigurationTemplate** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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 | |
+-------------------------------------------------+----------------+--------------+-----------------------+-------------+
The **Configuration** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------+---------------------+--------------+--------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Dataset** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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. |
+------------------------+---------------+--------------+------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **ConcreteDataset** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------+-----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------+
The **Schema** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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.
.. 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. |
+------------------------+----------------+--------------+--------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **Service** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
EService
""""""""
EService is any running service that is registered in the infrastructure and made available by an access point.
.. 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. |
+------------------------+----------------+--------------+------------------+-------------------------------------------------------------------------------------------------------------+
The **EService** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
RunningPlugin
"""""""""""""
RunningPlugin allows differentiating which is the primary service and which is an additional capability of a such a service. Keeping the two concepts separated enables to share a service across VREs with a subset of its capabilities.
.. table:: **RunningPlugin** ``extends`` **EService**
+-------------------------------------------------------+----------+--------------+--------+-------------+
| Source | Relation | Multiplicity | Target | Description |
+=======================================================+==========+==============+========+=============+
| **Facets** |
+-------------------------------------------------------+----------+--------------+--------+-------------+
| No specific facets usage defined for this type. |
+-------------------------------------------------------+----------+--------------+--------+-------------+
| **Resource Relations** |
+-------------------------------------------------------+----------+--------------+--------+-------------+
| No specific Resource relations defined for this type. |
+-------------------------------------------------------+----------+--------------+--------+-------------+
The **RunningPlugin** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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}.
.. 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 <key,value> 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. |
+-------------------------------------------------------+---------------------+--------------+---------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **HostingNode** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
VirtualMachine
""""""""""""""
VirtualMachine (VM) is the typical resource represented in a cloud infrastructure. It is an emulation of a physical computer which appears to the running operative system as real hardware. A VM provides operative system functionality and potentially allows to install any software designed for the running operative system.
.. 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. |
+-------------------------------------------------------+---------------------+--------------+-----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **VirtualMachine** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
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 resources 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 | |
+------------------------+----------------+--------------+---------------+-------------+
The **VirtualService** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Site
^^^^
Site is a resource representing the location (physical or virtual) hosting the resources associated. Site allows to identify all the services that will be affected by downtime due to a scheduled maintenance, as well as the impact on the infrastructure that an accidentalloss of connectivity could cause. This resource allows to study and define the replication scenarios or to provide an adequate redundancy level to a VRE.
.. 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 | |
+------------------------+----------------+--------------+-----------------+----------------------------------------------------+
The **Site** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Software
^^^^^^^^
Software is an entity worth being represented for management purposes. The relation {@link 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 | |
+------------------------+----------------+--------------+-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
The **Software** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Plugin
""""""
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. |
+-------------------------------------------------+------------+--------------+----------+----------------------------------------------------------------------------------+
The **Plugin** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.

153
is-model.rst Normal file
View File

@ -0,0 +1,153 @@
Property
========
Encrypted
---------
This type is used to properly manage encrypted values across contexts.
.. table:: **Encrypted** ``extends`` **Property**
+-------+--------+--------------------------------------------------------+----------------------------------------+
| Name | Type | Attributes | Description |
+=======+========+========================================================+========================================+
| value | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The value to store encrypted in the IS |
+-------+--------+--------------------------------------------------------+----------------------------------------+
The **Encrypted** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Header
------
This type provides metadata per every IdentifiableElement
.. table:: **Header** ``extends`` **Property**
+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Attributes | Description |
+================+========+====================================================================================================================================================+=========================================================================================================================================+
| createdBy | String | ``Mandatory:true`` ``ReadOnly:true`` ``NotNull:true`` | The user that created the Entity or the Relation. It is initialized at Creation Time. |
+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
| creationTime | Date | ``Mandatory:true`` ``ReadOnly:true`` ``NotNull:true`` | Creation time. It is represented in the format yyyy-MM-dd HH:mm:ss.SSS Z. |
+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
| lastUpdateBy | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | The user that made the last update to the Entity or the Relation. At Creation Time, it assumes the same value of createdBy. |
+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
| lastUpdateTime | Date | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Last Update time. At creation time it assumes the same value of creationTime. It is represented in the format yyyy-MM-dd HH:mm:ss.SSS Z |
+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
| uuid | String | ``Mandatory:true`` ``ReadOnly:true`` ``NotNull:true`` ``Regex:^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}){1}$`` | This UUID is be used to identify the Entity or the Relation univocally. |
+----------------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------+
The **Header** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
PropagationConstraint
---------------------
This type provides propagation constraint for Relation
.. table:: **PropagationConstraint** ``extends`` **Property**
+--------+--------+-----------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name | Type | Attributes | Description |
+========+========+=====================================================================================================+======================================================================================================================================================================================================================+
| add | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` ``Regex:^(propagate|unpropagate)$`` | It indicates the behaviour to implement for the target Entity when an 'add' action is performed on the source Resource. Add action is the operation of adding an instance to a context. |
+--------+--------+-----------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| delete | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` ``Regex:^(cascadeWhenOrphan|cascade|keep)$`` | It indicates the behaviour to implement for the target Entity when a 'delete' action is performed on the source Resource. Delet action is the operation of deleting an instance (it has an impact on all contexts). |
+--------+--------+-----------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| remove | String | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` ``Regex:^(cascadeWhenOrphan|cascade|keep)$`` | It indicates the behaviour to implement for the target Entity when a 'remove' action is performed on the source Resource. Remove actions is the operation of removing an instance from a context. |
+--------+--------+-----------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
The **PropagationConstraint** current version is 1.1.0.
Changelog:
* **1.1.0**: Added 'delete' propagation constraint;
* **1.0.0**: First Version;
Entity
======
This is the base type for any Entity
.. table:: **Entity**
+------------+----------+--------------------------------------------------------+--------------------------------------------------------------------------------------------+
| Properties |
+============+==========+========================================================+============================================================================================+
| **Name** | **Type** | **Attributes** | **Description** |
+------------+----------+--------------------------------------------------------+--------------------------------------------------------------------------------------------+
| header | Header | ``Mandatory:true`` ``ReadOnly:false`` ``NotNull:true`` | Metadata associated with the instance that is automatically created/updated by the system. |
+------------+----------+--------------------------------------------------------+--------------------------------------------------------------------------------------------+
The **Entity** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
Resource
========
Facet
=====
Relation
========
This is the base type for any Relation
.. table:: **Relation**
+-----------------------+-----------------------+----------------------------------------------------------+-----------------+----------------------------------------+
| **Definition** |
+=======================+=======================+==========================================================+=================+========================================+
| **Source** | **Relation** | **Multiplicity** | **Target** | **Description** |
+-----------------------+-----------------------+----------------------------------------------------------+-----------------+----------------------------------------+
| Resource | Relation | 0..n | Entity | This is the base type for any Relation |
+-----------------------+-----------------------+----------------------------------------------------------+-----------------+----------------------------------------+
| **Properties** |
+-----------------------+-----------------------+----------------------------------------------------------+-----------------+----------------------------------------+
| **Name** | **Type** | **Attributes** | **Description** |
+-----------------------+-----------------------+----------------------------------------------------------+-----------------+----------------------------------------+
| propagationConstraint | PropagationConstraint | ``Mandatory:false`` ``ReadOnly:false`` ``NotNull:false`` | |
+-----------------------+-----------------------+----------------------------------------------------------+-----------------+----------------------------------------+
The **Relation** current version is 1.0.0.
Changelog:
* **1.0.0**: First Version.
IsRelatedTo
===========
ConsistsOf
==========