Skip to content

6.1 _<semanticDescriptor>_ Operations

6.1.1 Introduction

The <semanticDescriptor> resource is used to store a semantic description pertaining to a resource and potentially sub-resources. Such a description may be provided according to ontologies. The semantic information is used by the semantic functionalities of the oneM2M system and is also available to applications or CSEs. For resource type description see [1] clause 9.6.30.

6.1.2 Create <semanticDescriptor>

This procedure shall be used for creating a <semanticDescriptor> resource.

Table 6.1.2-1: <semanticDescriptor> CREATE

<semanticDescriptor> CREATE <semanticDescriptor> CREATE
Associated Reference Point Mca, Mcc and Mcc'
Information in Request message All parameters defined in oneM2M TS-0001 [1] table 8.1.2-2 apply with the specific details for:
Content: The resource content shall provide the information as defined in clause 9.6.30 in oneM2M TS-0001 [1]
Processing at Originator before sending Request According to clause 10.1.2 in oneM2M TS-0001 [1]
Processing at Receiver The Hosting CSE shall follow the basic procedure according to clause 10.1.2 of [1], with the following specific details:
shall check that the descriptor attribute conforms to the syntax as defined in the descriptorRepresentation attribute.
shall trigger the semantic validation process as specified in clause 7.10 if the validationEnable attribute of the <semanticDescriptor> resource is set to true, and shall set the semanticValidated attribute of <semanticDescriptor> resource according to the validation result.
Information in Response message According to clause 10.1.2 in oneM2M TS-0001 [1]
Processing at Originator after receiving Response According to clause 10.1.2 in oneM2M TS-0001 [1]
Exceptions According to clause 10.1.2 in oneM2M TS-0001 [1]

6.1.3 Retrieve <semanticDescriptor>

This procedure shall be used for retrieving the attributes of a <semanticDescriptor> resource.

Table 6.1.3-1: <semanticDescriptor> RETRIEVE

<semanticDescriptor> RETRIEVE <semanticDescriptor> RETRIEVE
Associated Reference Point Mca, Mcc and Mcc'.
Information in Request message All parameters defined in oneM2M TS-0001 [1] table 8.1.2-2.
Processing at Originator before sending Request According to clause 10.1.3. in oneM2M TS-0001 [1]
Processing at Receiver According to clause 10.1.3 in oneM2M TS-0001 [1].
Information in Response message All parameters defined in oneM2M TS-0001 [1] table 8.1.3-1 apply.
Processing at Originator after receiving Response According to clause 10.1.3 in oneM2M TS-0001 [1].
Exceptions According to clause 10.1.3 in oneM2M TS-0001 [1].

6.1.4 Update <semanticDescriptor>

This procedure shall be used for updating attributes of a <semanticDescriptor> resource.

Table 6.1.4-1: <semanticDescriptor> UPDATE

<semanticDescriptor> UPDATE <semanticDescriptor> UPDATE
Associated Reference Point Mca, Mcc and Mcc'
Information in Request message All parameters defined in oneM2M TS-0001 [1] table 8.1.2-2 apply with the specific details for:
the Content request parameter which may contain the new descriptor information in one of the following ways:
1) full representation of the descriptor attribute; or
2) partial representation of the descriptor attribute as described in SPARQL statements [2] in the semanticOpExec attribute.
Processing at Originator before sending Request According to clause 10.1.4 in oneM2M TS-0001 [1].
Processing at Receiver The hosting CSE shall follow the basic procedure according to clause 10.1.4 in oneM2M TS-0001 [1], with the following specific details:
check if both semanticOpExec attribute and ontologyContent attribute exist in the the Content request parameter, if so, return an error code;
shall update the descriptor attribute according to the execution result of the SPARQL statements [2] in the semanticOpExec attribute, if it presents in the Content request parameter;
shall check that the descriptor attribute conforms to the syntax as defined in the descriptorRepresentation attribute, if it presents in the Content request parameter.
shall trigger the semantic validation process as specified in clause 7.10 if the validationEnable attribute of the <semanticDescriptor> resource is set to true, and shall update the semanticValidated attribute of <semanticDescriptor> resource according to the validation result.
Information in Response message According to clause 10.1.4 in oneM2M TS-0001 [1].
Processing at Originator after receiving Response According to clause 10.1.4 in oneM2M TS-0001 [1].
Exceptions According to clause 10.1.4 in oneM2M TS-0001 [1].

6.1.5 Delete <semanticDescriptor>

This procedure shall be used for deleting a <semanticDescriptor> resource.

Table 6.1.5-1: _<semanticDescriptor> DELETE

<semanticDescriptor> DELETE <semanticDescriptor> DELETE
Associated Reference Point Mca, Mcc and Mcc'
Information in Request message All parameters defined in table 8.1.2-2 in oneM2M TS-0001 [1] apply
Processing at Originator before sending Request According to clause 10.1.5 in oneM2M TS-0001 [1]
Processing at Receiver According to clause 10.1.5 in oneM2M TS-0001 [1]
Information in Response message According to clause 10.1.5 in oneM2M TS-0001 [1]
Processing at Originator after receiving Response According to clause 10.1.5 in oneM2M TS-0001 [1]
Exceptions According to clause 10.1.5 in oneM2M TS-0001 [1]