From 1e88e678536785ce57080491f8a0bfab6430e51b Mon Sep 17 00:00:00 2001
From: ankraft <an.kraft@gmail.com>
Date: Fri, 18 Oct 2024 14:20:26 +0200
Subject: [PATCH] Initial conversion
---
.gitignore | 1 +
WI-0112-oneM2M_Enhanced_Filter_and_Queries.md | 94 ++++++++++++++++++
media/image1.png | Bin 0 -> 4826 bytes
3 files changed, 95 insertions(+)
create mode 100644 .gitignore
create mode 100644 WI-0112-oneM2M_Enhanced_Filter_and_Queries.md
create mode 100644 media/image1.png
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e43b0f9
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.DS_Store
diff --git a/WI-0112-oneM2M_Enhanced_Filter_and_Queries.md b/WI-0112-oneM2M_Enhanced_Filter_and_Queries.md
new file mode 100644
index 0000000..6953fc1
--- /dev/null
+++ b/WI-0112-oneM2M_Enhanced_Filter_and_Queries.md
@@ -0,0 +1,94 @@
+
+|Work Item |Work Item |
+|-|-|
+|Work Item Title: |oneM2M Enhanced Filter and Queries |
+|Document Number |WI-0112 |
+|Supporting Members or Partner type 2 |Deutsche Telekom, Orange, Sejong University, Exacta |
+|Date: |2023-04-18 |
+|Abstract: |This Work Item is intended to improve the current method of providing filters for queries in RETRIEVE and DISCOVERY operations. This improvement will also be applicable to other parts of the oneM2M specifications where similar attribute-based filters and queries are used. |
+
+> **oneM2M Copyright statement**
+> No part may be reproduced except as authorized by written permission.
+> The copyright and the foregoing restriction extend to reproduction in all media.
+> All rights reserved.
+
+# 1 Title (Acronym)
+
+oneM2M Enhanced Filters and Queries
+
+
+# 2 Justification
+Searching for resources with certain characteristics in a CSE's resource tree is currently done by providing a **Filter Criteria** in a RETRIEVE or DISCOVERY request. This is defined in TS-0001, 10.2.6 "Discovery-related Procedures".
+
+Filtering is currently very limited:
+
+- Only equality of attributes is generally supported
+- "Greater", "less", "earlier", "later" for a small set of common and universal attributes. This makes, for example, querying of <flexContainer> specialization resources with comparison operators other than equality impossible.
+- There is no support for filtering using complex attributes.
+- Limited to either "AND", "OR", or "XOR" expressions when combining multiple comparisons.
+
+Also, the growing number of **Filter Criteria** attributes makes it more and more difficult to support in implementations. A generic approach would make this more flexible.
+
+Another problem is that similar functionality is now defined in different parts of the specifications. The <action> and <dependency> resource types defined a similar, though very limited, solution to filter on events. It does make sense to define a solution that could be applied to those cases as well to reduce the overhead in specification work, implementations, and for application development.
+
+
+# 3 Intended Output
+
+**Tick all the appropriate cases**
+
+| Check | Case |
+|:-:|-|
+|X |Change request(s) to existing Technical Specification(s) |
+| |Change request(s) to existing Technical Reports(s) |
+| |New Normative Technical Specifications(s) |
+| |New Permanent Technical Reports(s) |
+| |New Temporary Technical Reports(s) |
+
+
+# 4 Impact
+
+## 4.1 oneM2M Work Items
+None
+
+
+# 5 Scope
+The scope of this work item is to define an advanced and generic query method to filter resources, events etc in a oneM2M CSE to support RETRIEVE and DISCOVERY operations. It should also be applicable to other parts of the oneM2M specifications, such as in the procedures for, for example, <action> and <dependency> resource types where similar functionality is specified.
+
+A solution could be the introduction of a simple but flexible query language based on s-expressions as presented in SDS-2022-0014R02 ("Improving Queries in Discovery and Retrieve Requests").
+
+The solution must co-exist with the current filter methods, but may not be possible to avoid overlapping functionality since a new filter method will provide at least the same functionalities and more.
+
+
+
+
+# 6 Schedule and impacted specifications
+
+## 6.1 New Specifications (if any)
+
+| Document<br />Type | Document<br />Number\* | Title | Schedule (TP No.)<br />Start | Schedule (TP No.)<br />Change Control | Schedule (TP No.)<br />Freeze | Schedule (TP No.)<br />Approval | Lead WG | Impacted WGs | Comments |
+|-|-|-|-|-|-|-|-|-|-|
+|TR | |Enhanced filtering and queries |TP#59 | | |TP#62 |SDS | | |
+
+\* Optional for first versions (i.e. before it will be assigned by the secretariat)
+
+
+## 6.2 CRs to existing specifications (if any)
+
+| Impacted<br />TS/TR | CR number (when known) | Subject of the CR | Approved at plenary# | Impacted WGs | Comments |
+|-|-|-|-|-|-|
+|TS-0001 | |Enhanced queries and filtering (TS-0001) |TP#63 |SDS | |
+|TS-0004 | |Enhanced queries and filtering (TS-0004) |TP#64 |SDS | |
+
+
+# 7 Work Item Rapporteur(s)
+Andreas Kraft (Deutsche Telekom)
+
+
+# 8 History
+
+|Document history |Document history |Document history |
+|-|-|-|
+|V0.0.1 |2023-04-17 |Initial proposal |
+|V0.0.1 |2023-04-18 |Uploaded as a permanent document following approval of TP-2023-0022 |
+| | | |
+
diff --git a/media/image1.png b/media/image1.png
new file mode 100644
index 0000000000000000000000000000000000000000..97c1800c30f775e41f7ceeccb99e5678e51651cd
GIT binary patch
literal 4826
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%0De&V+v<zU)#1%}X{%gVm}
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
literal 0
HcmV?d00001
--
GitLab