К статье
Практический материал

Другое · 9 мин

Как программно установить тип значения реквизита 1С

Как программно задать тип значения реквизита в 1C: отличия типа конфигурации и типа значения, порядок проверки, риски и безопасные действия.

В терминологии 1С реквизит может означать как свойство объекта конфигурации, так и значение, которое это свойство принимает в работе программы. Тип реквизита в конфигурации задаётся на этапе разработки и определяет, какие данные можно записать в базу. Тип значения же устанавливается в момент выполнения, когда программа создаёт или заполняет объект, справочник, документ или регистр.

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

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

Объявленный тип реквизитаЗадаётся в свойствах конфигурации

Посмотрите тип в конфигураторе перед изменением кода

Тип значения в кодеОпределяется присвоенным объектом или литералом

Проверьте, что значение соответствует допустимому типу реквизита

Зависимые объектыОтчёты, формы, процедуры могут использовать реквизит

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

В конфигураторе тип реквизита описывается через описание типов. Оно может быть простым, например строка, число, дата, или составным, когда допускается несколько типов одновременно. Для реквизитов объектов метаданных тип фиксируется в свойствах реквизита и используется при сохранении данных. Программа не позволит записать в реквизит значение, не соответствующее объявленному типу, без приведения или ошибки.

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

Порядок действий при изменении типа реквизита
  1. 1
    Сделайте резервную копию информационной базы
  2. 2
    Откройте конфигурацию в режиме конфигурирования
  3. 3
    Проверьте использование реквизита в объектах и коде
  4. 4
    Измените тип реквизита и сохраните конфигурацию
  5. 5
    Обновите базу данных и проверьте работу зависимых объектов

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

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

1c
Если ТипЗначения(Значение) = Тип(Строка) Тогда
    Объект.Реквизит = Значение;
КонецЕсли;

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

Когда нужно только присвоить переменной или свойству значение требуемого типа, действия проще. В модуле создайте переменную, инициализируйте её значением нужного типа и запишите в реквизит объекта, если тип совместим. Если тип не совпадает, выполните приведение или преобразуйте данные перед записью. Результат проверяйте через тип значения или попытку сохранения объекта.

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

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

Типичные ошибки
01
Присвоение значения несовместимого типа реквизиту
02
Игнорирование пустого значения при проверке типа
03
Смена объявленного типа без анализа отчётов и форм

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

Ещё одна ошибка — изменение типа реквизита без анализа отчётов и обработок. Если в отчёте реквизит используется как число, а после изменения стал строкой, расчёты могут сломаться молча или выдавать неверные результаты. Перед изменением стоит проверить все места, где реквизит участвует в вычислениях, условиях и выводах.

Контрольные точки

Как проверить результат

Открытие объекта в форме
Норма

Значение отображается и сохраняется

Тревожный признак

Ошибка типа при записи или отображении

Работа отчётов и документов
Норма

Расчёты и вывод корректны

Тревожный признак

Неверные результаты или ошибки выполнения

Сохранение в базе
Норма

Данные записываются без исключений

Тревожный признак

Отказ сохранения из-за несовместимости типов

Проверка результата включает открытие объекта в форме, просмотр значения реквизита и попытку записи. Если значение сохраняется без ошибок, а в отчётах и документах данные отображаются корректно, тип установлен верно. Если появляются сообщения о несоответствии типов, нужно вернуться к проверке исходного значения и объявленного типа реквизита.

В некоторых конфигурациях используются динамические реквизиты или свойства с типом «Любой». В таких случаях программе проще принимать значения разных типов, но ответственность за корректность данных переходит на разработчика. Тогда важно явно проверять тип значения перед использованием в расчётах, чтобы избежать скрытых ошибок.

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

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

Итог

Что важно запомнить

Тип значения задаётся присвоением или объявлением типа; изменение типа конфигурации требует копии базы, проверки зависимостей и осторожного обновления.

Можно ли изменить тип реквизита только программно из модуля приложения?

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

Что делать, если значение не записывается из-за типа?

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

Безопасно ли менять тип реквизита в рабочей базе?

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

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

Откройте объект в форме, задайте значение реквизита и попробуйте сохранить. Убедитесь, что нет сообщений о несоответствии типов, а в отчётах и документах данные отображаются и считаются корректно. Повторная запись и чтение значения должны давать одинаковый результат.

Чем отличается тип реквизита от типа значения?

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