Другое · 11 мин
Передача структуры в 1С: способы, параметры и проверка
Практически о передаче структуры в 1С: по ссылке или копией, между клиентом и сервером, в формах и обменах, проверка результата и типичные ошибки.
В 1С:Предприятие структура — это набор пар «имя поля — значение», который часто используется в качестве параметра процедуры или функции, источника данных формы и аргумента вызова серверного метода. Передача структуры не дублирует весь набор полей автоматически: сложные типы, к которым относится структура, обычно передаются по ссылке, а не по значению. Поэтому вызывающий и вызываемый код могут работать с одним и тем же объектом в памяти.
Если получателю нужно только прочитать поля, достаточно принять структуру как параметр и обращаться к свойствам по именам. Если вызываемая процедура меняет поля, изменения сохранятся у вызывающего кода, если не сделано явное копирование. Это удобно для возврата нескольких значений через один параметр, но создаёт риск неконтролируемого изменения данных.
Способ передачи зависит от того, где запущен код: в одном модуле, между клиентом и сервером, в форме документа или при обмене с внешней системой. Внутри одной информационной базы структура чаще всего передаётся как обычный параметр, а через границы процесса или при интеграции требуется сериализация в XML, JSON или таблицу значений.
Перед передачей проверьте, что структура существует, поля имеют ожидаемые имена и типы, а получатель поддерживает сложные параметры. Пустая структура и структура с отсутствующим полем — разные ситуации, и код должен обрабатывать оба варианта явно.
Передача структуры внутри одного модуля и между процедурами
В пределах одного модуля структура объявляется, заполняется полями и передаётся в вызов без дополнительной подготовки. Вызываемая процедура принимает её в параметре и обращается к полям по именам. Если процедура изменяет значение поля, вызывающий код видит это изменение после возврата управления, так как объект не копируется.
Чтобы получить независимую копию, создайте новую структуру и скопируйте в неё поля исходной, либо используйте встроенные средства копирования, доступные в вашей конфигурации и версии платформы. Префикс Знач не гарантирует копирование всей структуры, поэтому не полагайтесь на него как на единственное средство защиты от изменений.
Проверка результата заключается в сравнении значений полей до и после вызова. Если поля не должны меняться, убедитесь, что вызываемая процедура не записывает в переданную структуру. Для чтения используйте только доступ к свойствам без записи.
- 1Создайте структуру и заполните необходимые поля
- 2Передайте её в параметр процедуры или функции
- 3В вызываемом коде читайте или меняйте поля по Names
- 4Если изменения недопустимы, передайте копию структуры
- 5После вызова проверьте значения полей у вызывающего кода
Сценарий с возвратом нескольких значений через одну структуру удобен, когда набор полей заранее известен и невелик. Если полей много или состав меняется, лучше рассмотреть таблицу значений или отдельные параметры, чтобы код оставался понятным.
При передаче между процедурами разных модулей следите за областью видимости имен полей. Одинаковые имена в разных структурах не означают одинакового смысла, поэтому документируйте Expected набор полей в комментариях к сигнатуре процедуры.
Передача между клиентом и сервером
При вызове серверной процедуры из клиентского кода структура может быть передана в качестве параметра, если обе стороны работают в одной информационной базе и поддерживают сложные типы. Серверная процедура получает ту же структуру, может читать и менять поля, а изменения отражаются на клиенте после возврата.
Не полагайтесь на порядок полей: структура не гарантирует фиксированной последовательности. Обращайтесь к полям строго по именам и проверяйте их наличие перед использованием. Это особенно важно, когда структура формируется на клиенте и используется сервером для расчётов или записи.
Если код выполняется в тонком клиенте, веб-клиенте или мобильном приложении, проверьте поддержку передачи структур в конкретном режиме работы. При ограничениях передавайте идентификатор или набор простых параметров, а сервер сам восстанавливает структуру по данным из базы.
Сравнение вариантов передачи
Подходит внутри одной базы, когда допустимы общие изменения данных. Ограничение: риск нежелательной модификации структуры.
Подходит, когда вызываемый код не должен менять исходные данные. Ограничение: требует явного копирования и дополнительных затрат.
Подходит при обмене с внешними системами и через границы процесса. Ограничение: нужна обратная разборка и проверка типов после получения.
При клиент-серверном взаимодействии структура передаётся не как файл, а как значение в параметре вызова. Если соединение прерывается или сервер недоступен, вызов не выполнится, а структура на клиенте останется без изменений. Обрабатывайте ошибки вызова и не считайте данные переданными до получения успешного ответа.
Для отладки выводите имена и значения полей структуры в журнал регистрации или отладочный вывод до и после серверного вызова. Это помогает найти момент, когда поле пропадает или меняет тип из-за несовместимости конфигураций клиента и сервера.
Передача в формы и команды интерфейса
Структура часто используется для передачи настроек в форму, отчёта или обработку. Форма принимает структуру в параметре открытия и заполняет поля управления по именам. Если структура содержит ссылки на объекты базы, форма может отображать их представления, а не внутренние идентификаторы.
При изменении данных в форме не записывайте значения напрямую в переданную структуру, если это не задумано. Лучше собрать результат в новую структуру и вернуть её вызывающему коду после закрытия формы. Это снижает вероятность частично сохранённых или некорректных данных.
Команды интерфейса могут передавать структуру в серверный метод при нажатии кнопки. Проверьте, что структура не содержит несериализуемых объектов, если команда выполняется на сервере или через тонкий клиент. В противном случае вызов завершится ошибкой перед началом обработки.
При открытии формы из списка структура может передаваться выделенным объектом. Убедитесь, что форма не изменяет исходный объект до подтверждения пользователем. Для предварительного просмотра используйте копию или режим только для чтения.
Если структура содержит вложенные структуры или массивы, изменения вложенных элементов также видны вызывающему коду. Проверяйте весь уровень вложенности, если требуется полная изоляция исходных данных.
Передача при обмене и интеграции
Через COM-соединение, внешнее подключение, HTTP-сервисы или обмен файлами структура не передаётся как встроенный тип 1С без дополнительной подготовки. Её нужно представить в виде набора простых значений: XML, JSON, таблица значений или набор параметров. Получающая сторона восстанавливает структуру по согласованному набору полей.
При обмене между разными конфигурациями проверьте соответствие имён полей, типов и порядка ключей. Даже небольшое различие в имени поля приводит к тому, что значение будет проигнорировано или интерпретировано неверно. Документируйте контракт обмена отдельно от кода.
При передаче через веб-сервисы структура может быть представлена как сложный тип в WSDL или как объект JSON. Проверьте обязательные поля, форматы дат и чисел, кодировку. Не передавайте в открытом виде конфиденциальные реквизиты, пароли или персональные данные без шифрования и контроля доступа.
Если принимающая система не поддерживает структуры, разбейте данные на отдельные простые параметры или используйте таблицу значений. Это менее удобно для одного вызова, но надёжнее при интеграции с разными платформами и версиями.
После восстановления структуры на принимающей стороне сверьте количество и имена свойств с ожидаемыми. Отсутствие обязательного поля должно вызывать явную ошибку, а не молчаливую работу со значениями по умолчанию.
Проверка результата и типичные ошибки
Проверяйте передачу структуры по трём признакам: объект существует, содержит ожидаемые поля, значения полей имеют нужные типы. Используйте средства проверки свойств и типов значений, доступные в языке 1С, перед записью в базу или использованием в расчётах.
Типичная ошибка — обращение к полю, которого нет в структуре. Это приводит к ошибке выполнения или возврату неопределённого значения. Другая ошибка — изменение переданной структуры в вызываемой процедуре без уведомления вызывающего кода, что вызывает трудноотловимые изменения данных.
Третья ошибка — попытка передать структуру через границу, где она не поддерживается, без сериализации. Вызов завершится ошибкой несовместимости типа. Четвёртая ошибка — зависимость от порядка полей, хотя структура не гарантирует его сохранение.
Как проверить результат
Поле существует и имеет ожидаемое имя
Поле отсутствует или имя содержит опечатку
Тип соответствует логике расчёта
Значение имеет неожидаемый тип или пусто
Поля не изменились там, где не должны
Исходные данные изменены неявно
Если после передачи структура содержит неожидаемые значения, сравните её с исходной по полям и найдите процедуру, которая вносит изменения. Логирование значений до и после каждого вызова упрощает поиск причины. Не исправляйте данные вручную без понимания источника изменения.
Безопасная самостоятельная работа возможна при чтении структуры и передаче её внутри одной информационной базы. Копирование, интеграция с внешними системами и изменение структуры в серверном коде требуют большей осторожности и проверки на тестовой базе.
Когда стоит использовать альтернативу
Если нужно передать список однородных записей, таблица значений подходит лучше структуры. Она хранит строки и колонки, удобна для выгрузки, импорта и отображения в табличных полях. Структура лучше для одного набора настроек или результата с разными по смыслу полями.
Для сложных объектов с поведением и методами используйте справочники, документы или собственные классы конфигурации, а не структуру. Структура подходит для данных, а не для бизнес-логики. Если структура становится слишком большой, разбейте её на несколько параметров или вложенных структур с чётким назначением.
При частых изменениях состава полей структура может усложнить поддержку. В таких случаях удобнее завести отдельный регистр сведений или справочник с версиями, чтобы отслеживать изменения настроек и параметров обмена.
Что важно запомнить
Структуру передают параметром, обычно по ссылке. Изменения полей видны вызывающему коду, если не сделать копию. Проверяйте наличие и типы полей, а при обмене с внешними системами используйте сериализацию.
Можно ли передать структуру из клиента на сервер?
Да, в рамках одной информационной базы структура обычно передаётся в параметре серверного вызова. Проверьте, что серверная процедура принимает сложный параметр и что оба приложения используют одинаковые имена полей. При выходе за пределы базы или при работе через внешнее соединение потребуется сериализация.
Что будет, если изменить поле в вызываемой процедуре?
Изменение сохранится у вызывающего кода, так как структура передаётся по ссылке. Если вызываемый код не должен менять исходные данные, передайте копию структуры или собирайте результат в новую структуру.
Как проверить, что поле есть в структуре?
Используйте средства проверки свойств структуры и типов значений перед обращением к полю. Прямое обращение к отсутствующему полю может привести к ошибке выполнения. Проверку нужно делать для каждого обязательного поля отдельно.
Можно ли передать пустую структуру?
Да, пустую структуру можно передать, но принимающий код должен явно обрабатывать этот случай. Пустая структура и структура с пустыми полями — разные ситуации, поэтому проверяйте не только сам объект, но и наличие необходимых свойств.
Чем структура отличается от таблицы значений?
Структура хранит набор именованных значений и подходит для одного объекта настроек или результата. Таблица значений хранит строки с одинаковыми колонками и подходит для списков, загрузки и выгрузки данных. Выбирайте по характеру передаваемой информации.