1с создать объект по типу

Обновлено: 05.07.2024

В других языках с данными, полученными из базы данных обычно работают «как с таблицей». В 1С такое тоже возможно – выполнить запрос, получить «в ответ» таблицу и работать с ней.

Работа с объектом 1С ведется тогда, когда требуется создать объект 1С или изменить существующий. В остальных случаях (например поиск объекта 1С, использование его в другом объекте 1С) – используется ссылка 1С на объект 1С.

Создание объектов 1С

Объект 1С можно создать с помощью оператора Новый, при этом вызывается конструктор данного типа, если у типа несколько конструкторов – он выбирается по указанным параметрам:
Переменная1 = Новый СписокЗначений();

Менеджеры для получения объектов 1С из базы данных

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

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

Например:
Переменная1 = Справочники.ИмяСправочника.СоздатьЭлемент();
Переменная1 = Справочники.ИмяСправочника.НайтиПоНаименованию("Наименование");

Ссылки 1С и объекты 1С

Работа с объектами 1С, связанными с данными в базе данных может вестись двумя способами – с помощи «ссылки 1С на данные» и объекта 1С.

Ссылка 1С – это данные, доступные только для чтения. Объект 1С – это данные, доступные для чтения, изменения и записи. Работа со ссылкой 1С производится гораздо быстрее, чем с объектом 1С.

Ссылка 1С на данные получается с помощью функций вида:
СправочникСсылка = Справочники.ИмяСправочника.НайтиПоНаименованию()

Объект 1С можно получить из ссылки 1С или создать с нуля:
СправочникОбъект = СправочникСсылка.ПолучитьОбъект();
СправочникОбъект = Справочники.ИмяСправочника.СоздатьЭлемент();

Пустая ссылка 1С

Ссылка может быть пустой, это значит, что создан «пустой» экземпляр объекта 1С, который не связан с данными.
СправочникСсылкаПустая = Справочники.ИмяСправочника.ПустаяСсылка();

Также ссылку 1С можно проверить на заполненность:
Если СправочникСсылка.Пустая() Тогда
//…
КонецЕсли

Уникальный идентификатор (GUID)

Узнать идентификатор можно с помощью универсального метода любого объекта 1С ссылочного типа:
СправочникСсылка = Справочники.ИмяСправочника.НайтиПоНаименованию("Наименование");
GUID = СправочникСсылка.УникальныйИдентификатор();

Возвращаемое значение данного метода имеет специальный тип. Если необходимо сравнивать значение со строкой, не забудьте преобразовать его к строке с помощью Строка(Параметр).

GUID назначается в момент первой записи объекта 1С. Уже до записи можно узнать GUID, который будет назначен объекту 1С при записи:

Также перед записью можно назначить свой GUID. Это бывает полезным, например, при обмене данными:

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

Переменная – созданная в модуле программистом, нетипизированная
Реквизит объекта 1С (справочника, документа), добавленный в конфигураторе – хранится в базе данных, строго типизирован
Реквизит формы – поле на форме, строго типизирован.

Поле на форме показывает «какие-то данные». Данные могут быть напрямую связаны с реквизитом объекта 1С (указаны в свойстве поля формы ПутьКДанным).

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

Доступ к значениям именованных свойств объектов 1С

У многих объектов 1С есть свойства, которые имеют наименования.
Например:

элемент справочника имеет реквизиты с наименованиями
форма имеет реквизиты с наименованиями
у таблицы есть колонки с наименованиями
у строки таблицы есть поля с такими же наименованиями, как колонки у таблицы.

Если у объекта 1С есть свойства (реквизиты, колонки и т.п.), у которых есть наименования, то к ним можно обращаться двумя способами.

Если в наличии имеются два объекта 1С с именованными свойствами и нужно скопировать их значения, удобно использовать процедуру
ЗаполнитьЗначенияСвойств(КудаКопировать, ОткудаКопировать)
которая копирует значения всех свойств, имена которых совпадают, пример:

Работа с прикладными объектами средствами встроенного языка

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

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

Вид объекта Описание Типичные
свойства и методы Менеджер прикладных объектов данного типа

СправочникиМенеджер
ДокументыМенеджер
КонстантыМенеджер
РегистрыНакопленияМенеджер
ОтчетыМенеджер
ОбработкиМенеджер

Объекты данного вида обеспечивают доступ к менеджерам конкретного прикладного объекта.

Обычно доступ к таким объектам производится через свойства глобального контекста, например, Справочники.Сотрудники, Документы.Счет, РегистрыСведений.КурсыВалют и т.д.

Эти объекты являются коллекциями значений и позволяют перебрать свои элементы с помощью цикла "Для Каждого".

Свойства соответствуют именам прикладных объектов и являются объектами типа "Менеджер прикладного объекта"

Менеджер прикладного объекта

СправочникМенеджер
ДокументМенеджер
КонстантаМенеджер
РегистрНакопленияМенеджер
ОтчетМенеджер
ОбработкаМенеджер

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

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

<предопределенный элемент>

Выбрать()
НайтиПоКоду()
НайтиПоРеквизиту()
ПустаяСсылка()
СоздатьЭлемент()
СоздатьНаборЗаписей()
ПолучитьМакет()
ПолучитьФорму()

СправочникСсылка
ДокументСсылка
ПланСчетовСсылка
ПланВидовРасчетаСсылка

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

Ссылки хранятся в реквизитах, ссылающихся на элементы данного прикладного объекта, например, в реквизите "Сотрудник" документа "ПриемНаРаботу" хранится ссылка на конкретный элемент справочника "Сотрудники".

Заметьте, что у записей регистров нет ссылок.

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

<реквизит>
<табличная часть>
ПометкаУдаления
Дата
Предопределенный
Ссылка

Пустая()
ПолучитьОбъект()
ПолучитьФорму()
Метаданные()
Скопировать()

СправочникВыборка
ДокументВыборка
ЖурналДокументовВыборка
РегистрНакопленияВыборка

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

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

Свойства аналогичны свойствам объекта типа "Ссылка".

СправочникОбъект
ДокументОбъект
ПланСчетовОбъект
ОтчетОбъект
ОбработкаОбъект

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

Для отчетов и обработок через этот объект обычно осуществляется формирование отчета или выполнение обработки.

Если в модуле прикладного объекта (не путать с модулем формы) есть экспортируемые переменные модуля или процедуры/функции, то они дополняют набор свойств и методов именно этого программного объекта.

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

Свойства аналогичны свойствам объекта типа "Ссылка".

Записать()
Удалить()
Заблокировать()
Разблокировать()
Заблокирован()
Скопировать()
ПолучитьФорму()
ПолучитьМакет()
Метаданные()

СправочникСписок
ДокументСписок
ЖурналДокументовСписок
ПланСчетовСписок
РегистрНакопленияСписок
КритерийОтбораСписок

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

Этот объект нельзя создать программно, он создается системой автоматически при размещении на форме табличного поля. Конечно, программно можно создать табличное поле в экранной форме и тогда будет создан объект данного типа.

Колонки
Отбор
Порядок

Обновить()

РегистрСведенийНаборЗаписей
РегистрНакопленияНаборЗаписей
РегистрБухгалтерииНаборЗаписей
РегистрРасчетаНаборЗаписей
ПоследовательностьНаборЗаписей

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

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

Отбор
ЭтотОбъект

Добавить()
Удалить()
Очистить()
Записать()
Прочитать()
Количество()
Выгрузить()
Загрузить()

РегистрСведенийЗапись
РегистрНакопленияЗапись
РегистрБухгалтерииЗапись
РегистрРасчетаЗапись

Обеспечивает доступ к одной записи из набора, для того чтобы установить ее измерения, ресурсы и т.д. Этот объект возвращается методами других объектов, например, методом Добавить у объекта типа РегистрНакопленияНаборЗаписей.

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

<измерение>
<реквизит>
<ресурс>
Активность
Период
Регистратор
НомерСтроки
ВидДвижения

МоментВремени()

РегистрСведенийКлючЗаписи
РегистрНакопленияКлючЗаписи
РегистрБухгалтерииКлючЗаписи
РегистрРасчетаКлючЗаписи

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

Свойства для регистра сведений:

Специфические объекты

Ниже перечислены некоторые важные объекты, которые не укладываются в приведенную выше классификацию:

Вид объекта Соответствующий
прикладной объект Описание

Менеджер записи регистра сведений

Применяется для операций над одной записью регистра сведений. Этот объект существует только у независимого регистра сведений, т.е. не подчиненного регистратору.

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

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

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

Менеджер внешних обработок подобен менеджерам других прикладных объектов. Его метод Создать(<имя файла>) позволяет создать объект типа "ВнешняяОбработка". Этот объект, в свою очередь, подобен объектам ОтчетОбъект и ОбработкаОбъект и предоставляет доступ к реквизитам и табличным частям внешней обработки для передачи параметров формирования отчета или выполнения обработки.

Если в модуле внешней обработки (не путать с модулем формы) есть экспортируемые переменные модуля или процедуры/функции, то они дополняют набор свойств и методов объекта "ВнешняяОбработка".

Взаимосвязь объектов

Ниже показана взаимосвязь программных объектов, характерная для объектов, имеющих ссылки (на примере справочников):

А теперь немного другая взаимосвязь, характерная для регистров (на примере регистров накопления):

Как видите, левые части этих схем очень похожи, а правые части различаются. Не думайте, что объект "Ключ записи" аналогичен объектам "Ссылка", а объекты "НаборЗаписей" и "Запись" аналогичны объекту "Объект", хотя некоторое сходство прослеживается.

Сегодня мы рассмотрим все объекты 1С на примере конфигурации Бухгалтерия 1С редакции 2.

Объекты метаданных 1С

После входа в конфигуратор 1С, слева открывается окно Конфигурации 1С. Как зайти в конфигуратор, рассказано здесь.

Суть конфигурации 1С – это список объектов 1С, которые вместе и составляют эту конфигурацию.

Все объекты 1С можно поделить на следующие группы:

Объекты 1С для учета
Объекты 1С для пользователя
Объекты 1С для программиста
Объекты 1С для работы с другими объектами.

Где посмотреть объекты 1С

В конфигураторе

В окне Конфигурации расположено дерево объектов метаданных 1С. Дерево – это значит, что все объекты расположены не просто списком, а сгруппированы по типам.

Напротив каждого типа Вы видите крестик. Нажав на него Вы можете видеть список объектов 1С данного типа.

Раскрыв крестик на конкретном объекте Вы можете видеть свойства, входящие в состав этого объекта. Свойства у разных типов объектов 1С – разные.

В режиме Предприятие – толстый клиент

В режиме 1С Предприятие видеть список всех объектов 1С может только администратор. Для этого существует специальное служебное меню. Данное меню не видно всем пользователям.

Поэтому Вам необходимо зайти в 1С под администратором.

В меню Операции Вы можете видеть список типов объектов метаданных. При выборе любого типа откроется список объектов 1С.

В режиме Предприятие 1С Вы можете видеть не все виды объектов 1С. Объекты 1С «для программиста» можно смотреть только в режиме Конфигуратор.

В режиме Предприятие – тонкий клиент

К тонкому клиенту также относятся замечания про администратора. Однако меню Операции здесь Вы не найдете – оно теперь называется «Все функции».

По умолчанию этот пункт меню скрыт. Чтобы его открыть, необходимо зайти в меню «Сервис / Параметры», где установить галочку «Отображать команду Все функции».

Теперь нажимаем на эту команду – она также появилась в меню.

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

Как работать с объектами 1С

Работа с объектами 1С производится в Конфигураторе. В режиме 1С Предприятие Вы можете просмотреть данные этого объекта 1С.

Работать с объектами 1С можно двумя способами:

Способ 1

Раскрыть свойства объекта и работать с ними напрямую. Также есть контекстное меню (по нажатию правой кнопки мыши).

Суть работы составляет:

Добавить или удалить свойства объекта
Настроить характеристики конкретного свойства объекта 1С, нажав на нем правой кнопкой и выбрав в меню «Свойства».

Редактор всегда открывается справа.

Исключение составляют Формы объекта 1С. Чтобы отредактировать форму нужно нажать на нее два раза мышкой и она откроется в редакторе.

Способ 2

Открыть редактор объекта 1С. Для этого нужно нажать на сам объект два раза мышкой.

В открывшемся редакторе все свойства расположены на закладках, которые их группируют.

Работа с конкретными свойствами и формами происходит аналогично со способом 1.

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

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

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

Чтобы получить быстро полное название нужной ссылки, можно воспользоваться контекстной подсказкой метода Тип.

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

Выше показано самое простое использование описания типов. Для числа, строки и даты мы можем использовать Квалификаторы. Это общие объекты – КвалификаторыЧисла, КвалификаторыСтроки, КвалификаторыДаты. Они также задаются при помощи конструктора Новый и имеют следующие синтаксисы.

Квалификатор числа 1С

Для числа будет следующий синтаксис квалификатора.

Новый КвалификаторыЧисла(<ЧислоРазрядов>, <ЧислоРазрядовДробнойЧасти>, <ДопустимыйЗнак>)

Где: ЧислоРазрядов – общее число разрядов;

ЧислоРазрядовДробнойЧасти – число разрядов после запятой;

ДопустимыйЗнак – системное перечисления (значения Любой, Неотрицательный).

Например, задать неотрицательно число с 6 разрядами и 2 дробными разрядами будет так:

Квалификатор строки 1С

Для строки будет следующий синтаксис квалификатора.

Новый КвалификаторыСтроки(<ДлинаСтроки>, <ДопустимаяДлина>)

Где: ДлинаСтроки – длина задаваемой строки

ДопустимаяДлина – системное перечисление ДопустимаяДлина, которое определяет, будет строка переменная или фиксированная.

Например, задать строку длинной 10 символов фиксированной длины нужно так:

Обратите внимание, что КвалификаторСтроки задаем третьим параметром.

Квалификатор даты 1С

Для даты будет следующий синтаксис квалификатора.

Где ЧастиДаты – системное перечисление, с тремя значениями Время, Дата, ДатаВремя.

Например, задать дату, которая будет иметь формат времени нужно так:

Обратите внимание, что КвалификаторДаты задаем третьим параметром.

Общий вариант синтаксиса с использование типов выглядит так:

Новый ОписаниеТипов(<Типы>, <КвалификаторыЧисла>, <КвалификаторыСтроки>, <КвалификаторыДаты>, <КвалификаторыДвоичныхДанных>)

Массив типов в описание типов

Кроме использования одного типа в синтаксисе описания типов, можно использовать массив типов, например, сделаем колонку таблицы значений, у которая может принимать значения примитивных типов Строка, Число, Дата, Булево. Для этого нужно все типы перечислить в массиве, причём типы должны быть не в виде строк, как мы делали ранее, а в виде значений типа Тип.

Также можно «собрать» массив из ссылочных типов, например из справочников:

Описание типов на основании описания типов

Выше был рассмотрен один вариант синтаксиса описания типов, на основания какого-то типа (или перечисления типов), но также можно создать описание типа на основании другого описания типов, т.е. дополнить имеющееся описание.

Например, мы создали описание типов для чисел, строк и булево.

Теперь нам нужно новое описание типов, в котором будут такие типы как Число, Строка и Дата (тип Булево нам не нужно).

Для этого мы можем использовать следующий конструктор описания типов:

Новый ОписаниеТипов(<ИсходноеОписаниеТипов>, <ДобавляемыеТипы>, <ВычитаемыеТипы>, <КвалификаторыЧисла>, <КвалификаторыСтроки>, <КвалификаторыДаты>, <КвалификаторыДвоичныхДанных>)

Где, в качестве первого параметра указывается описание типов, на основании которого создается это описание, а в качестве второго и третьего параметра – добавляемые и вычитаемые типы (могут быть как в виде массивов, так и в виде строк).

Давайте продолжим код выше:

В этом код в новое описание типов, мы добавили тип Дата, и вычли тип Булево.

Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.

Очень доступный и понятный язык изложения
Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
Поймете идеологию управляемого приложения 1С
Узнаете, как разрабатывать управляемое приложение;
Научитесь разрабатывать управляемые формы 1С;
Сможете работать с основными и нужными элементами управляемых форм
Программирование под управляемым приложением станет понятным

Если Вам помог этот урок решить какую-нибудь проблему, понравился или оказался полезен, то Вы можете поддержать мой проект, перечислив любую сумму:

Читайте также: