saref:Operation — Operation

Definition of saref:Operation

Defined in https://saref.etsi.org/core/v3.2.1/ as:

A saref:Operation is the means of a service to communicate in a procedure-type manner over the network (i.e. transmit data to/from other devices). It is the –machine interpretable– exposure of a –human understandable– command to a network.

Description as a Class

Turtle

@prefix dct: <http://purl.org/dc/terms/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix saref: <https://saref.etsi.org/core/> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

saref:OperationExecution rdfs:subClassOf [ a owl:Restriction ;
            owl:allValuesFrom saref:Operation ;
            owl:onProperty saref:isExecutionOf ] .

saref:hasInput rdfs:domain [ a owl:Class ;
            owl:unionOf ( saref:Command saref:CommandOfInterest saref:Operation saref:ProcedureExecution ) ] .

saref:hasOperation rdfs:range saref:Operation .

saref:hasOutput rdfs:domain [ a owl:Class ;
            owl:unionOf ( saref:Command saref:CommandOfInterest saref:Operation ) ] .

saref:isExecutionOf rdfs:range [ a owl:Class ;
            owl:unionOf ( saref:Command saref:CommandOfInterest saref:Operation ) ] .

saref:isOperationOf rdfs:domain saref:Operation .

saref:represents rdfs:domain [ a owl:Class ;
            owl:unionOf ( saref:Service saref:Operation ) ] .

<https://saref.etsi.org/saref4ehaw/v2.1.1/> dct:references saref:Operation .

<https://saref.etsi.org/saref4grid/v2.1.1/> dct:references saref:Operation .

<https://saref.etsi.org/core/v3.2.1/> dct:references saref:Operation ;
    dct:subject saref:Operation .

<https://saref.etsi.org/core/v4.1.1/> dct:references saref:Operation ;
    dct:subject saref:Operation .

saref:Operation a owl:Class ;
    rdfs:label "Operation"@en ;
    dct:isReferencedBy <https://saref.etsi.org/core/v3.2.1/>,
        <https://saref.etsi.org/core/v4.1.1/>,
        <https://saref.etsi.org/saref4ehaw/v2.1.1/>,
        <https://saref.etsi.org/saref4grid/v2.1.1/> ;
    rdfs:comment "A saref:Operation is the means of a service to communicate in a procedure-type manner over the network (i.e. transmit data to/from other devices). It is the –machine interpretable– exposure of a –human understandable– command to a network."@en ;
    rdfs:isDefinedBy <https://saref.etsi.org/core/v3.2.1/>,
        <https://saref.etsi.org/core/v4.1.1/> ;
    rdfs:seeAlso <https://saref.etsi.org/core/v3.2.1/>,
        <https://saref.etsi.org/core/v4.1.1/>,
        <https://saref.etsi.org/saref4ehaw/v2.1.1/>,
        <https://saref.etsi.org/saref4grid/v2.1.1/> ;
    rdfs:subClassOf [ a owl:Restriction ;
            owl:allValuesFrom [ a owl:Class ;
                    owl:unionOf ( saref:Command saref:CommandOfInterest ) ] ;
            owl:onProperty saref:represents ],
        [ a owl:Restriction ;
            owl:minQualifiedCardinality 1 ;
            owl:onClass saref:CommandOfInterest ;
            owl:onProperty saref:represents ],
        [ a owl:Restriction ;
            owl:cardinality 1 ;
            owl:onProperty saref:isOperationOf ] ;
    skos:example "In the set of operations exposed by a smart light bulb on a given network, one may be dedicated to turn on and off the light and expect a boolean as input. Another one may be dedicated to set the luminosity status and expect a target luminosity level (a byte) and a transition time (encoded on two bytes)."@en,
        "In the set of operations exposed by a smart washing machine on a given network, one may be dedicated to set the water temperature for the washing cycle, and expected as input a enumerated value. Another one may be dedicated to start, pause, or stop the washing cycle."@en,
        "To turn on a light, send a CoAP PUT request with CBOR content 0xf5 (true)"@en ;
    skos:hiddenLabel "Operation" ;
    skos:historyNote "V3.2.1: Introduced saref:Operation and associated properties from oneM2M base ontology."@en ;
    skos:note "An operation may be described in terms of its inputs and outputs using OP saref:hasInput and saref:hasOutput. Inputs and outputs of operations typically describe the expected schema or shape of network messages."@en,
        "Typically, a device connected to a given network offers one service for each of its functions of interest, and each service has one operation per command of interest of the function of interest it represents."@en .