Search tagging is an enrichment, used to add tags to incoming items. This way items can for example be assigned a certain product name based on a Smart Filter match or a company name based on a full text search result.
Table of Contents
| Table of Contents | ||||
|---|---|---|---|---|
|
Using Search Tagging
Search tagging is fully configurable in the user interface. The following sections describe the process to set up search tagging. Search tagging is especially useful in dashboards, where it can be used in the charts to display distribution of results.
Preparation
On the Search screen or in a dashboard construct the query that will serve as a basis for your tagging. This can include Smart Filters, filter drill-down options, full text search terms, etc.
...
Once you are happy with the result, copy the query from the search field.
Setup
Then in the Setup space navigate to the AI Studio and open the Search Tagging section.
Create a new tagging rule by pressing the orange plus sign at the top right.
In the resulting form fill out the fields as follows:
Enter a descriptive name, such as "Acquisitions".
Paste or formulate the query
Enter the keyword to be assigned to each item that matches the query. This is a keyword and value separated by colon. Multiple such combinations can be entered by hitting the Enter key between each entry.
...
Enable in Pipeline
Search tagging and alert rules by users are only executed for any items if the corresponding step is present in the relevant pipeline.
This only needs to be done once, independent of how many search tagging rules are created.
To ensure search tagging is run proceed as follows:
Open the Pipeline Editor
In the Steps Library find the “Search Tagging and Alerting” step
Drag the step to the pipeline, placing it as the last step (after “Indexing”)
...
Once saved, all new items passing through this workflow will be tagged with the given keyword(s). Add the "Search Tagging and Alerting" step to additional workflows if you require.
Caveats
Asynchronous Processing
Search tagging, especially when used with Smart Filters, can be a resource-intensive process. For that reason, this step is run asynchronously in the Pipeline. As a result items that are searchable and displayed may not yet have their search tags applied.
Historical Tagging
From the moment a search tagging has been set up it applies to all new items. All items that are already in the index are not processed at that time. Please contact Squirro Support if you need to tag existing items.
Recursion and Ordering
Ordering of search tagging rules in a project is not guaranteed. But it is still possible to chain search tagging rules as the tags are processed twice.
Assume as an example the following search tagging definitions:
...
Name
...
Query
...
Keywords
...
Personnel Change Catalyst
...
smartfilter:personnel_changes:0.5
...
catalyst:Personnel
...
Generic Catalyst
...
catalyst:Personnel OR catalyst:Financial
...
catalyst:Company
When an item is processed it now runs through this list of search tagging rules in phases.
In the first phase, the first search tagging rule for personnel changes matches and the value "Personnel" is added to the "catalyst" keyword. However the second rule will not yet match, because the original item doesn't match the query.
Because the item changed as a result of a search tagging, it is now processed a second time. In this second phase the second rule will also match. As a result the "Company" value is also added to the "catalyst" keyword and the item will now contain both values.
The process stops after the second stage to avoid infinite loops - so further chaining is not possibleThis page can now be found at Search Tagging and Alerting on the Squirro Docs site.