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

Установка соединителя Microsoft Call Quality для Power BI для использования шаблонов запросов панели мониторинга качества звонков

  • Статья
  • Применяется к:
    Microsoft Teams

Прежде чем использовать шаблоны запросов Power BI (PBIX-файлы) для панели мониторинга качества звонков Microsoft Teams (CQD), необходимо установить соединитель Качества вызовов Майкрософт для Power BI, используя файл MicrosoftCallQuality.pqx , включенный в загрузку.

Ознакомьтесь с статьей Использование Power BI для анализа данных CQD для Teams, чтобы узнать об этих шаблонах.

Убедитесь, что у вас есть правильная роль доступа CQD для доступа к отчетам Power BI.

Примечание.

Соединитель Качества звонков (Майкрософт) поддерживает DirectQuery только в Power BI. Режим импорта не поддерживается.

Установка

Процесс установки пользовательского соединителя и настройки безопасности для включения использования соединителя подробно описан в документации по Power BI. Для простоты, вот краткое объяснение:

  1. Проверьте, есть ли на компьютере папка [Documents]\Power BI Desktop\Custom Connectors. Если нет, создайте эту папку. 1

  2. Скачайте файл соединителя (файл *.mez или *.pqx ) и поместите его в каталог Пользовательские соединители .

  3. Если файл соединителя является файлом *.mez , необходимо также настроить параметры безопасности, как описано в документации по настройке настраиваемого соединителя.

Если выпущена новая версия соединителя Microsoft Call Quality, замените старый файл соединителя в каталоге Настраиваемые соединители новым файлом.

Клиентам в облачных средах для государственных организаций (GCC, GCC-H, DoD) необходимо установить соединитель с локальным шлюзом данных для обеспечения совместимости со службой Power BI. Без локального шлюза облачные клиенты для государственных организаций могут использовать соединитель качества звонков (Майкрософт) только в Power BI Desktop.

Установка

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

  1. На вкладке Главная Power BI Desktop выберите Получить данные.

    Получение данных в соединителе Power BI.

  2. На этом этапе должно появиться окно Получить данные . Перейдите в раздел Веб-службы, выберите Microsoft Call Quality (бета-версия) и нажмите кнопку Подключить.

    Качество вызовов (Майкрософт) в соединителе Power BI.

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

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

  5. В последнем запросе отображается вся модель данных для панели мониторинга качества звонков. На этом этапе данные не отображаются, только модель данных для CQD. Выберите Загрузить , чтобы завершить процесс установки.

  6. На этом этапе Power BI загружает модель данных в правой части окна. В противном случае страница остается пустой и по умолчанию запросы не загружаются. Сведения о создании запроса и возврате данных см. в разделе Создание запросов.

Если какие-либо действия во время этого процесса установки не ясны, вы можете найти более подробное описание процесса в статье Краткое руководство. Подключение к данным в Power BI Desktop.

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

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

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

    Область визуализаций в соединителе Power BI.

  2. Определите, какие измерения и меры (обозначаемые символом агрегирования по их имени), которые вы хотите использовать для запроса. Затем вручную выберите эти измерения и меры и перетащите их на черную визуализацию. Кроме того, перетащите их в поле Значения под параметрами визуализации.

    Запрос визуализаций в соединителе Power BI.

    Важно!

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

  3. Затем выберите все измерения, по которым требуется отфильтровать, и перетащите их в поле Фильтры этого визуального элемента в области Фильтры . Соединитель качества звонков (Майкрософт) в настоящее время поддерживает фильтрацию "Базовый" (выбор значений из списка возможных значений измерений), расширенную фильтрацию (вручную указывать значения и операнды для фильтрации, аналогично панели мониторинга качества звонков) и фильтрацию относительных дат (доступна только для измерений времени окончания и времени начала ). Панель мониторинга качества звонков не поддерживает фильтрацию в соответствии с top N.

    Фильтры визуализаций в соединителе Power BI.

    Важно!

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

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

    Примечание.

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

Создание отчета детализации

Детализация в Power BI позволяет создавать ориентированные отчеты, которые можно быстро фильтровать, используя значения других отчетов в качестве контекста. Как только вы узнаете, как создать свой первый запрос с помощью соединителя Microsoft Call Quality, создать детализацию будет еще проще.

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

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

    Детализация в соединителе Power BI.

  3. Вот и все! Любой другой запрос на другой странице, использующий это измерение, теперь может детализировать на этой странице, автоматически применяя значение измерения детализации в качестве фильтра.

    Фильтр детализации в соединителе Power BI.

В отличие от панели мониторинга качества вызовов, Power BI поддерживает не последовательную детализацию. Если запрос содержит необходимое измерение, он может детализировать любую другую страницу.

Рекомендация

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

Ограничения

Соединитель качества вызовов (Майкрософт) поддерживает не все функции Power BI из-за ограничений модели данных панели мониторинга качества звонков или соединителей DirectQuery в целом. В приведенном ниже списке отмечаются некоторые из более примечательных ограничений соединителя, но этот список не является исчерпывающим:

  1. Вычисляемые столбцы — Соединители DirectQuery обычно имеют ограниченную поддержку вычисляемых столбцов в Power BI. Некоторые вычисляемые столбцы могут работать с соединителем, что эти столбцы являются исключениями. Как правило, вычисляемые столбцы не работают.

  2. Агрегаты– Модель данных панели мониторинга качества вызовов построена на модели куба, что означает, что агрегаты уже поддерживаются в виде мер. Попытка вручную добавить агрегаты в различные измерения или изменить тип агрегирования меры не работает с соединителем, и обычно это приводит к ошибке.

  3. Пользовательские визуальные элементы — Хотя соединитель качества звонков (Майкрософт) работает с рядом пользовательских визуальных элементов, мы не можем гарантировать совместимость со всеми пользовательскими визуальными элементами. Многие пользовательские визуальные элементы используют вычисляемые столбцы или импортированные данные, ни один из которых не поддерживается соединителями DirectQuery.

  4. Ссылка на кэшированные данные — В настоящее время Power BI никак не поддерживает ссылки на кэшированные данные из соединителя DirectQuery. При любой попытке сослаться на результаты запроса будет создан новый запрос.

  5. Относительная фильтрация данных — Поддерживается в соединителе Качества звонков (Майкрософт), но только с измерениями Времени начала и окончания . Хотя измерение даты может быть очевидным выбором для фильтрации относительных дат, Дата не хранится в качестве объекта даты и времени и, следовательно, не поддерживает фильтрацию относительных дат в Power BI.

  6. Запросы только измерения или только измерения . В настоящее время не поддерживаются в соединителе Качества звонков Майкрософт. Если вы создаете визуализацию с тремя или более измерениями, без измерений или трех или более измерений без измерений, данные столбцов будут транспонированы. Всегда включайте в визуализации по крайней мере одно измерение (например, Год месяца) и одно измерение (например, Общее число вызовов).

  7. Поддержка облака сообщества для государственных организаций (GCC, GCC-High и DoD) — Для клиентов в облачных средах для государственных организаций соединитель Microsoft Call Quality можно использовать с локальным шлюзом данных для обеспечения совместимости с служба Power BI. Просто следуйте инструкциям по установке пользовательских соединителей с локальным шлюзом данных с помощью последней версии соединителя Microsoft Call Quality, чтобы включить доступ. Кроме того, для облака для государственных организаций требуется соответствующая лицензия Power BI для государственных организаций США. Дополнительные сведения о лицензировании см. в последнем руководстве по Power BI для государственных организаций США.

Большинство из этих проблем являются либо ограничениями на конструкцию соединителя DirectQuery в Power BI, либо имеют основополагающее значение для проектирования модели данных CQD.

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

Я пытаюсь использовать столбец Дата в качестве среза даты. Как только я преобразую тип данных этого столбца в Date, я получаю эту ошибку.

Не удалось загрузить данные для этого визуального элемента: ошибка OLE DB или ODBC: [Expression.Error] Не удалось сложить выражение в источник данных. Попробуйте более простое выражение.

Срезы даты не поддерживаются соединителем Качества звонков (Майкрософт). Чтобы указать диапазон дат, примените к отчету два фильтра, указав дату меньше и больше.

Кроме того, если даты, которые вы хотите просмотреть, являются последними, примените относительный фильтр дат, чтобы отобразить только данные за последние N дней,недель/месяцев.

При добавлении определенных измерений в отчеты визуальный элемент немедленно возвращает сообщение "Не удалось загрузить данные для этого визуального элемента". Удаление измерения исправляет визуальный элемент — что происходит?

Это известная проблема в соединителе качества звонков (Майкрософт). Любое измерение, предоставляемое в виде целого числа, отображается в Power BI в виде агрегатного столбца, где Power BI пытается выполнить действие суммирования по умолчанию (обычно "Сумма"). В некоторых случаях это поведение позволяет суммировать значения, даже если результат не полезен, так как "сумма" измерения, такого как Second WiFi Channel, не имеет смысла. В других случаях это действие сводки завершается сбоем и приводит к ошибкам в визуальном элементе.

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

Коды ошибок

Так как соединитель Microsoft Call Quality для Power BI менее ограничен, чем браузерное приложение, с точки зрения типов запросов, которые можно создать, иногда при создании запросов могут возникать ошибки. Если появляется сообщение об ошибке типа "CQDError. RunQuery — ошибка выполнения запроса" сослаться на приведенный ниже список с указанным номером ErrorType, чтобы устранить возможную проблему с запросом. Ниже приведены наиболее распространенные коды типов ошибок, которые могут возникнуть в соединителе CQD Power BI.

  • ErrorType 1 — ошибка структуры запроса: Ошибка структуры запроса обычно возникает из-за того, что соединителю не удалось создать правильно отформатированный запрос. Чаще всего это происходит при использовании неподдерживаемых функций, как указано в разделе Ограничения выше. Дважды проверка, что для этого запроса не используются вычисляемые столбцы или пользовательские визуальные элементы.

    • ErrorType 2 — ошибка построения запроса: Ошибка построения запроса вызвана тем, что соединителю Microsoft Call Quality не удается правильно проанализировать запрос, который вы пытаетесь создать. Эта ошибка чаще всего возникает при использовании неподдерживаемых функций, как указано в ограничениях выше. Дважды проверка, что для этого запроса не используются вычисляемые столбцы или пользовательские визуальные элементы.

    • ErrorType 5 — время ожидания выполнения: Запрос достиг максимально возможной среды выполнения до истечения времени ожидания. Попробуйте добавить в запрос дополнительные фильтры, чтобы ограничить его область. Сужение диапазона данных часто является наиболее эффективным способом достижения этой цели.

    • ErrorType 7 — ошибка без измерений: Для работы запросов панели мониторинга качества вызовов требуется мера. Двойное проверка, что запрос включает меру. Меры в соединителе Качества звонков (Майкрософт) обозначаются символом агрегирования (суммы) перед их именем.

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

Сноски

1 Некоторые процессы и приложения (например, OneDrive) могут привести к изменению корневой папки "Документы". Убедитесь, что каталог Power BI Desktop\Custom Connectors размещен в текущей корневой папке Документы.

2 Учетные данные для входа, используемые для панели мониторинга качества звонков, не должны совпадать с учетными данными, которые вы используете для входа в само приложение Power BI Desktop.

Вопросы и ответы

Когда соединитель Power BI будет обновлен из состояния "Бета-версия"?

Несмотря на метку "бета-версия" в соединителе Microsoft Call Quality, соединитель находится в состоянии выпуска; это не бета-версия. На момент первоначального выпуска соединителя команда Power BI не смогла обеспечить поддержку и более широкую сертификацию (и, следовательно, тег "бета"), но они все еще были готовы подтвердить безопасность, подлинность и общую функциональность соединителя Microsoft Call Quality. С тех пор команда CQD независимо продолжает инвестировать в дальнейшее развитие соединителя для улучшения и пересмотра его функциональности. Метка "beta" не должна отговаривать клиентов от использования соединителя. Маркировка является лишь побочным эффектом нашего независимого подхода к разработке соединителей.

Почему соединитель выглядит медленнее по сравнению с панелью мониторинга качества вызовов в браузере? Что можно сделать для повышения производительности?

Производительность запросов для различных шаблонов практически одинакова как в браузере, так и в соединителе. Как и любое другое автономное приложение, Power BI добавляет время проверки подлинности и отрисовки к нашей производительности. Кроме того, разница заключается в количестве одновременно выполняемых запросов. Так как в браузерной версии панели мониторинга качества вызовов были менее хорошо разработаны параметры визуализации с высокой плотностью информации, большинство наших отчетов были ограничены загрузкой 2–3 запросов за раз. С другой стороны, шаблоны соединителей часто отображают более 20 одновременных запросов. Если вы хотите создавать отчеты с таким же быстродействием, как и предыдущие, попробуйте создать отчеты с не более чем 2–3 запросами на вкладку.

Дополнительные сведения см. в следующих статьях:

Я считаю, что при выполнении запросов я регулярно натыкаюсь на ограничение в 10 000 строк. Как заставить соединитель возвращать более 10 000 строк?

Ограничение в 10 000 строк указывается в конце API и предназначено для значительного повышения производительности и снижения риска ошибок выполнения запросов, вызванных нехваткой памяти.

Вместо того, чтобы пытаться увеличить число результирующих строк, лучше перестроить отчеты в соответствии с рекомендациями соединителя. Шаблоны, которые мы включаем, предназначены для демонстрации этих рекомендаций. По возможности начните с просмотра ключевых показателей эффективности с использованием более широких измерений с меньшей кратностью, таких как месяц, год, дата, регион, страна и т. д. Оттуда вы можете детализировать все более высокие измерения кратности. Отчеты службы поддержки и Location-Enhanced предоставляют хорошие примеры этого рабочего процесса детализации.

Использование Power BI для анализа данных CQD для Teams