Changes between Initial Version and Version 1 of RpResDescription


Ignore:
Timestamp:
Sep 30, 2010, 8:41:42 PM (14 years ago)
Author:
s.meissner
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • RpResDescription

    v1 v1  
     1The Resource Description is essential for your Resources published in SENSEI domains. Based on the Resource Description Resource Users will lookup available Resources so that it is important you provide sufficient information about the Resources you have published.
     2
     3The basic elements of Resource Descriptions are:
     4
     5Resource ID: is a unique identifier you assign to your Resource. The IPv6 address is an appropriate identifier for instance.
     6Name:  an arbitrary name that describes your Resource
     7Tag: tags are optional, it is used to provide key words for search engines
     8RAI-Description: a RAI description shows the Resource Users how to access your Resource in order to retrieve its values. A Resource can expose several RAI interfaces for the same Resource. There could be a REST interface and an interface for SOAP web services. To distinguish between different RAI interfaces the RAI-ID is required. The REP-Locator determines the path to the Resource the Resource User's request is sent to. A WADL description of the RAI interface can be retrieved on the Document-Link.
     9 
     10An example Resource Description for a Telos B light sensor deployed in the domain 'sensinode.com' in Finland as used in the sample project is shown below:
     11
     12{{{
     13<?xml version="1.0"?>
     14<!DOCTYPE Resources [
     15 <!ENTITY eui64 "fa80-0342-001a-4201">
     16 <!ENTITY ipaddress "gateway.sensinode.com">
     17 <!ENTITY domain "sensinode.com">
     18 <!ENTITY wsan "Vuokatti">
     19 <!ENTITY nodeid "node1">
     20 ]>
     21<Resources xsi:noNamespaceSchemaLocation="ResourceDescription.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     22        <Resource-Description>
     23                <Resource-ID>urn:sensei:&domain;:Telosb:light:&eui64;</Resource-ID>
     24                <Name>Light sensor</Name>
     25                <Tag>urn:sensei:wsan:&wsan;</Tag>
     26                <Tag>urn:sensei:node:&eui64;</Tag>
     27                <RAI-Description>
     28                        <RAI-ID>0</RAI-ID>
     29                        <REP-Locator>http://&ipaddress;/&nodeid;/s/light</REP-Locator>
     30                        <Document-Link>urn:sensei:rai:sensor</Document-Link>
     31                </RAI-Description>
     32        </Resource-Description>
     33</Resources>
     34
     35}}}