Поделиться через

Глава 6. Использование веб-API в приложении

Мария и Киана готовы объединить приложение с веб-API. Однако, прежде чем продолжить, они решают проконсультироваться с Прити, менеджером по ИТ-операциям.

Общие сведения о требованиях к управлению ИТ-операциями для веб-API

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

Киана объясняет Прити, что веб-API в настоящее время реализован с помощью службы приложений Azure. Эта служба поддерживает ряд поставщиков аутентификации, которые Прити может настроить с помощью портала Azure. Прити особенно заинтересована в Microsoft Entra ID, потому что компания VanArsdel в ближайшем будущем планирует развернуть эту форму аутентификации во многих других своих корпоративных системах.

Конфигурация аутентификации службы приложений.

Служба приложений также обеспечивает горизонтальную и вертикальную масштабируемость. При необходимости Прити может масштабировать ресурсы, доступные веб-API, обновив план службы приложений для веб-приложения:

Масштабирование службы приложений.

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

Расширение службы приложений.

Ключевой частью роли менеджера ИТ-операций является наблюдение за тем, как могут развиваться системы, и обеспечение того, чтобы базовые структуры поддержки справились с будущим расширением и изменениями. Прити знает, что веб-API, разработанный Кианой, может быть расширен и повторно использован другими системами компании VanArsdel в будущем. Прити должна иметь возможность управлять и контролировать то, как разработчики запрашивают использование веб-API, защищать его как ценный ресурс и контролировать его использование. Поэтому Прити решает защитить веб-API, поместив его за службой управления API Azure.

Управление API обеспечивает дополнительный уровень безопасности веб-API, а также позволяет осуществлять подробный мониторинг и контроль над тем, какие клиенты могут получить доступ к каким операциям. Используя управление API, Прити может управлять использованием ресурсов и регулировать производительность клиентов с низким приоритетом, чтобы обеспечить более быстрое обслуживание критически важных приложений с более высоким приоритетом.

Для получения информации об услугах, которые предоставляет управление API, перейдите в раздел Сведения об управлении API.

Создание службы управления API

Прити создала службу управления API через портал Azure, выполнив следующие действия:

  1. Войдите в портал Azure и на страницу Главная, выберите Создать ресурс.

    Главная страница портала Azure.

  2. В текстовом поле Найти на MarketPlace введите Управление API, затем выберите Ввод.

  3. На странице Управление API выберите Создать.

    Страница создания службы управления API Azure.

  4. На странице Создать управление API введите следующие значения, затем выберите Обзор + создание:

    • Подписка: выберите свою подписку
    • Группа ресурсов: webapi_rg (это та же группа ресурсов, которую вы создали для службы приложений)
    • Регион: выберите ближайший к вам регион
    • Имя ресурса: введите уникальное имя для службы
    • Название организации: VanArsdel
    • Адрес электронной почты администратора: itadmin@vanarsdel.com
    • Ценовая категория: Разработчик (без SLA)

    Заметка

    Не используйте ценовую категорию Разработчик для производственной системы.

    Страница создания службы управления API.

  5. На странице проверки выберите Создать и дождитесь создания службы управления API.

    Заметка

    Подготовка службы управления API может занять 30 минут или больше; проявите терпение.

Публикация веб-API через управление API

После создания службы управления API Прити опубликовала веб-API, чтобы сделать его доступным для других служб и приложений, выполнив следующие действия:

  1. На портале Azure перейдите в службу управления API.

  2. На странице Служба управления API на левой панели в разделе API-интерфейсы выберите API-интерфейсы:

    Страница службы управления API. Выберите API.

  3. В области Добавить новый API выберите OpenAPI:

    Страница службы управления API. Выберите OpenAPI.

  4. В диалоговом окне Создать из спецификации OpenAPI введите следующие значения, а затем нажмите кнопку Создать:

    • Спецификация OpenAPI: https://<webapp name>.azurewebsites.net/swagger/v1/swagger.json, где <webapp name> является именем службы приложений, в которой размещен ваш веб-API
    • Отображаемое имя: API инженера выездного обслуживания
    • Имя: field-engineer-api
    • Суффикс URL-адреса API: оставьте пустым
    • Базовый URL-адрес: используйте URL-адрес по умолчанию

    Создайте API из спецификации OpenAPI.

  5. Когда API инженера выездного обслуживания был создан, выберите вкладку Параметры для API, установите для параметра URL-адрес веб-службы значение https://<webapp name>.azurewebsites.net, затем выберите Сохранить:

    Настройка параметров API.

  6. На вкладке Тест выберите GET api/Appointments URI, затем выберите Отправить:

    Тестирование API GetAppointments.

  7. Убедитесь, что запрос выполнен успешно (код возврата HTTP: 200 ОК), и что он возвращает результат, содержащий список встреч в теле ответа:

    Ответ от тестирования API GetAppointments.

Подключение к управлению API из приложения

Киана и Мария теперь могут работать вместе, чтобы подключить приложение, созданное с помощью Power Apps, к веб-API через службу управления API.

Первая задача — создать настраиваемый соединитель, который будет использоваться приложением для взаимодействия с управлением API. Это включает экспорт API в среду Power Apps, используемую для создания приложения, что Киана делает следующим образом:

  1. На портале Azure перейдите на страницу службы управления API, созданной Прити.

  2. На левой панели в разделе API-интерфейсы выберите API-интерфейсы.

  3. Нажмите кнопку с многоточием для API инженера выездного обслуживания, а затем выберите Экспорт.

    Экспорт веб-API.

  4. На панели Экспорт API выберите Power Apps и Power Automate:

    Экспорт веб-API в Power Apps.

  5. На панели Экспорт API в PowerApps выберите среду Power Apps, в которой вы создали прототип приложения (Мария на следующем изображении), затем выберите Экспорт.

    Экспорт в среду Power Apps Марии.

  6. После экспорта API выберите API инженера выездного обслуживания. На странице Параметры прокрутите вниз до раздела Подписки, очистите Требуется подписка, затем выберите Сохранить.

    Снятие флажка «Требуется подписка».

В качестве источников данных в прототипе приложения использовались книги Excel. Теперь, когда доступен настраиваемый соединитель для веб-API, Мария выполняет следующие шаги, чтобы добавить соединитель в приложение:

  1. Выполните вход в Power Apps.

  2. В левой области разверните Данные и выберите Настраиваемые соединители. Должен быть указан настраиваемый соединитель field-engineer-api. Выберите Создать подключение.

    Создание нового пользовательского соединителя.

  3. В диалоговом окне field-engineer-api выберите Создать.

    Создание соединителя FieldEngineerAPI.

  4. После создания подключения убедитесь, что оно отображается в списке доступных подключений.

    Отображение доступных подключений.

  5. На левой панели выберите Приложения, выберите VanArsdelApp, затем выберите Изменить.

    Изменить приложение VanArsdel.

  6. На левой панели выберите вкладку Данные. Выберите Добавить данные, выберите кнопку с многоточием для Соединители, затем выберите Обновить.

    Обновление источников данных.

  7. В списке соединителей выберите соединитель field-engineer-api.

    Просмотр соединителей.

  8. В диалоговом окне field-engineer-api выберите соединитель field-engineer-api.

    Добавление соединителя FieldEngineerAPI.

  9. На панели Данные убедитесь, что указан соединитель FieldEngineerApi.

    Соединитель FieldEngineerAPI добавлен.

Обновление приложения для использования соединителя: управление запасами для выездного обслуживания

Теперь, когда подключение было добавлено в приложение, Мария может изменить экраны, чтобы использовать его для замены книг Excel. Это включает в себя методическую проработку каждого экрана и изменение источника данных. Никаких других изменений не требуется. Мария начинает с экранов BrowseParts и PartDetails, как показано ниже:

  1. На экране Главный приложения выберите кнопку Запчасти. Задайте для свойства действия OnSelect следующую формулу.

    ClearCollect(partsCollection, FieldEngineerAPI.getapiboilerparts());

Navigate(BrowseParts, ScreenTransition.Fade)

    Функция ClearCollect создает новую коллекцию с именем partsCollection и заполняет ее данными, полученными в результате вызова операции getboilerparts в подключении FieldEngineerAPI.

    Создание переменной partsCollection.

    Заметка

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

  2. Выберите F5 для предварительного просмотра приложения.

  3. На экране Главный выберите Запчасти. Это действие создаст коллекцию partsCollection. Закройте окно предварительного просмотра и вернитесь в Power Apps Studio.

    Заметка

    Цель этого шага — позволить вам видеть данные, пока вы редактируете экран BrowseParts в следующих шагах.

  4. Выберите элемент управления BrowseGallery1 на экране BrowseParts. В формуле для свойства Элементы замените ссылку на источник данных [@Table1] на partsCollection.

    Это изменение приведет к некоторым ошибкам. Это связано с тем, что в именах полей в исходной книге Excel использовались заглавные буквы (Name, CategoryID и Overview), тогда как в именах свойств, возвращаемых в теле ответа веб-API, используются строчные буквы. Измените эти ссылки, чтобы использовать строчные буквы. Формула должна выглядеть следующим образом.

    SortByColumns(Search(FieldEngineerApi.getapiboilerparts(), TextSearchBox1.Text, "name", "categoryId", "overview"), "name", If(SortDescending1, Descending, Ascending))

    Обновите формулу для экрана обзора.

  5. На панели Представление в виде дерева выберите элемент управления IconRefresh1. Измените действие OnSelect на формулу ClearCollect(partsCollection, FieldEngineerAPI.getapiboilerparts()).

    Заметка

    Исходная формула для этого действия вызывает функцию Refresh для повторного заполнения данных с помощью подключения к исходному источнику данных. Вы не можете использовать функцию Refresh с подключением, которое запускает функцию для извлечение данных, поэтому она не будет работать с FieldEngineerApi.getapiboilerparts(). Решение на этом этапе повторно заполняет коллекцию partsCollection новейшими данными.

  6. На панели Представление в виде дерева разверните элемент управления BrowseGallery1 и выберите элемент управления Body1. Измените свойство Текст на ThisItem.overview.

  7. На панели Представление в виде дерева выберите элемент управления Subtitle1. Измените свойство Текст на ThisItem.categoryId.

  8. На панели Представление в виде дерева выберите элемент управления Title. Измените свойство Текст на ThisItem.name.

  9. На панели Представление в виде дерева выберите элемент управления DetailForm1 на экране PartDetails. Измените свойство DataSource с [@Table1] на partsCollection.

  10. На панели Представление в виде дерева выберите элемент управления Name_DataCard1 в разделе DetailForm1. Измените свойство По умолчанию на ThisItem.name.

    Изменение значения по умолчанию для карточки данных имени.

  11. Измените свойство По умолчанию элемента управления CategoryID_DataCard1 на ThisItem.categoryId.

  12. Измените свойство По умолчанию элемента управления Overview_DataCard1 на ThisItem.overview.

  13. Измените свойство По умолчанию элемента управления Price_DataCard1 на ThisItem.price.

  14. Измените свойство По умолчанию элемента управления NumberInStock_DataCard1 на ThisItem.numberInStock.

  15. Измените свойство По умолчанию элемента управления Image_DataCard1 на ThisItem.imageUrl.

  16. На левой панели на вкладке Данные щелкните правой кнопкой мыши подключение данных Table1, затем выберите Удалить, чтобы удалить его из приложения. Это подключение больше не требуется.

    Удалите подключение Table1.

  17. Сохраните приложение.

    Заметка

    Вы можете быстро сохранить приложение, не используя меню Файл, выбрав Ctrl+S.

  18. Выберите F5 для предварительного просмотра приложения. Экраны Обзор запчастей и Сведения о запасных частях должны работать точно так же, как и раньше, за исключением того, что на этот раз они получают данные из базы данных SQL Azure InventoryDB через веб-API, а не из локального файла Excel.

  19. Закройте окно предварительного просмотра и вернитесь в Power Apps Studio.

Обновление приложения для использования соединителя: планирование и заметки для выездного обслуживания

Мария продолжает с экранами BrowseAppointments, AppointmentDetails и EditAppointment. Данные, представленные на этих экранах, в настоящее время происходят из таблицы Встречи в другой книге Excel.

  1. На экране Главный приложения установите для действия OnVisible следующую формулу.

    ClearCollect(appointmentsCollection, Sort(Filter(FieldEngineerAPI.getapiappointments(), DateDiff(Today(), startDateTime) >= 0), startDateTime))

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

  2. Выберите элемент управления "подпись", который отображает время следующей встречи. Установите для свойства Текст значение Text(First(appointmentsCollection).startDateTime, ShortTime24).

  3. Выберите элемент управления "подпись", который отображает дату для следующей встречи. Установите для свойства Текст значение Text(First(appointmentsCollection).startDateTime, LongDate).

  4. Выберите элемент управления меткой, который отображает имя клиента для следующей встречи. Установите для свойства Текст значение First(appointmentsCollection).customer.name.

  5. Выберите F5 для предварительного просмотра приложения. На экране Главный выберите Встречи. Это действие создаст коллекцию appointmentsCollection. Закройте окно предварительного просмотра и вернитесь в Power Apps Studio.

  6. На панели Представление в виде дерева выберите элемент управления BrowseAppointmentsGallery на экране BrowseAppointments. Измените формулу в свойстве Элементы на следующую формулу.

    Sort(Filter(appointmentsCollection, StartsWith(customer.name, TextSearchBox1\_1.Text)), startDateTime)

    Эта формула фильтрует данные, отображаемые на экране, по имени клиента, позволяя пользователю ввести имя клиента. Встречи отображаются в порядке даты и времени.

  7. На панели Представление в виде дерева разверните элемент управления BrowseAppointmentsGallery и выберите элемент управления Title1_1. Измените свойство Текст следующим образом.

    Text(ThisItem.startDateTime, LongDate)

    Эта формула отображает часть даты в поле startDateTime для встречи.

  8. На панели Представление в виде дерева разверните элемент управления BrowseAppointmentsGallery и выберите элемент управления Subtitle1_1. Измените свойство Текст следующим образом.

    Text(ThisItem.startDateTime, ShortTime24)

Эта формула отображает элемент времени поля startDateTime.

  1. На панели Представление в виде дерева разверните элемент управления BrowseAppointmentsGallery и выберите элемент управления Body1_1. Измените свойство Текст следующим образом.

    ThisItem.customer.name

  2. На панели Представление в виде дерева выберите элемент управления IconRefresh1_1 на экране BrowseAppointments. Задайте для действия OnSelect следующую формулу.

    ClearCollect(appointmentsCollection, Sort(Filter(FieldEngineerAPI.getapiappointments(), DateDiff(Today(), startDateTime) >= 0), startDateTime));

  3. На панели Представление в виде дерева разверните экран AppointmentDetails и выберите элемент управления DetailForm1_1. Задайте для свойства DataSource значение appointmentsCollection.

  4. На панели Представление в виде дерева выберите элемент управления IconEdit1. Измените формулу в свойстве DisplayMode для проверки коллекции appoinmentsCollection.

    If(DataSourceInfo(**appointmentsCollection**, DataSourceInfo.EditPermission), DisplayMode.Edit, DisplayMode.Disabled)

  5. На панели Представление в виде дерева разверните экран DetailForm1_1 и выберите элемент управления Customer Name_DataCard1. Измените свойство По умолчанию на ThisItem.customer.name.

  6. Измените свойства По умолчанию остальных карточек данных следующим образом:

    • Customer Address_DataCard1: ThisItem.customer.address
    • Contact Number_DataCard1: ThisItem.customer.contactNumber
    • Problem Details_DataCard1: ThisItem.problemDetails
    • Status_DataCard1: ThisItem.appointmentStatus.statusName
    • Notes_DataCard1: ThisItem.notes
    • Image_DataCard1_1: ThisItem.imageUrl

  7. На панели Представление в виде дерева разверните экран EditAppointment и выберите элемент управления EditForm1. Задайте для свойства DataSource значение appointmentsCollection.

  8. На панели Представление в виде дерева разверните элемент управления EditForm1 и выберите элемент управления Customer Name_DataCard3. Измените свойство По умолчанию на ThisItem.customer.name.

  9. Измените свойства По умолчанию остальных карточек данных следующим образом:

  • Contact Number_DataCard2: ThisItem.customer.contactNumber; кроме того, измените значение свойства MaxLength на 20
  • Problem Details_DataCard2: ThisItem.problemDetails
  • Status_DataCard5: ThisItem.appointmentStatus.statusName
  • Notes_DataCard3: ThisItem.notes
  • Image_DataCard2: ThisItem.imageUrl

  1. На панели Представление в виде дерева разверните элемент управления Problem Details_Card2. Переименуйте поле DataCardValueX (X будет числом) под этим элементом управления в ProblemDetailsValue. Повторите этот процесс для элементов управления DataCardValueX в следующих карточках данных:

    • Status_DataCard5: StatusValue
    • Notes_DataCard3: NotesValue

    Заметка

    Элемент управления изображением будет рассмотрен в следующей главе.

  2. Выберите ProblemDetailsValue и установите для свойства MaxLength значение 100.

  3. На панели Представление в виде дерева выберите элемент управления IconAccept1 на экране EditAppointment. Задайте для свойства действия OnSelect следующую формулу.

    FieldEngineerAPI.putapiappointmentsid(BrowseAppointmentsGallery.Selected.id, {problemDetails:ProblemDetailsValue.Text, statusName:StatusValue.Selected.Value, notes:NotesValue.Text, imageUrl:""});

Remove(appointmentsCollection, First(Filter(appointmentsCollection, id=BrowseAppointmentsGallery.Selected.id)));

Set(appointmentRec, FieldEngineerAPI.getapiappointmentsid(BrowseAppointmentsGallery.Selected.id));

Collect(appointmentsCollection, appointmentRec);

Navigate(AppointmentDetails, ScreenTransition.None);

    Эта формула вызывает операцию PUT для контроллера "Встречи" в веб-API. Она передает идентификатор текущей встречи в качестве первого параметра, за которым следуют сведения, которые пользователь мог изменить на экране. Сведения передаются в виде объекта JSON. Операторы Remove, Set и Collect обновляют коллекцию appointmentsCollection с использованием данных, сохраненных в базе данных.

    Заметка

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

  4. На панели Представление в виде дерева выберите элемент управления IconAccept1 на экране EditAppointment. Задайте для свойства действия OnSelect следующее.

    ResetForm(EditForm1);

Navigate(AppointmentDetails, ScreenTransition.None);

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

  6. Сохраните приложение.

  7. Выберите F5 для предварительного просмотра приложения. С экрана Главный перейдите на экран Встречи, выберите и отредактируйте встречу, затем сохраните изменения. Убедитесь, что встреча была обновлена.

  8. Закройте окно предварительного просмотра и вернитесь в Power Apps Studio.

Создание службы когнитивного поиска Azure для базы знаний для выездного обслуживания

Экран базы знаний в приложении в настоящее время не привязан ни к какому источнику данных. Веб-API включает операции для запроса и обновления таблиц Советы, BoilerParts и Инженеры в базе данных KnowledgeDB. Однако экран Запрос в приложении предназначен для поддержки поиска по всем этим таблицам. Объем данных в этих таблицах, вероятно, быстро увеличится, поэтому Мария, Киана и Прити решают развернуть когнитивный поиск Azure для поддержки этой функции. Приложение может отправлять запросы и получать результаты из когнитивного поиска Azure через настраиваемый соединитель.

Когнитивный поиск Azure работает лучше всего, если данные для поиска содержатся в одной сущности базы данных. Киана создает представление в базе данных KnowledgeDB, которое представляет собой единое представление таблиц Советы, BoilerParts и Инженеры, а именно:

  1. На портале Azure перейдите на страницу База данных SQL KnowledgeDB.

  2. На левой панели выберите Редактор запросов и войдите в базу данных как sqladmin, используя пароль Pa55w.rd.

    Вход в базу данных SQL Azure.

  3. В окне запроса введите следующую инструкцию, затем выберите Выполнить.

    CREATE OR ALTER VIEW [dbo].[Knowledge] AS
SELECT T.Id, T.Subject, T.Body, B.Name, B.Overview
FROM [dbo].[Tips] T INNER JOIN [dbo].[BoilerParts] B
ON B.Id=T.KnowledgeBaseBoilerPartId

    Создание представления

    Убедитесь, что представление Knowledge было успешно создано.

  4. В левой области выберите Строки подключения. Запишите строку подключения ADO.NET; она вам понадобится при настройке когнитивного поиска Azure.

    Строка подключения ADO.NET к базе данных KnowledgeDB.

Работая с Кианой, Прити настраивает новый экземпляр службы когнитивного поиска Azure для выполнения поиска в строках в представлении Knowledge, а именно:

  1. На странице Главная на портале Azure выберите + Создать ресурс, введите Когнитивный поиск Azure, выберите Ввод, затем выберите Создать.

    Создание службы когнитивного поиска Azure.

  2. На странице Создать службу поиска введите следующие параметры, затем выберите Обзор + создание:

    • Подписка: выберите свою подписку Azure
    • Группа ресурсов: webapi_rg
    • Имя службы: введите уникальное имя для службы
    • Имя расположения: выберите ближайший к вам регион
    • Ценовая категория: Бесплатно

  3. На странице проверки выберите Создать и дождитесь завершения подготовки службы.

  4. Перейдите на страницу новой службы поиска, выберите Обзор, запишите URL-адрес (он понадобится вам позже, когда вы создадите настраиваемый соединитель для Power Apps), затем выберите Импортировать данные.

    Страница обзора службы поиска.

  5. На странице Импортировать данные в раскрывающемся поле списка Источник данных выберите База данных SQL Azure.

    Выберите базу данных SQL Azure.

  6. На странице Подключитесь к своим данным укажите следующие параметры:

    • Источник данных: База данных SQL Azure
    • Имя источника данных: knowledgebase
    • Строка подключения: введите строку подключения к базе данных SQL Azure для базы данных KnowledgDB, которую вы записали ранее; в этой строке обязательно установите пароль Pa55w.rd
    • Оставьте для полей ИД пользователя и Пароль значения по умолчанию; эти элементы извлекаются из строки подключения

  7. Выберите Проверить подключение. Убедитесь, что проверка прошла успешно, выберите [Knowledge] в раскрывающемся поле списка Таблица/представление, затем выберите Далее: добавить когнитивные навыки (необязательно).

    Укажите представление поиска.

  8. На странице Добавить когнитивные навыки (необязательно) выберите Перейти к: Настройка целевого индекса.

  9. На странице Настройка целевого индекса выберите Извлекаемый для всех столбцов и Поддерживает поиск для Тема, Основной текст, Имя и Обзор. Выберите Далее: Создание индексатора.

    Настройка целевого индекса.

  10. На странице Создание индексатора измените индексатор Имя на knowledgebase-indexer. Для параметра Расписание выберите Ежечасно, установите для параметра Столбец верхнего предела значение ИД, затем выберите Отправить:

    Создание индексатора.

  11. Чтобы протестировать индексатор, на странице Обзор для службы поиска выберите Обозреватель поиска:

    Выберите обозреватель поиска.

  12. В поле Запросстрока введите слово для поиска в базе знаний, затем выберите Поиск. Служба поиска должна сгенерировать список документов с совпадением в полях Тема, Основной текст, Имя или Обзор и показать их на панели Результаты. Запишите URL-адрес запроса и образец Результаты; вам понадобятся эти элементы позже в качестве примера запроса и ответа при настройке настраиваемого соединителя Power Apps.

    Результаты поискового запроса.

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

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

  1. Выполните вход в Power Apps.

  2. В левой области разверните Данные и выберите Настраиваемые соединители. На правой панели выберите + Новый пользовательский соединитель, затем выберите Создать с нуля:

    Новый настраиваемый соединитель.

  3. В диалоговом окне Создать с нуля для нового соединителя имя VanArsdelKBConnector, затем выберите Продолжить:

    Создание соединителя базы знаний.

  4. На странице Общая информация введите описание и установите для параметра Схема значение HTTPS. В поле Узлы введите URL-адрес вашей поисковой службы (вы записали этот URL-адрес ранее), но без префикса https://, затем выберите Безопасность.

    Страница общих сведений соединителя службы поиска.

  5. На странице Безопасность в раскрывающемся списке Аутентификация выберите Ключ API. В поле Метка параметра введите api-key. В поле Имя параметра введите api-key. Выберите Определение.

    Страница безопасности соединителя службы поиска.

  6. На странице Определение выберите Создать действие. В поле Сводка введите Запрос. В поле Описание введите Запросить базу знаний. В поле ИД операции введите Запрос. В разделе Запрос выберите + Импорт из образца.

    Страница определения соединителя службы поиска.

  7. В диалоговом окне Импорт из образца введите следующие значения, затем выберите Импорт:

    • Команда: GET
    • URL-адрес: укажите URL-адрес примера запроса, который вы записали ранее при тестировании службы поиска в проводнике поиска
    • Заголовки: Content-type

    Импорт определения из образца запроса.

  8. Вернувшись на страницу Определение прокрутите вниз до раздела Запрос, выберите кнопку с многоточием рядом с пунктом поиск, затем выберите Изменить.

    Изменение определения поискового запроса.

  9. На экране редактирования в разделе Параметры в поле Значение по умолчанию введите звездочку (*). В остальных полях оставьте значения по умолчанию, затем выберите Назад.

    Задание значение по умолчанию для поиска.

  10. На странице Определение в разделе Запрос выберите кнопку с многоточием рядом с пунктом api-version, затем выберите Изменить.

    Изменение версии API.

  11. На экране редактирования в разделе Параметры в поле Значение по умолчанию введите 2020-06-30-Preview (это версия, связанная с текущей версией когнитивного поиска Azure; вы можете увидеть версию в URL-адресе запроса, который вы записали ранее). Установите для параметра Является обязательным значение Да и установите для параметра Видимость значение внутренняя. В остальных полях оставьте значения по умолчанию, затем выберите Назад.

    Установите значения API для параметров поиска.

  12. На странице Определение прокрутите вниз до раздела Ответ и выберите + Добавить ответ по умолчанию.

    Определение добавления ответа по умолчанию. ]

  13. В диалоговом окне Импортировать из образца в поле Заголовки введите текст Content-type. В поле Основной текст введите примеры результатов, которые вы записали при тестировании службы поиска, затем выберите Импортировать.

    Импорт ответного сообщения из образца.

  14. На странице Определение выберите ответ по умолчанию.

    Выберите ответ по умолчанию.

  15. В поле Описание ответа Content-type введите application/json, затем выберите Назад.

    Установка содержимого заголовка ответного сообщения.

    Заметка

    Раздел Основной текст на этой странице должен отображать поля ответа, такие как Основной текст, ИД, Имя, Обзор и Тема, если он был успешно проанализирован.

  16. Выберите Создать соединитель.

    Создание соединителя когнитивного поиска Azure.

Соединитель должен быть создан без каких-либо сообщений об ошибках или предупреждений.

Обновление приложения для использования когнитивного поиска Azure: база знаний для выездного обслуживания

Теперь Мария может использовать настраиваемый соединитель в приложении. Но сначала Марии нужен ключ, который дает права, необходимые для подключения к службе когнитивного поиска Azure. Прити получает ключ со страницы Ключи на портале Azure и передает его Марии.

Ключ службы поиска на портале Azure.

Мария редактирует приложение в Power Apps Studio и выполняет следующие задачи:

  1. Откройте приложение VanArsdelApp для редактирования.

  2. В меню Вид выберите Источники данных, затем выберите Добавить данные.

    Добавление источника данных в приложение.

  3. В поле Найти в разделе Выберите источник данных выберите Van. Соединитель VanArdelKBConnector должен быть указан.

    Поиск соединителя когнитивного поиска Azure.

  4. Выберите соединитель VanArdelKBConnector. На панели VanArdelKBConnector введите ключ, предоставленный Прити для службы поиска, затем выберите Подключить.

    Введите ключ API.

  5. В меню Файл сохраните и закройте приложение, затем откройте его снова. Вам может быть предложено разрешить использование настраиваемого соединителя при повторном открытии приложения.

    Заметка

    Этот шаг необходим для включения настраиваемого соединителя.

  6. На панели Представление в виде дерева разверните экран База знаний и выберите элемент управления TextSearchBox2. Введите следующую формулу для действия OnChange.

    If(!IsBlank(TextSearchBox2.Text), ClearCollect(azResult, VanArsdelKBConnector.Query({search: TextSearchBox2.Text}).value))

    Эта формула вызывает операцию Запрос настраиваемого соединителя для поиска элементов, соответствующих термину, который пользователь вводит в поле поиска. Результаты хранятся в коллекции с именем azResult.

  7. На панели Представление в виде дерева на экране База знаний выберите элемент управления BrowseGallery2. Задайте свойству Элементы значение azResult.

  8. Разверните элемент управления BrowseGallery2 и удалите элемент управления Image4.

  9. Выберите элемент управления Title2. Задайте следующие свойства:

    • Текст: ThisItem.Subject
    • X: 24
    • Ширина: Parent.TemplateWidth - 104

  10. Выберите элемент управления Subtitle2. Задайте для свойства Текст значение ThisItem.Body.

  11. Выберите F5 для предварительного просмотра приложения. На экране База знаний введите поисковый запрос, затем выберите Ввод. Должны отображаться соответствующие статьи из базы знаний.

    Запрос базы знаний в приложении.

    Заметка

    Экран сведений еще не создан, поэтому выбор значка > рядом со статьей не работает.

  12. Закройте окно предварительного просмотра и вернитесь в Power Apps Studio.

  13. На панели Представление в виде дерева щелкните правой кнопкой мыши экран PartDetails и выберите Дублировать экран. Это действие добавит в приложение еще один экран с именем PartDetails_1.

    Дублируйте экран PartDetails.

  14. На панели Представление в виде дерева переименуйте экран PartDetails_1 в KnowledgebaseDetails.

    Выберите элемент управления LblAppNameX на экране; установить для свойства Текст значение "Сведения о статье" (включая кавычки).

  15. На панели Представление в виде дерева выберите элемент управления DetailFormX на экране. Задайте следующие свойства:

    • Источник данных: azResult
    • Элемент: **BrowseGallery2.Selected**

    Заметка

    BrowseGallery2 — это коллекция обзора на экране База знаний. В вашем приложении эта коллекция может иметь другое имя.

  16. На панели Представление в виде дерева разверните форму DetailFormX, затем измените имена следующих элементов управления карточки данных:

    • Name_DataCard1_1: Name_DataCard
    • CategoryID_DataCard1_1: Subject_DataCard
    • Overview_DataCard1_1: Overview_DataCard
    • Price_DataCard1_1: Body_DataCard

  17. Удалите элементы управления NumberInStock_DataCard1_1 и Image_DataCard1_1.

  18. Выберите элемент управления Name_DataCard. Установите для свойства По умолчанию значение ThisItem.Name.

  19. Выберите элемент управления Subject_DataCard. Задайте следующие свойства:

    • Поле данных: "Тема"
    • Отображаемое имя: "Тема"
    • По умолчанию: ThisItem.Subject

  20. Выберите элемент управления Overview_DataCard. Установите для свойства По умолчанию значение ThisItem.Overview.

  21. Выберите элемент управления Body_DataCard. Задайте следующие свойства:

    • Поле данных: "Основной текст"
    • Отображаемое имя: "Основной текст"
    • По умолчанию: ThisItem.Body

  22. Выберите элемент управления DataCardValueX в элементе управления Body_DataCard. Задайте для свойства Текст значение Parent.Default.

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

    Экран ArticleDetails.

  24. Выберите стрелку назад в заголовке экрана. Измените свойство действия OnSelect на Navigate(Knowledgebase, ScreenTransition.None).

  25. На панели Представление в виде дерева выберите экран База знаний, затем выберите элемент управления BrowseGalleryX. Измените свойство действия OnSelect на Navigate(KnowledgebaseDetails, ScreenTransition.None). Это действие отображает экран сведений для статьи базы знаний, когда пользователь выбирает значок > для записи на экране обзора.

  26. Сохраните приложение.

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

  28. Закройте окно предварительного просмотра и вернитесь в Power Apps Studio.

Мария, Киана и Прити успешно включили в приложение веб-API и когнитивный поиск Azure.

НазадДалее