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

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

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

Нотатка

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

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

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

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

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

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

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

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

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

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

     Нотатка

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

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

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

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

     

     Нотатка

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

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

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

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

Нотатка

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

Сповіщення

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

Безпека

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

Іменування

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

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

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

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

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

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

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

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

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

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

Чи можуть змінні середовища джерела даних використовуватись із підключеннями, що використовуються спільно, такими як SQL Server із автентифікацією SQL?

Зазвичай ні. Підключення, спільні з SQL Server, зберігають параметри, необхідні для підключення до даних у підключенні. Наприклад, ім'я сервера та бази даних надаються під час створення підключення, тому вони завжди отримуються з підключення.

Змінні середовища джерело даних використовуються для конекторів, які покладаються на автентифікацію на основі користувача, таких як Microsoft Entra ID, оскільки параметри не можуть бути отримані з підключення. Тому автентифікація за допомогою SQL Server, що є спільним підключенням, не використовуватиме змінні середовища джерела даних.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Так.

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

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

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

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

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

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

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

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

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

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

   

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

Так. Підтримка змінних середовища у користувальницьких конекторах

Див. також

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