Создание демонстрационного приложения поиска в Azure portal

Используйте демонстрационное приложение Create в Azure portal для создания скачиваемого веб-приложения в стиле localhost, работающего в браузере. В зависимости от того, как вы его настроите, созданное приложение готово к использованию при первом запуске, с активным подключением в режиме только для чтения к индексу в вашей поисковой службе. Приложение по умолчанию может включать в себя поле поиска, область результатов, фильтры боковой панели и поддержку автозаполнения.

Демонстрационное приложение позволяет визуализировать функции индекса в клиентском приложении, но он не предназначен для рабочих сценариев. Рабочие приложения должны включать в себя безопасность, обработку ошибок и логику размещения, которые отсутствуют в демонстрационном приложении.

Предварительные требования

• Учетная запись Azure с активной подпиской. Создание учетной записи бесплатно.

• Сервис поиска Azure ИИ. Создайте службу или найдите существующую службу в вашей текущей подписке. В этом примере можно использовать бесплатную службу.

• Индекс поиска, который станет основой создаваемого приложения. Мы используем пример индекса отелей для иллюстрации демонстрационного приложения.

Запуск мастера

Мастер создания демонстрационных приложений доступен для существующих индексов. Выберите индекс, включающий извлекаемые, фильтруемые и фасетные поля.

Чтобы запустить мастер, выполните следующие действия.

1. Перейдите в службу поиска в портал Azure.

2. В левой области выберите управление поиском>индексы.

3. Выберите hotels-sample из списка.

4. В верхней части страницы индекса выберите "Создать демонстрационную версию приложения".

5. Выберите "Включить CORS" и продолжайте добавлять поддержку CORS в определение индекса.

   

Настройка результатов поиска

Вы можете настроить базовый макет для отрисованных результатов поиска, включая пространство для изображения эскиза, заголовка и описания. Каждый элемент поддерживается полем в индексе, предоставляющим необходимые данные.

Чтобы настроить результаты поиска, выполните следующие действия.

1. Пропустите эскиз, так как в индексе hotels-sample нет URL-адресов изображений. Если индекс содержит поле, заполненное URL-адресами, разрешающими общедоступные изображения, следует указать это поле для эскиза.

2. Для заголовка выберите поле, которое передает уникальность каждого документа. В нашем примере используется HotelName.

3. В поле "Описание" выберите поле, которое может помочь кому-то решить, следует ли детализировать этот документ. В нашем примере используется описание.

4. Нажмите кнопку Далее.

   

Добавление боковой панели

Search service поддерживает фильтры и фасетную навигацию, которая часто отображается как боковая панель. Фасеты основаны на полях, указанных как фильтруемые и фасетируемые в схеме индекса.

Фильтры могут быть накопительными или вычитающими. Для нескольких фильтров одного поля, таких как несколько городов, разверните результаты поиска, чтобы включить все города. В полях несколько фильтров добавляют дополнительные критерии, которые должны соответствовать каждому документу, сужая результаты.

Чтобы настроить боковую панель, выполните следующие действия.

1. Просмотрите список фильтруемых и фасетных полей в индексе.

2. Чтобы сократить боковую панель и предотвратить прокрутку в готовом приложении, удалите некоторые поля.

3. Нажмите кнопку Далее.

   

Добавление предложений

Предложения — это автоматические запросы, которые отображаются в поле поиска. Демонстрационное приложение поддерживает предложения, которые предоставляют раскрывающийся список потенциальных подходящих документов на основе частичных текстовых входных данных.

Чтобы настроить предложения, выполните следующие действия.

1. Выберите поля, которые нужно отобразить в качестве предлагаемых запросов. Используйте более короткие строковые поля вместо подробных полей, таких как описания.

2. Установите флажок "Показать имя поля ", чтобы включить или исключить метки для предложений.

   

Создание, скачивание и выполнение

Чтобы завершить работу мастера и использовать демонстрационную версию приложения:

1. Нажмите кнопку "Создать демонстрационную версию приложения" , чтобы создать HTML-файл.

2. При появлении запроса выберите "Скачать ", чтобы скачать файл.

3. Откройте файл в браузере.

4. Нажмите кнопку поиска, чтобы запустить пустой запрос (*), который возвращает произвольный результирующий набор.

5. Введите термин в поле поиска и используйте фильтры боковой панели, чтобы сузить результаты. Выберите фильтры, чтобы сузить результаты.

   

6. Протестируйте предложения, введя часть поискового термина. Если вы не видите предложенные результаты, проверьте параметры браузера или попробуйте другой браузер. Обратите внимание, что предлагаемые результаты отличаются от автозаполнения термина поиска. Демонстрационная версия приложения поддерживает только предлагаемые результаты.

   

Очистка ресурсов

При работе с собственной подпиской рекомендуется завершить проект, удалив ресурсы, которые больше не нужны. Ресурсы, оставленные работающими, могут стоить вам денег.

В Azure portal выберите All resources или Resource groups на панели слева, чтобы найти ресурсы и управлять ими. Вы можете удалить ресурсы по отдельности или удалить группу ресурсов, чтобы удалить все ресурсы одновременно.

Если вы используете бесплатный search service, помните, что вы ограничены тремя индексами, индексаторами и источниками данных. Вы можете удалить отдельные элементы на портале, чтобы остаться в пределах ограничения.

Следующий шаг

Демонстрационная версия приложения полезна для создания прототипов, так как она имитирует взаимодействие с конечным пользователем, не требуя кода JavaScript или внешнего интерфейса. При подходе к этапу подтверждения концепции собственного проекта просмотрите комплексные примеры кода, которые более точно соответствуют реальному приложению.