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

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

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

Примітка

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

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

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

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

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

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

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

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

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

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

     Примітка

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

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

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

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

     

     Примітка

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

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

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

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

Примітка

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

Сповіщення

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

Безпека

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

Іменування

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

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

• Перевірка значень змінних середовища відбувається в інтерфейсах користувача та в компонентах, які їх використовують, але не в 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?

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

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

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

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

Так.

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

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

Чому під час імпорту автоматично призначається інше значення з’єднання, ніж те, яке потрібно призначити?

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

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

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

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

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

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

   

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

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

Див. також

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

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).