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

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

  • Статья

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

Соединитель — это оболочка 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 с действием Get twin by ID из соединителя 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 с действием Get twin by ID, используемым в функции.
  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.