head	1.8;
access;
symbols;
locks; strict;
comment	@# @;


1.8
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	1.7;

1.7
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	1.6;

1.6
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	1.5;

1.5
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	1.4;

1.4
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	1.3;

1.3
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	1.2;

1.2
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	1.1;

1.1
date	2007.01.09.00.00.00;	author MoinMoin;	state Exp;
branches;
next	;


desc
@Initial revision
@


1.8
log
@Revision 8
@
text
@All three types of searches would still be possible according to the parameters used, and the custom search would use XML schema instead of a simplified structure representation.

A full document search would look like:

<verbatim>

<search>

  <responseStructrure ns="http://www.tdwg.org/schemas/abcd/1.0"></responseStructrure>

</search>

</verbatim>

Implying that the responseStructure schema is a conceptual schema accepted by the provider.

A partial document search would look like:

<verbatim>

<search>

   <responseStructrure ns="http://www.tdwg.org/schemas/abcd/1.0"></responseStructrure>

  <concepts>

    <concept path="/datasets/dataset/units/unit/identification"/>

  </concepts>

</search>

</verbatim>

Also implying that the responseStructure schema is a conceptual schema accepted by the provider. In this case all mandatory elements from the response schema would be returned, including the additional concepts specified.

The custom search would also use an XML schema to specify the response structure, but now this schema would not be a conceptual schema accepted by the provider:

<verbatim>

<search>

  <responseStructrure ns="http://www.mydomain.org/myschema/1.0">http://www.mydomain.org/myschema/1.0/myschema.xsd</responseStructrure>

  <mapping xmlns:abcd="http://www.tdwg.org/schemas/abcd/1.0">

    <concept>
     <from path="Taxon/@@FullName" SearchRequestProposalTwo>
     <to path="abcd:/datasets/dataset/units/unit/identification/scientificname" SearchRequestProposalTwo>
    </concept>
    <concept>
     <from path="Taxon/@@HigherTaxon" SearchRequestProposalTwo>
     <to path="abcd:/datasets/dataset/units/unit/highertaxon" SearchRequestProposalTwo>
    </concept>
    <concept>
     <from path="Taxon/Coordinates/@@lat" SearchRequestProposalTwo>
     <to path="abcd:/datasets/dataset/units/unit/latitude" SearchRequestProposalTwo>
    </concept>
    <concept>
     <from path="Taxon/Coordinates/@@long" SearchRequestProposalTwo>
     <to path="abcd:/datasets/dataset/units/unit/longitude" SearchRequestProposalTwo>
    </concept>

  </mapping>

</search>

</verbatim>


However it would give the provider the necessary mappings to produce the results.

A custom search could also accept a list of concepts (as the partial search).

Providers could cache the mappings to speed up responses (should we also include a "useCache" attribute?)

Note: The recordDefinition elements would still be necessary here!

The custom schema above could look like:

<verbatim>

<element name="Taxon" maxOccurs="unbounded">
  <complexType>
    <attribute name="FullName" type="xsd:string" use="required"/>
    <attribute name="HigherTaxon" type="xsd:string"/>
    <sequence>
      <element name="Coordinates" maxOccurs="unbounded">
        <complexType>
          <sequence>
            <element name="lat" type="xsd:string" use="required" SearchRequestProposalTwo>
            <element name="long" type="xsd:string" use="required" SearchRequestProposalTwo>
          </sequence>
        </complexType>
    </sequence>
  </complexType>
</element>

</verbatim>
@


1.7
log
@Revision 7
@
text
@d48 2
a49 2
     <from path="taxon/@@name" SearchRequestProposalTwo>
     <to path="abcd:/datasets/dataset/units/unit/identification" SearchRequestProposalTwo>
d52 5
a56 1
     <from path="taxon/coordinates/@@lat" SearchRequestProposalTwo>
d60 1
a60 1
     <from path="taxon/coordinates/@@long" SearchRequestProposalTwo>
d77 1
a77 1
Important: The recordDefinition elements would still be necessary here!
d79 1
d81 1
d83 17
@


1.6
log
@Revision 6
@
text
@d9 1
a9 1
  <responseStructrure ns="http://www.tdwg.org/schemas/abcd/1.0">http://www.tdwg.org/schemas/abcd/1.0/abcd.xsd</responseStructrure>
d23 1
a23 1
   <responseStructrure ns="http://www.tdwg.org/schemas/abcd/1.0">http://www.tdwg.org/schemas/abcd/1.0/abcd.xsd</responseStructrure>
@


1.5
log
@Revision 5
@
text
@d47 12
a58 3
    <concept from="taxon/@@name" to="abcd:/datasets/dataset/units/unit/identification"/>
    <concept from="taxon/coordinates/@@lat" to="abcd:/datasets/dataset/units/unit/latitude"/>
    <concept from="taxon/coordinates/@@long" to="abcd:/datasets/dataset/units/unit/longitude"/>
@


1.4
log
@Revision 4
@
text
@d47 3
a49 3
    <concept fromPath="taxon/@@name" toPath="abcd:/datasets/dataset/units/unit/identification"/>
    <concept fromPath="taxon/coordinates/@@lat" toPath="abcd:/datasets/dataset/units/unit/latitude"/>
    <concept fromPath="taxon/coordinates/@@long" toPath="abcd:/datasets/dataset/units/unit/longitude"/>
@


1.3
log
@Revision 3
@
text
@d27 1
a27 1
    <concept path="/datasets/dataset/recordset/record/units/unit/identification"/>
d47 3
a49 3
    <concept fromPath="taxon/@@name" toPath="abcd:/datasets/dataset/recordset/record/units/unit/identification"/>
    <concept fromPath="taxon/coordinates/@@latitude" toPath="abcd:/datasets/dataset/recordset/record/units/unit/latitude"/>
    <concept fromPath="taxon/coordinates/@@longitude" toPath="abcd:/datasets/dataset/recordset/record/units/unit/longitude"/>
@


1.2
log
@Revision 2
@
text
@d9 1
a9 1
  <responseStructrure namespace="http://www.tdwg.org/schemas/abcd/1.0">http://www.tdwg.org/schemas/abcd/1.0/abcd.xsd</responseStructrure>
d23 1
a23 1
   <responseStructrure namespace="http://www.tdwg.org/schemas/abcd/1.0">http://www.tdwg.org/schemas/abcd/1.0/abcd.xsd</responseStructrure>
d43 1
a43 1
  <responseStructrure>http://www.mydomain.org/myschema/1.0/abcd.xsd</responseStructrure>
@


1.1
log
@Initial revision
@
text
@d9 1
a9 1
  <responseStructrure>http://www.tdwg.org/schemas/abcd/1.0</responseStructrure>
d23 1
a23 1
  <responseStructrure>http://www.tdwg.org/schemas/abcd/1.0</responseStructrure>
d43 1
a43 1
  <responseStructrure>http://www.mydomain.org/myschema/1.0</responseStructrure>
@