Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

the domain of model and instance classes changed to versioninfo #2003

Merged
merged 12 commits into from
Apr 25, 2024
6 changes: 6 additions & 0 deletions errata11.html
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,12 @@ <h2>Editorial Issues</h2>
<ul>
<li> <b>2024-04-24</b>: In the <a href="https://w3c.github.io/wot-resources/td/v1.1/ontology/td.ttl">Thing Description ontology</a> and it's associated <a href="https://www.w3.org/2019/wot/td#hasConfigurationInstance">HTML page</a>, the term <code>hasConfigurationInstance</code> has been changed to <code>hasInstanceConfiguration</code> to match the <a href="https://www.w3.org/2022/wot/td/v1.1">JSON-LD context file</a>. This change does not affect the <a href="https://www.w3.org/TR/wot-thing-description11/">WoT TD 1.1.</a> HTML specification.
</li>
<li> <b>2024-04-24</b>: In the <a href="https://w3c.github.io/wot-resources/td/v1.1/ontology/td.ttl">Thing Description
ontology</a> and it's associated <a href="https://www.w3.org/2019/wot/td#hasConfigurationInstance">HTML page</a>,
the <code>domain</code> of classes <code>model</code> and <code>instance</code> has been changed to
<code>versionInfo</code> to match the TD specification. This change does not affect the <a
href="https://www.w3.org/TR/wot-thing-description11/">WoT TD 1.1.</a> HTML specification.
</li>
</ul>
</section>
</section>
Expand Down
6 changes: 3 additions & 3 deletions ontology/td.html
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ <h2>Terminology</h2>
<section id="InteractionAffordance"><h4>InteractionAffordance</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#InteractionAffordance</code></p><span>Metadata of a Thing that shows the possible choices to Consumers, thereby suggesting how Consumers may interact with the Thing. There are many types of potential affordances, but W3C WoT defines three types of Interaction Affordances: Properties, Actions, and Events.</span><table class="def numbered"><tbody><tr><td>Super-class of</td><td><code><a href="#ActionAffordance">td:ActionAffordance</a></code><br><code><a href="#EventAffordance">td:EventAffordance</a></code><br><code><a href="#PropertyAffordance">td:PropertyAffordance</a></code></td></tr><tr><td>In the domain of</td><td><code><a href="#descriptionInLanguage">td:descriptionInLanguage</a></code><br><code><a href="#hasForm">td:hasForm</a></code><br><code><a href="#hasUriTemplateSchema">td:hasUriTemplateSchema</a></code><br><code><a href="#name">td:name</a></code><br><code><a href="#titleInLanguage">td:titleInLanguage</a></code><br><code><a href="https://www.w3.org/2019/wot/tm#ref">tm:ref</a></code></td></tr><tr><td>In the range of</td><td><code><a href="#hasInteractionAffordance">td:hasInteractionAffordance</a></code></td></tr></tbody></table></section>
<section id="OperationType"><h4>OperationType</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#OperationType</code></p><span>Enumeration of well-known operation types necessary to implement the WoT interaction model</span><table class="def numbered"><tbody><tr><td>Enumeration members</td><td><code><a href="#cancelAction">td:cancelAction</a></code><br><code><a href="#invokeAction">td:invokeAction</a></code><br><code><a href="#observeAllProperties">td:observeAllProperties</a></code><br><code><a href="#observeProperty">td:observeProperty</a></code><br><code><a href="#queryAction">td:queryAction</a></code><br><code><a href="#queryAllActions">td:queryAllActions</a></code><br><code><a href="#readAllProperties">td:readAllProperties</a></code><br><code><a href="#readMultipleProperties">td:readMultipleProperties</a></code><br><code><a href="#readProperty">td:readProperty</a></code><br><code><a href="#subscribeAllEvents">td:subscribeAllEvents</a></code><br><code><a href="#subscribeEvent">td:subscribeEvent</a></code><br><code><a href="#unobserveAllProperties">td:unobserveAllProperties</a></code><br><code><a href="#unobserveProperty">td:unobserveProperty</a></code><br><code><a href="#unsubscribeAllEvents">td:unsubscribeAllEvents</a></code><br><code><a href="#unsubscribeEvent">td:unsubscribeEvent</a></code><br><code><a href="#writeAllProperties">td:writeAllProperties</a></code><br><code><a href="#writeMultipleProperties">td:writeMultipleProperties</a></code><br><code><a href="#writeProperty">td:writeProperty</a></code></td></tr></tbody></table></section>
<section id="PropertyAffordance"><h4>PropertyAffordance</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#PropertyAffordance</code></p><span>An Interaction Affordance that exposes state of the Thing. This state can then be retrieved (read) and/or updated (write). Things can also choose to make Properties observable by pushing the new state after a change.</span><table class="def numbered"><tbody><tr><td>Sub-class of</td><td><code><a href="#InteractionAffordance">td:InteractionAffordance</a></code></td></tr><tr><td>In the domain of</td><td><code><a href="#isObservable">td:isObservable</a></code></td></tr><tr><td>In the range of</td><td><code><a href="#hasPropertyAffordance">td:hasPropertyAffordance</a></code></td></tr></tbody></table></section>
<section id="Thing"><h4>Thing</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#Thing</code></p><span>An abstraction of a physical or a virtual entity whose metadata and interfaces are described by a WoT Thing Description, whereas a virtual entity is the composition of one or more Things.</span><table class="def numbered"><tbody><tr><td>In the domain of</td><td><code><a href="#baseURI">td:baseURI</a></code><br><code><a href="#definesSecurityScheme">td:definesSecurityScheme</a></code><br><code><a href="#descriptionInLanguage">td:descriptionInLanguage</a></code><br><code><a href="#followsProfile">td:followsProfile</a></code><br><code><a href="#hasForm">td:hasForm</a></code><br><code><a href="#hasInteractionAffordance">td:hasInteractionAffordance</a></code><br><code><a href="#hasSecurityConfiguration">td:hasSecurityConfiguration</a></code><br><code><a href="#instance">td:instance</a></code><br><code><a href="#model">td:model</a></code><br><code><a href="#titleInLanguage">td:titleInLanguage</a></code></td></tr></tbody></table></section></section><section><h3>Object Properties</h3><section id="definesSecurityScheme"><h4>definesSecurityScheme</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#definesSecurityScheme</code></p><span>A Thing may define abstract security schemes, used to configure the secure access of (a set of) affordance(s).</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#Thing">td:Thing</a></code></td></tr></tbody></table></section>
<section id="Thing"><h4>Thing</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#Thing</code></p><span>An abstraction of a physical or a virtual entity whose metadata and interfaces are described by a WoT Thing Description, whereas a virtual entity is the composition of one or more Things.</span><table class="def numbered"><tbody><tr><td>In the domain of</td><td><code><a href="#baseURI">td:baseURI</a></code><br><code><a href="#definesSecurityScheme">td:definesSecurityScheme</a></code><br><code><a href="#descriptionInLanguage">td:descriptionInLanguage</a></code><br><code><a href="#followsProfile">td:followsProfile</a></code><br><code><a href="#hasForm">td:hasForm</a></code><br><code><a href="#hasInteractionAffordance">td:hasInteractionAffordance</a></code><br><code><a href="#hasSecurityConfiguration">td:hasSecurityConfiguration</a></code><br><code><a href="#titleInLanguage">td:titleInLanguage</a></code></td></tr></tbody></table></section></section><section><h3>Object Properties</h3><section id="definesSecurityScheme"><h4>definesSecurityScheme</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#definesSecurityScheme</code></p><span>A Thing may define abstract security schemes, used to configure the secure access of (a set of) affordance(s).</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#Thing">td:Thing</a></code></td></tr></tbody></table></section>
<section id="hasActionAffordance"><h4>hasActionAffordance</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#hasActionAffordance</code></p><span>All Action-based interaction affordance of the Thing.</span><table class="def numbered"><tbody><tr><td>Range includes</td><td><code><a href="#ActionAffordance">td:ActionAffordance</a></code></td></tr></tbody></table></section>
<section id="hasCancellationSchema"><h4>hasCancellationSchema</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#hasCancellationSchema</code></p><span>Defines any data that needs to be passed to cancel a subscription, e.g., a specific message to remove a Webhook</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#EventAffordance">td:EventAffordance</a></code></td></tr></tbody></table></section>
<section id="hasEventAffordance"><h4>hasEventAffordance</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#hasEventAffordance</code></p><span>All Event-based interaction affordance of the Thing.</span><table class="def numbered"><tbody><tr><td>Range includes</td><td><code><a href="#EventAffordance">td:EventAffordance</a></code></td></tr></tbody></table></section>
Expand All @@ -135,12 +135,12 @@ <h2>Terminology</h2>
<section id="description"><h4>description</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#description</code></p><span>Provides description of the Thing Model element.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="https://www.w3.org/2019/wot/tm#ThingModel">tm:ThingModel</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section>
<section id="descriptionInLanguage"><h4>descriptionInLanguage</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#descriptionInLanguage</code></p><span>description of the TD element (Thing, interaction affordance, security scheme or data schema) with language tag. By convention, a language tag must be added to the object of 'descriptionInLanguage' triples. Otherwise, use 'description'.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="https://www.w3.org/2019/wot/json-schema#DataSchema">jsonschema:DataSchema</a></code><br><code><a href="https://www.w3.org/2019/wot/security#SecurityScheme">wotsec:SecurityScheme</a></code><br><code><a href="#InteractionAffordance">td:InteractionAffordance</a></code><br><code><a href="#Thing">td:Thing</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section>
<section id="followsProfile"><h4>followsProfile</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#followsProfile</code></p><span>Indicates the WoT Profile mechanisms followed by this Thing Description and the corresponding Thing implementation.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#Thing">td:Thing</a></code></td></tr><tr><td>Range includes</td><td></td></tr></tbody></table></section>
<section id="instance"><h4>instance</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#instance</code></p><span>Provides a version identicator of this TD instance.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#Thing">td:Thing</a></code></td></tr></tbody></table></section>
<section id="instance"><h4>instance</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#instance</code></p><span>Provides a version identicator of this TD instance.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#versionInfo">td:versionInfo</a></code></td></tr></tbody></table></section>
<section id="isIdempotent"><h4>isIdempotent</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#isIdempotent</code></p><span>Indicates whether the action is idempotent (=true) or not. Informs whether the action can be called repeatedly with the same result, if present, based on the same input.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#ActionAffordance">td:ActionAffordance</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Boolean">schema:Boolean</a></code></td></tr></tbody></table></section>
<section id="isObservable"><h4>isObservable</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#isObservable</code></p><span>A hint that indicates whether Servients hosting the Thing and Intermediaries should provide a Protocol Binding that supports the <code>observeproperty</code> and <code>unobserveproperty</code> operations for this Property.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#PropertyAffordance">td:PropertyAffordance</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Boolean">schema:Boolean</a></code></td></tr></tbody></table></section>
<section id="isSafe"><h4>isSafe</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#isSafe</code></p><span>Signals if the action is safe (=true) or not. Used to signal if there is no internal state (cf. resource state) is changed when invoking an Action. In that case responses can be cached as example.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#ActionAffordance">td:ActionAffordance</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Boolean">schema:Boolean</a></code></td></tr></tbody></table></section>
<section id="isSynchronous"><h4>isSynchronous</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#isSynchronous</code></p><span>Indicates whether the action is synchronous (=true) or not. A synchronous action means that the response of action contains all the information about the result of the action and no further querying about the status of the action is needed. Lack of this keyword means that no claim on the synchronicity of the action can be made.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#ActionAffordance">td:ActionAffordance</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Boolean">schema:Boolean</a></code></td></tr></tbody></table></section>
<section id="model"><h4>model</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#model</code></p><span>Provides a version indicator of the underlying TM.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#Thing">td:Thing</a></code></td></tr></tbody></table></section>
<section id="model"><h4>model</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#model</code></p><span>Provides a version indicator of the underlying TM.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#versionInfo">td:versionInfo</a></code></td></tr></tbody></table></section>
<section id="name"><h4>name</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#name</code></p><span>Indexing property to store entity names when serializing them in a JSON-LD @index container.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#InteractionAffordance">td:InteractionAffordance</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section>
<section id="title"><h4>title</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#title</code></p><span>Provide the title of the Thing Model</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="https://www.w3.org/2019/wot/tm#ThingModel">tm:ThingModel</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section>
<section id="titleInLanguage"><h4>titleInLanguage</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#titleInLanguage</code></p><span>title of the TD element (Thing, interaction affordance or data schema) with language tag. By convention, a language tag must be added to the object of 'titleInLanguage' triples. Otherwise, use 'title'.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="https://www.w3.org/2019/wot/json-schema#DataSchema">jsonschema:DataSchema</a></code><br><code><a href="#InteractionAffordance">td:InteractionAffordance</a></code><br><code><a href="#Thing">td:Thing</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section></section><section><h3>Annotation Properties</h3><section id="supportContact"><h4>supportContact</h4><p>IRI: <code>https://www.w3.org/2019/wot/td#supportContact</code></p><span>Provides information about the TD maintainer as URI scheme (e.g., mailto [[RFC6068]], tel [[RFC3966]], https[[RFC9112]]).</span><table class="def numbered"><tbody></tbody></table></section>
Expand Down
4 changes: 2 additions & 2 deletions ontology/td.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -153,13 +153,13 @@
:instance rdf:type owl:DatatypeProperty ;
rdfs:label "instance" ;
rdfs:comment "Provides a version identicator of this TD instance."@en ;
schema:domainIncludes :Thing ;
schema:domainIncludes :versionInfo ;
rdfs:isDefinedBy <https://www.w3.org/2019/wot/td> .

:model rdf:type owl:DatatypeProperty ;
rdfs:label "model" ;
rdfs:comment "Provides a version indicator of the underlying TM."@en ;
schema:domainIncludes :Thing ;
schema:domainIncludes :versionInfo ;
rdfs:isDefinedBy <https://www.w3.org/2019/wot/td> .

:isSafe rdf:type owl:DatatypeProperty ;
Expand Down
Loading