👁 Image
Kentico.Xperience.AzureSearch 8.0.3

Xperience by Kentico Azure Search

👁 7-day bug-fix policy
👁 CI: Build and Test
👁 NuGet Package

Description

This integration enables you to create AzureSearch search indexes to index content of pages (content types with the 'Page' feature enabled) from the Xperience content tree using a code-first approach. To provide a search interface for the indexed content, developers can use the .NET API, JavaScript API library.

Library Version Matrix

Dependencies

• ASP.NET Core 8.0
• Xperience by Kentico
• Azure AI Search

Package Installation

Add the package to your application using the .NET CLI

dotnet add package Kentico.Xperience.AzureSearch

Quick Start

1. Add configuration from your Azure portal to the ASP.NET Core appsettings.json file:

   "CMSAzureSearch": {
    "SearchServiceEndPoint": "<your application url>",
    "SearchServiceAdminApiKey": "<your application admin key>",
    "SearchServiceQueryApiKey": "<your application query key>",
   
    // Opotionally add delay between indexing items.
    // This is useful if there are a lot of pages and items on your web which when crawled would increase the performance requirements.
    "IndexItemDelay" : 0
   }
   

2. Define a custom BaseAzureSearchIndexingStrategy<TSearchModel> implementation to customize how content pages/content items are processed for the index. See

3. Add this library to the application services, registering your custom BaseAzureSearchIndexingStrategy with type parameter GlobalSearchModel and Azure search services

   // Program.cs
   services.AddKenticoAzureSearch(builder =>
    {
    builder.RegisterStrategy<GlobalAzureSearchStrategy, GlobalSearchModel>("DefaultStrategy");
    }, configuration);
   

4. Create an index in Xperience's Administration within the Search application added by this library.

5. Rebuild the index in Xperience's Administration within the Search application added by this library.

6. Display the results on your site with a Razor View 👍.

Use DancingGoat sample

To use the DancingGoat sample project, you need to create a new Xperience by Kentico database using the included template.

Follow the instructions in the guide to set up the sample database.

Full Instructions

View the for more detailed instructions.

Contributing

To see the guidelines for Contributing to Kentico open source software, please see Kentico's CONTRIBUTING.md for more information and follow the Kentico's CODE_OF_CONDUCT.

Instructions and technical details for contributing to this project can be found in .

License

Distributed under the MIT License. See for more information.

Support

👁 7-day bug-fix policy

This project has Full support by 7-day bug-fix policy.

See SUPPORT.md for more information.

For any security issues see SECURITY.md.