<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><strong>In this guide we will cover:</strong></p><p><strong>- How to Search for Articles</strong></p><p data-pasted="true"><strong>- Which Elements of the Article are Checked as part of a Search?</strong></p><p><strong>- Improve Search Using Meta Words </strong></p><p><strong>- Search using Article IDs</strong></p><p><strong>- Force an FAQ list to be Chosen before Returning Articles in the Search</strong></p><p data-pasted="true"><strong>- Filtering and searching on Custom Fields</strong></p><p><br></p><p><br></p><p><strong>Related Guides:</strong></p><ul><li data-pasted="true"><a href="https://usehalo.com/haloitsm/guides/1699/" target="_blank" rel="noopener noreferrer"><strong>Searching Entities</strong></a></li></ul><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">How to Search for Articles</span></strong></p><p>There are various ways articles can be searched for in the Halo Agent App, articles can also be searched in the portal. </p><p><br></p><p><strong><span style="font-size: 12pt;">Use Global Search</span></strong></p><p data-pasted="true">The global search bar is found in the top right hand corner of page, this can be used to search knowledge base articles. Before searching ensure you select "Articles" as the entity to search. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk4MGY0YjViLTdjMTAtNDNjZi05MTNkLTg0NmFiMDliOTAzNiJ9.nrg-liLuOnoddks9jdFWsDqehVCY1KFtB5bxvAsJuFo" class="fr-fic fr-fil fr-dib" width="1170" style="width: 1172px; height: 641.349px;" height="641"></p><p><strong><span style="font-size: 10pt;">Fig 1. Global Search Bar</span></strong></p><p><br></p><p>If you have "Show the quick search in the navigation bar" (under Configuration > Advanced Settings) you will not need to select an entity before searching, instead all entities selected for the 'All Search' option will be searched. To have articles returned in the search ensure "Articles" are checked here. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImIxNjAxZDJkLTQ1YTktNDg0OS05M2QxLWIzOTNkNmM5NDExYyJ9.vdWpVFXmZBuGJhyRhIUO7QCvu1tl_bGoF0sP0SS43IQ" class="fr-fic fr-fil fr-dib" width="1805" height="357"></p><p><strong><span style="font-size: 10pt;">Fig 2. Entities to search when using the quick search in the navigation bar</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Search in the Knowledge Base module</span></strong></p><p>When in the knowledge base module you will also have an option to search for articles. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2MmI3MTBiLTk0YWItNGM1Ny05Mzc4LTE5NjQ0ZTBhOGVlZCJ9.GsH4S7G6EmwL4IlDcx5vljMFSr-0aJ-NdCHAA5opU1A" class="fr-fic fr-fil fr-dib" width="2006" style="width: 2008px; height: 679.824px;" height="680"></p><p><strong><span style="font-size: 10pt;">Fig 3. Searching in Knowledge Base </span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Search in the Search Module</span></strong></p><p>Articles can also be searched for in the "Search" module, by selecting "Articles" as the entity. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZlMWNmOTllLWY1ZDQtNDQxNy04MDBhLTlhOTZhZDJiZDUwYiJ9.tqcDhlgHf0t5W763rQ_7vACUf0HgbduSZBXRQUahees" class="fr-fic fr-fil fr-dib" width="1870" style="width: 1872px; height: 595.403px;" height="595"></p><p><strong><span style="font-size: 10pt;">Fig 4. Searching in the Search Module</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Search in the Portal</span></strong></p><p>Users can also search for articles in the Portal from the knowledge base area. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE3ZmE2OTE5LWU4NmQtNDYwNS04NWVkLTU0Njg3ZjI3MTI5MyJ9.zxQQVO8f_yBtZbDKmmxvQjW-OLkPzSbBeL_SnXV9DoQ" class="fr-fic fr-fil fr-dib" width="1785" style="width: 1787px; height: 863.909px;" height="864"></p><p><strong><span style="font-size: 10pt;">Fig 5. Searching the Knowledge Base in the Portal </span></strong></p><p><br></p><p>From v2.242+, filters can be hidden from Users on the Portal by selecting the option "Hide Article search filter on the User portal" in Configuration > Knowledge Base. </p><p><br></p><p><strong><span style="font-size: 14pt;">Which Elements of the Article are Checked as part of a Search?</span></strong></p><p>The following elements of articles will be checked when searching:</p><ul><li>Title</li><li data-pasted="true">Description</li><li>Resolution</li><li>Internal Memo</li><li>Tags</li></ul><p>All the text in each of these fields will be compared to the string entered into the search bar, if any of the text can be matched to the search string the article will be returned. </p><p><br></p><p>The way in which the article text is matched to a string is controlled by the "Knowledge Base Search Type" you have set. This is set under Configuration > Knowledge Base. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIxNDdlNjdlLTY5ZDItNDU2Ny05NGEwLWViZjg2NTcwN2ZlZiJ9.OezQZH-vwIudEP2xCgZ8Z1fSeZVQ5IWapYYhugX-DPA" class="fr-fic fr-fil fr-dib" width="1075" style="width: 1077px; height: 452.499px;" height="452"></p><p><strong><span style="font-size: 10pt;">Fig 6. Knowledge Base Search Type</span></strong></p><p><br></p><p><strong>Search for the entire string -</strong> Each article will be checked to see if it contains the whole string in the search bar. Articles that only contain selected words in the search string will not be returned. </p><p><strong>Search for each word of the search string -</strong> Each article will be checked to see if it contains any of the words in the search string. Articles that do not contain any of the words in the string will not be returned. </p><p><strong>Search for every word of the search string -</strong> Each article will be checked to see if it contains any of the words in the search string, if it contains each of the words in the string it will be returned. The article must contain all the words in the search string to be returned, but they do not have to appear in the same order as they do in the string. </p><p><br></p><p data-pasted="true">To optimize this search, "Enable Knowledge Base Article Full-Text Searching" can be switched on in Configuration > Advanced Settings > Searching. Full text searching searches for the entire string, rather than each individual word within the string, which not only speeds up searching, it also makes it more accurate upon doing so. This functionality will return search results which contain the whole, unbroken search phrase higher than articles which otherwise match the search phrase when using the search type "Search for each word of the search string" or "Search for every word of the search string". From v2.242+, If you are using Full-Text searching you will have the option to determine whether to include the Internal Memo in Agent search results using the checkbox "Full-text search the internal memo field when an Agent is searching". If you are not using Full-Text searching, Agent search results will always include Internal Memos. </p><p><br></p><p><strong><span style="font-size: 14pt;">Improve Search Using Meta Words</span></strong></p><p>Meta words can be enabled for knowledge base articles. Meta words allow you to boost the rank of an article in search results when particular search terms are used. For example you may add the meta word/phrase 'not turning on' to the article titled "Device issues", so that when users search for the phrase 'device not turning on' the article "Device Issues" returns higher in the search. Unlike titles, descriptions and tags, meta words are not visible to users, and you can add as many as you like. </p><p><br></p><p>Keep in mind meta words cannot be used to return articles in search results alone. The search string will still need to match to an article, meta words just improve how high up an article appears in search. </p><p><br></p><p>The weighting of meta words can also be set to determine how influential meta words are over how highly an article is returned in the search. </p><p><br></p><p><strong><span style="font-size: 12pt;">Enable Meta Words </span></strong></p><p><em>Pre-requisites</em></p><ul><li style="font-style: italic;"><em>Knowledge Base Article Full-Text Searching must be enabled</em></li></ul><p><br></p><p>To enable the use of meta words, head to Configuration > Knowledge Base > enable "Enable Meta for Searching". </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFiNTZlZTYxLTNlY2ItNDcxNi1iYzFjLTFiOTJmM2U0NDZhZiJ9._TnUgYO6aDzruKYIl8k5-pW02mVUs7m25mUMrLW8Ak4" class="fr-fic fr-fil fr-dib" width="1311" style="width: 1313px; height: 487.9px;" height="488"></p><p><strong><span style="font-size: 10pt;">Fig 7. Enable Meta for Searching</span></strong></p><p><br></p><p>Once enabled, you can set the "Meta weighting in results", this determines how much weighting meta words have over other elements of the article. Lower values mean meta words have a lower precedence. If you would articles that have meta words matching the search string to be returned higher in the search than articles that have a title/resolution/tag etc that matches the search string, set this to 1000 or more. </p><p><br></p><p><strong><span style="font-size: 12pt;">Adding Meta Words to Articles</span></strong></p><p>Once meta words are enabled, you will have a new field available against each article called "Meta". Here, add all the meta words relevant to this article, to add multiple words/phrases use a comma separated list. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU0YzhjYjU0LWIyZGItNGI3Mi05NDAxLTM2YWQ0MDAxN2JlMyJ9.RH9JSGW07ZFzjcKwZXPBUScWurfpKjWmqpo-CgRFtAc" class="fr-fic fr-fil fr-dib" width="1966" style="width: 1968px; height: 542.897px;" height="543"></p><p><strong><span style="font-size: 10pt;">Fig 8. Meta Words on an article</span></strong></p><p><br></p><p>Now, this article will be returned higher in if the search string matches one of these meta words as well as another element of the article. </p><p><br></p><p><strong><span style="font-size: 14pt;">Search using Article IDs</span></strong></p><p>The ID of a knowledge base article can be found in the URL of the article when viewing this, as shown in Figure 9. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA2ZWM3NDk5LTI4MzUtNDFhZi1hMzYwLWEzZDIzNWE3ZWQzMyJ9.r6z1xzW2dW2fWvyoZIB34vs-fLhTVHrlb7_d_9UItFA" class="fr-fic fr-fil fr-dib" width="1150" style="width: 1152px; height: 648.577px;" height="649"></p><p><strong><span style="font-size: 10pt;">Fig 9. Article ID</span></strong></p><p><br></p><p>If you would like to be able to search articles using this ID, this can be enabled. Head to Configuration > Knowledge Base > toggle "Article ID Search Behaviour".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQxM2QwZjJiLTMzOWQtNGIzNC1hZmVkLTVkZjUwMDlmZDQ2MSJ9.TqhIP0WliSf7vScETKaL6l2dPTqA4zR6fj_GRtrKVqw" class="fr-fic fr-fil fr-dib" width="1940" style="width: 1942px; height: 487.282px;" height="487"></p><p><strong><span style="font-size: 10pt;">Fig 10. Article ID Search Behaviour</span></strong></p><p><br></p><p><strong>Don't Search Article IDs - </strong>IDs entered into the search will not return articles.</p><p><strong>Search Articles by ID and include other results -</strong> Article IDs entered into the search will return articles with this ID, articles that contain this numerical value in their searchable elements will also be returned. This cannot be used in conjunction with Knowledge Base Article Full-Text Searching.</p><p><strong>Only Return the Article with a matching ID if one exists -</strong> Article IDs entered into the search will return only the article with this ID. Articles that contain this numerical value in their searchable elements will not be returned.</p><p><br></p><p><strong><span style="font-size: 14pt;">Force an FAQ list to be Chosen before Returning Articles in the Search</span></strong></p><p>If you would like agents/users to be required to choose which FAQ list to search before articles are returned, you can enable this for your knowledge base. This is useful if you have a lot of content in your knowledge base and would like to encourage agents/users to only search within a chosen FAQ list, rather than searching the whole knowledge base. </p><p><br></p><p>To enable this for agents head to Configuration > Knowledge Base > enable "Select an FAQ list before searching Articles".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQwNjkwMjdlLWZmOWQtNGUwMC04NzUwLWEyMGFmOTE3ZWJjOCJ9.YbkIBVfNSiwVMMQyu3aiqwLxdUhj4awqYNEgctzTjx8" class="fr-fic fr-fil fr-dib" width="730" style="width: 732px; height: 350.123px;" height="350"></p><p><strong><span style="font-size: 10pt;">Fig 11. Select an FAQ list before searching Articles</span></strong></p><p><br></p><p>Once enabled, agents will be prompted to choose an FAQ list to search within after they have entered their search string, as shown in Figure 12. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFhNGM1MTQ3LTJhYmEtNGM5MC04YzA0LTI3ODA0ZmE4YWRlYyJ9.QikA8IUXfsRiZrlfYtjyOAPAGDRTt3w0rFd7qBQCnZs" class="fr-fic fr-fil fr-dib" width="2005" style="width: 2007px; height: 720.813px;" height="721"></p><p><strong><span style="font-size: 10pt;">Fig 12. Choose an FAQ list before articles are returned</span></strong></p><p><br></p><p data-pasted="true">To enable this for users head to Configuration > Knowledge Base > enable "Show the FAQ List selection tiles and FAQ List filter on the Self Service Portal Search Screen".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE3ZDEyNGYwLTkxMTYtNDBlZS05YjUzLTQ4MzFlNWI0OTMwZiJ9.lzSPt8RI7BkRbdI4OEF6314mD9wgrQzwXJLlQERby2U" class="fr-fic fr-fil fr-dib" width="775" style="width: 777px; height: 371.647px;" height="372"></p><p><strong><span style="font-size: 10pt;">Fig 13. Show the FAQ List selection tiles and FAQ List filter on the Self Service Portal Search Screen</span></strong></p><p><br></p><p data-pasted="true">Once enabled, users will be prompted to choose an FAQ list to search within after they have entered their search string, as shown in Figure 14. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRjN2QxNDI3LWYzYTYtNGNjOC04MjdjLTRjNGU5OWZhYmE2OSJ9.mOzf_Jemdg5vHp9zvt9cTptm3tfETdyTj8jYKNJc234" class="fr-fic fr-fil fr-dib" width="1913" style="width: 1915px; height: 512.973px;" height="513"></p><p><strong><span style="font-size: 10pt;">Fig 14. Choose an FAQ list before articles are searched (in the Portal)</span></strong></p><p><br></p><p>All the FAQ lists the agent/user has access to will appear as tiles, by default. If you would only like FAQ lists that contain a matched article to show/be selected enable "Hide FAQ tiles with no search matches" under Configuration > Knowledge Base. Keep in mind this setting only applies to searching in the portal. </p><p><br></p><p>If you would like to search the whole knowledge base rather than a specific FAQ list choose "All FAQ Lists". </p><p><br></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;">Filtering and searching on Custom Fields</span></strong></p><p><span style="font-size: 11pt;">Custom fields of types text, single-select, multi-select, and checkbox fields, which have been added to an FAQ list can be filtered and searched on. In order to filter on a Custom field you will need to ensure "</span>Hide this Field from the Agent search filters<span style="font-size: 11pt;">" is not selected in the details tab of your Custom Field. Now when searching for an Article you can use the Filters section to restrict which results show based on the contents of the Custom Field. </span></p><p><br></p><p><span style="font-size: 11pt;"><span style="font-size: 11pt;" data-pasted="true">Custom Fields using the "</span>Store a row for each field value<span style="font-size: 11pt;">" will be searchable without any additional set-up required. </span></span></p><p><br></p><p><span style="font-size: 11pt;">However, Custom Fields which use the "</span>Store as a column in the parent table<span style="font-size: 11pt;">" will need to be saved, and edited</span><span style="font-size: 11pt;"> again in order to see the "</span>Include this field in searches<span style="font-size: 11pt;">" option against the Custom Field.</span><span style="font-size: 11pt;"> Selecting this will allow you to search for the contents of this field. </span></p><p><br></p><p><span style="font-size: 11pt;">If you would like to search on Rich Text Custom Fields, and you are using Full text searching, you will need to enable the new setting "</span>Enable Full-Text Searching on Searchable Rich Text Custom Fields in FAQ Lists" in Configuration > Knowledge Base. With this enabled the contents of Rich Text Custom Fields can be searched for when looking for an Article. </p><p><br></p>
