Skip to content

imeji search syntax

Bastien Saquet edited this page Jun 30, 2017 · 26 revisions

This page describes the syntax for the imeji search

Search for one attribute

To search for one attribute (see list of available attributes), for instance filename:

filename=image.jpg

Combine search attributes

You can combine 2 or more search attributes with the relation OR or AND and group the attributes between ():

filename=image.jpg OR filename=example.png

or

filename=image.jpg AND author=Max Mustermann

or

(filename=image.jpg AND author=Max Mustermann) OR (filename=image.png AND author=Max Mustermann)

Inverse query

To inverse a query, use the keyword NOT as following:

NOT filename=image.jpg

or with a group:

(filename=image.jpg AND author=Max Mustermann) OR NOT (filename=image.png AND author=Max Mustermann)

Text search

By searching for any Textattribute (see list of available attributes), you can:

Search for a list of words

description=Lorem ipsum dolor sit amet

Any collection with at least one of these words in its description will be found

Search for an exact phrase:

description="Lorem ipsum dolor sit amet"

Any collection with the exact complete phrase (i.e. all the words in the same order) in its description will be found

Search for a part of a word (wildcards) imeji supports the 2 standard wildcards: ? matches any character, and * matches zero or more characters. For instance:

description=Lor*m

Lorm or Lorem or Lorettem will be found

description=Lor?m

Lorem will be found but not Lorettem and not Lorm

Number search

By searching for any Number attribute (see list of available attributes), you can:

Search for the exact value

filesize=1024

Search for any value greater than

filesize>1024

Search for any value lesser than

filesize<1024

Search for any value greater or equals to

filesize>=1024

Search for any value lesser or equals to

filesize<=1024

Date search

Same rules as for attributes with type Number applies for attributes with type Date.

The Date format:

yyyy-MM-dd

You don't have to use the complete date format to make searches. You can simple use a part of the date, for instance:

created=2000

Search for all objects created in 2000, which is equivalent to

created>= 2000-01-01 and created<= 2000-12-31

Geolocation search

The geolocation is available for attribute of type Geolocation. To search for a geolocation (defined by a latitude and a longitude), use the following syntax:

attribute.geolocation=latitude,longitude

for example:

md.position.geolocation=48.148247,11.577071

which will find the item with the metadata position, defined by alatitude equals to 48.148247 and a longitude equals to 11.577071

To search for a distance, use the following syntax:

attribute.geolocation=latitude,longitude,distance

where the distance is a number with a unit (km, m, etc.). For example:

md.position.geolocation=48.148247,11.577071,1km

which will find the item with the metadata position, with alatitude and a longitude distant by less than 1 kilometer from the geolocation 48.148247,11.577071.

Metadata search

Same rules as for any other attributes applies for metadata search. As metadata can be freely defined in imeji, attributes are created dynamically as following:

md.metadata_name

For instance:

  • for the metadata with the name title, the atttribute is md.title
  • for the metadata with the name Experience Number, the attribute is md.experience_number

Some metadata type are composed of multiple attributes (Link, Person, Geolocation). To search for these specific attributes, you can choose this syntax:

md.metadata_name.attribute

List of the attributes for the metadata

Index Description Possible values supported operators supported metadata type
text The text value of the metadata Any text = text date person number link geolocation
number The number value of the metadata Double = < > number
date The date value of the metadata See Date search = < > date
placename The name of a place Any text = geolocation
coordinates The coordinates of a place See Geolocation search = geolocation
title The title of a link Any text = link
url The url of a link Any valid url = link
familyname the family name of a person Any text = person
givenname the given name of a person Any text = person
completename the complete name of a person (familyName, givenName) Any text = person
identifier the identifier of a person Any text = person
organisation the organisation of a person Any text = person

Technical metadata search

Same rules as for any other attributes applies for technical metadata search. All technical metadata have the type Text. As technical metadata are automatically extracted, attributes are created dynamically as following:

technical[attribute]

For example, for the technical metadata Thumbnail Compression, attribute is: technical[Thumbnail Compression].

List of search attributes

Index Description Possible values supported operators supported objects
id The id of the object Any valid id = item collection
created The date of creation of the object See Date search = > < item collection
modified The date of the last modification of the object See Date search = > < item collection
collaborator The persons to whom an object is shared with the email of the person = item collection
creator The person who created the object the email of the person = item collection
status The status of the object pending released discarded = item collection
collectionid the id of the collection of the item Any valid id = item
filename the name of the file Any text = item
checksum the checksum of the file The MD5 checksum = item
license the license of the item the license name * no_license = item
filetype the type of the file Any type as defined in the advanced search = item
fulltext the text content of the file Any text = item
title the name of the collection Any text = collection
description the description of the collection Any text = collection
author the author of the collection any text = collection
You can’t perform that action at this time.