Defining the parameters for a search operation and a result list
If, for example, you want to provide your users with a predefined search operation or result list, you can specify a variety of parameters. Usually, the full-text search in a d.3 repository is not specific enough. Therefore, you can restrict the search query by using query parameters.
You must encode the URL parameters (e.g. spaces in %20
). The length of the encoded query parameter is limited to 2000 characters.
Parameter | Description |
---|---|
| Sets the categories used for searching items. You can define at least one category. Specify the ID of a category. If this value is not specified, the search is done across all categories in a d.3 repository. Examples (not encoded):
|
| Specifies a full-text keyword. |
| Specifies the search restriction based on the properties of documents and dossiers. You can use the following criteria to restrict a search operation:
You can define at least one value for each property. Examples (not encoded):
Restriction in relation to the definition of a search operation: You can also define multiple values for a parameter, provided that facets have been configured for the corresponding property. If no facets for viewing have been configured for the property, the last value is always adopted for the search operation. You can also limit the result list and search operation based on an advanced property. The ID of the property corresponds to the ID (RID) of a property that you can determine for each advanced property in d.3 admin. For additional information about the ID of a property (RID) see the manual about d.3 admin ( Examples (not encoded):
You can also use several properties as search restrictions simultaneously. Examples (not encoded):
|
Note
Specific values for the properties
parameter related to the various options for restricting the result in a targeted way:
Search for a numeric value or a money value:
Specify the value without using a thousand separator. The decimal separator is the period (.). Example: For the value 1,000.20 EUR specify 1000.20.
Search for a date and time:
Specify the date in the format YYYY-MM-DD. Example: Enter 2014-12-05 for the date 12/05/2014 (MM/DD/YYYY).
Time is specified in the format YYYY-MM-DDTHH:mm:ss+01:00. You must encode the plus character (+) with
%2b
. Example: 2015-02-18T23:59:59%2b01:00 for 02/18/2015 at 11:59 p.m. and 59 seconds in the time zone UTC+1 for standard time in Germany.Search for items that are located in a specific range:
To search in a range, use a combination of the pipe and minus character (|-) as separators. Examples for a numeric field with the ID
"231"
:
Values greater than or equal to 100:
{"231":["100|-"]}
Values smaller than or equal to 100:
{"231":["|-100"]}
Values between 100 and 200:
{"231":["100|-200"]}