Azure Digital Twins (предварительная версия)

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Стандарт	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Стандарт	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Стандарт	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя	Microsoft
URL	https://azure.microsoft.com/support/

Метаданные соединителя
Publisher	Корпорация Майкрософт
Веб-сайт	https://azure.microsoft.com/products/digital-twins/
Политика конфиденциальности	https://privacy.microsoft.com
Категории	Интернет вещей

Azure Digital Twins — это платформа Интернета вещей (IoT), которая позволяет создавать цифровое представление реальных вещей, мест, бизнес-процессов и людей. Получайте аналитические сведения, помогающие повысить эффективность продуктов, оптимизировать операции и затраты, а также создавать прорывные возможности клиентов. Эти соединители позволяют взаимодействовать с API цифровых двойников. Это позволит создавать, администрировать и запрашивать двойники.

Предпосылки

Для продолжения вам потребуется следующее:

• План Microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
• подписка Azure
• Средства командной строки Power Platform
• Экземпляр Azure Digital Twin

Получение учетных данных

Используйте идентификатор пользователя и пароль Идентификатора Microsoft Entra, который предоставляет разрешение на доступ к конечным точкам Цифровых двойников.

Начало работы с соединителем

• Добавьте соединитель в приложение power platform.
• Зарегистрируйте экземпляр ADT, который требуется установить.
• Проверка подлинности с помощью пользователя Идентификатора Microsoft Entra.
• Теперь вы сможете взаимодействовать с конечными точками Azure Digital Twins. (https://learn.microsoft.com/en-us/rest/api/digital-twins/dataplane/twins и https://learn.microsoft.com/en-us/rest/api/digital-twins/dataplane/query)

Известные проблемы и ограничения

• Так как ADT работает с динамическими ответами схемы. Разработчик приложений должен проанализировать json до его использования. Например: Set(jsonVal, AzureDigitalTwins.GetTwinById(TextInput1.Text).result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp. $dtId');

Распространенные ошибки и средства устранения неполадок

• Ошибка синтаксического анализа JSON:
  • В случае, если модель не совпадает с проанализированным json, вы получите ошибку средства синтаксического анализа json. Чтобы решить это, проверьте xml-код ответа и получите доступ к значениям соответствующим образом.

Часто задаваемые вопросы

• Можно ли создать экземпляр ADT через соединитель?

  • Чтобы создать и удалить экземпляр ADT, перейдите в Azure.

• Доступна ли страница?

  • Страница выполняется в рамках разработки приложений с помощью маркера продолжения.

• Можно ли получить доступ к нескольким экземплярам ADT в одном приложении?

  • Чтобы получить доступ к нескольким экземплярам ADT, необходимо установить новое подключение и использовать его соответствующим образом в приложении.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

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

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Имя экземпляра ADT:	струна	Введите универсальный код ресурса (URI) экземпляра ADT	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	300	60 секунд

Действия

API запроса	Выполняет запрос, позволяющий просматривать связи и фильтровать по значениям свойств.
Вывод списка входящих связей	Извлекает все входящие связи для цифрового двойника.
Добавление двойника	Добавляет или заменяет цифровой двойник.
Добавление модели	Отправляет одну или несколько моделей. При возникновении любой ошибки модели не передаются.
Добавление связи	Добавляет связь между двумя цифровыми двойниками.
Обновить отношения	Обновляет целые свойства связи между двумя цифровыми двойниками.
Обновление двойника	Обновляет свойства двойника.
Обновление компонента	Обновляет целые свойства для компонента двойника.
Обновление свойства модели	Обновляет метаданные для модели.
Отправка данных телеметрии	Отправляет данные телеметрии от имени цифрового двойника.
Отправка телеметрии компонента	Отправляет данные телеметрии от имени компонента в цифровом двойнике.
Получение двойника по идентификатору	Извлекает цифровой двойник и его данные.
Получение компонента	Извлекает компонент из цифрового двойника.
Получение модели по идентификатору	Извлекает метаданные модели и, при необходимости, определение модели.
Получение связи по идентификатору	Извлекает связь между двумя цифровыми двойниками.
Список моделей	Извлекает метаданные модели и, при необходимости, определения моделей.
Список отношений	Извлекает все исходящие связи из цифрового двойника.
Удаление двойника	Удаляет цифровой двойник. Все связи, ссылающиеся на цифровой двойник, уже должны быть удалены.
Удаление связи	Удаляет связь между двумя цифровыми двойниками.
Удалить модель	Удаляет модель. Модель можно удалить только в том случае, если другие модели не ссылаются на нее.

API запроса

Вывод списка входящих связей

Добавление двойника

Добавление модели

Добавление связи

Обновить отношения

Обновление двойника

Обновление компонента

Обновление свойства модели

Отправка данных телеметрии

Отправка телеметрии компонента

Получение двойника по идентификатору

Получение компонента

Получение модели по идентификатору

Получение связи по идентификатору

Список моделей

Список отношений

Удаление двойника

Удаление связи

Удалить модель

Определения

ВходящиеRelationship

TwinRelationship

TwinResult

GetComponentResult

QueryResult