/[volute]/trunk/projects/registry/VODataService/VODataService.tex
ViewVC logotype

Diff of /trunk/projects/registry/VODataService/VODataService.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 5155 by msdemlei, Mon Oct 1 13:24:31 2018 UTC revision 5156 by msdemlei, Mon Oct 1 14:48:24 2018 UTC
# Line 452  Line 452 
452    
453  \noindent{\small  \noindent{\small
454             (A dataset is a collection of digitally-encoded data that             (A dataset is a collection of digitally-encoded data that
455             is normally accessible as a single unit, e.g. a file.)             is normally accessible as a single unit, e.g., a file.)
456           \par}           \par}
457    
458  \vspace{1ex}\noindent\textbf{\xmlel{vs:DataCollection} Type Schema Definition}  \vspace{1ex}\noindent\textbf{\xmlel{vs:DataCollection} Type Schema Definition}
# Line 531  Line 531 
531                                            
532  \item[Occurrence] optional; multiple occurrences allowed.  \item[Occurrence] optional; multiple occurrences allowed.
533  \item[Comment]  \item[Comment]
534                        MIME types should be used for network-retrievable, digital                        This should use RFC 2046 media (“MIME”) types for
535                        data.  Non-MIME type values are used for media that cannot                        network-retrievable, digital data.  
536                        be retrieved over the network--e.g. CDROM, poster, slides,                        Non-RFC 2046 values could be used for media that cannot
537                        video cassette, etc.                          be retrieved over the network.
538                                            
539    
540  \end{description}  \end{description}
# Line 587  Line 587 
587    
588    
589    
590  All of the child elements except \xmlel{tableset} derive  The attributes \xmlel{facility}, \xmlel{instrument}, \xmlel{rights},
591  from RM terms.  Four of the elements -- \xmlel{facility},  and \xmlel{accessURL} are re-used from
 \xmlel{instrument}, \xmlel{rights}\todo{no, that's no longer RM in  
 VOResource},  
 and \xmlel{accessURL}--are reuses of elements defined in  
592  the core VOResource schema, sharing the same syntax and similar  the core VOResource schema, sharing the same syntax and similar
593  semantics.  In particular, the meanings of \xmlel{facility}  semantics.  In particular, the meanings of \xmlel{facility}
594  and \xmlel{instrument} in the context of  and \xmlel{instrument} in the context of
595  \xmlel{vs:DataCollection} are different from that in  \xmlel{vs:DataCollection} are different from that in
596  \xmlel{vr:Organisation} only in that in the former type, they refer  \xmlel{vr:Organisation} only in that in the former type, they refer
597  to the origin of the data.    to the origin of the data.
598    
599    
600    
# Line 628  Line 625 
625  \begin{description}  \begin{description}
626  \item[Type] boolean (true/false): xs:boolean  \item[Type] boolean (true/false): xs:boolean
627  \item[Meaning]  \item[Meaning]
628                   if true, then the content is a MIME Type                   If true, the content of the element is an RFC
629                     2046-compliant media time.
630                                
631  \item[Occurrence] optional  \item[Occurrence] optional
632  false  false
# Line 1062  Line 1060 
1060  \item[Meaning]  \item[Meaning]
1061                    a single numeric value representing the angle, given                    a single numeric value representing the angle, given
1062                    in decimal degrees, by which a positional query                    in decimal degrees, by which a positional query
1063                    against this resource should be {"}blurred{"} in order                    against this resource should be “blurred” in order
1064                    to get an appropriate match.                    to get an appropriate match.
1065                                
1066  \item[Occurrence] optional  \item[Occurrence] optional
# Line 1131  Line 1129 
1129                                
1130  \item[Occurrence] required; multiple occurrences allowed.  \item[Occurrence] required; multiple occurrences allowed.
1131  \item[Comment]  \item[Comment]
1132                  The name given by the {"}name{"} child element must                  The name given by the “name” child element must
1133                  be unique within this TableSet instance.  If there is                  be unique within this TableSet instance.  If there is
1134                  only one schema in this set and/or there's no locally                  only one schema in this set and/or there's no locally
1135                  appropriate name to provide, the name can be set to                  appropriate name to provide, the name can be set to
1136                  {"}default{"}.                    “default”.  
1137                                
1138  \item[Comment]  \item[Comment]
1139                  This aggregation does not need to map to an                  This aggregation does not need to map to an
# Line 1210  Line 1208 
1208  \item[Comment]  \item[Comment]
1209                 If there is no appropriate logical name associated with                 If there is no appropriate logical name associated with
1210                 this set, the name should be explicitly set to                 this set, the name should be explicitly set to
1211                 {"}default{"}.                   “default”.  
1212                            
1213    
1214  \end{description}  \end{description}
# Line 1224  Line 1222 
1222  \item[Comment]  \item[Comment]
1223                    This is used for display purposes.  There is no requirement                    This is used for display purposes.  There is no requirement
1224                    regarding uniqueness.  It is useful when there are                    regarding uniqueness.  It is useful when there are
1225                    multiple schemas in the context (e.g. within a                    multiple schemas in the context (e.g., within a
1226                    tableset; otherwise, the resource title could be                    tableset; otherwise, the resource title could be
1227                    used instead).                    used instead).
1228                                
# Line 1314  Line 1312 
1312  \item[Type] string: \xmlel{xs:string}  \item[Type] string: \xmlel{xs:string}
1313  \item[Meaning]  \item[Meaning]
1314                 a name for the role this table plays.  Recognized                 a name for the role this table plays.  Recognized
1315                 values include {"}output{"}, indicating this table is output                 values include “output”, indicating this table is output
1316                 from a query; {"}base\_table{"}, indicating a table                 from a query; “base\_table{"}, indicating a table
1317                 whose records represent the main subjects of its                 whose records represent the main subjects of its
1318                 schema; and {"}view{"}, indicating that the table represents                 schema; and “view”, indicating that the table represents
1319                 a useful combination or subset of other tables.  Other                 a useful combination or subset of other tables.  Other
1320                 values are allowed.                   values are allowed.  
1321                            
# Line 1861  Line 1859 
1859    
1860  \noindent{\small  \noindent{\small
1861              As the parameter's data type is usually important, schemas              As the parameter's data type is usually important, schemas
1862              normally employ a sub-class of this type (e.g. Param),              normally employ a sub-class of this type (e.g., Param),
1863              rather than this type directly.              rather than this type directly.
1864           \par}           \par}
1865    
# Line 2017  Line 2015 
2015  \item[Type] string: \xmlel{xs:string}  \item[Type] string: \xmlel{xs:string}
2016  \item[Meaning]  \item[Meaning]
2017                       the string that is used to delimit elements of an array                       the string that is used to delimit elements of an array
2018                       value when arraysize is not {"}1{"}.                       value when arraysize is not “1”.
2019                                        
2020  \item[Occurrence] optional  \item[Occurrence] optional
2021    
# Line 2025  Line 2023 
2023                       Unless specifically disallowed by the context,                       Unless specifically disallowed by the context,
2024                       applications should allow optional spaces to                       applications should allow optional spaces to
2025                       appear in an actual data value before and after                       appear in an actual data value before and after
2026                       the delimiter (e.g. {"}1, 5{"} when delim={"},{"}).                       the delimiter (e.g., “1, 5” when delim=“,”).
2027                                        
2028  \item[Comment]  \item[Comment]
2029                       the default is {"} {"}; i.e. the values are delimited                       the default is “ ”; i.e. the values are delimited
2030                       by spaces.                         by spaces.  
2031                                        
2032  \end{description}  \end{description}
# Line 2201  Line 2199 
2199  \end{longtermsdescription}  \end{longtermsdescription}
2200  optional  optional
2201  \item[Comment]  \item[Comment]
2202                       Allowed values are {"}required{"} and {"}optional{"}.                       Allowed values are “required” and “optional”.
2203                                        
2204  \end{description}  \end{description}
2205  \item[std]  \item[std]
# Line 2350  Line 2348 
2348  \item[Type] string: \xmlel{xs:token}  \item[Type] string: \xmlel{xs:token}
2349  \item[Meaning]  \item[Meaning]
2350                          a keyword representing traits of the column.                            a keyword representing traits of the column.  
2351                          Recognized values include {"}indexed{"}, {"}primary{"}, and                          Recognized values include “indexed”, “primary”, and
2352                          {"}nullable{"}.                            “nullable”.  
2353                                            
2354  \item[Occurrence] optional; multiple occurrences allowed.  \item[Occurrence] optional; multiple occurrences allowed.
2355  \item[Comment]  \item[Comment]

Legend:
Removed from v.5155  
changed lines
  Added in v.5156

msdemlei@ari.uni-heidelberg.de
ViewVC Help
Powered by ViewVC 1.1.26