1с получить свойство объекта

Обновлено: 04.07.2024

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

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

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

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

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

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

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

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

С помощью метода Родитель() можно получить вышестоящий объект метаданных.
Например:

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

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

Для поиска объекта метаданных, соответствующего значению перечисления, можно использовать методику, описанную в разделе "Как получить имя значения перечисления, заданное в метаданных?".

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

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

Некоторые свойства объектов метаданных являются коллекциями значений и представляются типом КоллекцияЗначенийСвойстваОбъектаМетаданных .
Например:

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

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

Для получения форм и макетов используются специализированные методы.

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

Для проверки прав текущего пользователя используются специализированные методы глобального контекста ПравоДоступа() и ПараметрыДоступа() .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обновить()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Общие свойства всех объектов 1С

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

2. Общие модули в 1С

Общие модули в 1С:

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

Клиент, сервер — определяет контекст исполнения функций, и откуда их можно вызывать: если установлена галка «Вызов сервера», то данные серверные функции модуля можно вызывать и с клиента. «Внешнее соединение» определяет доступность функций, например для com-соединений 1С.

Привилегированный — все функции в данном модуле будут исполняться под полными правами.

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

3. Регламентные задания в 1С

Имя метода — экспортная процедура общего модуля, выполняемая при срабатывании задания.

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

Предопределенное — будет ли задание работать сразу же после обновления конфигурации или нужно будет настраивать его запуск вручную в каждой базе.

4. Общие команды в 1С

Тип параметра команды — в каких объектах данная команда будет доступна.

Режим использования параметра — возможность передать в качестве параметра не один, а множество объектов (например, при выделении списка документов).

Изменяет данные — блокирует форму и ставит признак модифицированности в истину.

5. Константы в 1С

История данных — версионирование объекта.

Использовать стандартные команды — видимость константы в командном интерфейсе.

Пояснение — всплывающая подсказка при вызове константы.

Форматы — формат типов число, дата и булево.

Быстрый выбор — отвечает за «выпадание» списка значений при активации поля выбора.

История выбора — «выпадание» недавно выбранных значений.

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

6. Справочники в 1С:ЕРП 2.4

Иерархический, вид иерархии, количество уровней и их ограничение — определяет наличие групп элементов и их подчинение друг другу, количество уровней вложенности данного подчинения.

Владельцы — если справочник подчинен другому справочнику (например, справочник характеристик номенклатуры подчинен справочнику Номенклатура).

Серии кодов — будут ли коды уникальны во всем справочнике или уникальность будет сохраняться только в пределах одного владельца.

Контроль уникальности и автонумерация — проверка при записи элемента справочника на уникальность его кода и генерация нового кода автоматически.

Обновление предопределенных данных — иногда, например, при использовании РИБ создавать элементы при обновлении в базе не нужно, они загрузятся из основной.

Вводится на основании — можно использовать конструктор для ввода на основании других объектов.

Полнотекстовый поиск — поиск объекта по наименованию по всей базе, с использованием операторов полнотекстового поиска.

Быстрый выбор и способ выбора — выбор элемента из выпадающего списка (удобно, когда мало элементов) и также возможность открытия формы выбора.

Ввод по строке — по наименованиям каких реквизитов будет происходить поиск при вводе символов в поле.

Создание при вводе — появление «плюсика» для создания нового элемента при начале ввода.

7. Документы в 1С

Давайте разберем свойства документов в 1С.

Периодичность — период контроля уникальности номера.

Проведение, оперативное проведение — проводится или только записывается документ, есть возможность проведения оперативно.

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

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

Заполнения последовательностей — в каких последовательностях участвует документ. Нужно для восстановления правильной цепочки последовательности документов.

Прив. Режимы — действия выполняются на сервере и без контроля прав. Ускоряет проведение документа.

8. Регистры сведений 1С

Периодичность — является ли периодическими, а также с каким периодом вносятся новые записи.

Режим записи — записи вносятся независимо или с помощью документа.

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

Разрешить итоги — создаются дополнительные физические таблицы для хранения итогов, для ускорения доступа к срезу первых и последних.

9. Регистры накопления в 1С 8.3

Давайте рассмотрим регистры накопления в 1С 8.3.

Вид регистра — определяет, создавать ли дополнительную таблицу для хранения остатков по регистру.

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

10 Регистры бухгалтерии в 1С

Корреспонденция — включает возможность принципа двойной записи за счет наличия корреспондирующих счетов в движениях регистра.

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

11. Регистры расчета 1С

Период действия — включает доступность реквизитов ПериодДействияНачало и ПериодДействияКонец для расчета периодических начислений (например, оклада по месяцам).

Базовый период действия — включает доступность реквизитов БазовыйПериодНачало и БазовыйПериодКонец для определения границ расчета базы для начислений (например, для начисления суммы больничного используется средняя зарплата за последние три месяца).

График — регистр сведений 1С с данными о периодах, за которые нужно произвести расчеты.

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

Дата графика — измерение, отвечающее за значение периода, в который был отработан данный показатель.