Использование ссылки на подключение в решении с Microsoft Dataverse

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

Подключение – это сохраненные учетные данные проверки подлинности для соединителя, например учетные данные OAuth для соединителя SharePoint.

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

Добавление ссылок на подключения в решение

Можно добавить ссылки на подключения к решению несколькими разными способами:

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

• При импорте решения в. Чтобы узнать больше, перейдите в раздел Импорт решений.

• Неявно, когда вы собираете свои приложения на основе холста и потоки, которые определяются в решении Microsoft Dataverse.

Примечание

• Приложения на основе холста и потоки обрабатывают подключения по-разному. Потоки используют ссылки на соединения для всех соединителей, тогда как приложения на основе холста используют их только для неявно общих (не OAuth) соединений, таких как аутентификация SQL Server. Дополнительная информация: Безопасность и типы аутентификации
• Ссылка на подключение создается автоматически при создании новых подключений из конструкторов потока и приложений на основе холста.
• Приложения на основе холста и потоки, добавленные из внешних решений, не будут автоматически обновлены для использования ссылок на соединения.
• Ссылки на подключение связываются с приложениями на основе холста только в то время, когда в приложение добавляется источник данных. Чтобы обновить приложения, вы должны удалить соединение из приложения, а затем добавить соединение, содержащее связанную ссылку на соединение.

Добавьте ссылку на подключение вручную с помощью обозревателя решений

1. Выполните вход в Power Apps или Power Automate.

2. В левой области выберите Решения. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.

3. Создание нового или открытие существующего решения.

4. На панели команд выберите Создать > Дополнительно > Ссылка на подключение.

5. В области Создать ссылку на подключение введите следующие сведения. Обязательные столбцы отмечены звездочкой (*).

   • Отображаемое имя: введите уникальное и понятное имя, которое поможет отличить эту ссылку соединения от других.
   • Добавить описание: введите текст, описывающий соединение.
   • Соединитель: выберите существующий соединитель из списка, как показано на снимке экрана здесь. Вы также можете выбрать Создать, чтобы создать новое соединение для этой ссылки на соединение. Когда вы закончите создание нового подключения, выберите Обновить, чтобы выбрать ваше соединение из списка.
   • Подключение: на основе выбранного Соединитель, выберите существующее соединение или выберите Создать соединение, чтобы создать его.

6. Выберите Создать.

   

Присвоение имени ссылке на подключение

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

Повторное использование соединений в потоке решения

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

Обновление потока для использования ссылок на подключения вместо подключений

Когда поток не входит в состав решения, он использует подключения. Если этот поток затем будет добавлен в решение, он будет продолжать использовать подключения изначально. Потоки можно обновить для использования ссылок на подключения вместо подключений одним из двух способов:

1. Если поток экспортируется в неуправляемое решение и импортируется, подключения будут удалены и заменены ссылками на подключения.

2. Когда поток решения открыт, средство проверки потока на странице сведений о потоке покажет предупреждение Используйте ссылки на подключения. Предупреждающее сообщение содержит действие Удалите подключения, чтобы можно было добавить ссылки на подключения. Выбор этого действия удалит подключения из триггера и действий в потоке, и позволит выбирать и создавать ссылки на подключения.

Автоматическое использование ссылок на соединения в потоке решения

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

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

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

Примечание

Подключения OAuth могут быть явно предоставлены только пользователю, представляющему субъект-службу.

Ручное предоставление общего доступа к подключениям для включения потока

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

1. Перейдите к Power Apps и выберите среду с подключением.

2. В левой области навигации выберите Подключения, а затем выберите подключение, которым вы хотите поделиться. Если этого пункта нет на боковой панели, выберите …Еще, а затем выберите нужный пункт.

3. В меню выберите Предоставить доступ.

4. На экране предоставления общего доступа введите имя пользователя (субъекта-службы), который включит поток.

5. В списке разрешений выберите Может использовать.

6. Чтобы завершить предоставление доступа, выберите Сохранить.

Автоматическое предоставление общего доступа к подключениям для включения потока

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

Ограничения

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

Известные проблемы

В этом разделе описаны известные проблемы со ссылками на подключение.

Копирование среды нарушает ссылки на подключение для пользовательских подключений

Пользовательские подключения используют идентификатор, специфичный для среды, для ссылки на пользовательский соединитель. После операции копирования среды необходимо создать новую ссылку на подключение с новым пользовательским соединителем. Затем необходимо исправить любые приложения или потоки, использующие старые ссылки на подключения.

Пользовательские соединители необходимо импортировать в отдельное решение от их ссылок на подключение

Пользовательские соединители необходимо импортировать в отдельное решение до их ссылок на подключение или потоков. Сначала экспортируйте решение, содержащее только пользовательский соединитель.

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

Как исправить ошибку "Недопустимое подключение"

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

Что такое ошибка ConnectionAuthorizationFailed? Почему я не могу включить (активировать) поток?

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

• Пользователи, владеющие подключениями, должны поделиться всеми соединениями при включении (активации) потока пользователем.
• Если один пользователь владеет всеми подключениями в потоке, то этот пользователь может включить (активировать) поток.

Как только поток включен владельцем подключений, поток получает разрешения на использование этих подключений. С этого момента любой совладелец потока может включить поток.

Может ли поток быть включен владельцем его подключений, а затем передан другому пользователю?

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

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

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

См. также

Соединители

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).