Table of Contents
Searching for assets (Fotoware Pro)
02. April 2025
Table of Contents
Performing a basic search
To perform a basic search, start typing words in the search box. This will execute a full-text search across all the entire definition of metadata fields.
Example:
beautiful beach
By default, this will be construed as the precise string "beautiful beach". The way FotoWeb interprets searches that contain several words without quotation marks to separate them can be configured by the FotoWeb administrator in the search string modification settings.
Recent searches are retained, so you can easily access them by clicking on the search box.
Searching for an exact phrase
To search for an exact phrase, such as a complete name, enclose the phrase in quotation marks:
"barack obama"
This will only produce hits in assets that contain the exact phrase barack obama, but not, for example, return assets that contain the phrase president obama.
Searching in specific fields
To search in a specific field, you need to specify the field followed by the word or phrase you're searching for.
For example, to search for winter in the Keywords field (field no 25):
25:winter
You can also expand this search - say you want to search for winter and snow as keywords in field 25:
25:winter & 25:snow
This example uses the boolean operator AND - a complete list of such operators can be found below.
To go even further, let's imagine a search for winter and snow in field 25 and the phrase alpine skiing in the caption (field 120):
25:winter & 25:snow & 120:"alpine skiing"
Note: In the last example above, a search string such as 25:winter&snow will produce another result since it specifies a search for winter in field 25, while the search for snow is based on free text in all fields in the metadata definition since no field is specifically set for that term.
Editing search terms
When you enter a search term and press Enter, it is saved so that you can add more search terms if necessary, or delete an existing term by selecting x.
To edit a search term, double-click it.
Reference material
- Get a complete list of field specifiers (predicates)
- Get a complete list of XMP fields in the definition that comes with the standard Fotoware installation
Wildcards
When you are searching, you can make use of some special characters that can help you find what you are looking for. These special characters are:
? (question mark)
Matches any single character
Example:
shoe?
This search will match the word shoes, but not shoe.
* (asterisk)
Matches any number (including zero) of characters
Example:
shoe*
This search will match shoe, shoes, shoestring etc.
Example: Searching for filenames using wildcards
fn:*.jpg
Finds all assets assets with the .jpg extension. A complete list of specifiers (predicates) can be found in the search reference.
Boolean search
The following boolean operators can be used:
| Operator | Example search | Result |
|---|---|---|
| AND / & |
winter & snow winter AND snow |
Finds assets with both words present. Note: The AND operators can be omitted: If two clauses are put next to each other, they are implicitly combined using the AND operator. |
| OR / | |
apples OR pears apples | pears |
Expression matches if both or both operands match. |
| NOT / - | apples NOT pears | Expression matches assets with the words apples that does not also contain the word pears. |
Additional details can be found in the search reference.
Numeric range search
A numeric range search can be used to search for pictures of a specific size, assets within a date range and so on.
Two range forms can be used: closed range form and open range form.
Closed range form example:
pw:800~~2048
This will execute a search for pictures with a pixel width in the range of 800 to 2048 pixels.
Open range form example
pwf:800 AND pwt:2048
This is essentially the same search; we have specified pixel width from (pwf) and pixel width to (pwt) - A complete list of operators can be found in Search expressions reference.
The benefit of using an open range form is that you can specify only an upper or a lower limit. So if you're interested in finding pictures that are 800 pixels wide or more but don't want to specify an upper limit, your search can look like this:
pwf:800
Example 1: Searching for assets that have been modified between Jan 1st and 31st 2024
mt:2024-01-01~~2024-01-31
Here we use the mt specifier, modified time, which lets us set an interval.
Example 2: Searching for assets that have been modified since Jan 1st 2024
mtf:2024-01-01
This search uses the mtf specified, modified time from, without specifying an end. Therefore, all files modified since the specified start date will be found.
Example 3: Searching for assets that have been uploaded since Jan 1st 2024
A slightly different approach is needed when searching in XMP date fields: To find files that have been uploaded since Jan 1st, 2024, we can perform a search in the Uploaded time field (no 362). The syntax will then look like this:
362:2024-01-01~~9999-12-31
Since there is no way to specify an end date representing today, you can use an imagined date far into the future - in this case, we've set an end date in the year 9999. The same can be used to set a start date far into the past - you can, for example, set the start date in the year 1700 to make sure you include all files since then.
A complete set of available search expressions can be found in the search expressions reference article.
Extended search
When searching for assets, extended search parameters can be used to specify more closely which fields to search in, folder names to include, and more. For more information, see Using extended search.
Search result display
When you perform a search, FotoWeb opens tabs for all the archives that generate search results. If your search produces hits in so many archives that they don't all fit on your screen, the little menu icon to the left of the tab area shows a counter to indicate how many other archives have search results in them. You can then open that menu and select the archives you want to display.
To find specific content in archives, use the Search field at the top right of the screen. When you log in, a large search bar on the home page allows you to search all the archives you can access.
Clearing the search
To clear the search, select X in the search field.
Other ways to locate files
Though performing a search is a convenient way to locate the files you're looking for, browsing archives by folders or taxonomies, when available, can also be very useful for finding assets.
For a complete overview of search capabilities in FotoWeb, see Search Expressions reference article.
Searching for assets using Asian languages
Some Asian languages (such as Thai, Chinese, Japanese, and Korean) do not have spaces between all words. To support full-text search in these languages, FotoWeb automatically wraps search words in Asian languages between wildcard characters. For example, if you search for "สตาร์คราฟต์", FotoWeb internally searches for "*สตาร์คราฟต์*". This causes the search to match assets where the search word appears in a sentence in the Thai language without being separated from the rest of the text by spaces.
Wildcard character wrapping is applied separately to each word in a search expression. It is only applied to words that contain letters in one of the following languages: Thai, Korean, Japanese, Chinese (not including rare and historical characters with Unicode values above U+FFFF). This means that when searching for words that do not contain any of these Asian characters, such as numbers or names in Latin characters, you have to enclose them in wildcard characters manually. For example, you need to manually search for "*1950*" instead of "1950" to match the number "1950" in a sentence in Chinese, where "1950" is not separated from the rest of the text by spaces.
Wildcard character wrapping is applied to full-text searches, taxonomy searches (regular and custom searches), and field searches using the API. In all cases, wildcard characters are applied per word.
Note: Wildcard Wildcard character wrapping is applied to full-text searches, taxonomy searches (regular and custom searches), and field searches using the API. In all cases, wildcard characters are applied per word. Wrapping, as described above, impacts performance and will increase search times.