registry-ws: add tagNamespace filter parameter

12567
Reporter: kbraak
Type: Improvement
Summary: registry-ws: add tagNamespace filter parameter
Priority: Minor
Status: Open
Created: 2012-12-20 19:56:21.331
Updated: 2013-12-16 23:16:31.661
        
Description: Add tagNamespace filter to the following web service endpoint URLs:

/node//tag
/organization//tag
/network//tag
/installation//tag
/dataset//tag

For example: /dataset?tagNamespace=GBIF_HARVESTING will filter all tags for dataset with key  that belong to the HIT namespace. Alternatively, consider accepting the namespace prefix or uri.

Please refer to the complete list of tag namespaces: http://code.google.com/p/gbif-common-resources/source/browse/gbif-api/trunk/src/main/java/org/gbif/api/vocabulary/TagNamespace.java

Also, please refer to API documentation http://www.gbif.org/developer/registry and update the related services when work is complete.]]>
    

Author: kbraak@gbif.org
Created: 2013-12-11 17:27:37.492
Updated: 2013-12-12 14:04:13.72
        
Currently in Registry2, a tag has a key and a value, no namespace. Furthermore, there is no way to filter a list of a dataset's tags or machine tags for example. We could consider a filter by tag key, or a filter by tag value (new issues needed?).

At the very least, the dataset search and suggest services, can filter by keyword, which is the merged collection of tags, the dataset keywordCollections and temporalCoverages.

MachineTag does have a namespace. I believe its values are restricted to values from the TagNamespace ENUM: https://code.google.com/p/gbif-common-resources/source/browse/gbif-api/trunk/src/main/java/org/gbif/api/vocabulary/TagNamespace.java
    

Author: mdoering@gbif.org
Comment: This only makes sense for machine tags and I would suggest to use a simple "namespace" query parameter that takes the namespace itself, not the enum which is just a convenience for java development. For example the crawler namespace is crawler.gbif.org, not CRAWLER.
Created: 2013-12-16 23:16:31.661
Updated: 2013-12-16 23:16:31.661