# Доступ к свойствам элементов

> [HTML Version](app-properties-access.html)

В поставке On‑Premises, начиная с версии 2025.10, есть возможность ограничить доступ к просмотру и редактированию пользовательских полей в карточках элементов приложения.

Например, в приложении **Договоры** просматривать поле **Сумма договора** в карточках элементов могут менеджеры, а редактировать — только руководитель отдела.

Обратите внимание, установить ограничение для системных полей можно только с помощью опции [Ограничить доступ к данным](360007527512.md#limit). Например, пользователь с правами типа **Просмотр** на уровне элементов приложения может просматривать все системные поля в карточке элемента.

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

Чтобы настроить ограничение:

1. Нажмите значок шестерёнки справа от названия приложения и выберите **Настройка доступа**.

2. В правом верхнем углу нажмите кнопку **Доступ к свойствам элементов**.

3. Нажмите **+ Добавить свойство** и выберите пользовательское поле, к которому хотите ограничить доступ.

4. Нажмите кнопку **+ Добавить** и выберите объект для назначения прав доступа:

- пользователь, [группа пользователей](360007146071.md) и [элемент организационной структуры](360003861992.md#orgchart_item);

- **Системное поле** — свойство **Автор**, **Исполнители** или **Подписчики**;

- [Свойство приложения](element-right.md#application-property).

5. Укажите, какие права будут доступны для выбранного объекта: **Просмотр** или **Редактирование**.

**(properties-access.png)**

Пользователь с правами на редактирование свойства может изменять его значение в нескольких элементах, используя [массовое редактирование](mass_actions.md#use-mass-edit).

6. ## Нажмите Сохранить.

## Как применяется ограничение доступа к свойствам

1. **Поиск элементов приложения**.

Поиск можно выполнять только по доступным полям. В окне расширенного поиска пользователь не увидит поля, к которым нет доступа. Также в строке для EQL-поиска не отобразятся для выбора недоступные свойства.

2. **Отображение данных на страницах**.

Если недоступные свойства используются на страницах, в отчётах, графиках и таблицах, информация будет скрыта:

- при выборе параметров для построения графика или отчёта не отобразятся фильтры с недоступными данными;

- на странице не сформируется график, в котором настроено отображение недоступных полей;

- в таблице и отчёте пользователь увидит пустую ячейку вместо недоступных данных.

3. **Экспорт данных**.

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

4. **Скрипты**.

Ограничение прав учитывается только в клиентских скриптах. При этом:

- при обращении к недоступному свойству возвращается значение `undefined`. Если в скрипте не предусмотрена обработка `undefined`, скрипт завершится с ошибкой;

- поиск по недоступным свойствам не выполняется, поэтому в методах `.first()`, `.count()`, `.all()` будет возвращаться пустой результат. Если не настроена проверка на пустые значенияи, скрипт завершится с ошибкой.

5. **Методы API**.

При использовании методов API в приложениях:

- в ответ на запрос возвращаются только те свойства, на чтение которых есть права у пользователя — владельца API-токена;

- при создании или изменении элемента игнорируются свойства, на редактирование которых нет прав у пользователя — владельца API-токена. Остальные данные изменяются в соответствии с запросом.