/[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 5194 by msdemlei, Thu Oct 25 14:07:01 2018 UTC revision 5195 by msdemlei, Thu Oct 25 14:31:14 2018 UTC
# Line 1097  Line 1097 
1097  <xs:complexType name="TableSet" >  <xs:complexType name="TableSet" >
1098    <xs:sequence >    <xs:sequence >
1099      <xs:element name="schema" type="vs:TableSchema" minOccurs="1"      <xs:element name="schema" type="vs:TableSchema" minOccurs="1"
1100                maxOccurs="unbounded" />                maxOccurs="unbounded" >
1101          <xs:unique name="DataCollection-tableName" >
1102            <xs:selector xpath="table" />
1103            <xs:field xpath="name" />
1104          </xs:unique>
1105        </xs:element>
1106    </xs:sequence>    </xs:sequence>
1107    <xs:anyAttribute namespace="##other" />    <xs:anyAttribute namespace="##other" />
1108  </xs:complexType>  </xs:complexType>
# Line 1600  Line 1605 
1605    
1606  \item Apply a globally-defined attribute from a schema other than  \item Apply a globally-defined attribute from a schema other than
1607         VODataService (i.e. from a namespace other than         VODataService (i.e. from a namespace other than
1608         \url{http://www.ivoa.net/xml/VODataService/v1.1} to any of the         \url{http://www.ivoa.net/xml/VODataService/v1.1}) to any of the
1609         \xmlel{tableset}, \xmlel{schema},         \xmlel{tableset}, \xmlel{schema},
1610         \xmlel{table}, and/or \xmlel{column}         \xmlel{table}, and/or \xmlel{column}
1611         elements.         elements.
# Line 1627  Line 1632 
1632  The \xmlel{vs:ParamHTTP} type is a specialized service interface  The \xmlel{vs:ParamHTTP} type is a specialized service interface
1633  description that extends the VOResource \xmlel{vr:Interface} type  description that extends the VOResource \xmlel{vr:Interface} type
1634  (as recommended by VOResource 1.1, section 2.2).  It  (as recommended by VOResource 1.1, section 2.2).  It
1635  describes a service interface that is invoke over HTTP via a GET or a  describes a service interface that is invoked over HTTP via a GET or a
1636  POST in which the inputs are parameters  POST in which the inputs are parameters
1637  encoded as \emph{name=value} pairs, delimited by ampersands  encoded in multipart/form-data or application/x-www-form-urlencoded
1638  (\verb|&|) and URL-encoded as per RFC 3986 \citep{std:RFC3986}.  When  containers.
 the service is invoked as a GET service, this input list is appended  
 to a base URL (where the result must form a legal URL.  Usually, the  
 URL contains a question mark (\verb|?|) setting off a list of  
 URL arguments to the URL.  
 \todo{Insert material currently developed in UWSRegExt, and try to clear  
 up relationship between these and ParamHTTP.}  
   
   
 When the service is invoked as a POST, the encoded list of parameters  
 are uploaded to the service as the HTTP Message Body.    
   
   
 The \xmlel{vs:ParamHTTP} type is intended for (but not limited  
 to) use in describing an interface within a VOResource description of  
 a service capability (as described in VOResource  
 section 2.2.7); that is, it can be invoked via the  
 \xmlel{xsi:type} attribute on an \xmlel{interface}  
 element.  
   
1639    
1640  % GENERATED: !schemadoc VODataService-v1.2.xsd ParamHTTP  % GENERATED: !schemadoc VODataService-v1.2.xsd ParamHTTP
1641  \begin{generated}  \begin{generated}
# Line 1971  Line 1957 
1957    <xs:simpleContent >    <xs:simpleContent >
1958      <xs:extension base="xs:token" >      <xs:extension base="xs:token" >
1959        <xs:attribute name="arraysize" type="vs:ArrayShape" />        <xs:attribute name="arraysize" type="vs:ArrayShape" />
1960        <xs:attribute name="delim" type="xs:string" default=" " />        <xs:attribute name="delim" type="xs:string" />
1961        <xs:attribute name="extendedType" type="xs:string" />        <xs:attribute name="extendedType" type="xs:string" />
1962        <xs:attribute name="extendedSchema" type="xs:anyURI" />        <xs:attribute name="extendedSchema" type="xs:anyURI" />
1963        <xs:anyAttribute namespace="##other" />        <xs:anyAttribute namespace="##other" />
# Line 2007  Line 1993 
1993                       value when arraysize is not “1”.                       value when arraysize is not “1”.
1994                                        
1995  \item[Occurrence] optional  \item[Occurrence] optional
   
1996  \item[Comment]  \item[Comment]
1997                       Unless specifically disallowed by the context,                       Unless specifically disallowed by the context,
1998                       applications should allow optional spaces to                       applications should allow optional spaces to
# Line 2015  Line 2000 
2000                       the delimiter (e.g., “1, 5” when delim=“,”).                       the delimiter (e.g., “1, 5” when delim=“,”).
2001                                        
2002  \item[Comment]  \item[Comment]
2003                       the default is “ ”; i.e. the values are delimited                       This should not be used for VOTable types; there,
2004                       by spaces.                         VOTable (typcially TABLEDATA) conventions for writing
2005                         arrays are binding.
2006                                        
2007  \end{description}  \end{description}
2008  \item[extendedType]  \item[extendedType]
# Line 2640  Line 2626 
2626  \item DataType/@arraysize no longer defaults to 1, and the  \item DataType/@arraysize no longer defaults to 1, and the
2627  interpretation of arraysize=1 as a scalar is withdrawn.  Use empty  interpretation of arraysize=1 as a scalar is withdrawn.  Use empty
2628  arraysize for scalars now.  arraysize for scalars now.
2629    \item BaseParam's delim attribute no longer defaults to blank.  That
2630    would be very unfortunate with VOTable, where other conventions are in
2631    place (e.g., for string arrays).  Now discouraging the use of delim
2632    outside of InputParams.
2633  \item Deprecated TAPType.  \item Deprecated TAPType.
2634  \item No longer requiring unique table names within a tableset;  \item No longer requiring unique table names within a tableset;
2635  uniquness is now required within a schema (actually, many services have  uniquness is now required within a schema (actually, many services have

Legend:
Removed from v.5194  
changed lines
  Added in v.5195

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