Змінні середовища для Power Platform огляду

Змінні середовища дозволяють використовувати базовий сценарій керування життєвим циклом програми (ALM) для переміщення програми між Power Platform середовищами. У цьому сценарії програма залишається абсолютно незмінною, за винятком кількох ключових зовнішніх посилань на програму (таких як таблиці, з’єднання та ключі), які відрізняються між вихідним середовищем та середовищем призначення. Додаток вимагає, щоб структура таблиць або з’єднань була абсолютно однаковою між вихідним і цільовим середовищами, з деякими відмінностями. Змінні середовища дозволяють вказати, які з цих різних зовнішніх посилань повинні оновлюватися при переміщенні програми між середовищами.

Змінні середовища зберігають ключі та значення параметрів, які потім слугують вхідними даними для різних об'єктів програм. Завдяки відокремленню параметрів від об'єктів, яки їх використовують, ви отримуєте можливість змінювати значення в межах того ж середовища, або ж при перенесенні рішень до інших середовищ. Альтернативу цьому підходу складає реалізація, в якій значення параметрів жорстко задані у коді компонентів, що їх використовують. Такий підхід часто є проблематичним; особливо, коли значення потрібно змінити під час операцій ALM. Оскільки змінні середовища – це компоненти рішень, ви можете передати посилання (ключі) та змінити значення під час перенесення відповідного рішення в інші середовища.

Переваги використання змінних середовища:

• Надавайте нові значення параметрів під час імпорту рішень до інших середовищ.
• Конфігурація сховища для джерел даних, які використовуються в програмах і потоках полотна. Наприклад, параметри сайту та списку SharePoint Online можуть зберігатися як змінні середовища. Такий підхід дозволяє підключатися до різних сайтів і списків у різних середовищах без необхідності змінювати програми та потоки.
• Запакуйте та передайте ваше настроювання разом із конфігурацією, і керуйте ними в одному місці.
• Запакуйте та передайте секрети, наприклад облікові дані, що використовуються різними компонентами, окремо від компонентів, які їх використовують.
• Одна змінна середовища можна використовуватися для багатьох різних компонентів рішення: незалежно від того, належать вони до одного типу компонентів або до різних. Наприклад, компонована програма й потік можуть використовувати однакові змінні середовища. Якщо значення змінної середовища потрібно змінити, вам доведеться змінити лише одне значення.
• Крім того, якщо вам потрібно завершити роботу джерела даних у виробничих середовищах, ви можете оновити значення змінних середовища інформацією для нового джерела даних. Застосунки та ланцюжки не потребують модифікації та починають використовувати нове джерело даних.
• Підтримка інструментів SolutionPackager та DevOps забезпечує безперервну інтеграцію та безперервну доставку (CI/CD).
• Змінні середовища можна розпаковувати та зберігати в елементі керування вхідним кодом. Ви також можете зберігати різні файли значень змінних середовища для окремих налаштувань, потрібних у різних середовищах. Після цього Solution Packager може прийняти файл, що відповідає середовищу, в яке імпортується рішення.

Як працюють змінні середовища?

Змінні середовища можуть створюватися та змінюватися в рамках сучасного інтерфейсу рішення. Вони також можуть бути автоматично створені під час підключення до певних джерел даних у програмах canvas або за допомогою коду. Їх також можна імпортувати до середовища за допомогою рішень. Змінні середовища можуть використовуватися як вхідні дані при створенні canvas-додатків, потоків Power Automate, плагінів та додавання панелей Power BI до додатків, керованих моделями. Коли ви використовуєте змінні середовища, значення потім виводяться зі змінних середовища і можуть бути змінені при імпорті рішень до інших середовищ.

Створення змінної середовища в рішенні вручну

1. Увійдіть у Power Apps (make.powerapps.com), а на лівій панелі виберіть Solutions. Якщо елемента немає на бічній панелі, виберіть ... Більше , а потім виберіть потрібний елемент.
2. Відкрийте потрібне рішення, або створіть нове.
3. На панелі команд виберіть «Створити>більше», а потім виберіть « Змінна середовища».
4. На правій панелі заповніть наведені нижче стовпці, а потім натисніть Зберегти.

   • Відображуване ім’я. Введіть ім’я змінної середовища.

   • Назва. Унікальне ім’я автоматично генерується з відображуваного імені, але ви можете його змінити.

   • Тип даних. Виберіть із пунктів «Десяткове число», «Текст», «JSON», «Два варіанти», «Джерело даних» або «Секрет».

     Примітка

     • Якщо джерелом даних є обраний тип, потрібно вибрати конектор ,допустиме підключення для вибраного конектора та тип параметра. З’єднання не зберігається як частина змінної середовища. Змінна середовища зберігає інформацію, не всередині з'єднання, необхідного для підключення Power Apps до потрібного сервера та таблиці. З'єднання використовується лише для отримання доступних параметрів, таких як сайти SharePoint, до яких ви маєте доступ, або списки, пов'язані з сайтом.
     • Якщо обраний тип Secret потрібна додаткова інформація для налаштування та налаштування Azure Key Vault, щоб Power Platform мала доступ до секрету.

   • поточне значення. Також називається значенням. Ця властивість необов'язкова і є частиною таблиці значень змінних середовища. Визначене значення використовується, навіть якщо також присутнє значення за замовчуванням. Вилучіть значення з рішення, якщо ви не хочете використовувати його в наступному середовищі. Значення також розділені на окремі файли JSON у експортованому файлі solution.zip і їх можна редагувати в автономному режимі. Додаткові відомості: Як видалити значення зі змінної середовища?

   • Значення за замовчуванням. Цей стовпець є частиною таблиці визначення змінних середовища і не є обов’язковим. Якщо поточне значення відсутнє, використовується значення за замовчуванням.

     Розділення значень за замовчуванням і поточного значення дає змогу обслуговувати визначення та значення за замовчуванням окремо від вказаного значення. Наприклад, видавець додатків може розмістити свою пропозицію на Marketplace із значенням за замовчуванням. Потім, за потреби, клієнт може надати нове значення. Коли видавець програми публікує оновлення програми, значення, встановлене клієнтом, не перезаписується.

     

     Примітка

     Значення не може існувати без визначення. Інтерфейс дає лише змогу створення одного значення на визначення.

Power Apps можуть автоматично створювати змінні середовища

На вкладці General у Power Apps налаштуваннях:

• Увімкніть опцію Автоматично створювати змінні середовища при додаванні джерел даних. Тепер, коли ви додаєте нове джерело даних у свій додаток, він додає змінну середовища для вас.

  

Різні джерела даних

Різні джерела даних дозволяють використовувати різні типи змінних середовища.

Microsoft Dataverse

Power Apps нативно підключається до Dataverse. Вам не потрібна змінна середовища для таблиць у вашому поточному середовищі. Коли ви підключаєтеся до Dataverse неї, ваша програма автоматично шукає точно таке ж ім’я таблиці в будь-якому середовищі, куди ви її переносите. До тих пір, поки структура імен вашої таблиці в цільовому середовищі така ж, як і в оригінальному середовищі, вона працює.

Якщо ви використовуєте зовнішню таблицю з іншого середовища (через Change Environment), то Power Apps припускає, що ви завжди хочете звертатися до однієї й тієї ж таблиці. Вам потрібна змінна середовища, якщо вам потрібно, щоб ця зовнішня таблиця була іншою зовнішньою таблицею при переході від розробки до тесту чи продакшну. Найпростіше дозволити Power Apps автоматично створювати змінну середовища для вас. (Якщо ви раніше додали таблицю до програми, то ввімкніть перемикач настройок, перетягніть зовнішню таблицю, а потім додайте її назад.)

Коли ви додаєте зовнішню таблицю до програми, виберіть вкладку Додатково , щоб вибрати змінну середовища.

SharePoint

SharePoint підтримує лише підключення Microsoft Entra. Отже, для SharePoint, окрім дійсного з'єднання, потрібна окрема змінна середовища для Site і List.

Щоб успішно використовувати змінні середовища зі списками SharePoint:

• Коротке ім’я та логічне ім’я для кожного відповідного стовпця у вихідному та цільовому середовищах мають збігатися.
• Змінні середовища для SharePoint повинні мати відповідні метадані. SharePoint має внутрішні ідентифікатори, які можуть не співбігати між цільовими середовищами. Наприклад, якщо ви створюєте список з однаковим іменем і стовпцями в цільовому середовищі, внутрішні імена не співпадатимуть. Метадані завжди співпадають, якщо ви дублюєте сайт SharePoint і скопіюєте його у цільове середовище.

SQL Server

SQL Server підтримує багато різних типів автентифікації та підключень. Використовуйте змінні середовища для з'єднань Microsoft Entra. Для сервера та бази даних потрібна окрема змінна середовища. Програма прив’язана до конкретних імен таблиць, тому вони вважаються однаковими в різних середовищах.

Не використовуйте змінні середовища для спільних з'єднань, наприклад, базової SQL-автентифікації з SQL Server. Використовуйте посилання на з'єднання для інформації, яка традиційно передається як частина connection string. Базові параметри SQL-аутентифікації є частиною connection string. Наприклад, ім'я сервера та бази даних надаються під час створення підключення, тому вони завжди отримуються з підключення.

Змінні середовища джерела даних використовуються для конекторів з автентифікаційною, таких як Microsoft Entra. У таких типах з'єднань Power Apps має лише ідентифікованого користувача. Power Apps не може визначити, з яким сервісом чи таблицею ви плануєте працювати, з цього з'єднання.

Введення нових значень при імпортуванні рішень

Сучасний інтерфейс імпорту рішень дозволяє вказувати значення змінних середовища. Це встановлює властивість value на environmentvariablevalue таблиці.

Значення змінних середовища видно під час імпорту рішень або під час використання Pipelines для розгортання. Змінні середовища без стандартного значення або значення запитують значення, але ті, що в іншому випадку, попередньо заповнюються міткою під текстовою областю, що позначає джерело значення: значення рішення, значення цільового середовища або значення за замовчуванням.

Примітка

• У деяких випадках для певних значень змінних середовища джерела даних може з’являтися попередження про відмову в доступі, якщо виробник імпорту не має доступу до з’єднання або джерела, використаного для змінної середовища. Це неблокуюче попередження, але на нього слід звернути увагу, залежно від того, як ви плануєте використовувати змінну середовища у цільовому середовищі.
• Ви можете видалити значення зі свого рішення перед експортом рішення. Це гарантує, що існуюче значення залишиться у вашому середовищі розробки, але не буде експортовано в рішення. Такий підхід дає змогу надавати нові значення під час імпортування рішення до інших середовищ. Додаткові відомості: Як видалити значення зі змінної середовища?

Сповіщення

Коли змінні середовища не мають значень, відображається сповіщення. Встановіть значення так, щоб компоненти, які залежать від змінних середовища, не виходили з ладу.

Безпека

Стіл environmentvariabledefinition належить користувачеві або команді. Якщо створюєте програму, яка використовує змінні середовища, обов'язково призначте користувачам належний рівень прав для цієї таблиці. Дозвіл на environmentvariablevalue таблицю успадковується від батьківської environmentvariabledefinition таблиці, тому не потребує окремих привілеїв. Права для environmentvariabledefinition таблиць включено до ролей безпеки Environment Maker і Basic User за замовчуванням. Додаткова інформація: Безпека в Dataverse.

Іменування

Переконайтеся, що імена змінних середовища є унікальними, щоб на них можна було точно посилатися. Повторювані короткі імена змінних середовища створюють труднощі у використанні та розрізнення змінних середовища. Переконайтеся, що імена змінних середовища є унікальними, щоб на них можна було точно посилатися. Імена $authentication і $connection є спеціально зарезервованими параметрами для потоків, і їх слід уникати. Збереження потоку блокується, якщо використовуються змінні середовища з такими іменами. Якщо змінна середовища використовується в потоці, а відображуване ім’я змінної середовища змінено, тоді розробник показує як старі, так і нові маркери відображуваного імені, щоб допомогти з ідентифікацією. Під час оновлення потоку ми рекомендуємо видалити посилання на змінну середовища та додати її знову.

Поточні обмеження

• Перевірка значень змінних середовища відбувається в інтерфейсах користувача та в компонентах, які їх використовують, але не в Dataverse. Тому слід переконатися, що встановлено належні значення, якщо вони змінюються за допомогою коду.
• Power Platform Завдання інструментів збірки ще не доступні для керування змінними середовища джерела даних. Проте це не блокує їх використання в наданих Microsoft засобах і системах керування вихідним кодом.
• Взаємодія зі змінними середовища через спеціальний код потребує виклику API для отримання значень; немає кешу, відкритого для використання кодом сторонніх виробників.
• Змінні середовища обмежені максимум 2000 символами.

Запитання й відповіді

Чому я не бачу значення своєї змінної середовища?

Якщо змінна середовища є в керованому рішенні, ви не зможете побачити значення, доки не заглянете в рішення за замовчуванням. Така поведінка розроблена, оскільки значення змінної середовища є некерованим налаштуванням.

Як переглянути, де використовуються змінні середовища?

Вибравши Показати залежності в інтерфейсі рішення під час створення компонентів або в системі керування джерелами та у файлі рішення, переглянувши метадані програми чи потоку.

Чи правда, що змінні середовища для джерела даних та підключеннями — одне й те саме?

Ні. Хоча вони пов’язані, з’єднання представляє облікові дані або автентифікацію, необхідні для взаємодії з конектором. Змінні середовища джерела даних зберігають параметри, необхідні для однієї або кількох дій з'єднувача, і ці параметри часто відрізняються залежно від дії. Наприклад, підключення SharePoint Online не зберігає жодної інформації про сайти, списки чи бібліотеки документів. Тому для виклику конектора потрібне як дійсне з’єднання, так і деякі додаткові параметри.

Чи можна в автоматизованому процесі ALM використовувати різні файли значень для різних середовищ?

Так. Пакувальник рішень приймає в якості параметра вводу ім'я файлу, отже ваш процес може пакувати різні файли значень до рішення залежно від типу середовища, для якого він виконується.

Чи слід включити значення в своє рішення?

Ні. Змінні середовища призначені для використання програмами, які повинні мати різні значення в різних середовищах, де розгортається рішення. Визначення змінних середовища мають бути включені у ваше рішення, але значення мають бути надані для цільового середовища під час розгортання. Така поведінка призводить до того, що визначення змінної середовища є керованим об’єктом рішення в цільовому середовищі, тоді як змінна середовища є некерованим записом.

Чому я не можу видалити значення у своєму середовищі?

Якщо значення було включено в кероване рішення, єдиний спосіб видалити значення — оновити рішення у вихідному середовищі, щоб виключити значення, а потім експортувати нову версію рішення. Потім цю нову версію можна імпортувати в середовище за допомогою операції оновлення (а не оновлення), у результаті чого запис значення буде видалено.

Що робити, якщо хтось випадково видалить значення?

Якщо це ще не заборонено системою залежностей, середовище виконання використовує останнє відоме значення як резервне.

Якщо значення змінилося, коли нове значення почне використовуватись у компонованих програмах та хмарних циклах?

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

Чи потрібні ліцензії Premium?

Ні. Хоча ALM вимагає Dataverse (або додатки Dynamics 365), використання преміальних конекторів не є обов'язковим. Єдина ситуація, на яку треба звернути увагу — це використання з'єднувача Dataverse для взаємодії із змінними середовища у такий самий спосіб, як ви взаємодієте із іншими записами даних, такими як бізнес-партнери або контактні особи. Раніше це було єдиним способом використання змінних середовища в компонованих програмах і циклах.

Чи існує обмеження на кількість змінних середовища?

Ні. Однак максимальний розмір рішення — 95 МБ. Додаткова інформація: Створення рішення

Чи можна локалізувати короткі імена та описи змінних середовища?

Так.

Чи слід використовувати змінні середовища замість зберігання даних конфігурації в настроюваних таблицях?

Так, якщо дані конфігурації не є реляційним. Змінні середовища слід використовувати для пар ключ: значення, і для ситуацій, коли значення, скоріш за все, буде іншим в інших середовищах. Інші засоби, наприклад утиліта міграції конфігурації, краще пристосовані для міграції реляційних даних конфігурації, що зберігаються у настроюваних таблицях. На відміну від інших даних конфігурації, змінні середовища переносяться як частина рішення, отже вони значно простіші у керуванні та ефективніші при імпортуванні.

Чому моє підключення не зберігається для змінних середовища джерела даних?

Підключення використовуються лише для створення інтерфейсу користувача. Наприклад, щоб отримати дружні назви для списків SharePoint, пов'язаних із сайтом. Під час редагування змінної середовища джерела даних обов’язково виберіть підключення з доступом до джерела даних. Якщо ви більше не маєте доступу до підключення, ви можете вручну ввести значення. Наприклад, введіть URL сайту SharePoint або унікальний ідентифікатор (GUID) для списку.

Якщо для однієї змінної середовища (типу джерела даних) доступні кілька з’єднань, передбачено реалізацію, що передбачає вибір першого з’єднання в списку з’єднань. Оскільки зазвичай існує лише одне з’єднання, пов’язане зі змінною середовища, це не те, що зазвичай потрібно перевіряти. Крім того, завдяки останнім змінам видимості значення змінної середовища це легше перевірити під час імпорту.

Як видалити значення зі змінної середовища?

Можливо, перед експортуванням рішення буде потрібно видалити значення змінної середовища. Тоді наявне значення залишається у вашому середовищі розробки, але не експортується в рішення. Цей підхід дозволяє задати нове значення під час імпортування рішення до іншого середовища.

Щоб видалити значення, виконайте наведені нижче кроки.

1. У рішенні, де розташована змінна середовища, виберіть змінну середовища, щоб відобразити властивості.

2. У розділі Поточне значення виберіть ...>Видалити з цього рішення.

   

Чи можу я використовувати змінні середовища в настроюваних з’єднувачах?

Так. Підтримка змінних середовища в настроюваних конекторах

Див. також

Використання змінних середовища джерела даних у програмах на полотні
Використовувати змінні середовища в Power Automate хмарних потоках рішення
EnvironmentVariableDefinition таблиця/сутність
Web API зразки
Використовуйте змінні середовища джерела даних у додатках Canvas
Використовуйте змінні середовища в Power Automate хмарних потоках рішення
Використовуйте Azure Key Vault secrets
підтримка змінних середовища у власних конекторах
Power Apps Блог: Змінні середовища доступні у попередньому перегляді!