Help about search

Queries

Queries done on Dat@OSU are interpreted as a logic condition. If a record comply with conditions it will be shown.

Conditions can be simple words for a fulltext search. For example: "densities", "karst", "Kuiper". This words will be search everywhere on the record.

To select a precise criteria you can use a selector as described bellow. In short write selector's name, ":" and the value you search for. For example "access:open" to select only records on open datas.

Multiple criteria can be mixed with logic operatic. The default operator is "and" so you can generally make your request as easy as writing some words. Ex: "arvicola population jura".

Using logic operators

"And" operation: the operator "&" is considered as "and" operator. If multiple criterias is given without any operator it will be considered as an "And" operation. Like usual mathematics "and" have priority on "or"

"Or" operation: the operator "|" (the pipe, not a uppercase "i") and ";" is considered as "or" operation.

"Not" operation: prefix a condition with "!" to invert it. For example: "astronomy" returns all records with the word "astronomy". At opposite "!astronomy" returns all records without the word "astronomy".

Parenthesis "(" and ")" can be used to change operator precedence with same conventions than mathematics.

For much custom queries filters on left part of the page will be not shown because queries can't always be represented with this type of checkboxes.

Selectors

A selector can select something precise in a record. The format you must use for this is "selector_name:value". It is common to surround the value with quotes to avoid most needs to escape characters. Also note some selectors have synonyms to be more convenient.

access

Selects on accessibility. Value must be 'open' or 'libre' to search for open access and 'restricted' or 'restreint' for data who require contact to author.

all

(obsoleted by "obsolete")

Returns all records according to their level of obsolescence. Value must be 'obsolete' to search only records on obsolete data, 'current' to search for non obsolete data or 'all' to select all records.

audience

Returns all records available for given audience. Audiences are within a set of values.

collection

Returns records contained in named collection.

contributor

(synonym: contrib)

Selects on a contributor present in the record. It can be a person or a structure given as creator, contributor or contact. For persons, names can be given with both first and last name separated by a space. The first and last name can be inverted. It can also be named with only first or only last name. For structures names can be full name or acronym.

createdsince

(synonym: created)

Select records created since given date. Date is in format "year-month-day", for example "2017-04-01" for 1st April 2017. Hint: to search for records before a date you can use the "!" operator to invert selection.

creators

(synonyms: crea, créa)

Selects on a creator present in the record. It can be a person or a structure. Names formats are the same than the "contributor" selector.

discipline

(synonym: dis)

Select records related to given discipline.

domain

(synonym: dom)

Select records related to a discipline of a grand domain.

keyword

(synonym: kw)

Select records with given keyword in this keyword list. Note if demanded keyword is present in other parts of the record but not in the keyword list, the record will not be selected. To search everywhere do not use this and use fulltext search (just write the word without selector in the request).

label

Select records related to given label name.

lang

Select records according to the language used in their dataset/database. You can use full name of the language but also ISO 639-2 codes (fre, eng …)

method

Select on type of data acquisition method (ex: "Observational data", "Experimental data" …).

obsolete

Returns all records according to their level of obsolescence. Search for "yes", "oui", "y", "o", "obsolete", "obsolète" or "1" will select all obsoletes records. Search for "no", "non", "n", "current", "actuel" or "0" will select non obsolete records. This selector will replaces the "all" selector.

project

Select records related to given project. Project is characterised by this name.

publisher

(synonym: pub)

Select records published by given structure. You can use publisher's full name or it's acronym.

structure

(synonym: struct)

Select records reflated to structure. The structure can be a creator, contributor or publisher. The record is also selected if a person affiliated to the structure is creator, contributor or contact.

type

Select of type of data ("dataset" or "database").

updatedsince

(synonym: since)

Select records updated since given date. If the record has never been updated the creation date is used. Date is in format "year-month-day" like "createdsince". Hint: to search for records before a date you can use the "!" operator to invert selection.

updateperiod

Select on records who declares given update periodicity. You can use full label of periodicity's name (ex: "continually") or ISO 19115 MD_MaintenanceFrequencyCode code (ex: "continual").

    Some selector examples:
  • discipline:ecology
    Records about ecology
  • lang:english
    Records this data in english
  • method:"Observational data"
    Records on observational data (note request is surrounded by quotes because demanded value contents space)
  • method:Observational\ data
    Records on observational data (same thing as above but without quotes and escaping the space with a backslash)
  • updatedsince:2017-06-01
    Records updated or created since 1st June 2017.
  • since:2017-06-01
    Records updated or created since 1st June 2017 (same thing as above but using the shorter "since" synonym of "updatedsince").

Escaping special characters

When the value you search for contains spaces or any special characters it should be escaped.

A text is a sequence or characters. It is possible to just write the text or surround it with simple quote (') or double quote ("), of course it is required to finish the text with the same quote than it began. The advantage of surrounding it with quotes is to avoid interpretation of some special characters. It is also possible to protect some characters to be considered as a part of the text and not an operator. In some cases this manipulation is unavoidable for example to avoid confusion between a quote in the text and the end of the text.

It is possible to escape characters following these codes:

CharacterEscaped
character
Unavoidable if text surrounded by …
nothingsingle quote (')double quote (")
Space\(space)X
Tabulation *\tXXX
New line *\nXXX
\\\XXX
'\'XX
"\"XX
:\:X
(\(X
)\)X
&\&X
|\|X
;\;X

*: not usable for most search

Also note fulltext searches only matches words. Don't rely on this for anything else than words.

    Some escaping examples:
  • Escaping space and ampersand:
    discipline:"astronomy & astrophysics"
    discipline:astronomy\ \&\ astrophysics
  • Escaping space, parenthesis and apostrophe:
    label:"l'OSU (test)"
    label:'l\'OSU (test)'
    label:l\'OSU\ \(test\)
  • Escaping space and quotation mark:
    collection:"book \"Palaeontology\""
    collection:'book "Palaeontology"'
    collection:book\ \"Palaeontology\"
About
Terms of use
Contact
© OSU-THETA, CNRS