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

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

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

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

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

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

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

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

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

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

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

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

Источник

Программирование в 1С для всех

В этой статье разберем метаданные 1С. Метаданные или объекты метаданных в 1С – это «кирпичики», из которых строится конфигурация 1С. Узнаем, что такое метаданные (объекты метаданных) и научимся получать значения свойств объектов метаданных.

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

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

У объектов метаданных имеются прототипы. Визуально в дереве конфигурации прототипы представлены в виде веток дерева.

Например, у справочника Номенклатура прототип Справочники.

А у документа Закупка товаров – прототип Документы.

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

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

А у справочника Валюта – 3.

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

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

К свойствам объектов метаданных можно обратиться при помощи программного кода. Сделать это можно воспользовавшись свойством глобального контекста, которое так и называется Метаданные.

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

У свойства Метаданные имеются свойства, которые отображают прототипы объектов. Это тоже коллекции. Например, для справочников имеется свое свойство.

Которое, также является коллекцией.

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

Мы можем прочитать свойство того или иного объекта метаданных. Например, длину кода у справочника Валюта.

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

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

В учебной конфигурации, у этого кода будет следующий результат.

Обратите внимание, что этот код должен выполняться в серверном контексте (или в клиентском на толстом клиенте), поскольку у свойства Метаданные доступность Сервер, Толстый клиент и т.д.

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

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

А к реквизитам конкурентного документа – так:

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

Результат работы этого кода в учебной конфигурации будет следующим.

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

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

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

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

Читайте также по теме:

Более подробно и основательно начальные вопросы программирования в 1С есть вы можете изучить в
Книга «Программировать в 1С за 11 шагов»

Изучайте программирование в 1С в месте с моей книгой «Программировать в 1С за 11 шагов»

Книга написана понятным и простым языком — для новичка.

О том как разрабатывать под управляемым приложением 1С, читайте в книге Книга «Основы разработки в 1С: Такси»

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

Промо-код на скидку в 15% — 48PVXHeYu

Эти книги, плюс книга по программированию оперативного учета имеются в едином комплекте: комплект книг по разработке в 1С.
Только для читателей моего блога,
промо-код на скидку в 300 рублей на весь комплект: blog

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

можно оплатить вручную:

Яндекс.Деньги — 410012882996301
Web Money — R955262494655

Источник

Чем отличаются ссылочные и табличные объекты метаданных

Структура базы данных 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С:Предприятие предназначен для ведения списков однородных элементов данных — справочников, картотек, нормативных сборников и тому подобное. Использование объектов метаданных этого типа позволяет организовать ведение любых справочников, необходимых для автоматизации деятельности предприятия.

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

Реализованный в системе 1С:Предприятис при помощи объекта метаданных компьютерный аналог конкретного понятия предметной области будем называть объектом данных.

Свойства объекта метаданных

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

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

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

Приведем такой пример.

Объект метаданных «Константа» в системе 1С:Предприятие предназначен для хранения информации, которая не изменяется во времени или изменяется очень редко. Простым примером константы может служить название предприятия: оно, как правило, не меняется о процессе деятельности предприятия.

Константа обладает следующим набором редактируемых свойств:

· идентификатор — «имя» константы;

· точность значения (для числовых констант);

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

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

Способность сохранять и возвращать значение — неотъемлемая особенность любой константы в системе 1С:Предприятие. Никакое редактирование свойств константы на эту способность не влияет.

Форма объекта метаданных

Большинство объектов метаданных в системе 1С:Предприятие могут иметь визуальное представление. В самом общем случае визуальное представление состоит из следующих частей:

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

· печатная форма объекта метаданных (печатных форм может быть несколько);

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

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

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

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

Агрегатные объекты метаданных

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

Например, независимым объектом метаданных является константа. Константа самодостаточна: она может содержать какое-либо значение, и этим полностью исчерпывается ее назначение в системе 1С:Предприятие. Более того: константа может присутствовать в системе и даже может содержать какое-либо значение, но при этом не использоваться другими объектами метаданных. Правда, на практике такое встречается редко.

Теперь — прямо противоположный пример.

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

Объекты метаданных, которые могут иметь в своем составе подчиненные объекты, называются агрегатными объектами метаданных.

Основные виды объектов метаданных

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

Формально объекты метаданных объединяются в виды в дереве метаданных. Названия видов пользователь видит на первом уровне дерева метаданных, когда открывает окно «Конфигурация» в Конфигураторе.

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

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

Ниже приведена краткая характеристика основных видов объектов метаданных системы 1С:Предприятие (см. таблицу). Подробная информация об объектах метаданных, объединяемых в каждом из этих видов, будет изложена далее в настоящем Руководстве.

Постоянные (условно-постоянные) величины. Константы хранят информацию, которая не изменяется или изменяется достаточно редко: название организации, се почтовый адрес и так далее.

Списки однородных элементов данных. Используются для храпения нормативно-справочной информации.

Служат для ввода информации о совершенных хозяйственных операциях.

Списки объектов данных типа «Документ». Служат для работы с документами.

Списки значений, задаваемые на этапе конфигурирования.

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

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

Списки объектов данных типа «бухгалтерский счет» — учетных регистров, по которым будет выполняться группировка средств при работе с системой 1С:Прсдприятие. Понятие «план счетов» в системе 1С:Предприятис вполне соответствует общепринятому пониманию аналогичного термина в бухгалтерском учете.

Списки объектов аналитического учета. Используются для организации аналитического учета средств предприятия, в совокупности с бухгалтерскими счетами.

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

Бухгалтерские проводки. Используются только совместно с объектами данных «Операция» и предназначены для отражения в бухгалтерских итогах результатов хозяйственных операций.

Средство накопления оперативной информации о наличии и движении средств.

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

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

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

Средство построения графиков работы предприятия, внешних организаций или отдельных категорий работников.

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

Типизированные и типообразующие объекты метаданных

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

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

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

Типы значений, которые может принимать объект метаданных, можно разделить на 2 группы.

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

Кроме этого, некоторые объекты метаданных системы 1С:Предприятие также могут образовывать типы значений. Например, константе может быть назначен тип значения «Документ». В этом случае значение константы будет представлять собой ссылку на один из существующих в системе 1С:Предприятие документов.

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

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

Метаданные

Итак, теперь можно дать расшифровку самого понятия «метаданные».

Метаданными («данными о данных») в системе 1С:Предприятие называется совокупность объектов метаданных, настроенных на хранение и обработку информации о хозяйственной деятельности конкретного предприятия.

Наряду с понятием метаданные, в настоящем Руководстве будет широко использоваться термин «структура метаданных». Данный термин более точно отражает суть метаданных, как сложной структуры взаимодействующих объектов метаданных. Фактически, структура метаданных является моделью предметной области.

Конфигурация

Конфигурацией в системе 1С:Предприятие называется совокупность трех взаимосвязанных составных частей:

· набора пользовательских интерфейсов;

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

Расшифровка понятия метаданные была дана ранее в этой главе.

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

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

Операция назначения прав пользователю решает две основные задачи.

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

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

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

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

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

Модуль

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

Приведем такой пример.

В системе 1С:Предприятис может быть организован удобный для пользователей режим ввода новых документов — «ввод на основании». Суть этого режима проста: за основу берется документ-образец (например, счет на оплату), из которого в новый создаваемый документ (например, расходную накладную) переносится информация о получателе, товарах, ценах, количестве.

Перенос информации из документа-образца во вновь создаваемый документ выполняется при помощи специальной процедуры ВводНаОсновании(), содержащейся в модуле последнего.

Предварительная настройка режима «ввода на основании» для конкретного документа выполняется в Конфигураторе диалоговыми средствами. Однако алгоритм переноса информации из документа-образца в новый документ должен создать специалист, выполняющий конфигурирование системы. Этот алгоритм хранится в модуле, «привязанном» к форме документа, и выполняется всякий раз при показе документа.

Источник