ldp-ucr.html
author Steve Speicher <sspeiche@gmail.com>
Mon, 26 Jan 2015 11:51:28 -0500
changeset 938 859f98c26867
parent 446 54e29dfbcbaa
permissions -rw-r--r--
AC rep comment #2 on clarity on types in examples
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     1
<!DOCTYPE html>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     2
<html>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     3
  <head>
35
a70ab3ad21aa 2013-01-03 - Fixed Typo. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 34
diff changeset
     4
    <title>Linked Data Platform Use Cases and Requirements</title>
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     5
    <meta http-equiv='Content-Type' content='text/html;charset=utf-8'/>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     6
    <!-- 
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     7
      === NOTA BENE ===
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     8
      For the three scripts below, if your spec resides on dev.w3 you can check them
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
     9
      out in the same tree and use relative links so that they'll work offline,
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    10
     -->
41
634a37de3539 Changed to pulling respec using https
sspeiche
parents: 35
diff changeset
    11
    <script src='https://www.w3.org/Tools/respec/respec-w3c-common' class='remove' async></script> 
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    12
    <script class='remove'>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    13
      var respecConfig = {
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    14
          // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
446
54e29dfbcbaa UCR status test
steve.battle@sysemia.co.uk
parents: 445
diff changeset
    15
          specStatus:           "ED",
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    16
          
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    17
          // the specification's short name, as in http://www.w3.org/TR/short-name/
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    18
          shortName:            "ldp-ucr",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    19
          // TODO: Confirm short name
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    20
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    21
          // if your specification has a subtitle that goes below the main
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    22
          // formal title, define it here
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    23
          // subtitle   :  "an excellent document",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    24
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    25
          // if you wish the publication date to be other than today, set this
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    26
          // publishDate:  "2009-08-06",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    27
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    28
          // if the specification's copyright date is a range of years, specify
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    29
          // the start date here:
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    30
          // copyrightStart: "2005"
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    31
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    32
          // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    33
          // and its maturity status
408
b6cbb2b13e7e refreshed UC&R WD
steve.battle <steve.battle@sysemia.co.uk>
parents: 407
diff changeset
    34
          previousPublishDate:  "2013-01-31",
b6cbb2b13e7e refreshed UC&R WD
steve.battle <steve.battle@sysemia.co.uk>
parents: 407
diff changeset
    35
          previousMaturity:  	"WD",
b6cbb2b13e7e refreshed UC&R WD
steve.battle <steve.battle@sysemia.co.uk>
parents: 407
diff changeset
    36
          previousURI: 			"http://www.w3.org/TR/2013/WD-ldp-ucr-20130131/",
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    37
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    38
          // if there a publicly available Editor's Draft, this is the link
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    39
          edDraftURI:           "http://www.w3.org/2012/ldp/hg/ldp-ucr.html",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    40
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    41
          // if this is a LCWD, uncomment and set the end of its review period
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    42
          // lcEnd: "2009-08-05",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    43
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    44
          // if you want to have extra CSS, append them to this list
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    45
          // it is recommended that the respec.css stylesheet be kept
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    46
          //extraCSS:             ["https://dvcs.w3.org/hg/ldpwg/css/respec.css"],
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    47
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    48
          // editors, add as many as you like
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    49
          // only "name" is required
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    50
          editors:  [
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    51
              { name:"Steve Battle", url: "http://stevebattle.me",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    52
                company: "Sysemia Limited", companyURL: "http://www.sysemia.com" },
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    53
              { name:"Steve Speicher", url: "http://stevespeicher.me",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    54
                company: "IBM Corporation", companyURL: "http://ibm.com/" }
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    55
          ],
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    56
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    57
          // authors, add as many as you like. 
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    58
          // This is optional, uncomment if you have authors as well as editors.
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    59
          // only "name" is required. Same format as editors.
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    60
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    61
          //authors:  [
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    62
          //    { name: "Your Name", url: "http://example.org/",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    63
          //      company: "Your Company", companyURL: "http://example.com/" },
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    64
          //],
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    65
          
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    66
          // name of the WG
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    67
          wg:           "Linked Data Platform Working Group",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    68
          
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    69
          // URI of the public WG page
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    70
          wgURI:        "http://www.w3.org/2012/ldp",
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    71
          
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    72
          // name (without the @w3c.org) of the public mailing to which comments are due
46
a56c74d03222 changed feedback list to the publicly writable list
Yves Lafon <ylafon@w3.org>
parents: 41
diff changeset
    73
          wgPublicList: "public-ldp",
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    74
          
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    75
          // URI of the patent status for this WG, for Rec-track documents
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    76
          // !!!! IMPORTANT !!!!
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    77
          // This is important for Rec-track documents, do not copy a patent URI from a random
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    78
          // document unless you know what you're doing. If in doubt ask your friendly neighbourhood
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    79
          // Team Contact.
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
    80
          wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/55082/status",
339
b2fd35c64739 localbiblio test
steve.battle <steve.battle@sysemia.co.uk>
parents: 338
diff changeset
    81
          doRDFa: "1.1",
b2fd35c64739 localbiblio test
steve.battle <steve.battle@sysemia.co.uk>
parents: 338
diff changeset
    82
		  localBiblio:  {
340
a70cf24f4468 localbiblio test
steve.battle <steve.battle@sysemia.co.uk>
parents: 339
diff changeset
    83
			"OSLC": {
a70cf24f4468 localbiblio test
steve.battle <steve.battle@sysemia.co.uk>
parents: 339
diff changeset
    84
				title:    "Open Services for Lifecycle Collaboration",
344
f3bedfe31422 localbiblio test
steve.battle <steve.battle@sysemia.co.uk>
parents: 343
diff changeset
    85
				href:     "http://open-services.net/"
346
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
    86
		    },
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
    87
			"XO": {
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
    88
				title:    "SemanticXO",
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
    89
				href:     "http://worldwidesemanticweb.org/projects/semanticxo/"
347
986567017ca7 Added ADMS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 346
diff changeset
    90
		    },
986567017ca7 Added ADMS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 346
diff changeset
    91
			"ADMS": {
986567017ca7 Added ADMS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 346
diff changeset
    92
				title:    "Asset Description Metadata Schema",
986567017ca7 Added ADMS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 346
diff changeset
    93
				href:     "http://joinup.ec.europa.eu/asset/adms/home",
986567017ca7 Added ADMS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 346
diff changeset
    94
				publisher:  "European Commission"
348
35c503904791 Added WoT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 347
diff changeset
    95
		    },
35c503904791 Added WoT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 347
diff changeset
    96
			"WOT": {
35c503904791 Added WoT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 347
diff changeset
    97
				title:    "Web of Things Community Group",
35c503904791 Added WoT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 347
diff changeset
    98
				href:     "http://www.w3.org/community/wot/",
35c503904791 Added WoT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 347
diff changeset
    99
				publisher:  "W3C"
350
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   100
			},
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   101
			"6LOWPAN": {
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   102
				title:    "IPv6 over Low power WPAN",
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   103
				href:     "http://datatracker.ietf.org/wg/6lowpan/",
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   104
				publisher:  "IETF"
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   105
			},
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   106
			"COAP": {
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   107
				title:    "Constrained Application Protocol",
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   108
				href:     "http://tools.ietf.org/html/draft-ietf-core-coap-18",
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   109
				publisher:  "IETF"
351
c3bd4a0d2599 Added COAP-MAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 350
diff changeset
   110
			},
c3bd4a0d2599 Added COAP-MAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 350
diff changeset
   111
			"COAP-MAP": {
c3bd4a0d2599 Added COAP-MAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 350
diff changeset
   112
				title:    "Best Practices for HTTP-CoAP Mapping Implementation",
c3bd4a0d2599 Added COAP-MAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 350
diff changeset
   113
				href:     "http://tools.ietf.org/html/draft-castellani-core-http-mapping-07",
c3bd4a0d2599 Added COAP-MAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 350
diff changeset
   114
				publisher:  "IETF"
352
8bb8d646e1ba Added CHANGESET ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 351
diff changeset
   115
			},
8bb8d646e1ba Added CHANGESET ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 351
diff changeset
   116
			"CHANGESET": {
8bb8d646e1ba Added CHANGESET ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 351
diff changeset
   117
				title:    "Changeset",
353
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   118
				href:     "http://vocab.org/changeset/schema.html",
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   119
				"authors": [
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   120
					"S. Tunnicliffe",
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   121
					"I. Davis"
354
ecf80fcd9aa7 Corrected SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 353
diff changeset
   122
				]
ecf80fcd9aa7 Corrected SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 353
diff changeset
   123
			},
353
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   124
			"SSN": {
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   125
				title:	"Semantic Sensor Network XG Final Report",
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   126
				href:	"http://www.w3.org/2005/Incubator/ssn/XGR-ssn/",
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
   127
				publisher: "W3C"
355
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   128
			},
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   129
			"SNOMED": {
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   130
				title: "SNOMED CT",
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   131
				href: "http://www.ihtsdo.org/snomed-ct/",
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   132
				publisher: "International Health Terminology Standards Development Organisation (IHTSDO)"
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   133
			},
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   134
			"DC-COLLECTIONS": {
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   135
				title: "Dublin Core Collections Application Profile",
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
   136
				href: "http://dublincore.org/groups/collections/collection-application-profile/"
356
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   137
			},
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   138
			"FRBR": {
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   139
				title: "Functional Requirements for Bibliographic Records",
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   140
				href: "http://www.ifla.org/publications/functional-requirements-for-bibliographic-records",
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   141
				publisher: "International Federation of Library Associations (IFLA)"
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   142
			},
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   143
			"FRBR-CORE": {
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   144
				title: "Expression of Core FRBR Concepts in RDF",
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   145
				href: "http://vocab.org/frbr/core.html",
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   146
				"authors": [
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   147
					"I. Davis",
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   148
					"R. Newman"
9e3c439e10c1 Added FRBR ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 355
diff changeset
   149
				]				
357
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   150
			},
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   151
			"BBC-SPORT": {
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   152
				title: "Sport Ontology",
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   153
				href: "http://www.bbc.co.uk/ontologies/sport/2011-02-17.shtml",
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   154
				"authors": [
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   155
					"J. Rayfield",
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   156
					"P. Wilton",
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   157
					"S. Oliver"
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
   158
				]					
358
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
   159
			},
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
   160
			"ORG-ONT": {
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
   161
				title: "An organization ontology",
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
   162
				href: "http://www.epimorphics.com/public/vocabulary/org.html",
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
   163
				"authors": [
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
   164
					"D. Reynolds"
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
   165
				]				
359
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   166
			},
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   167
			"RESEARCH-OBJECTS": {
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   168
				title: "Workflow-Centric Research Objects: First Class Citizens in Scholarly Discourse",
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   169
				href: "http://ceur-ws.org/Vol-903/paper-01.pdf",
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   170
				"authors": [
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   171
					"K Belhajjame et al"
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   172
				]				
348
35c503904791 Added WoT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 347
diff changeset
   173
			}
339
b2fd35c64739 localbiblio test
steve.battle <steve.battle@sysemia.co.uk>
parents: 338
diff changeset
   174
		  }
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   175
      };
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   176
    </script>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   177
    <style type="text/css">
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   178
    	div.rule {padding-top: 1em;}
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   179
    	div.ldp-issue {
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   180
	    	border-color: #E05252;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   181
			background: #FBE9E9;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   182
			padding: 0.5em;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   183
			margin: 1em 0;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   184
			position: relative;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   185
			clear: both;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   186
			border-left-width: .5em;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   187
			border-left-style: solid;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   188
    	}
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   189
    	div.ldp-issue-title {
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   190
    	    color: #E05252;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   191
    	    padding-right: 1em;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   192
            min-width: 7.5em;
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   193
    	}
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   194
    </style>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   195
  </head>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   196
<body>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   197
<section id='abstract'>
148
502481f2742d Updates to UC&R abstract
steve.battle <steve.battle@sysemia.co.uk>
parents: 147
diff changeset
   198
<p>
502481f2742d Updates to UC&R abstract
steve.battle <steve.battle@sysemia.co.uk>
parents: 147
diff changeset
   199
To foster the development of the Linked Data Platform specification, this document includes a set of user stories, use cases, scenarios and requirements that motivate a simple read-write Linked Data architecture, based on HTTP access to web resources that describe their state using RDF.
156
9dafe5f2b2e8 cosmetic chnages to UC&R use cases.
steve.battle <steve.battle@sysemia.co.uk>
parents: 155
diff changeset
   200
 The starting point for the development of these use cases is a collection of user stories that provide realistic examples describing how people may use read-write Linked Data. The use cases themselves are captured in a narrative style that describes a
9dafe5f2b2e8 cosmetic chnages to UC&R use cases.
steve.battle <steve.battle@sysemia.co.uk>
parents: 155
diff changeset
   201
 behavior, or set of behaviors based on, and using scenarios from, these user stories. The aim throughout has been to avoid details of protocol (specifically 
148
502481f2742d Updates to UC&R abstract
steve.battle <steve.battle@sysemia.co.uk>
parents: 147
diff changeset
   202
 the HTTP protocol), and use of any specific vocabulary that might be introduced by the 
502481f2742d Updates to UC&R abstract
steve.battle <steve.battle@sysemia.co.uk>
parents: 147
diff changeset
   203
 <abbr title="Linked Data Platform">LDP</abbr> specification.
502481f2742d Updates to UC&R abstract
steve.battle <steve.battle@sysemia.co.uk>
parents: 147
diff changeset
   204
</p>
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   205
</section>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   206
396
f0942ab2bf05 changed section 'status' to 'sotd'
steve.battle <steve.battle@sysemia.co.uk>
parents: 392
diff changeset
   207
<section id='sotd'>
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   208
</section>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   209
 
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   210
<section>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   211
<h1 id="scope">Scope and Motivation</h1>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   212
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   213
		Linked Data was defined by Tim Berners-Lee with the following
26
a3eb8135ecc4 Updated Abstract and removed extra statements from Status
sspeiche
parents: 25
diff changeset
   214
		guidelines [[LINKED-DATA]]:
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   215
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   216
	<ol>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   217
		<li>Use URIs as names for things</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   218
		<li>Use HTTP URIs so that people can look up those names</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   219
		<li>When someone looks up a URI, provide useful information,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   220
			using the standards (RDF*, SPARQL)</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   221
		<li>Include links to other URIs. so that they can discover
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   222
			more things</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   223
	</ol>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   224
	<p>These four rules have proven very effective in guiding and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   225
		inspiring people to publish Linked Data on the web. The amount of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   226
		data, especially public data, available on the web has grown
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   227
		rapidly, and an impressive number of extremely creative and useful
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   228
		“mashups” have been created using this data as result.</p>
147
6060c53dc7f8 Content removed from UC&R Scope and Motivation
steve.battle <steve.battle@sysemia.co.uk>
parents: 146
diff changeset
   229
	
145
f26a0fd3ec5c Cosmetic updates to UC&R scope & motivation
steve.battle <steve.battle@sysemia.co.uk>
parents: 144
diff changeset
   230
	<p>The goal for the [[LINKED-DATA-PLATFORM]] is
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   231
		to define a specification required to allow the definition of a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   232
		writable Linked Data API equivalent to the simple application APIs
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   233
		that are often written on the web today using the Atom Publishing
145
f26a0fd3ec5c Cosmetic updates to UC&R scope & motivation
steve.battle <steve.battle@sysemia.co.uk>
parents: 144
diff changeset
   234
		Protocol (APP), which shares some characteristics with Linked Data
146
34eab02b1fb7 Further cosmetic operations on Scope & Motivation
steve.battle <steve.battle@sysemia.co.uk>
parents: 145
diff changeset
   235
		such as the use of HTTP and URLs but relying on a flexible data model based on RDF that allows for
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   236
		multiple representations.</p>
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   237
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   238
</section>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   239
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   240
<section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   241
<h1 id="org">Organization of this Document</h1>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   242
	<p>This document is organized as follows:</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   243
	<ul>
27
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   244
		<li><b><a href="#userstories" title="User Stories">User Stories</a></b>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   245
			capture statements about system requirements written from a user
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   246
			or application perspective. They are typically lightweight and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   247
			informal and can run from one line to a paragraph or two
241
6cbfa4e97a0d Revisions to user-stories UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 240
diff changeset
   248
			(sometimes described as an 'epic') [[COHN-2004]]. 
6cbfa4e97a0d Revisions to user-stories UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 240
diff changeset
   249
			This document redacts a number of user stories around the theme of read/writeable linked data.
6cbfa4e97a0d Revisions to user-stories UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 240
diff changeset
   250
			Analysis of each user story reveals a
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   251
			number of (functional) use cases and other non-functional
346
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
   252
			requirements. See <em>Device API Access Control Use Cases and Requirements</em> [[DAP-REQS]] for a good example
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   253
			of user stories and their analysis.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   254
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   255
	<ul>
406
2b89cd5ec08f Fixed usecases fragment
steve.battle <steve.battle@sysemia.co.uk>
parents: 405
diff changeset
   256
		<li><b><a href="#usecases" title="Use Cases">Use Cases</a></b> are
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   257
			used to capture and model functional requirements. Use cases
239
e3d0ad609944 Added new informative references to UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 166
diff changeset
   258
			describe the system’s behavior under various conditions [[COCKBURN-2000]],
27
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   259
			cataloging who does what with the system, for what purpose, but
239
e3d0ad609944 Added new informative references to UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 166
diff changeset
   260
			without concern for system design or implementation. Each use case is identified by a
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   261
			reference number to aid cross-reference from other documentation;
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   262
			use case indexing in this document is based on rdb2rdf
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   263
			use cases [[RDB2RDF-UC]]. A variety of styles may be used to capture use cases,
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   264
			from a simple narrative to a structured description with actors,
346
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
   265
			pre/post conditions, step-by-step behaviors (as in <em>POWDER:
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
   266
			Use Cases and Requirements</em> [[POWDER-USE-CASES]]), and non-functional requirements
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   267
			raised by the use case.</li>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   268
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   269
	<ul>
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   270
		<li><b>Scenarios</b> are used to model the functional requirements of a use case and focus on a use case in action. Scenarios may range from
346
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
   271
			lightweight narratives as seen in <em>Use
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
   272
			cases and requirements for Media Fragments</em> [[MEDIA-FRAGMENTS-REQS]], to being formally
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   273
			modeled as interaction diagrams. Each use case includes at
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   274
			least a primary scenario, and possibly other alternative
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   275
			scenarios.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   276
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   277
	<ul>
27
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   278
		<li><b><a href="#reqs" title="Requirements">Requirements</a></b>
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   279
			list functional and non-functional or quality requirements, and the use cases
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   280
			they may be derived from. This approach is exemplified in the <em>Use Cases and Requirements for the Data
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   281
			Catalog Vocabulary</em> [[DCAT-UCR]].</li>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   282
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   283
</section>
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   284
	
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   285
<section>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   286
<h1 id="userstories">User Stories</h1>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   287
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   288
	<section>
284
dc6f22366747 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 283
diff changeset
   289
	<h2 id="story-social"><dfn>Maintaining Social Contact Information</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   290
	<p>Many of us have multiple email accounts that include
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   291
		information about the people and organizations we interact with –
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   292
		names, email addresses, telephone numbers, instant messenger
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   293
		identities and so on. When someone’s email address or telephone
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   294
		number changes (or they acquire a new one), our lives would be
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   295
		much simpler if we could update that information in one spot and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   296
		all copies of it would automatically be updated. In other words,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   297
		those copies would all be linked to some definition of “the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   298
		contact.” There might also be good reasons (like off-line email
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   299
		addressing) to maintain a local copy of the contact, but ideally
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   300
		any copies would still be linked to some central “master.”</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   301
	<p>Agreeing on a format for “the contact” is not enough,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   302
		however. Even if all our email providers agreed on the format of a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   303
		contact, we would still need to use each provider’s custom
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   304
		interface to update or replace the provider’s copy, or we would
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   305
		have to agree on a way for each email provider to link to the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   306
		“master”. If we look outside our own personal interests, it would
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   307
		be even more useful if the person or organization exposed their
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   308
		own contact information so we could link to it.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   309
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   310
		What would work in either case is a common understanding of the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   311
		resource, a few formats needed, and access guidance for these
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   312
		resources. This would support how to acquire a link to a contact,
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   313
		how to use those links to interact with a contact (including <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   314
			href="#uc3" title="">reading</a>,
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   315
		<a href="#uc4" title="">updating</a>,
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   316
		and <a href="#s2.2" title="">deleting</a>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   317
		it), as well as how to easily <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   318
			href="#s2.1" title="">create a
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   319
			new contact</a>, add it to my contacts, and when deleting a
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   320
		contact, how it would be removed from my list of contacts. It
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   321
		would also be good to be able to add some application-specific
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   322
		data about my contacts that the original design didn’t consider.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   323
		Ideally we’d like to eliminate multiple copies of contacts, there
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   324
		would be additional valuable information about my contacts that
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   325
		may be stored on separate servers and need a simple way to link
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   326
		this information back to the contacts. Regardless of whether a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   327
		contact collection is my own, shared by an organization, or all
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   328
		contacts known to an email provider (or to a single email account
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   329
		at an email provider), it would be nice if they all worked pretty
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   330
		much the same way.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   331
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   332
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   333
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   334
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   335
	<h2 id="story-tracking_relationships"><dfn>Keeping Track of Personal and Business Relationships</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   336
	<p>In our daily lives, we deal with many different
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   337
		organizations in many different relationships, and they each have
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   338
		data about us. However, it is unlikely that any one organization
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   339
		has all the information about us. Each of them typically gives us
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   340
		access to the information (at least some of it), many through
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   341
		websites where we are uniquely identified by some string – an
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   342
		account number, user ID, and so on. We have to use their
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   343
		applications to interact with the data about us, and we
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   344
		have to use their identifier(s) for us.</p>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   345
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   346
		Would it not be simpler if at least the Web-addressable portion of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   347
		that data could be linked to consistently, so that instead of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   348
		maintaining various identifiers in different formats and instead
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   349
		of having to manually supply those identifiers to each one’s
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   350
		corresponding custom application, we could essentially build a set
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   351
		of bookmarks to it all? When we want to <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   352
			href="#uc3" title="">examine</a>
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   353
		or <a href="#uc4" title="">change</a>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   354
		their contents, would it not be simpler if there were a single
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   355
		consistent application interface that they all supported? 
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   356
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   357
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   358
		The information held by any single organization might be a mix of
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   359
		simple data and <a href="#uc6" title="">collections
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   360
			of other data</a>, for example, a bank account balance and a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   361
		collection of historical transactions. Our bank might easily have
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   362
		<a href="#s1.2"
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   363
			title="">a collection of accounts for each member of its collection
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   364
			of customers</a>.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   365
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   366
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   367
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   368
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   369
	<h2 id="story-oslc"><dfn>System and Software Development Tool Integration</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   370
	<p>System and software development tools typically come from a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   371
		diverse set of vendors and are built on various architectures and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   372
		technologies. These tools are purpose built to meet the needs for
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   373
		a specific domain scenario (modeling, design, requirements and so
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   374
		on.) Often tool vendors view integrations with other tools as a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   375
		necessary evil rather than providing additional value to their
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   376
		end-users. Even more of an afterthought is how these tools’ data
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   377
		-- such as people, projects, customer-reported problems and needs
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   378
		-- integrate and relate to corporate and external applications
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   379
		that manage data such as customers, business priorities and market
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   380
		trends. The problem can be isolated by standardizing on a small
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   381
		set of tools or a set of tools from a single vendor, but this
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   382
		rarely occurs and if does it usually does so only within small
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   383
		organizations. As these organizations grow both in size and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   384
		complexity, they have needs to work with outsourced development
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   385
		and diverse internal other organizations with their own set of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   386
		tools and processes. There is a need for better support of more
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   387
		complete business processes (system and software development
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   388
		processes) that span the roles, tasks, and data addressed by
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   389
		multiple tools. This demand has existed for many years, and the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   390
		tools vendor industry has tried several different architectural
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   391
		approaches to address the problem. Here are a few:</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   392
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   393
		<li>Implement an API for each application, and then, in each
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   394
			application, implement “glue code” that exploits the APIs of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   395
			other applications to link them together.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   396
		<li>Design a single database to store the data of multiple
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   397
			applications, and implement each of the applications against this
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   398
			database. In the software development tools business, these
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   399
			databases are often called “repositories.”</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   400
		<li>Implement a central “hub” or “bus” that orchestrates the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   401
			broader business process by exploiting the APIs described
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   402
			previously.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   403
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   404
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   405
		It is fair to say that although each of those approaches has its
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   406
		adherents and can point to some successes, none of them is wholly
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   407
		satisfactory. The use of Linked Data as an application integration
336
2a92845ecff8 Added OSLC informative reference.
steve.battle <steve.battle@sysemia.co.uk>
parents: 306
diff changeset
   408
		technology has a strong appeal [[OSLC]].
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   409
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   410
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   411
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   412
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   413
	<h2 id="story-lld"><dfn>Library Linked Data</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   414
	<p>
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   415
		The W3C Library Linked Data Working Group has a number of use
346
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
   416
		cases cited in their <em>Use Case Report</em> [[LLD-UC]]. These referenced use cases focus on the
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   417
		need to extract and correlate library data from disparate sources.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   418
		Variants of these use cases that can provide consistent formats,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   419
		as well as ways to improve or update the data, would enable
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   420
		simplified methods for both efficiently sharing this data as well
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   421
		as producing incremental updates without the need for repeated
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   422
		full extractions and import of data.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   423
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   424
	<p>The 'Digital Objects Cluster' contains a number of relevant
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   425
		use cases:</p>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   426
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   427
		<li>Grouping: This should "Allow the end-users to define <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   428
			href="#uc6" title="">groups of resources</a>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   429
			on the web that for some reason belong together. The relationship
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   430
			that exists between the resources is often left unspecified. Some
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   431
			of the resources in a group may not be under control of the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   432
			institution that defines the groups."
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   433
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   434
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   435
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   436
		<li>Enrichment: "Enable end-users to <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   437
			href="#uc4" title="">link resources
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   438
				together</a>."
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   439
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   440
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   441
	<ul>
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   442
		<li>Browsing: "<a href="#uc7"
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   443
			title="">Support end-user browsing through groups</a> and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   444
			resources that belong to the groups."
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   445
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   446
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   447
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   448
		<li>Re-use: "Users should have the capability to re-use all
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   449
			or parts of a collection, with all or part of its metadata,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   450
			elsewhere on the linked Web."</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   451
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   452
	<p>The 'Collections' cluster also contains a number of relevant
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   453
		use cases:</p>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   454
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   455
		<li>Collection-level description: "Provide <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   456
			href="#uc7" title="">metadata
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   457
				pertaining to a collection as a whole</a>, in contrast to item-level
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   458
			description."
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   459
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   460
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   461
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   462
		<li>Collections discovery: "Enable innovative collection
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   463
			discovery such as identification of nearest location of a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   464
			physical collection where a specific information resource is
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   465
			found or mobile device applications ... based on collection-level
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   466
			descriptions."</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   467
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   468
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   469
		<li>Community information services: Identify and classify
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   470
			collections of special interest to the community.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   471
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   472
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   473
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   474
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   475
	<h2 id="story-meter_monitoring"><dfn>Municipality Operational Monitoring</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   476
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   477
		Across various cities, towns, counties, and various municipalities
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   478
		there is a growing number of services managed and run by
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   479
		municipalities that produce and consume a vast amount of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   480
		information. This information is used to help monitor services,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   481
		predict problems, and handle logistics. In order to effectively
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   482
		and efficiently collect, produce, and analyze all this data, a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   483
		fundamental set of loosely coupled standard data sources are
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   484
		needed. A simple, low-cost way to <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   485
			href="#uc3" title="">expose
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   486
			data</a> from the diverse set of monitored services is needed, one
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   487
		that can easily integrate into the municipalities of other systems
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   488
		that inspect and analyze the data. All these services have links
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   489
		and dependencies on other data and services, so having a simple
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   490
		and scalable linking model is key.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   491
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   492
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   493
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   494
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   495
	<h2 id="story-healthcare"><dfn>Healthcare</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   496
	<p>For physicians to analyze, diagnose, and propose treatment
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   497
		for patients requires a vast amount of complex, changing and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   498
		growing knowledge. This knowledge needs to come from a number of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   499
		sources, including physicians’ own subject knowledge, consultation
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   500
		with their network of other healthcare professionals, public
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   501
		health sources, food and drug regulators, and other repositories
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   502
		of medical research and recommendations.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   503
	<p>To diagnose a patient’s condition requires current data on
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   504
		the patient’s medications and medical history. In addition, recent
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   505
		pharmaceutical advisories about these medications are linked into
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   506
		the patient’s data. If the patient experiences adverse effects
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   507
		from medications, these physicians need to publish information
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   508
		about this to an appropriate regulatory source. Other medical
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   509
		professionals require access to both validated and emerging
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   510
		effects of the medication. Similarly, if there are geographical
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   511
		patterns around outbreaks that allow both the awareness of new
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   512
		symptoms and treatments, this information needs to quickly reach a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   513
		very distributed and diverse set of medical information systems.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   514
		Also, reporting back to these regulatory agencies regarding new
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   515
		occurrences of an outbreak, including additional details of
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   516
		symptoms and causes, is critical in producing the most effective
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   517
		treatment for future incidents.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   518
	</section>	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   519
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   520
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   521
	<h2 id="story-media"><dfn>Metadata Enrichment in Broadcasting</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   522
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   523
		There are many different use cases when broadcasters show interest
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   524
		in metadata <a href="#uc4" title="">
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   525
			enrichment</a>:
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   526
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   527
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   528
		<li>enrich archive or news metadata by linking facts, events,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   529
			locations and personalities</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   530
		<li>enrich metadata generated by automatic extraction tools
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   531
			such as person identification, etc.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   532
		<li>enrich definitions of terms in classification schemes or
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   533
			enumeration lists</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   534
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   535
	<p>This comes in support of more effective information
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   536
		management and data/content mining (if you can't find your
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   537
		content, it's like you don't have it and must either recreate or
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   538
		acquire it again, which is not financially effective).</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   539
	<p>However, there is a need for solutions facilitating linkage
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   540
		to other data sources and taking care of the issues such as
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   541
		discovery, automation, disambiguation, etc. Other important issues
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   542
		that broadcasters would face are the editorial quality of the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   543
		linked data, its persistence, and usage rights.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   544
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   545
		
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   546
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   547
	<h2 id="story-mashup"><dfn>Aggregation and Mashups of Infrastructure Data</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   548
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   549
		For infrastructure management (such as storage systems, virtual
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   550
		machine environments, and similar IaaS and PaaS concepts), it is
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   551
		important to provide an environment in which information from
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   552
		different sources can be <a href="#uc6"
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   553
			title="">aggregated</a>, <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   554
			href="#uc7" title="">filtered</a>,
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   555
		and visualized effectively. Specifically, the following use cases
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   556
		need to be taken into account:
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   557
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   558
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   559
		<li>While some data sources are based on Linked Data, others
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   560
			are not, and aggregation and mashups must work across these
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   561
			different sources.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   562
		<li>Consumers of the data sources and aggregated/filtered
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   563
			data streams are not necessarily implementing Linked Data
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   564
			themselves, they may be off-the-shelf components such as
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   565
			dashboard frameworks for composing visualizations.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   566
		<li>Simple versions of this scenario are pull-based, where
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   567
			the data is requested from data sources. In more advanced
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   568
			settings, without a major change in architecture it should be
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   569
			possible to move to a push-based interaction model, where data
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   570
			sources push notifications to subscribers, and data sources
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   571
			provide different services that consumers can subscribe to (such
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   572
			as "informational messages" or "critical alerts only").</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   573
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   574
	<p>In this scenario, the important factors are to have
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   575
		abstractions that allow easy aggregation and filtering, are
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   576
		independent from the internal data model of the sources that are
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   577
		being combined, and can be used for pull-based interactions as
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   578
		well as for push-based interactions.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   579
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   580
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   581
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   582
	<h2 id="story-low-end_devices"><dfn>Sharing Payload of RDF Data Among Low-End Devices</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   583
	<p>
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
   584
		Several projects around the idea of <em>downscaling the Semantic Web</em> need to be able to ship payloads of RDF across
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   585
		the nodes member of a given network. The transfers are done in a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   586
		constrained context in terms of bandwidth, scope of the local
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   587
		semantics employed by the nodes and computing capabilities of the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   588
		nodes. In a P2P style, every node has the capability to act either
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   589
		as a data consumer or a data provider, serving its own data or
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   590
		acting as a relay to pass other's data along (typically in mesh
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   591
		networks).
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   592
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   593
	<p>The transfer of an arbitrary payload of RDF data could be
298
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   594
		implemented through a container mechanism, adding and removing
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   595
		sets of RDF triples to it. Currently, the 
346
dd43bf682a67 Added SemanticXO ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 345
diff changeset
   596
		SemanticXO [[XO]] project uses named graphs and the graph store protocol to
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   597
		create/delete/copy graphs across the nodes but this (almost)
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   598
		imposes the usage of a triple store. Unfortunately, triple stores
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   599
		are rather demanding pieces of software that are not always usable
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   600
		on limited hardware. Some generic REST-like interaction backed up
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   601
		with a lightweight column store would be a better approach.</p>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   602
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   603
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   604
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   605
	<h2 id="story-binary_and_metadata"><dfn>Sharing Binary Resources and Metadata</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   606
	<p>When publishing datasets about stars one may want to publish
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   607
		links to the pictures in which those stars appear, and this may
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   608
		well require publishing the pictures themselves. Vice versa: when
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   609
		publishing a picture of space we need to know which telescope took
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   610
		the picture, which part of the sky it was pointing at, what
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   611
		filters were used, which identified stars are visible, who can
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   612
		read it, who can write to it.</p>
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   613
	<p>If Linked Data contains information about resources that are
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   614
		most naturally expressed in non-RDF formats (be they binary such
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   615
		as pictures or videos, or human readable documents in XML
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   616
		formats), those non-RDF formats should be just as easy to publish
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   617
		to the LinkedData server as the RDF relations that link those
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   618
		resources up. A LinkedData server should therefore allow
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   619
		publishing of non-linked data resources too, and make it easy to
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   620
		publish and edit metadata about those resources.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   621
	<p>The resource comes in two parts - the image and information
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   622
		about the image (which may be in the image file but is better kept external
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   623
		to it as it's more general). The information about the image is
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   624
		vital. It's a compound item of image data and other data (application 
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   625
		metadata about the image) that are not distinguished from the
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   626
		platform's point-of-view.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   627
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   628
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   629
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   630
	<h2 id="story-data_catalogs"><dfn>Data Catalogs</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   631
	<p>
347
986567017ca7 Added ADMS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 346
diff changeset
   632
		The <em>Asset Description Metadata Schema</em> [[ADMS]]
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   633
		provides the data model to describe semantic asset repository
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   634
		contents, but this leaves many open challenges when building a
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   635
		federation of these repositories to serve the need of asset
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   636
		reuse. These include accessing and querying individual
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   637
		repositories and efficiently retrieving <a
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   638
			href="#uc5" title="">
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   639
			updated content</a> without having to retrieve the whole content.
241
6cbfa4e97a0d Revisions to user-stories UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 240
diff changeset
   640
		The Data Warehousing integration approach allows us to cope
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   641
		with heterogeneity of sources technologies and to benefit from the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   642
		optimized performance it offers, given that individual
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   643
		repositories do not usually change frequently. With Data
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   644
		Warehousing, the federation requires one to:
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   645
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   646
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   647
		<li>understand the data, i.e. understand their semantic
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   648
			descriptions, and other systems.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   649
		<li>seamlessly exchange the semantic assets metadata from
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   650
			different repositories</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   651
		<li>keep itself up-to-date.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   652
	</ul>
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   653
	<p>Repository owners can maintain de-referenceable URIs for
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   654
		their repository descriptions and contained assets in a Linked Data
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   655
		compatible manner. ADMS provides the necessary data model to
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   656
		enable meaningful exchange of data. However, this leaves the
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   657
		challenge of efficient access to the data not fully addressed.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   658
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   659
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   660
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   661
	<h2 id="story-constrained_devices"><dfn>Constrained Devices and Networks</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   662
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   663
		Information coming from resource constrained devices in the Web of
349
08593c28d774 Corrected WOT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 348
diff changeset
   664
		Things [[WOT]]
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   665
		has been identified as a major driver in many domains, from smart
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   666
		cities to environmental monitoring to real-time tracking. The
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   667
		amount of information produced by these devices is growing
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   668
		exponentially and needs to be accessed and integrated in a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   669
		systematic, standardized and cost efficient way. By using the same
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   670
		standards as on the Web, integration with applications will be
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   671
		simplified and higher-level interactions among resource
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   672
		constrained devices, abstracting away heterogeneities, will become
350
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   673
		possible. Up-coming IoT/WoT standards such as '6LowPAN' [[6LOWPAN]]
155
e960d5f2cd9e Cosmetic changes to UC&R user-stories
steve.battle <steve.battle@sysemia.co.uk>
parents: 153
diff changeset
   674
		- IPv6 for resource constrained devices - and the <em>Constrained
350
b87294080bd4 Added COAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 349
diff changeset
   675
		Application Protocol</em> [[COAP]], which provides a downscaled version of
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   676
		HTTP on top of UDP for the use on constrained devices, are already
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   677
		at a mature stage. The next step now is to support RESTful
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   678
		interfaces also on resource constrained devices, adhering to the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   679
		Linked Data principles. Due to the limited resources available,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   680
		both on the device and in the network (such as bandwidth, energy,
351
c3bd4a0d2599 Added COAP-MAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 350
diff changeset
   681
		and memory) a solution based on <em>SPARQL Update</em> [[RDF-SPARQL-UPDATE]] is at the current point
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   682
		in time considered not to be useful and/or feasible. An approach
351
c3bd4a0d2599 Added COAP-MAP ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 350
diff changeset
   683
		based on the HTTP-CoAP Mapping [[COAP-MAP]] would enable constrained
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   684
		devices to directly participate in a Linked Data-based
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   685
		environment.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   686
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   687
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   688
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   689
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   690
	<h2 id="story-process_of_science"><dfn>Services Supporting the Process of Science</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   691
	<p>Many fields of science now include branches with in silico
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   692
		data-intensive methods, e.g. bioinformatics, astronomy. To support
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   693
		these new methods we look to move beyond the established platforms
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   694
		provided by scientific workflow systems to capture, assist, and
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   695
		preserve the complete lifecycle from record of the experiment,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   696
		through local trusted sharing, analysis, dissemination (including
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   697
		publishing of experimental data "beyond the PDF"), and re-use.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   698
	<ul>
405
6cce06dff7a3 Fixed broken fragments from http://validator.w3.org/checklink
steve.battle <steve.battle@sysemia.co.uk>
parents: 400
diff changeset
   699
		<li><a href="#uc6" title="">Aggregations</a>,
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
   700
			specifically <em>Research Objects (ROs)</em> are exchanged
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   701
			between services and clients bringing together workflows, data
265
b67e11794076 Edits to user-stories (UC&R)
steve.battle <steve.battle@sysemia.co.uk>
parents: 241
diff changeset
   702
			sets, annotations, and provenance.
b67e11794076 Edits to user-stories (UC&R)
steve.battle <steve.battle@sysemia.co.uk>
parents: 241
diff changeset
   703
		</li>
b67e11794076 Edits to user-stories (UC&R)
steve.battle <steve.battle@sysemia.co.uk>
parents: 241
diff changeset
   704
		<li>We need lightweight services that can be simply and easily
b67e11794076 Edits to user-stories (UC&R)
steve.battle <steve.battle@sysemia.co.uk>
parents: 241
diff changeset
   705
			integrated into, and scale across the wide variety of softwares
b67e11794076 Edits to user-stories (UC&R)
steve.battle <steve.battle@sysemia.co.uk>
parents: 241
diff changeset
   706
			and data used in science.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   707
			<ul>
265
b67e11794076 Edits to user-stories (UC&R)
steve.battle <steve.battle@sysemia.co.uk>
parents: 241
diff changeset
   708
				<li>Foundation services collect and expose ROs for
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   709
					storage, modification, exploration, and reuse.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   710
				<li>Services that provide added-value to ROs such as
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   711
					seamless import/export from scientific workflow systems,
265
b67e11794076 Edits to user-stories (UC&R)
steve.battle <steve.battle@sysemia.co.uk>
parents: 241
diff changeset
   712
					automated stability evaluation, or recommendation.</li>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   713
			</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   714
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   715
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   716
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   717
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   718
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   719
	<h2 id="story-project_data"><dfn>Project Membership Information</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   720
	<p>Information about people and projects changes as roles
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   721
		change, as organisations change and as contact details change.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   722
		Finding the current state of a project is important in enabling
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   723
		people to contact the right person in the right role. It can also
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   724
		be useful to look back and see who was performing what role in the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   725
		past.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   726
	<p>A use of a Linked Data Platform could be to give
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   727
		responsibility for managing such information to the project team
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   728
		itself, instead of requiring updates to be requested from a centralised
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   729
		website administrator.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   730
	<p>This could be achieved with:</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   731
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   732
		<li>Resource descriptions for each person and project</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   733
		<li>A container resource to describe roles/membership in the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   734
			project.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   735
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   736
	<p>To retain the history of the project, the old version of a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   737
		resources, including container resources, should be retained so
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   738
		there is a need to address both specific items and also have a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   739
		notion of "current".</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   740
	<p>Access to information has two aspects:</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   741
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   742
		<li>Access to the "current" state, regardless of the version
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   743
			of the resource description</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   744
		<li>Access to historical state, via access to a specific
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   745
			version of the resource description</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   746
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   747
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   748
	
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   749
	<section>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   750
	<h2 id="story-cloud"><dfn>Cloud Infrastructure Management</dfn></h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   751
	<p>Cloud operators offer API support to provide customers with
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   752
		remote access for the management of Cloud infrastructure (IaaS).
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   753
		Infrastructure consists of Systems, Computers, Networks, Discs,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   754
		etc. The overall structure can be seen as mostly hierarchical,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   755
		(Cloud contains Systems, Systems contain Machines, etc),
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   756
		complemented with crossing links (e.g. multiple Machines connected
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   757
		to a Network).</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   758
	<p>The IaaS scenario makes specific requirements on lifecycle
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   759
		management and discovery, handling non-instant changes, history
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   760
		capture and query:</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   761
	<ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   762
		<li>Many aspects of Cloud infrastructure have associated
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   763
			lifecycle, e.g. a Computer can be transitioned between Running
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   764
			and Shutdown. This should be manageable through the API, which
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   765
			should include how a client discovers dynamic lifecycle options
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   766
			and thus help steering through an application.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   767
		<li>It is often the case that attaining a new lifecycle state
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   768
			is not instantaneous. Clients require a universal mechanism for
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   769
			monitoring such changes.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   770
		<li>A facility to retrieve all events in the lifecycle of a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   771
			resource can be useful.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   772
		<li>Query provides the means to interrogate the resources
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   773
			behind the API, as well as finding new entry points into the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   774
			application.</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   775
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   776
	<p>Infrastructure management may be viewed as the manipulation
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   777
		of the underlying graph of resources.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   778
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   779
22
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   780
</section>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   781
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   782
<section>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   783
<h1 id="usecases">Use Cases</h1>
55dc01a9ed48 Initial framework for UCR doc in ReSpec
sspeiche
parents:
diff changeset
   784
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   785
	<p>The following use cases are each derived from one or more of
156
9dafe5f2b2e8 cosmetic chnages to UC&R use cases.
steve.battle <steve.battle@sysemia.co.uk>
parents: 155
diff changeset
   786
		the user stories above. These use cases are explored in detail
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   787
		through the development of scenarios, each motivated by some key
156
9dafe5f2b2e8 cosmetic chnages to UC&R use cases.
steve.battle <steve.battle@sysemia.co.uk>
parents: 155
diff changeset
   788
		aspect exemplified by a single user story. The examples they
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   789
		contain are included purely for illustrative purposes, and should
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   790
		not be interpreted normatively.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   791
		
297
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
   792
	<section id="uc1">
298
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   793
	<h2><dfn>UC1</dfn>: Compose resources</h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   794
	<p>
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
   795
		A number of user stories introduce the idea of a <em>container</em>
298
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   796
		as a mechanism for composing resources within the
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   797
		context of an application. A
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   798
		composition would be identified by URI being a linked resource in its own
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
   799
		right. Its properties may represent the <em>affordances</em>
298
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   800
		of the application, enabling clients to determine what other
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   801
		operations they can do. These operations may
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   802
		include descriptions of application specific services that can be
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   803
		invoked by exchanging RDF documents.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   804
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   805
	<ul>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
   806
		<li><a>NF1.1</a>: Provide "access guidance" (affordances) from user story, <a>Maintaining Social Contact Information</a>.</li>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   807
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   808
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   809
	<section id="s1.1">
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   810
	<h3>Primary scenario: create a container</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   811
	<p>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   812
		Create a new container resource within the LDP server. In <a>Services Supporting the Process of Science</a>, 
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   813
			<a
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   814
			href="http://www.wf4ever-project.org/" 
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   815
			title="http://www.wf4ever-project.org/" rel="nofollow">Research
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   816
			Objects</a> are semantically rich aggregations of resources that
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   817
		bring together data, methods and people in scientific
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   818
		investigations. A basic workflow research object will be created
359
9dcd5af66d04 Added RESEARCH-OBJECTS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 358
diff changeset
   819
		to aggregate scientific workflows and their artefacts [[RESEARCH-OBJECTS]]. 		
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   820
		These artefacts will be added to the research object throughout the project lifecycle of the project.
286
e92110818f93 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 285
diff changeset
   821
	</p>
288
26b12ae1c151 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 287
diff changeset
   822
	<p>
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   823
		The RDF description below captures the initial state of the research object. For the purposes of the example, we have included the time of creation. It is a linked data resource addressed via URL from which the following RDF can be retrieved. The null-relative URL <code>&lt;&gt;</code> should be understood as a self-reference to the research object itself.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   824
	</p>
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   825
	<pre class='example'><code>
287
05f4b4e8ea88 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 286
diff changeset
   826
@prefix ro:  &lt;http://purl.org/wf4ever/ro#&gt; .
05f4b4e8ea88 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 286
diff changeset
   827
@prefix dct: &lt;http://purl.org/dc/terms/&gt; .
05f4b4e8ea88 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 286
diff changeset
   828
@prefix ore: &lt;http://www.openarchives.org/ore/&gt; .
05f4b4e8ea88 UC1 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 286
diff changeset
   829
@prefix xsd: &lt;http://www.w3.org/2001/XMLSchema#&gt; .
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   830
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   831
&lt;&gt; a ro:ResearchObject, ore:Aggregation ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   832
    dct:created &quot;2012-12-01&quot;^^xsd:dateTime .
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   833
</code></pre>
305
957e318e988c Added F1.3
steve.battle <steve.battle@sysemia.co.uk>
parents: 304
diff changeset
   834
	<div>(see functional requirement <a>F1.1</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   835
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   836
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   837
	<section id="s1.2">
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   838
	<h3>Alternative scenario: create a nested container</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   839
	<p>
290
3fe9b9f4bbfb UC1 edit
steve.battle <steve.battle@sysemia.co.uk>
parents: 289
diff changeset
   840
		The motivation for nested containers comes from the <a>System and Software Development Tool Integration</a> user story. The
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   841
		OSLC Change Management vocabulary allows bug reports to have
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   842
		attachments referenced by the membership predicate
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   843
		<code>oslc_cm:attachment</code>. This may be viewed as nested containment. The <em>top-level-container</em> contains issues, and
157
3117cd615572 additional changes to UC&R use cases
steve.battle <steve.battle@sysemia.co.uk>
parents: 156
diff changeset
   844
		each issue is itself a container of attachments.
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   845
		In the example, <code>issue1234</code> is a member of the container <code>top-level-container</code>. In turn, <code>attachment324</code> and <code>attachment251</code> are attachments within <code>issue1234</code>. Treating these as containers makes it easier to manage them as self-contained units.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   846
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
   847
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   848
@prefix dcterms: &lt;http://purl.org/dc/terms/&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   849
@prefix rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   850
@prefix oslc_cm: &lt;http://open-services.net/ns/cm#&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   851
@prefix : &lt;http://example.org/&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   852
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   853
:top-level-container rdfs:member :issue1234 .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   854
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   855
:issue1234 a oslc_cm:ChangeRequest;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   856
      dcterms:identifier &quot;1234&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   857
      dcterms:type &quot;a bug&quot;;
157
3117cd615572 additional changes to UC&R use cases
steve.battle <steve.battle@sysemia.co.uk>
parents: 156
diff changeset
   858
      oslc_cm:attachments :attachments.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   859
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   860
:attachments a oslc_cm:AttachmentList;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   861
      oslc_cm:attachment :attachment324, :attachment251.
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
   862
</code></pre>
305
957e318e988c Added F1.3
steve.battle <steve.battle@sysemia.co.uk>
parents: 304
diff changeset
   863
	<div>(see functional requirement <a>F1.2</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   864
	</section>
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   865
	<section id="s1.3">
305
957e318e988c Added F1.3
steve.battle <steve.battle@sysemia.co.uk>
parents: 304
diff changeset
   866
		<h3>Alternative scenario: Delete a container</h3>
293
645fbe09c9f6 UC2 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 292
diff changeset
   867
		If a container can be deleted, it seems natural that any contained resources and nested containers should also be deleted.
367
12c176da0c19 UC1 rewording
steve.battle <steve.battle@sysemia.co.uk>
parents: 366
diff changeset
   868
		<div>(see functional requirement <a>F1.3</a>).</div>
293
645fbe09c9f6 UC2 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 292
diff changeset
   869
	</section>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   870
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   871
	
297
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
   872
	<section id="uc2">
298
9e7ec0a1a979 UC&R edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 297
diff changeset
   873
	<h2><dfn>UC2</dfn>: Manage resource lifecycle</h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   874
	<p>
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   875
		This use case addresses the managed lifecycle of a resource and is
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
   876
		concerned with resource <em>ownership</em>. The responsibility for
157
3117cd615572 additional changes to UC&R use cases
steve.battle <steve.battle@sysemia.co.uk>
parents: 156
diff changeset
   877
		managing resources belongs to their container. For example, a
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   878
		container may accept a request from a client to make a new
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
   879
		resource. This use case focuses on creation and deletion of
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   880
		resources in the context of a container, and the potential for
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   881
		transfer of ownership by moving resources between containers. The
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   882
		ownership of a resource should always be clear; no resource
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   883
		managed in this way should ever be owned by more than one
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   884
		container.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   885
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   886
	<ul>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
   887
		<li><a>NF2.1</a>: Non-duplication of resources: "Eliminate multiple
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   888
			copies", representing resources in a single place from <a>Maintaining Social Contact Information</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   889
		</li>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
   890
		<li><a>NF2.2</a>: Distribution of resources: Linked data "may be stored on
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   891
			separate servers" from <a>Maintaining Social Contact Information</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   892
		</li>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
   893
		<li><a>NF2.3</a>: Consistent, global naming: Resources should be "linked to
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   894
			consistently, ... instead of maintaining various identifiers in
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   895
			different formats" from <a>Keeping Track of Personal and Business Relationships</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   896
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   897
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   898
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   899
	<section id="s2.1">
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   900
	<h3>Primary scenario: create resource</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   901
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   902
		Resources begin life by being created within a container. From
293
645fbe09c9f6 UC2 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 292
diff changeset
   903
		user story, <a>Maintaining Social Contact Information</a>, It should be
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   904
		possible to "easily create a new contact and add it to my
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   905
		contacts." This suggests that resource creation is closely linked
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   906
		to the application context. The new resource is created in a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   907
		container representing "my contacts." The lifecycle of the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   908
		resource is linked to the lifecycle of it's container. So, for
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   909
		example, if "my contacts" is deleted then a user would also
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   910
		reasonably expect that all contacts within it would also be
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   911
		deleted.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   912
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   913
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   914
		Contact details are captured as an RDF description and it's
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   915
		properties, including "names, email addresses, telephone numbers,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   916
		instant messenger identities and so on." The description may
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   917
		include non-standard RDF; "data about my contacts that the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   918
		original design didn’t consider." The following RDF could be used
27
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   919
		to describe contact information using the FOAF
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   920
		vocabulary [[FOAF]]. A contact is represented here by a
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   921
		<code>foaf:PersonalProfileDocument</code> defining a resource that can be
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   922
		created and updated as a single-unit, even though it may describe
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   923
		ancillary resources, such as a <code>foaf:Person</code>, below.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   924
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
   925
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   926
@prefix foaf:  &lt;http://xmlns.com/foaf/0.1/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   927
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   928
&lt;&gt; a foaf:PersonalProfileDocument;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   929
	foaf:PrimaryTopic [ 
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   930
		a foaf:Person;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   931
		foaf:name &quot;Timothy Berners-Lee&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   932
		foaf:title &quot;Sir&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   933
		foaf:firstName &quot;Timothy&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   934
		foaf:surname &quot;Berners-Lee&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   935
		foaf:nick &quot;TimBL&quot;, &quot;timbl&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   936
		foaf:homepage &lt;http://www.w3.org/People/Berners-Lee/&gt;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   937
		foaf:weblog &lt;http://dig.csail.mit.edu/breadcrumbs/blog/4&gt;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   938
		foaf:mbox &lt;mailto:timbl@w3.org&gt;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   939
		foaf:workplaceHomepage &lt;http://www.w3.org/&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   940
	]
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
   941
</code></pre>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
   942
		<div>(see functional requirement <a>F2.1</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   943
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   944
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   945
	<section id="s2.2">
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   946
	<h3>Alternative scenario: delete resource</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   947
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   948
		Delete a resource and all it's properties. If the resource resides
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   949
		within a container it will be removed from that container, however
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   950
		other links to the deleted resource may be left as dangling
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   951
		references. In the case where the resource is a container, the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   952
		server may also delete any or all contained resources. In normal
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   953
		practice, a deleted resource cannot be reinstated. There are
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   954
		however, edge-cases where limited undelete may be desirable. Best
27
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   955
		practice states that "Cool URIs don't change" [[COOLURIS]], which implies that
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   956
		deleted URIs shouldn't be recycled.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   957
	</p>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
   958
		<div>(see functional requirement <a>F2.2</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   959
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   960
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   961
	<section id="s2.3">
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   962
	<h3>Alternative scenario: moving contained resources</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   963
	<p>
293
645fbe09c9f6 UC2 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 292
diff changeset
   964
		Resources may have value beyond the life of their membership
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   965
		in a container. This implies methods to add references to revise
293
645fbe09c9f6 UC2 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 292
diff changeset
   966
		container membership. 
645fbe09c9f6 UC2 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 292
diff changeset
   967
		A change of ownership may or may not imply a change of URI,
645fbe09c9f6 UC2 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 292
diff changeset
   968
		depending upon the naming policy. While assigning a
27
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   969
		new URI to a resource is discouraged [[WEBARCH]], it is possible to indicate that a
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   970
		resource has moved with an appropriate HTTP response.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   971
	</p>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
   972
		<div>(see functional requirement <a>F2.3</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   973
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   974
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   975
	
297
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
   976
	<section id="uc3">
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
   977
	<h2><dfn>UC3</dfn>: Retrieve resource description</h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   978
	<p>Access the current description of a resource, containing
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   979
		properties of that resource and links to related resources. The
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   980
		representation may include descriptions of related resources that
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   981
		cannot be accessed directly. Depending upon the application, an
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
   982
		server may enrich the retrieved RDF with additional triples. Examples
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
   983
		include adding incoming links, <code>owl:sameAs</code> closure and <code>rdf:type</code> closure.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   984
		The HTTP response should also include versioning information (i.e.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   985
		last update or entity tag) so that subsequent updates can ensure
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   986
		they are being applied to the correct version.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   987
	<ul>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
   988
		<li><a>NF3.1</a>: Use standard vocabularies as appropriate to enable a
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   989
			"common understanding of the resource" from <a>Maintaining Social Contact Information</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   990
		</li>
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   991
		<li><a>NF3.2</a>: A "scalable linking model is key" from <a>Municipality Operational Monitoring</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   992
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   993
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   994
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
   995
	<section id="s3.1">
300
4c50523f695d UC3 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 299
diff changeset
   996
	<h3>Primary scenario: retrieve resource description</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
   997
	<p>
156
9dafe5f2b2e8 cosmetic chnages to UC&R use cases.
steve.battle <steve.battle@sysemia.co.uk>
parents: 155
diff changeset
   998
		The user story <a
27
bf23e5525c6f Fixed up local links and inserted first pass at biblio refs
sspeiche
parents: 26
diff changeset
   999
			href="#story-project_data"
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1000
			title=""> Project Membership Information</a> discusses the
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1001
		representation of information about people and projects. It calls
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1002
		for "Resource descriptions for each person and project" allowing
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1003
		project teams to review information held about these resources.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1004
		The example below illustrates the kinds of information that might
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1005
		be held about organizational structures based on the <a
407
350549c3c9d2 removed trailing stroke from /xhtml/vocab/
steve.battle <steve.battle@sysemia.co.uk>
parents: 406
diff changeset
  1006
			href="http://www.epimorphics.com/web/"
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1007
			title="http://www.epimorphics.com" rel="nofollow">Epimorphics</a>
358
81d7ed340066 Added ORG-ONT ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 357
diff changeset
  1008
		organizational ontology [[ORG-ONT]].
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1009
	</p>
304
9a13469622d5 UC9 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 303
diff changeset
  1010
	<p>Examples 4 and 5 below define two resources that would be hosted on an LDP server based at
376
5c357dcfe499 Further changes for W3C Markup Validation Service
steve.battle <steve.battle@sysemia.co.uk>
parents: 375
diff changeset
  1011
		&lt;http://example.com/&gt;. The representation in Example 4 describes &lt;http://example.com/member1&gt;, while that of Example 5 describes &lt;http://example.com/role&gt;.
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1012
		A client reading Example 4 would have to separately retrieve Example 5 in order to get role information such as its descriptive label.
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1013
	</p>
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1014
	<p>
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1015
		Note that the representations of these resources may
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1016
		include descriptions of related resources, such as
375
414ee07c3714 Corrections to UC&R for HTML5 W3C Markup Validation Service
steve.battle <steve.battle@sysemia.co.uk>
parents: 369
diff changeset
  1017
		&lt;http://www.w3.org/&gt;, that that fall under a completely different authority and
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1018
		therefore can't be served directly from the LDP server at this location.</p>
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1019
	<div>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1020
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1021
@prefix org: &lt;http://www.w3.org/ns/org#&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1022
@prefix owltime: &lt;http://www.w3.org/2006/time&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1023
@prefix xsd: &lt;http://www.w3.org/2001/XMLSchema#&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1024
@base &lt;http://example.com/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1025
     
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1026
&lt;member1&gt; a org:Membership ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1027
	org:member &lt;http://www.w3.org/People/Berners-Lee/card#i&gt; ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1028
	org:organization http://www.w3.org/&gt; ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1029
	org:role &lt;director&gt; ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1030
	org:memberDuring [a owltime:Interval; owltime:hasBeginning [
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1031
		owltime:inXSDDateTime &quot;1994-10-01T00:00:00Z&quot;^^xsd:dateTime]] .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1032
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1033
&lt;http://www.w3.org/&gt; a org:FormalOrganization ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1034
	skos:prefLabel &quot;The World Wide Web Consortium&quot;@en ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1035
	skos:altLabel &quot;W3C&quot; .
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1036
</code></pre>
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1037
</div>
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1038
<div>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1039
<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1040
@prefix org: &lt;http://www.w3.org/ns/org#&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1041
@prefix rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1042
@base &lt;http://example.com/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1043
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1044
&lt;director&gt; a org:Role ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1045
	rdfs:label &quot;Director&quot; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1046
 
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1047
</code></pre>
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1048
</div>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
  1049
		<div>(see functional requirement <a>F3.1</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1050
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1051
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1052
	<section id="s3.2">
300
4c50523f695d UC3 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 299
diff changeset
  1053
	<h3>Alternative scenario: retrieve description of a non-document resource (hash URI)</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1054
	<p>In many cases, the things that are of interest are not
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1055
		always the things that are resolvable. The example below
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
  1056
		demonstrates how a FOAF profile may be used to distinguish between
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1057
		the person and the profile; the former being the topic of the
300
4c50523f695d UC3 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 299
diff changeset
  1058
		latter. Where the fragment is defined relative to the base, as in this example, the URL including the fragment may be used to access the resource representing the containing document. The HTTP protocol
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1059
		requires that the fragment part be stripped off before requesting
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
  1060
		the URI from the server. The client can then read properties of the hash URI <code>&lt;#i&gt;</code> from the retrieved description.
300
4c50523f695d UC3 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 299
diff changeset
  1061
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1062
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1063
@base &lt;http://www.w3.org/People/Berners-Lee/card&gt;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1064
@prefix foaf: &lt;http://xmlns.com/foaf/0.1/&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1065
@prefix dc: &lt;http://purl.org/dc/elements/1.1/&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1066
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1067
&lt;&gt; a foaf:PersonalProfileDocument ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1068
	dc:title &quot;Tim Berners-Lee's FOAF file&quot; ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1069
	foaf:homepage &lt;http://www.w3.org/People/Berners-Lee/&gt; ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1070
	foaf:primaryTopic &lt;#i&gt; .
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1071
</code></pre>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
  1072
		<div>(see functional requirement <a>F3.2</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1073
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1074
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1075
	
297
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1076
	<section id="uc4">
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1077
	<h2><dfn>UC4</dfn>: Update existing resource</h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1078
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1079
		Change the RDF description of a LDP resource, potentially removing
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
  1080
		or overwriting existing data. This allows applications to <em>enrich</em>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1081
		the representation of a resource by addling additional links to
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1082
		other resources.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1083
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1084
	<ul>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
  1085
		<li><a>NF4.1</a>: Unrestricted vocabulary: It should be possible be "able
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1086
			to add ... application-specific data" to resources from <a>Maintaining Social Contact Information</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1087
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1088
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1089
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1090
	<section id="s4.1">
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1091
	<h3>Primary scenario: enrichment</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1092
	<p>
357
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
  1093
		This relates to user story <a>Metadata Enrichment in Broadcasting</a> and is based on the BBC
2bd2fff4cd31 Added BBC ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 356
diff changeset
  1094
		Sports Ontology [[BBC-SPORT]]. The <em>resource-centric</em> view of linked-data
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1095
		provides a natural granularity for substituting, or overwriting a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1096
		resource and its data. The simplest kind of update would simply
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1097
		replace what is currently known about a resource with a new
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1098
		representation. 
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1099
	</p>
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1100
	<p>
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1101
		There are two distinct resources in the example
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1102
		below; a sporting event and an associated award. The granularity
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
  1103
		of the resource would allow a user to replace the information about the
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1104
		award without disturbing the information about the event.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1105
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1106
	<pre class='example'><code>
361
f3a814fbf218 Added empty namespace declaration to UC4 examples
steve.battle <steve.battle@sysemia.co.uk>
parents: 359
diff changeset
  1107
@prefix : &lt;http://example.com/&gt;.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1108
@prefix sport: &lt;http://www.bbc.co.uk/ontologies/sport/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1109
@prefix rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1110
 
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1111
 :mens_sprint a sport:MultiStageCompetition;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1112
    rdfs:label &quot;Men's Sprint&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1113
    sport:award &lt;#gold_medal&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1114
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1115
&lt;#gold_medal&gt; a sport:Award .
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1116
</code></pre>
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1117
	<p>The description can be enriched as events unfold, adding a link to
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1118
		the winner of the gold medal by substituting the above description
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1119
		with the following.</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1120
	<pre class='example'><code>
361
f3a814fbf218 Added empty namespace declaration to UC4 examples
steve.battle <steve.battle@sysemia.co.uk>
parents: 359
diff changeset
  1121
@prefix : &lt;http://example.com/&gt;.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1122
@prefix sport: &lt;http://www.bbc.co.uk/ontologies/sport/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1123
@prefix rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1124
@prefix foaf: &lt;http://xmlns.com/foaf/0.1/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1125
 
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1126
 :mens_sprint a sport:MultiStageCompetition;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1127
    rdfs:label &quot;Men's Sprint&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1128
    sport:award &lt;#gold_medal&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1129
&lt;#gold_medal&gt; a sport:Award; 
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1130
    sport:awarded_to [
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1131
        a foaf:Agent ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1132
        foaf:name &quot;Chris Hoy&quot; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1133
    ] .
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1134
</code></pre>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
  1135
		<div>(see functional requirement <a>F4.1</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1136
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1137
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1138
	<section id="s4.2">
300
4c50523f695d UC3 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 299
diff changeset
  1139
	<h3>Alternative scenario: selective update of a resource</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1140
	<p>
352
8bb8d646e1ba Added CHANGESET ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 351
diff changeset
  1141
		This relates to user story <a>Data Catalogs</a>. A catalogue is
8bb8d646e1ba Added CHANGESET ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 351
diff changeset
  1142
		described by the following RDF model, based on the Data Catalog Vocabulary [[vocab-dcat]] which provides a standard format for representing the metadata held by organizations.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1143
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1144
	<pre class='example'><code>
361
f3a814fbf218 Added empty namespace declaration to UC4 examples
steve.battle <steve.battle@sysemia.co.uk>
parents: 359
diff changeset
  1145
@prefix : &lt;http://example.com/&gt;.
352
8bb8d646e1ba Added CHANGESET ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 351
diff changeset
  1146
@prefix dcat: &lt;http://www.w3.org/ns/dcat#&gt; .
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1147
@prefix dcterms: &lt;http://purl.org/dc/terms/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1148
   
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1149
 :catalog a dcat:Catalog ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1150
    dcat:dataset :dataset/001;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1151
    dcterms:issued &quot;2012-12-11&quot;^^xsd:date.
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1152
</code></pre>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1153
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1154
		A catalog may contain multiple datasets, so when linking to new
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1155
		datasets it would be simpler and preferable to selectively add
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
  1156
		just the new dataset links. For this example, a Changeset [[CHANGESET]] might be used to add a new <code>dc:title</code> to the
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1157
		dataset. The following update would be directed to the catalogue
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1158
		to add an additional dataset.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1159
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1160
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1161
@prefix : &lt;http://example.com/&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1162
@prefix dcterms: &lt;http://purl.org/dc/terms/&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1163
@prefix cs: &lt;http://purl.org/vocab/changeset/schema#&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1164
@prefix rdf: &lt;http://www.w3.org/1999/02/22-rdf-syntax-ns#&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1165
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1166
&lt;change1&gt;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1167
  a cs:ChangeSet ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1168
  cs:subjectOfChange :catalog ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1169
  cs:createdDate &quot;2012-01-01T00:00:00Z&quot; ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1170
  cs:changeReason &quot;Update catalog datasets&quot; ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1171
  cs:addition [
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1172
    a rdf:Statement ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1173
    rdf:subject :catalog ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1174
    rdf:predicate dcat:dataset ;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1175
    rdf:object :dataset/002 .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1176
  ] .
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1177
</code></pre>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
  1178
		<div>(see functional requirement <a>F4.2</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1179
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1180
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1181
	
297
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1182
	<section id="uc5">
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1183
	<h2><dfn>UC5</dfn>: Determine if a resource has changed</h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1184
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1185
		It should be possible to retrieve versioning information about a
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1186
		resource (e.g. last modified or entity tag) without having to
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1187
		download a representation of the resource. This information can
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1188
		then be compared with previous information held about that
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1189
		resource to determine if it has changed. This versioning
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
  1190
		information can also be used in subsequent <em>conditional</em>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1191
		requests to ensure they are only applied if the version is
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1192
		unchanged.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1193
	</p>
363
c4826d26ac0a renumbered NF4.2 as NF5.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 362
diff changeset
  1194
	<ul>
c4826d26ac0a renumbered NF4.2 as NF5.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 362
diff changeset
  1195
		<li><a>NF5.1</a>: Multiple changes to a resource: The <a>Project Membership Information</a> user story is concerned with "access to the 'current' state", as distinct from earlier versions. 
364
4c6fee229579 reworded NF5.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 363
diff changeset
  1196
		This is particularly relevant to changes which are made with respect to a specific version of the resource description.
4c6fee229579 reworded NF5.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 363
diff changeset
  1197
		The LDP must ensure consistent access in the case of multiple simultaneous attempts to access a resource.
363
c4826d26ac0a renumbered NF4.2 as NF5.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 362
diff changeset
  1198
		</li>
c4826d26ac0a renumbered NF4.2 as NF5.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 362
diff changeset
  1199
	</ul>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1200
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1201
	<section id="s5.1">
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1202
	<h3>Primary scenario: determine if a resource has changed</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1203
	<p>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
  1204
		Based on the user story, <a>Constrained Devices and Networks</a>, an LDP server could be configured to
353
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
  1205
		act as a proxy for a CoAP [[COAP]] based Web of Things [[WOT]]. As an observer of CoAP resources, the LDP server registers
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1206
		its interest so that it will be notified whenever the sensor
34
e82a925b73b7 2013-01-03 - Fixed Typos. Rewording for clarity. (JA)
John Arwe <johnarwe@us.ibm.com>
parents: 32
diff changeset
  1207
		reading changes. Clients of the LDP can interrogate the server to
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1208
		determine if the state has changed.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1209
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1210
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1211
		In this example, the information about a sensor and corresponding
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1212
		sensor readings can be represented as RDF resources. The first
353
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
  1213
		resource below, represents a sensor described using the Semantic
c87613880c1c Added SSN ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 352
diff changeset
  1214
		Sensor Network [[SSN]] ontology.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1215
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1216
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1217
@prefix : &lt;http://example.com/energy-management/&gt;.
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1218
@prefix rdfs: &lt;http://www.w3.org/2000/01/rdf-schema#&gt; .
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1219
@prefix ssn: &lt;http://purl.oclc.org/NET/ssnx/ssn#&gt; .
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1220
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1221
&lt;&gt; a :MainsFrequencySensor;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1222
  rdfs:comment &quot;Sense grid load based on mains frequency&quot;;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1223
  ssn:hasMeasurementCapability [
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1224
	a :FrequencyMeasurementCapability;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1225
	ssn:hasMeasurementProperty &lt;#property_1&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1226
  ] .
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1227
</code></pre>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1228
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1229
		The value of the sensor changes in real-time as measurements are
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1230
		taken. The LDP client can interrogate the resource below to
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
  1231
		determine if it has changed, <em>without</em> necessarily having to
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1232
		download the RDF representation. As different sensor properties
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1233
		are represented disjointly (separate RDF representations) they may
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1234
		change independently.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1235
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1236
	<pre class='example'><code>
301
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1237
@prefix : &lt;http://example.com/energy-management/&gt; .
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1238
@prefix ssn: &lt;http://purl.oclc.org/NET/ssnx/ssn#&gt; .
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1239
@prefix xsd: &lt;http://www.w3.org/2001/XMLSchema#&gt; .
85a57c1b6f39 UC5 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 300
diff changeset
  1240
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1241
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1242
&lt;http://example.com/energy-management#property_1&gt; :hasMeasurementPropertyValue &lt;&gt; .
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1243
&lt;&gt; a :FrequencyValue;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1244
	:hasQuantityValue &quot;50&quot;^^xsd:float.
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1245
</code></pre>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
  1246
		<div>(see functional requirement <a>F5.1</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1247
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1248
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1249
	
297
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1250
	<section id="uc6">
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1251
	<h2><dfn>UC6</dfn>: Aggregate resources</h2>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1252
	<p>
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
  1253
		There is a requirement to be able to manage <em>collections</em> of
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1254
		resources. The concept of a collection overlaps with, but is
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1255
		distinct from that of a container. These collections are (weak)
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1256
		aggregations, unrelated to the lifecycle management of resources,
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1257
		and distinct from the ownership between a resource and its
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1258
		container. However, the composition of a container may be
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1259
		reflected as a collection to support navigation of the container
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1260
		and its contents. There is a need to be able to create collections
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1261
		by adding and deleting individual membership properties. Resources
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1262
		may belong to multiple collections, or to none.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1263
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1264
	<ul>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
  1265
		<li><a>NF6.1</a>: Resource descriptions are a "mix of simple data and
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1266
			collections" from <a>Keeping Track of Personal and Business Relationships</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1267
		</li>
295
cfd1608b408d UC&R requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 294
diff changeset
  1268
		<li><a>NF6.2</a>: Relative URIs: It should be possible to "ship payloads of
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1269
			RDF" for a collection as a whole without breaking internal links
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1270
			from <a>Constrained Devices and Networks</a>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1271
		</li>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1272
	</ul>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1273
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1274
	<section id="s6.1">
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1275
	<h3>Primary scenario: add a resource to a collection</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1276
	<p>
355
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
  1277
		This example is from <a>Library Linked Data</a> and LLD-UC [[LLD-UC]], specifically <em>Subject Search</em>.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1278
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1279
	<p>There is an existing collection at
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1280
		&lt;http://example.com/concept-scheme/subject-heading&gt; that
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1281
		defines a collection of subject headings. This collection is
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
  1282
		defined as a <code>skos:ConceptScheme</code> and the client wishes to insert a
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1283
		new concept into the scheme. which will be related to the
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
  1284
		collection via a <code>skos:inScheme</code> link. In the example below, a new subject-heading,
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
  1285
		"outer space exploration" is added to the <code>scheme:subject-heading</code> collection. The following RDF describes the (item-level)
366
f3e3d04c6349 UC6 rewording
steve.battle <steve.battle@sysemia.co.uk>
parents: 365
diff changeset
  1286
		description of the collection,
f3e3d04c6349 UC6 rewording
steve.battle <steve.battle@sysemia.co.uk>
parents: 365
diff changeset
  1287
		also demonstrating that the relationship between the parent and child resources may run in a seemingly counter-intuitive direction, from child to parent.
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1288
		</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1289
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1290
@prefix scheme : &lt;http://example.com/concept-scheme/&gt;.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1291
@prefix concept : &lt;http://example.com/concept/&gt;.
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1292
@prefix skos: &lt;http://www.w3.org/2004/02/skos/core#&gt; .
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1293
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1294
scheme:subject-heading a skos:ConceptScheme.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1295
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1296
concept:Outer+space+Exploration skos:inScheme scheme:subject-heading.
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1297
</code></pre>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
  1298
		<div>(see functional requirement <a>F6.1</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1299
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1300
	
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1301
	<section id="s6.2">
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1302
	<h3>Alternative scenario: add a resource to multiple collections</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1303
	<p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1304
		Logically, a resource should not be owned by more than one
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1305
		container. However, it may be a member of multiple collections
345
2a546f825272 <em>downscaling the Semantic Web</e>
steve.battle <steve.battle@sysemia.co.uk>
parents: 344
diff changeset
  1306
		which define a weaker form of <em>aggregation</em>. As this is
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1307
		simply a manipulation of the RDF description of a collection, it
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1308
		should be possible to add the same resource to multiple
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1309
		collections.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1310
	</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1311
	<p>
355
b33edf9794e8 Added DC-COLLECTIONS ref
steve.battle <steve.battle@sysemia.co.uk>
parents: 354
diff changeset
  1312
		As a machine-readable collection of medical terms, the SNOMED CT ontology [[SNOMED]]
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1313
		is of key importance in user story, <a>Healthcare</a>. SNOMED CT allows concepts with more than one parent. In the example below, SNOMED concepts are treated as
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1314
		collections (aggregations) of narrower concepts. We see that the 
382
c7270e98c5c3 Using <code> tags instead of <tt>
steve.battle <steve.battle@sysemia.co.uk>
parents: 381
diff changeset
  1315
		concept <code>:TissueSpecimenFromHeart</code> belongs to two parent collections as it is both a  <code>:TissueSpecimen</code> and a <code>:SpecimenFromHeart</code>.
303
35bd937377f3 UC7 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 302
diff changeset
  1316
		This example also demonstrates how composition and aggregation support different scenarios, as the ability to have multiple parents should not be a possibility with composition.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1317
	</p>
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1318
	<pre class='example'><code>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1319
@prefix : &lt;http://example.com/snomed/&gt;.
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1320
@prefix skos: &lt;http://www.w3.org/2004/02/skos/core#&gt; .
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1321
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1322
:TissueSpecimen a skos:Concept ;
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1323
	:conceptID "119376003";
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1324
	skos:prefLabel &quot;Tissue specimen&quot;
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1325
	skos:narrowerTransitive :TissueSpecimenFromHeart.
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1326
   
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1327
:SpecimenFromHeart a skos:Concept ;
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1328
	:conceptID "127462005";
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1329
	skos:prefLabel &quot;Specimen from heart&quot;
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1330
	skos:narrowerTransitive :TissueSpecimenFromHeart.
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1331
302
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1332
:TissueSpecimenFromHeart a skos:Concept;
c8ec6c748bcd UC6 edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 301
diff changeset
  1333
	:conceptID "128166000";
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1334
	rdfs:label &quot;Tissue specimen from heart&quot;.
383
0f8e96885093 using <pre><code>..</code></pre> for multiline code in UC&R
steve.battle <steve.battle@sysemia.co.uk>
parents: 382
diff changeset
  1335
</code></pre>
306
59e0d4b7bb4c UC&R improved traceability
steve.battle <steve.battle@sysemia.co.uk>
parents: 305
diff changeset
  1336
		<div>(see functional requirement <a>F6.2</a>)</div>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1337
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1338
	</section>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1339
	
297
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1340
	<section id="uc7">
a1e7018d481f requirements edits
steve.battle <steve.battle@sysemia.co.uk>
parents: 296
diff changeset
  1341
	<h2><dfn>UC7</dfn>: Filter resource description</h2>
153
86956781820b Edits to UC&R 'Organization of this Document'
steve.battle <steve.battle@sysemia.co.uk>
parents: 148
diff changeset
  1342
	<p>This use case extends the normal behaviour of retrieving an
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1343
		RDF description of a resource, by dynamically excluding specific
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1344
		(membership) properties. For containers, it is often desirable to
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1345
		be able to read a collection, or item-level description that
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1346
		excludes the container membership.</p>
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1347
		
299
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1348
	<section id="s7.1">
2c73704fce2d Added F8.1
steve.battle <steve.battle@sysemia.co.uk>
parents: 298
diff changeset
  1349
	<h3>Primary scenario: retrieve collection-level description</h3>
24
2181c58ad40f Pulled in content from wiki version
sspeiche
parents: 23
diff changeset
  1350
	<p>