Ссылки на метаданные

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

Spec1C ссылается на два вида объектов: на объекты конфигурации (справочники, документы, регистры) и на реквизиты самой обработки. Первые записываются путём метаданных, вторые — с префиксом epf..

Назначение#

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

Путь метаданных#

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

Вид.ИмяОбъекта
Вид.ИмяОбъекта.Часть

Поддерживаемые виды:

«Везде» — в привязке источника в data, в show, include list, balance и turnovers. Для последних четырёх видов строка fields под привязкой работает неправильно — см. к какому источнику относится fields.

report demo
data {
  contracts = Справочник.КлиентскиеДоговора
    fields: Ссылка, Код
  orders = Документ.ЗаказКлиента
    fields: Ссылка, Дата
}
show structure РегистрНакопления.ТоварыНаСкладах

Что не поддерживается#

• Английские имена видов (Catalog.Номенклатура, Document.…) не распознаются.
• Корень conf. редактор подсвечивает, но разбор его не принимает.
• Другие виды (ПланВидовХарактеристик, ПланСчетов, РегистрРасчета и т. д.) не распознаются: привязка или команда с ними молча пропускается.

Как путь попадает в запрос#

• Таблица в запросе — путь как есть: Справочник.КлиентскиеДоговора.
• Псевдоним таблицы — последняя часть пути: КлиентскиеДоговора. Идентификатор источника (contracts) в запрос не попадает.

	|ИЗ
	|	Справочник.КлиентскиеДоговора КАК КлиентскиеДоговора
	|	ЛЕВОЕ СОЕДИНЕНИЕ РегистрСведений.ДокументыИзменяющиеУсловияДоговора КАК ДокументыИзменяющиеУсловияДоговора

Путь из нескольких частей разбор принимает (Справочник.Номенклатура.ТабличныеЧасти.Состав) и подставляет в запрос без изменений. Studio не переводит его в синтаксис языка запросов 1С — проверьте такой запрос в Конфигураторе.

Ссылки на реквизиты обработки: epf.*#

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

• at epf.<Реквизит> — дата остатков в balance;
• into epf.<ТаблицаЗначений> — куда положить результат balance или turnovers.

При генерации кода префикс epf. снимается: epf.тзОстатки превращается в тзОстатки. Studio не проверяет, что такой реквизит есть в обработке, и не создаёт его.

Подсказки Ctrl+Space после epf. предлагают реквизиты формы, имена таблиц из into и несколько стандартных имён. При наведении на epf.… редактор показывает «реквизит / таблица значений обработки».

Проверка путей#

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

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

Как пользоваться подсказками в редакторе — Использовать подсказки Ctrl+Space.

Ограничения#

• Поддерживаются восемь видов объектов, только русские имена.
• conf. не поддерживается.
• Четыре вида (РегистрБухгалтерии, Перечисление, Обработка, Отчет) распознаются, но на вкладке «Данные» показываются как справочник, а fields к ним не привязывается.
• Путь из нескольких частей подставляется в запрос как есть.
• Реквизиты epf.* не проверяются и не создаются.
• Полный список ограничений — Ограничения реализации.

Сверено с продуктом: 27.10.2026