The Search Editor's main view is a panel with two tabs: Input and Output.
Input
The Input tab deals with creating, deleting, and updating Filters for a search.
Here is a brief explanation of various terms, which are relevant for the Search Editor's Input tab. Each term has a link to a page, where there will be a more in-depth explanation and guide on how to apply it.
- Filter
- A Filter is a condition, which is applied to the data in the DAM Center during a search.
- Group
- Draft - Comparison Type
- Determines how a given Filter does its "filtering".
- Input Type
- Determines how any Visible filter gets the user's input. This is specific to Media Manager and Video Portal, ie Input Type can be used to gather a search's parameters and therefore has no impact on the search itself.
- Visible filter
- If a Filter is visible, then parameters for that filter can be supplied by the user in Media Manager and Video Portal.
- Predetermined values
- If the parameters for a Filter are known in advance, predetermined values can be applied to the Filter. If Predetermined values are applied to a Filter, any parameters supplied by the user or client code will be ignored.
Output
The Output tab deals with creating, deleting, and updating the Value Fields for a search.
Here is a brief explanation of various terms, which are relevant for the Search Editor's Output tab. Each term has a link to a page, where there will be a more in-depth explanation and guide on how to apply it.
- Value Field
- A Value Field is an element, which defines a property in the search result.
- isArray
- Determines whether a Value Field is ALWAYS output as an array.
- returnType
- Determines how a Value Field is represented in the search result.
- Tooltip
- Determines whether a Value Field is used in the tooltip of an asset
- Determines whether a Value Field is used in the tooltip of an asset
Input and Output
Some terms are used in both the Input and Output tabs. As with the two previous paragraphs, here is a brief explanation of these terms as well as a link to a page with a more in-depth explanation.
- ID
- The ID has two different implications: one for Input, and one for Output
- Input: The ID of a Filter is the name of the parameter given to the search.
- Output: The ID of a Value Field is the name of the property in the JSON returned by the search. It can also the name of a label, which is used in Media Manager and Video Portal to display the output of a Value Field.
- The ID has two different implications: one for Input, and one for Output
- Custom attributes
- Custom attributes are user-defined attributes of a Filter or Value Field.
- Draft - Field
- A Draft - Field is used in conjunction with a Meta data field to specify a value other than the default Meta data field value.
- Draft - Aggregate
- An Draft - Aggregate behaves exactly like an SQL aggregate function in that it performs a calculation on a set of values and returns a single number.
A user can add three different kinds of Filters and Value Fields:
- Table and column
- This is a filter or value field, which acts upon a specific table and column in the database.
- Meta data field
- This is a filter or value field, which acts upon a meta data field, eg "Keywords", "Description", or "Title".
- Predefined
- This is a special filter or value field, which can be a Group, Value Field, Filter, any combination of these, or something else entirely. A Predefined Input or Output element is an element, which represents functionality, that is not supported by either a Table and column element or Meta data field.
"Translations"
During the genesis of the Search Editor a decision was made to rename certain concepts. This was done to help the user understand what these concepts do.
This small section's purpose is to explain, that these concepts might be called something different elsewhere in the documentation.
"searchField" → Filter.
"searchFields" → Group.
"valueHandler" → "Draft - Comparison Type".
"renderType" → "Input Type".
"operator" → "Condition"