Revision as of 20:49, 5 December 2011 (view source) Mcrump (Talk | contribs) ← Older edit		Latest revision as of 20:50, 21 January 2013 (view source) Smiller (Talk | contribs) (→Search)
(41 intermediate revisions by 2 users not shown)
Line 1:		Line 1:
	{{REST_resource}}		{{REST_resource}}
−	= Query =	+	= Search =
	== Query language ==		== Query language ==
Line 7:		Line 7:
	Suggestion:		Suggestion:
−	:someQuery a tb:Query ;	+	Queries will be passed as parameters to the search URI.  Valid query parameters are as follows:
−	tb:hasKeyword <keywordUri1>, <keywordUri2> ;	+
−	tb:searchTerm "free text search" ;	+
−	tb:target tb:Protocol .	+
−	== Ad Hoc Search ==	+	keyword=some_keyword
−	{{HasOperation |id=Query:Search}}	+	Search only keywords for given keyword
		+	metadata=free_text
		+	Search all metadata for given free text
		+	resourceType=protocol|data
		+	Limit search to either protocol or data.  All resource types are searched if omitted.
		+	timeModified=epoch-epoch
		+	Limit search to give time period.  Times must be represented as seconds since the epoch.
		+	timeModified=0 - all times equal to and after the value.
		+	timeModified=-11111111 - all times up to and including the value.
		+	timeMOdified=1234-11111111 - all times inclusive of value range.
−	== Predefined Search ==	+	== Search Ad Hoc Query ==
−	{{ HasOperation |id=Query:PredefinedSearch }}	+	{{HasOperation |id=Search:AdHocQuery}}
−	== Search Protocols ==	+	== Get Indexed Investigation ==
		+	{{HasOperation |id=Search:GetIndexedInvestigation}}
−	[[API_Protocol|Protocols]]	+	== Get Indexed Protocol ==
		+	{{HasOperation |id=Search:GetIndexedProtocol}}
−	{{HasOperation |id=Query:SearchProtocols}}	+	== Index Investigation ==
		+	{{HasOperation |id=Search:IndexInvestigation}}
−	== Search Studies ==	+	== Index Protocol ==
−	{{HasOperation |id=Query:SearchStudy}}	+	{{HasOperation |id=Search:IndexProtocol}}
−	== Search Data==	+	== Delete Indexed Investigation ==
−	[[API_Data|Data]] [[API_Study#Assays|Assays]]	+	{{HasOperation |id=Search:DeleteIndexedInvestigation}}
−	{{HasOperation |id=Query:SearchData}}	+	== Delete Indexed Protocol ==
		+	{{HasOperation |id=Search:DeleteIndexedProtocol}}
−	== Create a predefined query ==	+	== Administer Index Resources ==
−	{{HasOperation |id=Query:Create}}	+	{{HasOperation |id=Search:AdministerIndexResources}}
	== Keyword hierarchy ==		== Keyword hierarchy ==

---

Latest revision as of 20:50, 21 January 2013

Search

Contents 1 Search 1.1 Query language 1.2 Search Ad Hoc Query 1.3 Get Indexed Investigation 1.4 Get Indexed Protocol 1.5 Index Investigation 1.6 Index Protocol 1.7 Delete Indexed Investigation 1.8 Delete Indexed Protocol 1.9 Administer Index Resources 1.10 Keyword hierarchy 1.11 Filtering the query 2 Alerts

Search

Query language

Suggestion:

Queries will be passed as parameters to the search URI. Valid query parameters are as follows:

   keyword=some_keyword
       Search only keywords for given keyword
   metadata=free_text
       Search all metadata for given free text
   resourceType=protocol|data
       Limit search to either protocol or data.  All resource types are searched if omitted.
   timeModified=epoch-epoch
       Limit search to give time period.  Times must be represented as seconds since the epoch.
       timeModified=0 - all times equal to and after the value.
       timeModified=-11111111 - all times up to and including the value.
       timeMOdified=1234-11111111 - all times inclusive of value range.

Search Ad Hoc Query

Description	Search an ad hoc query
Resource	Search
Method	GET
URI	/search
Parameters	See query language
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)
Results	URIs of the results
Media Type (output)	text/uri-list
Status code	200,400,401,402,403

Links: Page, Edit with form

Get Indexed Investigation

Description	Get uri of index investigation
Resource	Index
Method	GET
URI	/search/index/investigation
Parameters	resourceUri={resourceUri}
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)
Results
Media Type (output)	uri of resource if it exists in index
Status code	200,400,401,402,403

Links: Page, Edit with form

Get Indexed Protocol

Description	Get uri of indexed protocol
Resource	Index
Method	GET
URI	/search/index/protocol
Parameters	resourceUri={resourceUri}
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)
Results
Media Type (output)	uri of resource if it exists in index
Status code	200,400,401,402,403

Links: Page, Edit with form

Index Investigation

Description	Add investigation to query index
Resource	Index
Method	PUT
URI	/search/index/investigation
Parameters	resourceUri={resourceUri}
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)	text/uri
Results
Media Type (output)
Status code	200,400,401,402,403

Links: Page, Edit with form

Index Protocol

Description	Add protocol to query index
Resource	Index
Method	PUT
URI	/search/index/protocol
Parameters	resourceUri={resourceUri}
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)	text/uri
Results
Media Type (output)
Status code	200,400,401,402,403

Links: Page, Edit with form

Delete Indexed Investigation

Description	Delete an indexed investigation
Resource	Index
Method	DELETE
URI	/search/index/investigation
Parameters	resourceUri={resourceUri}
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)
Results
Media Type (output)
Status code	200,400,401,402,403

Links: Page, Edit with form

Delete Indexed Protocol

Description	Delete an indexed protocol
Resource	Index
Method	DELETE
URI	/search/index/protocol
Parameters	resourceUri={resourceUri}
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)
Results
Media Type (output)
Status code	200,400,401,402,403

Links: Page, Edit with form

Administer Index Resources

Description	Sync search index with actual data
Resource	Index
Method	POST
URI	/search/index
Parameters	admin=sync
Header Parameters	subjectid:SECURITY-TOKEN
Media Type (input)
Results
Media Type (output)
Status code	200,400,401,402,403

Links: Page, Edit with form

Keyword hierarchy

Web service access to ontologies

Filtering the query

TBD

Alerts

An Alert is defined by Query URI ,frequency and an User to be notified.