Установка и настройка Connected Field Service для центра Интернета вещей Azure

Выполните действия, описанные в этой статье, чтобы настроить Connected Field Service для использования с центром Интернета вещей Azure.

• Шаг 1. Развертывание Connected Field Service и ресурсов Azure из шаблона ARM
• Шаг 2. Создание экземпляра поставщика Интернета вещей
• Шаг 3. Настройка конечной точки Интернета вещей
• Шаг 4. Авторизация подключения приложения Azure
• Шаг 5. Обновление devicerules.json
• Шаг 6. Запуск заданий Azure Stream Analytics
• Шаг 7. Настройка подключения аналитики временных рядов Azure
• Шаг 8. (Необязательно) Настройка симулятора

Заметка

Аналитика временных рядов будет объявлена устаревшей после марта 2025 года. Connected Field Service переходит на Azure Data Explorer. Более подробная информация о переходе появится в ближайшее время.

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

• Установлено Dynamics 365 Field Service.

• У вас имеются роли безопасности системного администратора и администратора Интернета вещей.

• У вас есть активная подписка Azure с правами на создание ресурсов и служб.

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

Совет

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

Развертывание Connected Field Service и ресурсов Azure из шаблона ARM

Используйте шаблон управления ресурсами Azure (Azure Resource Manager), чтобы развернуть центр Интернета ващей Azure и подключить его к своей среде Field Service.

1. Выберите Развернуть в Azure на странице https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

2. Выберите свою подписку Azure.

3. Выберите группу ресурсов или создайте ее.

4. Установите тот же регион, что и в вашей среде Field Service.

   

5. Введите уникальное имя вашей организации и URL-адрес организации для среды Field Service.

6. Выберите необязательные ресурсы, которые вы хотите развернуть.

   • Выберите Развертывание симулятора (необязательно) для тестирования и проверки сценариев Интернета вещей с образцами данных.
   • Выберите Аналитика временных рядов Azure (необязательно) для включения визуализации показаний устройств и сводных плиток.
   • Выберите Развернуть SQL Server для Power BI (необязательно) и введите SQL Server и учетные данные для создания собственных отчетов в Power BI.

7. Выберите Просмотр + создание.

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

Создание экземпляра поставщика IoT

1. Войдите в Dynamics 365 и откройте приложение Connected Field Service.

2. В Connected Field Service перейдите в область Параметры.

3. Выберите Поставщики, затем выберите Создать.

4. Введите следующие данные:

   

   • Имя: имя группы ресурсов в Azure, в которой вы развернули ресурсы Интернета вещей
   • Поставщик Интернета вещей: Поставщик Интернета вещей для Центра Интернета вещей
   • Идентификатор экземпляра поставщика: имя ресурса Центра Интернета вещей, который вы развернули в своей группе ресурсов в Azure
   • URL-адрес: URL-адрес обзора группы ресурсов на портале Azure; например, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

5. Выберите Сохранить.

Теперь вам необходимо обновить настройки нового экземпляра поставщика.

1. В области Параметры выберите Параметры IoT>Параметры поставщика IoT.

   

2. Для параметра Поставщик Интернета вещей по умолчанию выберите созданный вами экземпляр поставщика Интернета вещей.

3. Выберите Сохранить и закрыть.

4. Для одного из последующих шагов найдите строку Экземпляр поставщика Интернета вещей в таблице msdyn_iotproviderinstance и скопируйте GUID.

Настройка конечной точки Интернета вещей

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

1. Скачайте и установите интерфейс командной строки Power Platform.

2. Откройте интерфейс командной строки и запустите Plugin Registration Tool (PRT) с помощью команды pac tool prt.

3. В окне PRT выберите Создать новое подключение.

4. Для параметра Отображать список доступных организаций выберите Office 365.

5. Выберите Показать список доступных организаций, затем выберите Показать расширенный.

6. Выберите регион своей среды Field Service, введите свои учетные данные Field Service, затем выберите Войти.

   Если у вас есть доступ к нескольким организациям Dynamics 365, выберите название организации, с которой вы хотите работать.

Теперь вам нужно обновить конечную точку службы сообщений Интернета вещей.

1. После подключения к организации найдите и выберите конечную точку службы Сообщение Интернета вещей.

2. Выберите Обновить.

3. Для параметра Адрес пространства имен введите имя хоста пространства имен служебной шины в инструменте регистрации подключаемого модуля с префиксом sb://; например, sb://myServiceBusNamespace.servicebus.windows.net.

4. В ресурсе пространства имен служебной шины перейдите к пункту Очереди и найдите очередь с именем, заканчивающимся на -crm. Скопируйте полное имя и введите его как Имя темы в инструменте регистрации подключаемых модулей Plug-in Registration Tool.

5. Для параметра Формат сообщения выберите значение XML.

6. В ресурсе пространства имен служебной шины перейдите к пункту Политики общего доступа>RootManageSharedAccessKey.

7. Скопируйте имя и вставьте его в Имя ключа SaS.

8. Скопируйте первичный ключ и вставьте его в Ключ SAS.

9. Выберите Сохранить.

   

Авторизация подключения приложения Azure

1. Войдите в вашу учетную запись Azure и перейдите на портал Azure.

2. Перейдите к Группы ресурсов и найдите группу ресурсов, в которую вы недавно развернули центр Интернета вещей.

3. Выберите и измените commondataservice ресурса подключения API.

4. В разделе Общие выберите Изменить соединение API, затем выберите Авторизовать.

5. Войдите с учетными данными Dynamics 365, которые вы используете для входа в среду Connected Field Service.

   Они могут отличаться от учетных данных, которые вы используете для входа на портал Azure.

6. Выберите Сохранить.

Обновление devicerules.json

Задание Stream Analytics, развернутое в вашей группе ресурсов, ссылается на файл с именем devicerules.json. Этот файл определяет правило, которое создает оповещения Интернета вещей при использовании дополнительного симулятора устройства.

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

1. Скачайте файл devicerules.json из репозитория GitHub.

2. Откройте группу ресурсов на портале администрирования Azure и выберите учетную запись хранения, развернутую в вашей группе ресурсов.

3. Выберите Контейнеры, затем создайте контейнер с именем devicerules.

4. Откройте новый контейнер devicerules и выберите Отправить.

5. Найдите и выберите devicerules.json.

6. Разверните раздел "Расширенный". В поле Отправить в папку введите 2016-05-30, затем выберите Отправить.

7. Откройте новую папку 2016-05-30 и выберите Отправить.

8. Найдите и выберите devicerules.json.

9. Разверните раздел "Расширенный". В поле Отправить в папку введите 22-40, затем выберите Отправить.

Запуск заданий Azure Stream Analytics

1. В разделе Портал Azure перейдите к Группы ресурсов и найдите группу ресурсов, в которую вы недавно развернули центр Интернета вещей.

2. Выберите каждое задание Stream Analytics и на вкладке Обзор выберите Начать.

Поздравляем! Теперь можно передавать данные между Центром Интернета вещей Azure и Dynamics 365 для использования Connected Field Service.

Настройка подключения аналитики временных рядов Azure

Используйте аналитику временных рядов Azure для создания визуализаций. Для этого шага вам необходимо знать свой идентификатор клиента Azure.

1. В Dynamics 365 откройте приложение Connected Field Service.

2. Запустите инструменты разработчика браузера и перейдите в консоль.

3. Введите или вставьте следующий скрипт в консоль и запустите его. Замените параметр Value своим идентификатором клиента Azure.

var req = {};

req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"Key": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"Value": {
"typeName": "Edm.String",
"structuralProperty": 1
},
},
operationType: 0,
operationName: "msdyn_IoTSetConfiguration"
};
};

req["Key"]="TSI_PLUGIN_AZURE_TENANT_ID";
req["Value"]="REPLACE";

Xrm.WebApi.online.execute(req).then( 
function (data) { 
console.log("Success Response Status: " + data.status);
}, 
function (error) { 
console.log("Error: " + error.message);
}
);

1. Выполните сценарий еще раз. На этот раз замените Key на TSI_PLUGIN_CLIENT_APPLICATION_ID и Value на идентификатор клиента приложения из регистрации приложения Аналитика временных рядов, которую вы создали как необходимое условие.

2. Запустите скрипт еще раз. На этот раз замените Key на TSI_PLUGIN_CLIENT_SECRET и Value на секрет клиента приложения из регистрации приложения Аналитика временных рядов, которую вы создали как необходимое условие.

3. Запустите следующий сценарий, используя URL-адрес приложения Аналитика временных рядов и GUID строки экземпляра поставщика Интернета вещей в таблице msdyn_iotproviderinstance для экземпляра поставщика Интернета вещей, созданного вами ранее.

var data = {"msdyn_timeseriesinsightsurl": "Enter Data Access FQDN found on Time Series Insights environment overview"};
Xrm.WebApi.updateRecord("msdyn_iotproviderinstance", "Copy the value for msdyn_iotproviderinstanceid from the json object returned with the API call https://[your-environment-name].crm.dynamics.com/api/data/v9.2/msdyn_iotproviderinstances", data);

(Необязательно) Настройка примера симулятора

Симулятор позволяет вам тестировать Connected Field Service без необходимости подключения физического оборудования. Моделованные устройства и данные Интернета вещей помогают понять составляющие системы, которые способствуют превращению данных Интернета вещей в заказы на работу.

Для этого шага вам понадобится URL-адрес симулятора и первичный ключ для политики iothubowner.

Получение ключа доступа

1. Войдите в вашу учетную запись Azure и перейдите на портал Azure.

2. Перейдите к Группы ресурсов и найдите группу ресурсов, в которую вы недавно развернули центр Интернета вещей.

3. Выберите центр Интернета вещей.

4. Выберите Политики общего доступа, затем скопируйте первичный ключ для iothubowner.

   

Получение URL-адреса симулятора

1. В группе ресурсов Портал Azure, в которой вы развернули центр Интернета вещей, выберите тип ресурса "Служба приложений", который начинается с Simulator, и скопируйте URL-адрес в верхнем правом углу.

2. Вставьте URL-адрес в адресную строку браузера и загрузите страницу.

3. Выберите Подключение.

4. Введите имя узла из ресурса центра Интернета вещей и iothubowner в качестве имени политики. В поле Ключ вставьте скопированный ранее первичный ключ.

   

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

Отправьте тестовую команду с помощью симулятора. Например, выберите температуру и увеличьте ее до значения выше 70 градусов. Симулятор предварительно запрограммирован на создание оповещений Интернета вещей, если температура поднимается выше 70 градусов.

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

• Регистрация устройств
• Извлечь данные устройства
• Визуализация показаний устройств