-
Notifications
You must be signed in to change notification settings - Fork 2
/
SearchProposalTwo.txt
196 lines (183 loc) · 8.66 KB
/
SearchProposalTwo.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
---+ Search Proposal II
This proposal for a general search request unifies the FullSearch and the PartialSearch.
It defines the search request and response on a RecordBasedApproach as opposed to the DocumentBasedApproach. The provider defines a root table which should be associated to the record elements being served. All conceptual schemas defined by the provider are data structures "rooted" in that record definition.
---+++++ Request Definition
Based on the PartialSearch we suggest this structure for a request (ABCD example):
<verbatim>
<request>
<header>
...
<type>search</type>
</header>
<message count="true">
<concepts>
<concept path="abcd:/unit/Identifications"/> *
<concept path="micro:/Strain"/>
<concept path="micro:/Temperature"/>
</concepts>
<filter>
...
</filter>
</message>
</request>
</verbatim>
There is no need to give a RecordDefinition as the RecordBasedApproach considers global elements of a ConceptualSchema to represent a single record. If multiple global elements are requested in order to extend a schema (as in the example above), all global elements refer to the same record from a table inside the database, so they should be grouped by the <record> element defined by the protocol.
---+++++ Schema Extension & Response
The search is also meant for integrating data in a response from different ConceptualSchemas to support e.g. extension schemas for DarwinCore. The idea is to leave the structure below a root element definition immutable and only allow the addition ("inheritance") of new root elements within a RecordObject.
So for example a RecordObject of DarwinCore looking like this:
<verbatim>
<Record xmlns:dwc="http://www.namespaceTBD.org/darwin2">
<dwc:DateLastModified>2001-12-17T09:30:47-05:00</DateLastModified>
<dwc:InstitutionCode>String</InstitutionCode>
<dwc:CollectionCode>String</CollectionCode>
<dwc:CatalogNumber>String</CatalogNumber>
<dwc:ScientificName>String</ScientificName>
<dwc:BasisOfRecord>String</BasisOfRecord>
<dwc:Genus>String</Genus>
<dwc:Species>String</Species>
<dwc:ScientificNameAuthor>String</ScientificNameAuthor>
<dwc:Notes>String</Notes>
</Record>
</verbatim>
could be extended with microbial data taken from another ConceptualSchema definition like this:
<verbatim>
<Record xmlns:dwc="http://www.namespaceTBD.org/darwin2" xmlns:micro="http://www.namespaceTBD.org/microbial">
<dwc:DateLastModified>2001-12-17T09:30:47-05:00</DateLastModified>
<dwc:InstitutionCode>String</InstitutionCode>
<dwc:CollectionCode>String</CollectionCode>
<dwc:CatalogNumber>String</CatalogNumber>
<dwc:ScientificName>String</ScientificName>
<dwc:BasisOfRecord>String</BasisOfRecord>
<dwc:Genus>String</Genus>
<dwc:Species>String</Species>
<dwc:ScientificNameAuthor>String</ScientificNameAuthor>
<dwc:Notes>String</Notes>
<micro:Strain>String</Strain>
<micro:Temperature>String</Temperature>
</Record>
</verbatim>
Complex data types (objects) like an ABCD unit would be immutable, as the ABCD schema would have to define slots for extending it with other elements. It would only be possible to extend the RecordObject at the same level as the ABCD unit, thus adding RecordObjectProperties.
Imagine an ABCD unit RecordObject as this:
<verbatim>
<Record xmlns:abcd="http://www.tdwg.org/schemas/abcd/1.46">
<abcd:unit>
<abcd:SourceInstitutionID>String</abcd:SourceInstitutionID>
<abcd:SourceID>normalizedString</abcd:SourceID>
<abcd:UnitID>normalizedString</abcd:UnitID>
<abcd:LastEditor>normalizedString</abcd:LastEditor>
<abcd:DateLastEdited>1967-08-13</abcd:DateLastEdited>
<abcd:UnitIPRStatements Language="en-us">
<abcd:General>
<abcd:ShortText>normalizedString</abcd:ShortText>
</abcd:General>
</abcd:UnitIPRStatements>
<abcd:RecordBasis>Specimen</abcd:RecordBasis>
<abcd:Identifications>
<abcd:Identification>
<abcd:IdentificationResult>
<abcd:TaxonIdentified>
<abcd:ScientificName>
<abcd:FullScientificNameString>normalizedString</abcd:FullScientificNameString>
<abcd:NameAtomized>
<abcd:Bacterial>
<abcd:Genus>String</abcd:Genus>
<abcd:Subgenus>String</abcd:Subgenus>
<abcd:SubgenusAuthorAndYear>normalizedString</abcd:SubgenusAuthorAndYear>
<abcd:SpeciesEpithet>String</abcd:SpeciesEpithet>
<abcd:SubspeciesEpithet>String</abcd:SubspeciesEpithet>
<abcd:ParentheticalAuthorTeamAndYear>normalizedString</abcd:ParentheticalAuthorTeamAndYear>
<abcd:AuthorTeamAndYear>normalizedString</abcd:AuthorTeamAndYear>
<abcd:NameApprobation>normalizedString</abcd:NameApprobation>
</abcd:Bacterial>
</abcd:NameAtomized>
</abcd:ScientificName>
</abcd:TaxonIdentified>
</abcd:IdentificationResult>
<abcd:Identifier>
<abcd:IdentifierPersonName>
<abcd:PersonName>normalizedString</abcd:PersonName>
</abcd:IdentifierPersonName>
</abcd:Identifier>
<abcd:IdentificationDate>
<abcd:ISODateTimeBegin>0000-01-01T00:00</abcd:ISODateTimeBegin>
</abcd:IdentificationDate>
</abcd:Identification>
</abcd:Identifications>
<abcd:Gathering>
<abcd:GatheringDateTime>
<abcd:ISODateTimeBegin>0000-01-01T00:00</abcd:ISODateTimeBegin>
</abcd:GatheringDateTime>
<abcd:GatheringAgents>
<abcd:GatheringAgent PrimaryCollectorFlag="1">
<abcd:Person>
<abcd:PersonName>normalizedString</abcd:PersonName>
</abcd:Person>
</abcd:GatheringAgent>
</abcd:GatheringAgents>
</abcd:Gathering>
</abcd:unit>
</Record>
</verbatim>
Extending this RecordObject with the same concepts as above in DarwinCore, you would get:
<verbatim>
<Record xmlns:abcd="http://www.tdwg.org/schemas/abcd/1.46" xmlns:micro="http://www.namespaceTBD.org/microbial">
<abcd:unit>
<abcd:SourceInstitutionID>String</abcd:SourceInstitutionID>
<abcd:SourceID>normalizedString</abcd:SourceID>
<abcd:UnitID>normalizedString</abcd:UnitID>
<abcd:LastEditor>normalizedString</abcd:LastEditor>
<abcd:DateLastEdited>1967-08-13</abcd:DateLastEdited>
<abcd:UnitIPRStatements Language="en-us">
<abcd:General>
<abcd:ShortText>normalizedString</abcd:ShortText>
</abcd:General>
</abcd:UnitIPRStatements>
<abcd:RecordBasis>Specimen</abcd:RecordBasis>
<abcd:Identifications>
<abcd:Identification>
<abcd:IdentificationResult>
<abcd:TaxonIdentified>
<abcd:ScientificName>
<abcd:FullScientificNameString>normalizedString</abcd:FullScientificNameString>
<abcd:NameAtomized>
<abcd:Bacterial>
<abcd:Genus>String</abcd:Genus>
<abcd:Subgenus>String</abcd:Subgenus>
<abcd:SubgenusAuthorAndYear>normalizedString</abcd:SubgenusAuthorAndYear>
<abcd:SpeciesEpithet>String</abcd:SpeciesEpithet>
<abcd:SubspeciesEpithet>String</abcd:SubspeciesEpithet>
<abcd:ParentheticalAuthorTeamAndYear>normalizedString</abcd:ParentheticalAuthorTeamAndYear>
<abcd:AuthorTeamAndYear>normalizedString</abcd:AuthorTeamAndYear>
<abcd:NameApprobation>normalizedString</abcd:NameApprobation>
</abcd:Bacterial>
</abcd:NameAtomized>
</abcd:ScientificName>
</abcd:TaxonIdentified>
</abcd:IdentificationResult>
<abcd:Identifier>
<abcd:IdentifierPersonName>
<abcd:PersonName>normalizedString</abcd:PersonName>
</abcd:IdentifierPersonName>
</abcd:Identifier>
<abcd:IdentificationDate>
<abcd:ISODateTimeBegin>0000-01-01T00:00</abcd:ISODateTimeBegin>
</abcd:IdentificationDate>
</abcd:Identification>
</abcd:Identifications>
<abcd:Gathering>
<abcd:GatheringDateTime>
<abcd:ISODateTimeBegin>0000-01-01T00:00</abcd:ISODateTimeBegin>
</abcd:GatheringDateTime>
<abcd:GatheringAgents>
<abcd:GatheringAgent PrimaryCollectorFlag="1">
<abcd:Person>
<abcd:PersonName>normalizedString</abcd:PersonName>
</abcd:Person>
</abcd:GatheringAgent>
</abcd:GatheringAgents>
</abcd:Gathering>
</abcd:unit>
<micro:Strain>String</Strain>
<micro:Temperature>String</Temperature>
</Record>
</verbatim>