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

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

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

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

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

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

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

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

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

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

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

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

     Нотатка

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

     • Якщо вибрано тип Secret , потрібна додаткова інформація для налаштування та конфігурації Azure Key Vault, щоб дозволити Power Platform доступ до секрету.

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

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

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

     

     Нотатка

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

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

На вкладці Загальні налаштувань Power Apps :

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

  

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

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

Microsoft Dataverse

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

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

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

SharePoint

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

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

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

SQL Server

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

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

Змінні середовища джерела даних використовуються для конекторів з аутентифікацією, наприклад 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 списків, пов’язаних із сайтом. Під час редагування змінної середовища джерела даних обов’язково виберіть підключення з доступом до джерела даних. Якщо ви більше не маєте доступу до підключення, ви можете вручну ввести значення. Наприклад, введіть SharePoint URL сайту або унікальний ідентифікатор (GUID) для списку.

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

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

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

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

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

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

   

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

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

Див. також

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