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

Интеграция с Power Platform и Logic Apps с помощью соединителя Azure Digital Twins

  • Статья

Вы можете интегрировать Azure Digital Twins в поток Microsoft Power Platform или Azure Logic Apps с помощью соединителя Power Platform Для Azure Digital Twins.

Соединитель представляет собой оболочку для API плоскости данных Azure Digital Twins для операций двойника, модели и запросов, что позволяет базовой службе взаимодействовать с Microsoft Power Automate, Microsoft Power Apps и Azure Logic Apps. Соединитель позволяет пользователям подключать свои учетные записи и использовать набор готовых действий для создания приложений и рабочих процессов.

Общие сведения о соединителе, включая краткую демонстрацию, см. в следующем видео о шоу Интернета вещей:

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

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

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начинать работу. Войдите в портал Azure с помощью своей учетной записи.

Чтобы работать с Azure Digital Twins в этой статье, вам потребуется экземпляр Azure Digital Twins и необходимые разрешения для его использования. Если у вас уже настроен экземпляр Azure Digital Twins, его можно использовать и перейти к следующему разделу. В противном случае выполните инструкции по настройке экземпляра и аутентификации. В инструкциях приводится информация, которая поможет вам убедиться, что вы успешно выполнили каждый шаг.

После настройки экземпляра запишите имя узла экземпляра. Вы можете найти имя хоста на портале Azure.

Наконец, необходимо настроить все службы Power Platform , в которых вы хотите использовать соединитель.

Настройка соединителя

Для Power Automate и Power Apps сначала настройте подключение перед созданием потока. Выполните следующие действия, чтобы добавить подключение в Power Automate и Power Apps.

  1. Выберите Подключения в меню навигации слева (в Power Automate он находится под заголовком Данные ). На странице Подключения выберите + Новое подключение.
  2. Найдите Azure Digital Twins и выберите соединитель Azure Digital Twins (предварительная версия).
  3. Если соединитель запрашивает имя экземпляра ADT, введите имя узла экземпляра.
  4. Введите сведения о проверке подлинности при запросе, чтобы завершить настройку подключения.
  5. Чтобы убедиться, что подключение создано, найдите его на странице Подключения. Снимок экрана Power Automate с подключением Azure Digital Twins на странице

Для Logic Apps можно использовать встроенное подключение Azure Digital Twins при создании потока в следующем разделе. Дополнительные сведения о встроенных соединителях см. в статье Встроенные соединители в Azure Logic Apps.

Создание потока

Вы можете включить Azure Digital Twins в потоки Power Automate, потоки Logic Apps или приложения Power Apps. С помощью соединителя Azure Digital Twins и более 700 других соединителей Power Platform вы можете принимать данные из других систем в двойники или реагировать на системные события.

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

  1. В Power Automate выберите Мои потоки в меню навигации слева. Выберите + Новый поток и Мгновенный облачный поток.
  2. Введите имя потока и выберите Вручную активировать поток из списка триггеров. Создайте поток.
  3. Добавьте шаг в поток и выполните поиск Azure Digital Twins , чтобы найти подключение. Выберите подключение Azure Digital Twins. Снимок экрана Power Automate с соединителем Azure Digital Twins в новом потоке.
  4. Вы увидите список всех действий , доступных с соединителем. Выберите один из них для взаимодействия с API Azure Digital Twins. Снимок экрана: Power Automate со всеми действиями для соединителя Azure Digital Twins.
  5. Вы можете продолжать изменять или добавлять дополнительные шаги в рабочий процесс, используя другие соединители для создания сценария интеграции. Снимок экрана Power Automate: действие Получить двойник по идентификатору из соединителя Azure Digital Twins в потоке.

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

  1. В Power Apps выберите + Создать в меню навигации слева. Выберите Пустое приложение и следуйте инструкциям, чтобы создать новое приложение.
  2. В построителе приложений выберите Данные в меню навигации слева. Выберите Добавить данные и выполните поиск По запросу Azure Digital Twins , чтобы найти подключение к данным. Выберите подключение Azure Digital Twins. Снимок экрана Power Apps с соединителем Azure Digital Twins в качестве источника данных.
  3. Теперь действия из соединителя Azure Digital Twins будут доступны в качестве функций для использования в приложении. Снимок экрана Power Apps: действие
  4. Вы можете продолжить создание приложения с доступом к данным Azure Digital Twins. Дополнительные сведения о создании Power Apps см. в статье Общие сведения о создании приложений в Power Apps.

Выполните приведенные ниже действия, чтобы создать пример потока с соединителем в Logic Apps.

  1. Перейдите к приложению логики в портал Azure. Выберите Рабочие процессы в меню навигации слева и + Добавить. Следуйте инструкциям, чтобы создать новый рабочий процесс.
  2. Выберите новый поток и войдите в конструктор.
  3. Добавьте триггер в приложение.
  4. Выберите Выберите операцию , чтобы добавить действие из соединителя Azure Digital Twins. Выполните поиск Azure Digital Twins на вкладке Azure , чтобы найти подключение к данным. Выберите подключение Azure Digital Twins. Снимок экрана: Logic Apps с соединителем Azure Digital Twins.
  5. Вы увидите список всех действий , доступных с соединителем. Выберите один из них для взаимодействия с API Azure Digital Twins.
  6. После выбора действия в соединителе Azure Digital Twins вам будет предложено ввести сведения о проверке подлинности для создания подключения.
  7. Вы можете продолжать изменять или добавлять дополнительные шаги в рабочий процесс, используя другие соединители для создания сценария интеграции.

Ограничения и предложения

Ниже приведены некоторые ограничения соединителя и рекомендации по работе с ними.

  • Некоторые действия соединителя (например, Добавление модели) требуют ввода в виде литеральной строки, начинающейся с @. В таких случаях экранируйте @ символ с помощью @@ . Это не позволит интерпретировать литеральное значение как выражение JSON.
  • Так как Azure Digital Twins работает с ответами динамической схемы, необходимо проанализировать JSON, полученный от API, прежде чем использовать его в приложении. Например, вот набор вызовов, которые анализируют данные перед извлечением dtId значения: Set(jsonVal, AzureDigitalTwins.GetTwinById("your_twin_id").result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));.

Дальнейшие действия

Дополнительные сведения о соединителях Power Platform, включая их использование в рабочих процессах в нескольких продуктах, см. в документации по соединителям Power Platform и Azure Logic Apps.