Merge branch 'SDS-2024-0064-architecture_model' into 'R5'

SDS-2024-0064R02-architecture_model

See merge request specifications/ts-0041!6

TS-0041-oneM2M-SensorThings_interworking.md

@@ -73,6 +73,7 @@ References are either specific (identified by date of publication and/or edition
 
  
 - <a name="_ref_1">[1]</a>    OGC SensorThings API "Part 1: Sensing Version 1.1" (http://www.opengis.net/doc/is/sensorthings/1.1)
+- <a name="_ref_2">[2]</a>    oneM2M TS-0033 (V3.0.0): "Interworking Framework"
 
 ## 2.2 Informative references
 
@@ -174,8 +175,33 @@ The Sensing Entities data model and the purpose of data within the data model di
 -	Data embedded in the Sensing Entities Data Model, like "historic locations" should be seen as data for documentation purposes.
 
 
-## 5.1 User defined subdivisions of clause(s) from here onwards
-&lt;Text>
+
+# 6 Architecture Model of OGC/STA to oneM2M interworking
+
+## 6.0 Introduction
+
+Figure 6.0-1 shows an architecture approach for an Interworking Proxy Entity (IPE) between oneM2M and the OGC SensorThings API. The IPE is located between a oneM2M CSE and an OGC/SensorThings API (STA)-Server. 
+
+The basic interworking enables applications that are connected to an oneM2M-based system to get data from sensors that are connected to an OGC/STA server. Furthermore, an application that is connected to an OGC/STA server will be able to get data from sensors that are connected to an oneM2M-based system.
+
+<figure>
+  <img src="media/STA_oneM2M_architekturbild_01.svg" alt="arch_overview">
+  <figcaption>Figure 6.0-1: IPE architecture overview</figcaption>
+</figure>
+
+## 6.1 OGC/STA-to-oneM2M Data Model Mapping
+
+According to oneM2M TS-0033 <a href="#_ref_2">[2]</a> a representation of a non-oneM2M Proximal IoT function/device in a oneM2M-specified resource instance is to be synchronized with the entity that it represents. Thus the OGC/STA data model has to be represented in the hosting CSE. The SensorThings data model is comprehensive and should be regarded as a n:m relational database structure, holding both:
+- sensor (IoT-data); and 
+- administrative data (like historic locations or historic products IDs).
+
+The IPE shall map the 'result' attribute of an OGC/STA 'Observation' to the 'content' attribute of a oneM2M <contentInstance>, and vice versa as shown in Figure 6.1-1.
+
+<figure>
+  <img src="media/data_mapping.svg" alt="data_mapping">
+  <figcaption>Figure 6.1-1: OGC / STA-to-oneM2M data model mapping</figcaption>
+</figure>
+
 
 <mark>The following text is to be used when appropriate:</mark>
 

media/data_mapping.svg

+<svg width="2114" height="1515" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" overflow="hidden"><g transform="translate(-1142 -226)"><rect x="2502.5" y="708.5" width="424" height="190" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2613.51 820)">Container</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1230.3 294)">SensorThings</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1511.6 294)">API Data </text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1697.8 294)">Model</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1448.01 355)">(</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1463.48 355)">subset</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1596.96 355)">)</text><rect x="2247.5" y="1009.5" width="721" height="211" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2381.77 1131)">ContentInstance</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2729.53 1131)">4711</text><rect x="2495.5" y="420.5" width="424" height="205" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2680.11 539)">AE</text><path d="M0 0 38.1442 0 38.1442 0.000360892 76.288 0.000360892" stroke="#000000" stroke-width="6.875" stroke-miterlimit="8" fill="none" fill-rule="evenodd" transform="matrix(-1.83697e-16 -1 -1 1.83697e-16 1424.5 707.788)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2473.69 303)">oneM2M Data </text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2781.91 303)">Model</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2611.76 364)">(</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2627.23 364)">subset</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2760.72 364)">)</text><rect x="1786" y="1420" width="736" height="212" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="55" transform="matrix(1 0 0 1 1981.15 1544)">Mapping by IPE</text><path d="M1144.5 454.834C1144.5 435.319 1160.32 419.5 1179.83 419.5L1668.17 419.5C1687.68 419.5 1703.5 435.319 1703.5 454.834L1703.5 596.166C1703.5 615.681 1687.68 631.5 1668.17 631.5L1179.83 631.5C1160.32 631.5 1144.5 615.681 1144.5 596.166Z" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1367.39 542)">Thing </text><path d="M1144.5 738C1144.5 721.708 1157.71 708.5 1174 708.5L1674 708.5C1690.29 708.5 1703.5 721.708 1703.5 738L1703.5 856C1703.5 872.292 1690.29 885.5 1674 885.5L1174 885.5C1157.71 885.5 1144.5 872.292 1144.5 856Z" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1304.09 813)">Datastream</text><path d="M1144.5 1039C1144.5 1022.71 1157.71 1009.5 1174 1009.5L1757 1009.5C1773.29 1009.5 1786.5 1022.71 1786.5 1039L1786.5 1157C1786.5 1173.29 1773.29 1186.5 1757 1186.5L1174 1186.5C1157.71 1186.5 1144.5 1173.29 1144.5 1157Z" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1282.5 1114)">Observation 1234</text><path d="M1199.5 1094C1199.5 1077.71 1212.71 1064.5 1229 1064.5L1812 1064.5C1828.29 1064.5 1841.5 1077.71 1841.5 1094L1841.5 1212C1841.5 1228.29 1828.29 1241.5 1812 1241.5L1229 1241.5C1212.71 1241.5 1199.5 1228.29 1199.5 1212Z" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1337.5 1169)">Observation 1234</text><path d="M1254.5 1149C1254.5 1132.71 1267.71 1119.5 1284 1119.5L1867 1119.5C1883.29 1119.5 1896.5 1132.71 1896.5 1149L1896.5 1267C1896.5 1283.29 1883.29 1296.5 1867 1296.5L1284 1296.5C1267.71 1296.5 1254.5 1283.29 1254.5 1267Z" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1392.5 1224)">Observation 1234</text><path d="M1309.5 1204C1309.5 1187.71 1322.71 1174.5 1339 1174.5L1922 1174.5C1938.29 1174.5 1951.5 1187.71 1951.5 1204L1951.5 1322C1951.5 1338.29 1938.29 1351.5 1922 1351.5L1339 1351.5C1322.71 1351.5 1309.5 1338.29 1309.5 1322Z" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1504.78 1249)">Observation</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1504.51 1310)">„</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1525.7 1310)">result</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 1642.58 1310)">“:“…“</text><path d="M2707 625 2714.02 707.586" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="2307.5" y="1064.5" width="721" height="211" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2442.46 1186)">ContentInstance</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2790.22 1186)">4711</text><rect x="2382.5" y="1119.5" width="721" height="211" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2517.37 1241)">ContentInstance</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2865.13 1241)">4711</text><rect x="2463.5" y="1174.5" width="721" height="211" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2658.13 1266)">c</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2679.33 1266)">ontentInstance</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2677.31 1327)">„</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2698.51 1327)">content</text><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="50" transform="matrix(1 0 0 1 2857.21 1327)">“:“…“</text><path d="M1424 885 1465.15 1008.74" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M1424 885 1499.57 1059.31" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M1424 885 1575.15 1118.74" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M1424 885 1630.15 1173.74" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M0 0 106.851 110.173" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd" transform="matrix(-1 0 0 1 2713.85 898)"/><path d="M2714 898 2829.39 1058.74" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M2714 898 2742.75 1118.17" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M2714 898 3109.45 1164.61" stroke="#000000" stroke-width="2.29167" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M2104.5 226.5 2113.28 1455.16" stroke="#000000" stroke-width="4.58333" stroke-miterlimit="8" stroke-dasharray="18.3333 13.75" fill="none" fill-rule="evenodd"/><path d="M2868.5 1539.5C2868.5 1649.4 2579.05 1738.5 2222 1738.5 1864.95 1738.5 1575.5 1649.4 1575.5 1539.5L1675 1539.5C1675 1594.45 1919.9 1639 2222 1639 2524.1 1639 2769 1594.45 2769 1539.5Z" stroke="#41719C" stroke-width="4.58333" stroke-linecap="round" stroke-miterlimit="8" fill="#5B9BD5" fill-rule="evenodd"/><path d="M2942.5 1534.56 2883.75 1534.56 2883.75 1536.5 2766.25 1536.5 2766.25 1534.56 2707.5 1534.56 2825 1404.5Z" stroke="#41719C" stroke-width="4.58333" stroke-miterlimit="8" fill="#5B9BD5" fill-rule="evenodd"/><path d="M1742.5 1536.56 1683.75 1536.56 1683.75 1538.5 1566.25 1538.5 1566.25 1536.56 1507.5 1536.56 1625 1406.5Z" stroke="#41719C" stroke-width="4.58333" stroke-miterlimit="8" fill="#5B9BD5" fill-rule="evenodd"/></g></svg>
\ No newline at end of file