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


Використання параметрів для настроювання програм

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

Параметри складаються з трьох підкомпонентів: визначення параметра, значення параметра для середовища та значення параметра для програми.

Підкомпонент Опис
Визначення параметра
  • Автори програм, адміністратори або партнери можуть створити визначення параметра, яке матиме такі властивості, як ім’я, опис, тип даних, стандартне значення тощо.
  • Потім вони можуть за допомогою коду використовувати значення параметра, щоб вмикати, вимикати чи настроювати потрібну функцію.
  • Вони можуть включати визначення параметра в рішення, яке використовується для надання функції клієнтам.
  • Приклад:
    • Асинхронний обробник save для модельних програм – це функція з Power Apps, яка використовує параметри.
    • Параметр має тип Так/Ні, а стандартне значення цього параметра – Ні.
    • Отже, за промовчанням Асинхронний обробник save буде вимкнуто для всіх модельних програм.
Значення параметра для середовища
  • Значення параметра для середовища можна використовувати, щоб змінити стандартне значення, зазначене у визначенні параметра.
  • Приклад:
    • Якщо продовжити приклад, наведений вище, адміністратор середовища в організації клієнта може додати для параметра Асинхронний обробник save значення для середовища та вибрати для нього варіант Так.
    • Це значення параметра для середовища змінить стандартне значення і буде застосоване до всіх програм у цьому середовищі.
    • Це активує функцію Асинхронний обробник save для всіх модельних програм у даному середовищі.
Значення параметра для програми
  • Значення параметра для програми можна використовувати, щоб змінити стандартне значення, зазначене у визначенні параметра, і значення параметра для середовища (якщо таке є).
  • Приклад:
    • Знову продовжуючи приклад, наведений вище: автор програми в тому самому середовищі може додати значення параметра Асинхронний обробник save для своєї програми та вибрати для нього варіант Ні.
    • Це значення параметра для програми замінить значення для середовища та застосовуватиметься лише до цієї програми.
    • Таким чином, функцію Асинхронний обробник save буде активовано для цієї окремої програми.

Примітка

Щоб виконати кроки, перелічені нижче, потрібно активувати параметр Підготовчу версію рішення ввімкнуто. Переконайтеся, що в області Рішення в Power Apps, на панелі команд, активовано параметр Підготовчу версію рішення ввімкнуто. Якщо відображається Підготовчу версію рішення вимкнуто, виберіть цей параметр, щоб увімкнути підготовчу версію. Додаткові відомості: Подання рішення

Визначення параметра

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

Властивість Опис
Коротке ім’я. Ім’я, яке відображається для споживачів параметра в усіх інтерфейсах користувача, де показано цей параметр.
Унікальне ім'я Унікальна назва параметра в середовищі.
Ім’я створюється автоматично на основі наданого короткого імені, але його можна змінити перед створенням параметра. Після створення параметра значення Ім’я не можна змінити, оскільки на нього можуть посилатися програми або код.
Значення Ім’я має префікс, який відповідає видавцю рішення. Ціль цього префікса – забезпечити параметр унікальним іменем на випадок, якщо ви його імпортуватимете до іншого рішення або середовища (де буде використовуватися інший префікс).
Опис Опис допоможе іншим користувачам зрозуміти, для чого використовується параметр у всіх інтерфейсах користувача, де цей параметр відображається.
Тип даних Тип даних параметра визначає спосіб збереження значення параметра. Можна встановити тип даних Число, Рядок або Так/ні. Тип даних не можна змінити після створення параметра.
Стандартне значення Після вибору типу даних стає доступним стандартне значення. Це значення параметра, яке використовуватиметься, якщо його не буде замінено значенням для середовища або значенням для програми.
Значення можна змінити для Параметр можна перезаписати на одному з наведених нижче рівнів.
  • Середовище та програма: стандартне значення можна перезаписати значенням параметра для середовища чи значенням параметра для програми.
  • Лише середовище: стандартне значення можна перезаписати лише значенням параметра для середовища.
  • Лише програма: стандартне значення можна перезаписати лише значенням параметра для програми.
  • Немає: значення неможливо перезаписати.
Рівень випуску Рівень випуску використовується для інформування платформи та інших споживачів про параметр стану функції, з якою використовується цей параметр. Для рівня випуску можна вибрати значення Загальнодоступний або Підготовча версія.
Інформаційна URL-адреса Посилання на документацію, яка допоможе користувачам зрозуміти мету параметра. Буде використано як посилання Дізнатися більше в усіх інтерфейсах користувача, де відображаються параметри.

Додавання нового визначення параметра

  1. Увійти до Power Apps.
  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.
  3. Зі списку рішень відкрийте те, до якого потрібно додати параметр.
  4. На панелі команд виберіть Створити > Додатково > Параметри > Визначення параметра.
  5. У діалоговому вікні Створення параметра укажіть значення для кожної властивості залежно від ваших потреб. Відомості про властивості визначення параметра див. тут: Визначення параметра
  6. Після вибору значень для властивостей натисніть Зберегти.

Додавання наявного визначення параметра

  1. Увійти до Power Apps.
  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.
  3. Зі списку рішень відкрийте те, до якого потрібно додати параметр.
  4. На панелі команд виберіть Додати наявне > Додатково > Параметри.
  5. В діалоговому вікні Додавання наявного визначення параметра виберіть один чи кілька параметрів, які потрібно додати.
  6. Після вибору параметрів натисніть кнопку Далі.
  7. У діалоговому вікні Визначення вибраного параметра для кожного вибраного параметра буде доступна функція Включити визначення параметра. Ви також можете Включити значення параметра для середовища, якщо таке значення існує.
  8. Натисніть кнопку Додати, щоб додати визначення параметра та/або значення параметра для середовища.

Оновлення визначення параметра

  1. Увійти до Power Apps.
  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.
  3. Зі списку рішень відкрийте те, у якому ви створили параметр.
  4. У поданні дерева виберіть Параметри > Визначення параметра.
  5. Виберіть визначення параметра, яке потрібно оновити.
  6. У діалоговому вікні Редагування параметрів оновіть значення для властивостей, які потрібно змінити.
    Зауважте, що після створення параметра деякі властивості оновити не можна. Крім того, у більшості випадків ви не зможете оновлювати визначення параметрів, за які ви не відповідаєте.
  7. Після оновлення значень для властивостей натисніть Зберегти.

Вилучення визначення параметра

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

Вилучення визначення параметра

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

Налаштування значення середовища

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

Додавання нового значення параметра для середовища

  1. Увійти до Power Apps.

  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.

  3. Зі списку рішень відкрийте те, до якого потрібно додати значення параметра для середовища.

  4. Якщо визначення параметра доступне в рішенні:

    1. Виберіть визначення параметра.
    2. У діалоговому вікні Редагування значення параметра в розділі Значення параметра для середовища виберіть Нове значення.
    3. Укажіть значення та натисніть кнопку Зберегти.

    Якщо визначення параметра не доступне в рішенні:

    1. На панелі команд виберіть Створити > Додатково > Параметри > Значення параметра для середовища.
    2. Виберіть параметр, для якого потрібно додати значення параметра для середовища, а потім натисніть кнопку Додати.
    3. У діалоговому вікні Нове значення параметра для середовища в розділі Значення параметра для середовища виберіть Нове значення.
    4. Укажіть значення та натисніть кнопку Зберегти.

Додавання наявного значення параметра для середовища

  1. Увійти до Power Apps.

  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.

  3. Зі списку рішень відкрийте те, до якого потрібно додати значення параметра для середовища.

  4. Якщо визначення параметра доступне в рішенні:

    1. Виберіть визначення параметра.
    2. У діалоговому вікні Редагування значення параметра в розділі Значення параметра для середовища виберіть Додати наявне значення.
    3. Оновіть значення в разі потреби, а потім виберіть Зберегти.

    Якщо визначення параметра не доступне в рішенні:

    1. На панелі команд виберіть Додати наявне > Додатково > Параметри.
    2. В діалоговому вікні Додавання наявного визначення параметра виберіть один чи кілька параметрів, для яких потрібно додати значення для середовища.
    3. Після вибору параметрів натисніть кнопку Далі.
    4. У діалоговому вікні Визначення вибраного параметра для кожного вибраного параметра буде доступна функція Включити значення параметра для середовища, якщо таке значення є. Ви також можете Включити визначення параметра для кожного параметра за потреби.
    5. Натисніть кнопку Додати, щоб додати визначення параметра та/або значення параметра для середовища.

Оновлення значення параметра для середовища

  1. Увійти до Power Apps.
  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.
  3. Зі списку рішень відкрийте те, до якого ви додали значення параметра для середовища.
  4. У поданні дерева виберіть Параметри > Значення параметра для середовища.
  5. Виберіть значення параметра для середовища, яке потрібно оновити.
  6. У діалоговому вікні Редагування значення параметра в розділі Значення параметра для середовища оновіть значення, потім виберіть Зберегти.

Вилучення значення параметра для середовища

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

Видалення значення параметра для середовища

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

Значення параметра для програми

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

Примітка

Щоб виконати дії, перелічені нижче, скористайтеся новим конструктором програм. Наразі в конструкторі програм відображаються лише параметри платформи Power Apps. Для параметрів, що не відносяться до платформи, використовуйте провідник рішень, як описано нижче.

Додавання або оновлення значення параметра для програми за допомогою конструктора програм

  1. Відкрийте програму, для якої потрібно додати значення параметра для програми, у конструкторі програм.
  2. На панелі команд виберіть елемент Настройки.
  3. У діалоговому вікні Параметри виберіть вкладку Функції або Найближчі.
    На вкладці Функції відображаються всі параметри, для яких установлено рівень випуску Загальнодоступний. На вкладці Найближчі відображаються всі параметри, для яких установлено рівень випуску Підготовча версія.
  4. Додайте або оновіть значення потрібного параметра для програми.
  5. Збережіть та опублікуйте програму.

Вилучення значення параметра для програми за допомогою конструктора програм

  1. Відкрийте програму, для якої потрібно вилучити значення параметра для програми, у конструкторі програм.
  2. На панелі команд виберіть елемент Настройки.
  3. У діалоговому вікні Параметри виберіть вкладку Функції або Найближчі.
  4. Виберіть Скинути до значення для середовища поруч зі значенням параметра для програми, яке потрібно видалити. Якщо значення параметра для середовища існує, воно буде відновлено як значення параметра. Якщо значення параметра для середовища не існує, буде відновлено стандартне значення.
    Зверніть увагу: параметр Скинути до значення для середовища відображається, лише якщо для цього параметра було раніше додано значення параметра для програми.
  5. Збережіть та опублікуйте програму.

Додавання або оновлення значення параметра для програми за допомогою провідника рішень

  1. Увійти до Power Apps.
  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.
  3. Зі списку рішень відкрийте те, до якого потрібно додати значення параметра для програми.
  4. Якщо визначення параметра або значення параметра для середовища недоступні в рішенні, додайте одне з них. Виберіть Додавання наявного визначення параметра або Додавання наявного значення параметра для середовища.
  5. Виберіть визначення параметра або значення параметра для середовища.
  6. У діалоговому вікні Редагування значення параметра в розділі Значення параметра для програми знайдіть програму, стосовно якої потрібно додати значення параметра для програми. Зауважте, що за допомогою провідника рішень можна додавати значення параметра для програми лише стосовно тих програм, які існують у поточному рішенні.
  7. Укажіть значення та натисніть кнопку Зберегти.
  8. Щоб значення параметра для програми набрало сили, потрібно повторно опублікувати програму за допомогою конструктора програм або провідника рішень.

Видалення значення параметра для програми за допомогою провідника рішень

  1. Увійти до Power Apps.
  2. В області переходів виберіть Рішення. Якщо елемента немає на бічній панелі, виберіть ... Додатково та знайдіть потрібний елемент.
  3. Зі списку рішень відкрийте те, з якого потрібно видалити значення параметра для програми.
  4. Якщо визначення параметра або значення параметра для середовища недоступні в рішенні, додайте одне з них. Додаткова інформація: Додавання наявного визначення параметра або Додавання наявного значення параметра для середовища.
  5. Виберіть визначення параметра або значення параметра для середовища.
  6. У діалоговому вікні Редагування значення параметра в розділі Значення параметра для програми знайдіть програму, стосовно якої потрібно видалити значення параметра для програми. Зауважте, що за допомогою провідника рішень можна видаляти значення параметра для програми лише стосовно тих програм, які існують у поточному рішенні.
  7. Виберіть ... поруч із налаштуванням значення програми, а потім виберіть Скинути до середовища.
  8. Виберіть Зберегти.
  9. Щоб видалення значення параметра для програми набрало сили, потрібно повторно опублікувати програму за допомогою конструктора програм або провідника рішень.

Отримання або оновлення значення параметра за допомогою коду

Доступні методи див тут: Отримання або оновлення значення параметра за допомогою API клієнта.

Див. також

Для розробників: