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

Использование переменных среды в пользовательских соединителях решений

  • Статья

При развертывании в разных средах приложениям часто требуются разные параметры конфигурации или входные параметры. Переменные среды хранят ключи и значения параметров, которые затем могут служить входными данными для различных других объектов приложения. Можно также использовать переменные среды в пользовательских соединителях решения для обновления основных свойств пользовательских соединителей, таких как Host, Base URL, Client ID, Client Secret, Login Url, Refresh Url и другие. Подробное пошаговое руководство можно найти в этом блоге.

Использование переменной среды в настраиваемом соединителе

При создании или обновлении настраиваемого соединителя значения переменных среды будут использоваться для создания настраиваемого соединителя. Настраиваемый соединитель использует значение переменных среды во время сохранения. При обновлении переменной среды необходимо повторно сохранить настраиваемые соединители, чтобы использовать обновленное значение переменной среды.

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

  2. Выберите решение из списка.

    or

    Или, если вам нужно создать новый пользовательский соединитель в решении, см. Создание пользовательских соединителей в решениях.

  3. Выберите вновь созданное или существующее решение из списка.

  4. Выберите Переменные среды.

  5. Выберите Создать > Дополнительно > Переменная среды.

  6. Введите Имя переменной среды, которое содержит префикс идентификатора издателя. (Не используйте имя в поле Отображаемое имя.)

    В следующем примере используется URL-адрес сайта SharePoint. Вы можете создать другие значения переменных среды для других параметров, таких как идентификатор клиента OAUTH, ресурс и другие.

    Снимок экрана имени переменной среды.

    Переменные среды могут использовать следующий синтаксис в полях настраиваемых соединителей:
    @environmentVariables("environmentVariableName")

    Пример
    @environmentVariables("cr49f_SharePointSiteURL_7weem")

    Снимок экрана переменных среды.

  7. (Необязательно) Чтобы использовать значения из переменных среды в полях Узел и Базовый URL-адрес, выполните следующие действия:

    1. Выберите Создать > Автоматизация > Настраиваемый соединитель.

      Снимок экрана нового меню настраиваемого соединителя.

    2. На вкладке Общее введите синтаксис переменной среды, чтобы ссылаться на переменную среды.

      Снимок экрана вкладки Общее.

  8. (Необязательно) Чтобы использовать значения из переменных среды в каких-либо полях на вкладке Безопасность, выполните следующие действия:

    1. Выберите Создать > Автоматизация > Настраиваемый соединитель.

    2. На вкладке Безопасность введите синтаксис переменной среды, чтобы ссылаться на переменную среды.

    Подробнее см. в разделе Укажите тип аутентификации.

    Снимок экрана вкладки "Безопасность".

    Переменные среды с типом данных Секрет в настоящее время используются в настраиваемых соединителях. Вам необходимо настроить Azure Key Vault путем выполнения описанных здесь действий. В пользовательском интерфейсе конфигурации безопасности значение маскируется. Вам нужно будет использовать следующий синтаксис: @environmentVariables("environmentVariableName")

    Важно!

Переменная среды, созданная для секрета клиента с типом данных Текст, не является безопасной. Эти значения не зашифрованы. Рекомендуется использовать Azure Key Vault.

  1. (Необязательно) На вкладке Определение добавьте необходимые действия, триггеры или политики. В настоящее время переменные среды не поддерживаются в действиях, триггерах или политиках.

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

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

Чтобы использовать новые значения для переменных среды

  1. Экспортируйте решение. На этом шаге вы удалите значение, как упоминалось в предыдущем абзаце.

  2. Импортируйте решение в новую среду.

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

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

Предоставление отзывов

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