...
This article contains information about the implementation of the searching process. The C# SDK exposes a method which can be used to make search requests to the Hawksearch API. All of these methods can be found in the HawksearchClient class.
Prerequisite
Info |
---|
Configured Connector - Configure HawksearchInstalled .NET SDK NuGet package |
Search
...
The Search method exposes a functionality to make search requests to the Hawksearch API.
SearchResult Search(SearchQuery query);
Parameters:
Expand |
---|
title | SearchQuery properties |
---|
|
Code Block |
---|
public string ClientGuid { get; set; }
public string IndexName { get; set; }
public string Keyword { get; set; }
public int PageNo { get; set; }
public int MaxPerPage { get; set; }
public string SortBy { get; set; }
public string CustomUrl { get; set; }
public string SortingSetCode { get; set; }
public string SearchWithin { get; set; }
public List<string> FacetOverride { get; set; }
public List<string> FieldOverride { get; set; }
public ClientData ClientData { get; set; }
public bool IsInPreview { get; set; }
public string ExplainDocId { get; set; }
public List<object> SmartBar { get; set; }
public bool BoostAndBury { get; set; }
public bool VisibilityRules { get; set; }
public bool PersonalizedBoost { get; set; }
public bool PopularityBoost { get; set; }
public bool ItemPin { get; set; }
public bool Is100CoverageTurnedOn { get; set; }
public Dictionary<string, List<object>> FacetSelections { get; set; } |
|
The SearchQuery
object should contain all the information needed to make the request to the Hawksearch API. The mandatory ones are ClientGuid
,IndexName
,Keyword
and FacetSelections
.
Returns:
The Hawksearch API responds with a message which is the mapped to an object of type SearchResult
...
Expand |
---|
|
Code Block |
---|
public Guid DocId { get; set; }
public long Score { get; set; }
public Dictionary<string, List<string>> Document { get; set; }
public Redirect BestFragments { get; set; }
public bool IsPin { get; set; } |
|
Usage
Call this method when you want to make search requests to the Hawksearch API.
Autocomplete
...
The Autocomplete method exposes a functionality for autocompleting search request depending on input.
Code Block |
---|
|
AutocompleteResult Autocomplete(AutocompleteQuery query) |
Parameters
This is the data which is expected in order to make a successful autocomplete request
Expand |
---|
title | AutocompleteQuery properties |
---|
|
Code Block |
---|
public string ClientGuid { get; set; }
public string Keyword { get; set; }
public string IndexName { get; set; }
public string Type { get; set; }
public long ProductCount { get; set; }
public bool DisplayFullResponse { get; set; }
public string[] FieldOverride { get; set; }
public ClientData ClientData { get; set; } |
|
The mandatory ones are ClientGuid
, Keyword
, IndexName
, DisplayFullResponse
.
Returns
The Hawksearch API returns a response message which is mapped to object of type AutocompleteResult
Expand |
---|
title | AutocompleteResult properties |
---|
|
Code Block |
---|
public long Count { get; set; }
public long ContentCount { get; set; }
public List<Category> Categories { get; set; }
public List<Product> Products { get; set; }
public List<object> Content { get; set; }
public List<object> Popular { get; set; }
public string SearchWebsiteUrl { get; set; }
public string KeywordField { get; set; }
public string CategoryHeading { get; set; }
public string ContentHeading { get; set; }
public string ProductHeading { get; set; }
public string PopularHeading { get; set; }
public string ViewAllButtonLabel { get; set; } |
|
The actual autocomplete results are mapped to a List<Product> Products
Expand |
---|
|
Code Block |
---|
public string ProductName { get; set; }
public string Thumb { get; set; }
public string Url { get; set; }
public string Html { get; set; }
public Result Results { get; set; } |
|
And the data for each result is mapped to an object of type Result
Expand |
---|
|
Code Block |
---|
public Guid DocId { get; set; }
public long Score { get; set; }
public Dictionary<string, List<string>> Document { get; set; }
public Redirect BestFragments { get; set; }
public bool IsPin { get; set; } |
|
Usage
Call this method when you want to enhance your UI by using the results from the Autocomplete method to display suggestions to your users.