Используйте настройки для обеспечения индивидуального взаимодействия с приложением

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

Настройки состоят из трех подкомпонентов: настройка определения, настройка значения среды и настройка значения приложения.

Подкомпонент Описание
Определение параметра
  • Разработчики приложений, администраторы или партнеры могут создать определение параметра, которое включает такие свойства, как имя, описание, тип данных, значение по умолчанию и многое другое.
  • Затем они могут с помощью кода использовать значение параметра для включения, отключения или настройки предоставляемой функции.
  • Они могут включить определение параметра в решение, которое используется для предоставления функции своим клиентам.
  • Пример:
    • В Обработчик асинхронного сохранения для приложений на основе моделей — это функция из Power Apps, которая использует настройки.
    • Настройка типа Да/нет и значение этого параметра по умолчанию — Нет.
    • Поэтому по умолчанию функция Обработчик асинхронного сохранения будет отключена для всех приложений на основе модели.
Настройка значения в среде
  • Настройка значения среды может использоваться для переопределения значения по умолчанию, как указано в настройке определения.
  • Пример:
    • Расширяя приведенный выше пример, администратор среды в организации клиента может добавлять значение среды настройки для параметра Обработчик асинхронного сохранения и задавать его как Да.
    • Это значение среды настройки переопределит значение по умолчанию и будет применяться ко всем приложениям в этой среде.
    • Это разрешит функцию Обработчик асинхронного сохранения для всех приложений на основе модели в этой среде.
Настройка значения приложения
  • Настройка значения приложения может использоваться для переопределения значения по умолчанию и настройки значения среды (если существует).
  • Пример:
    • Еще раз, расширяя приведенный выше пример, разработчик приложения в той же среде, приведенной выше, может добавить значение настройки приложения для параметра Обработчик асинхронного сохранения для приложения, которое они создают, и установить для него Нет
    • Это значение параметра приложения переопределит значение среды настройки и будет применяться только к этому отдельному приложению.
    • Это разрешит функцию Обработчик асинхронного сохранения для этого единственного приложения.

Примечание

Чтобы выполнить шаги, перечисленные ниже, у вас должна быть включена предварительная версия решения. В области Решения в 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.

См. также

Для разработчиков: