Как получить значение реквизита на клиенте 1С: 5 способов

Работа с реквизитами объектов на клиентской стороне в 1С:Предприятие — одна из самых частых задач для разработчиков. Однако не все знают, что получение значений реквизитов на клиенте имеет свои особенности, отличающиеся от серверных операций. В этой статье разберём все актуальные способы чтения реквизитов в клиентском контексте, включая нюансы работы с управляемыми формами, динамическими списками и внешними компонентами.

Главная сложность заключается в том, что не все реквизиты доступны напрямую на клиенте из-за ограничений платформы. Например, реквизиты объектов базы данных (справочников, документов) требуют специальных методов для чтения, а значения реквизитов форм могут зависеть от текущего состояния интерфейса. Мы рассмотрим не только стандартные подходы через ЭтотОбъект или Объект.Реквизит, но и альтернативные решения для сложных сценариев.

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

1. Базовые методы получения реквизитов на клиенте

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

Самый прямой способ — обращение к реквизиту через точку:

ЗначениеРеквизита = Объект.ИмяРеквизита;

Такой синтаксис работает для реквизитов текущей формы, элементов управления и даже для некоторых объектов базы данных (если они загружены на клиент). Например, чтобы получить значение реквизита Контрагент в форме документа, достаточно написать:

ТекущийКонтрагент = ЭтотОбъект.Контрагент;

Однако здесь есть важные нюансы:

🔹 Для управляемых форм используйте ЭтотОбъект.Значение или ЭлементыФормы.ИмяЭлемента.Значение, так как реквизиты формы и элементы управления — разные сущности.
🔹 Для обычных форм можно обращаться напрямую к реквизитам через ЭтотОбъект, но только если они объявлены как экспортные.
🔹 Для объектов базы данных (справочников, документов) прямой доступ к реквизитам на клиенте часто ограничен — потребуется загрузка объекта или использование серверных функций.

Если реквизит является объектом (например, ссылкой на справочник), его значение можно получить как ссылку или как строку представления:

СсылкаНаКонтрагента = ЭтотОбъект.Контрагент; // Возвращает ссылку

НаименованиеКонтрагента = ЭтотОбъект.Контрагент.Наименование; // Возвращает строку

Но помните: доступ к вложенным реквизитам (например, Контрагент.Наименование) может вызвать серверный вызов, если объект не загружен на клиент полностью.

2. Работа с реквизитами в управляемых формах

Управляемые формы в 1С:Предприятие 8.3 имеют свою специфику работы с реквизитами. Здесь значение реквизита и значение элемента формы — это разные вещи, и их легко перепутать. Например, если у вас есть реквизит формы ДатаДокумента и поле ввода с таким же именем, то:

📝 ЭтотОбъект.ДатаДокумента — значение реквизита формы (может не совпадать с тем, что введён в поле).
🖥️ ЭлементыФормы.ДатаДокумента.Значение — текущее значение элемента управления (то, что видит пользователь).

Чтобы синхронизировать эти значения, используйте метод УстановитьЗначениеРеквизита():

ЭтотОбъект.УстановитьЗначениеРеквизита("ДатаДокумента", ЭлементыФормы.ДатаДокумента.Значение);

Обратная операция (обновление поля по изменению реквизита) выполняется автоматически, если свойство ПутьКДанным элемента формы настроено корректно.

Для динамического чтения реквизитов в управляемых формах также полезен метод ПолучитьФорму(), который возвращает объект формы и позволяет работать с её реквизитами:

ФормаОбъекта = ЭтотОбъект.ПолучитьФорму();
ТекущаяСумма = ФормаОбъекта.СуммаДокумента;

💡

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

3. Чтение реквизитов объектов базы данных на клиенте

С реквизитами объектов базы данных (справочников, документов, планов видов характеристик) на клиенте работать сложнее, так как платформа 1С:Предприятие по умолчанию не загружает их значения на клиентскую сторону. Attempt to read a property that is not loaded on the client — типичная ошибка при попытке доступа к незагруженному реквизиту.

Есть несколько способов решения этой проблемы:

Загрузка объекта полностью с помощью метода Загрузить():

Объект = Документы.ЗаказПокупателя.НайтиПоНомеру("000123");
Объект.Загрузить();
СуммаЗаказа = Объект.СуммаДокумента; // Теперь доступно на клиенте

Частичная загрузка только нужных реквизитов через ЗагрузитьРеквизиты():

Объект.ЗагрузитьРеквизиты(Новый Массив("СуммаДокумента", "Контрагент"));

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

Важно понимать, что Загрузить() и ЗагрузитьРеквизиты() выполняют серверный вызов, поэтому их частое использование может замедлить работу системы. Оптимальный подход — загружать только те реквизиты, которые действительно нужны на клиенте.

Что делать, если объект не найден?

Если метод НайтиПоНомеру() или ПолучитьСсылку() возвращает Неопределено, проверьте:

1. Существует ли объект с таким номером в базе.

2. Достаточно ли прав у текущего пользователя для чтения этого объекта.

3. Не удалён ли объект (проверьте через ПометкаУдаления).

4. Получение значений реквизитов в динамических списках

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

Основные методы работы с реквизитами в динамических списках:

📋 Через колонки списка: если реквизит отображается в колонке, его значение можно получить через ТекущаяСтрока.Колонка:
```
ТекущаяСумма = ЭлементыФормы.СписокДокументов.ТекущаяСтрока.Сумма;
```

🔄 Через метод Получить(): для произвольных реквизитов, не отображаемых в списке:

ДатаДокумента = ЭлементыФормы.СписокДокументов.ТекущаяСтрока.Получить("Дата");

🔍 Через серверную функцию: если реквизит не доступен на клиенте, но нужен для логики (например, для фильтрации).

Обратите внимание: значения в динамических списках кэшируются. Если данные на сервере изменились (например, другой пользователь изменил документ), а список не обновлялся, вы получите устаревшие значения. Чтобы избежать этого, используйте метод Обновить():

ЭлементыФормы.СписокДокументов.Обновить();

Проверьте, что реквизит добавлен в колонки списка|Используйте ТекущаяСтрока.Получить() для скрытых реквизитов|Обновляйте список после изменений на сервере|Избегайте частого обращения к серверу в цикле-->

5. Асинхронное получение реквизитов и работа с сервером

В некоторых сценариях значение реквизита нужно получить асинхронно, чтобы не блокировать интерфейс. Например, если реквизит требует длительных вычислений на сервере или загрузки больших данных. Для этого в 1С:Предприятие есть механизм ВыполнитьОжидание и ПоказатьОжидание.

Пример асинхронного получения реквизита через серверную функцию:

Процедура ПолучитьСуммуДокументаНаСервере(НомерДокумента) Экспорт
Документ = Документы.ЗаказПокупателя.НайтиПоНомеру(НомерДокумента);
Возврат Документ.СуммаДокумента;
КонецПроцедуры

// На клиенте:
Ожидание = ПоказатьОжидание("Загрузка данных...");
ВыполнитьОжидание(Новый ОписаниеОповещения("ПослеПолученияСуммы", ЭтотОбъект, НомерДокумента));

Процедура ПослеПолученияСуммы(Результат, ДополнительныеПараметры) Экспорт
ЗакрытьОжидание(Ожидание);
Сообщить("Сумма документа: " + Результат);
КонецПроцедуры

Такой подход полезен, когда:

🕒 Нужно получить данные, вычисление которых занимает много времени.
🖥️ Требуется избежать "замораживания" интерфейса.
🔒 Данные нужно получить с сервера, но без блокировки клиентской логики.

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

💡

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

6. Типичные ошибки и как их избежать

При работе с реквизитами на клиенте разработчики часто сталкиваются с одними и теми же проблемами. Разберём наиболее распространённые ошибки и способы их решения.

Ошибка	Причина	Решение
`Attempt to read a property that is not loaded on the client`	Попытка прочитать реквизит объекта базы данных, который не загружен на клиент.	Используйте `Загрузить()` или `ЗагрузитьРеквизиты()` перед чтением.
Значение реквизита не обновляется в форме	Свойство `ПутьКДанным` элемента формы настроено неверно.	Проверьте привязку элемента формы к реквизиту в конфигураторе.
`Неопределено` при обращении к реквизиту динамического списка	Реквизит не добавлен в колонки списка и не доступен через `Получить()`.	Добавьте реквизит в колонки или используйте серверную функцию для его получения.
Зависание интерфейса при чтении реквизита	Длительная серверная операция блокирует клиентский поток.	Перенесите операцию в асинхронный вызов с `ВыполнитьОжидание`.

Ещё одна частая проблема — несоответствие типов данных. Например, если реквизит в базе имеет тип Число, а на клиенте вы пытаетесь присвоить ему строку, платформа может не выдать ошибку сразу, но логика работы нарушится. Всегда проверяйте типы данных с помощью функции ТипЗнч():

Если ТипЗнч(ЗначениеРеквизита) <> Тип("Число") Тогда
Сообщить("Ошибка: ожидалось число!");
КонецЕсли;

Сообщить("Значение: " + ЗначениеРеквизита + ", Тип: " + ТипЗнч(ЗначениеРеквизита));

Это поможет быстро найти несоответствия типов.-->

7. Альтернативные способы: внешние компоненты и DirectCLR

В редких случаях, когда стандартные методы не подходят (например, при интеграции с внешними системами), можно использовать внешние компоненты или DirectCLR для работы с реквизитами. Это актуально для:

🔌 Интеграции с оборудованием (сканеры, весы), где значения реквизитов приходят извне.
🌐 Взаимодействия с веб-сервисами, где реквизиты обновляются по API.
🖥️ Работы с низкоуровневыми функциями Windows через DirectCLR.

Пример использования внешней компоненты для чтения реквизита из оборудования:

ВнешняяКомпонента = Новый COMОбъект("MyDevice.ComComponent");
ЗначениеШтрихкода = ВнешняяКомпонента.ReadBarcode();
ЭтотОбъект.Штрихкод = ЗначениеШтрихкода;

Для работы с DirectCLR потребуется подключить сборку .NET и написать обёртку на C#. Например, чтобы получить значение реквизита из файла конфигурации Windows:

// На стороне C# (упрощённо)
public string GetRegistryValue(string keyName) {
return Microsoft.Win32.Registry.GetValue(...).ToString();
}

// В 1С:
CLRОбъект = Новый COMОбъект("MyCLRLibrary.Class1");
ЗначениеИзРеестра = CLRОбъект.GetRegistryValue("MyKey");
ЭтотОбъект.Настройка = ЗначениеИзРеестра;

Ограничения внешних компонент

1. Требуют регистрации в системе (для COM).

2. Могут не работать в веб-клиенте или тонком клиенте.

3. Потенциальные проблемы с безопасностью (проверяйте источники компонент).

8. Оптимизация производительности при работе с реквизитами

Неэффективное чтение реквизитов может значительно замедлить работу клиентского приложения. Вот ключевые рекомендации по оптимизации:

🚀 Минимизируйте серверные вызовы: загружайте только необходимые реквизиты с помощью ЗагрузитьРеквизиты().
🔄 Используйте кэширование: если реквизит читается часто, сохраните его значение в переменной на клиенте.
📊 Оптимизируйте динамические списки: добавьте нужные реквизиты в колонки заранее, чтобы избежать вызовов Получить().
⚡ Избегайте вложенных чтений: если вам нужно значение Контрагент.Наименование, сначала проверьте, загружен ли Контрагент на клиент.

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

// Плохо: отдельные вызовы для каждого реквизита
Документ.Загрузить();
Сумма = Документ.СуммаДокумента;
Дата = Документ.Дата;
Контрагент = Документ.Контрагент;

// Хорошо: одна загрузка для всех нужных реквизитов
Документ.ЗагрузитьРеквизиты(Новый Массив("СуммаДокумента", "Дата", "Контрагент"));
Сумма = Документ.СуммаДокумента;
Дата = Документ.Дата;
Контрагент = Документ.Контрагент;

Также обратите внимание на контекст выполнения. Если вы работаете в модуле формы, используйте ЭтотОбъект для доступа к реквизитам формы. Если в общем модуле с флагом Клиент — передавайте ссылки на объекты явным образом, чтобы избежать лишних серверных вызовов.

💡

Оптимизация работы с реквизитами на клиенте может ускорить выполнение кода в 2-3 раза, особенно в формах с большим количеством элементов.

FAQ: Частые вопросы по работе с реквизитами на клиенте

Можно ли получить значение реквизита объекта базы данных на клиенте без загрузки?

Нет, платформа 1С:Предприятие не позволяет читать реквизиты объектов базы данных на клиенте без предварительной загрузки. Attempt to access unloaded property — стандартная ошибка в этом случае. Используйте Загрузить() или ЗагрузитьРеквизиты().

Почему значение реквизита в форме не совпадает с тем, что в базе данных?

Это происходит из-за того, что форма работает с копией данных, а не с оригинальным объектом. Если другой пользователь изменил объект на сервере, а форма не обновлялась, вы увидите устаревшие данные. Используйте метод Обновить() для синхронизации.

Как получить значение реквизита в динамическом списке, если оно не отображается в колонках?

Используйте метод Получить() для текущей строки:

Значение = ЭлементыФормы.Список.ТекущаяСтрока.Получить("ИмяРеквизита");

Убедитесь, что реквизит доступен в настройках списка (включён в запрос).

Можно ли изменить значение реквизита на клиенте без сохранения на сервер?

Да, но только для реквизитов формы. Изменение реквизитов объектов базы данных (справочников, документов) требует серверного вызова и записи. Пример для формы:

ЭтотОбъект.РеквизитФормы = НовоеЗначение; // Изменяется только на клиенте

ЭтотОбъект.Записать(); // Сохраняет изменения на сервер (если форма привязана к объекту)

Как отладить ошибки при чтении реквизитов на клиенте?

Используйте следующие приёмы:

Проверяйте загруженность объекта: Если Не Объект.Загружен() Тогда....
Выводите тип значения: Сообщить(ТипЗнч(Объект.Реквизит)).
Включите отладку в конфигураторе и ставьте точки останова на клиентских процедурах.
Проверяйте права доступа текущего пользователя к реквизиту.

Получение значения реквизита на клиенте в 1С: методы, примеры и подводные камни