Адресация: FQN — Документация Кванты

Адресация: FQN

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

Правила

Адрес — пары Тип.Имя: Catalog.Номенклатура.Attribute.Артикул — это пары Catalog.Номенклатура и Attribute.Артикул. Правильный адрес — один сегмент (Configuration) или чётное число сегментов.
Типы и маркеры принимаются по-английски и по-русски: Catalog = Справочник, Attribute = Реквизит. Имена объектов пишутся как в метаданных, обычно по-русски.
Регистр букв при поиске объекта не важен.
Маркер без имени в конце — коллекционный адрес: Catalog.Номенклатура.Attribute — все реквизиты справочника. Чтение возвращает список, запись принимает пачку (Коллекционные адреса и пачки).
После # — грань: что показать у узла (#properties, #source, #help). Символ # не встречается в именах 1С, поэтому путаницы нет (Грани # и маркеры-хвосты).
:: отделяет метод от модуля (CommonModule.ОбщегоНазначения::ЗначениеРеквизитаОбъекта) и объект от документа прав роли (Role.ПолныеПрава.Rights::Catalog.Номенклатура).

Примеры по доменам

Метаданные

metadata_read, metadata_write

Configuration
Catalog.Номенклатура
Catalog.Номенклатура.Attribute.Артикул
Catalog.Контрагенты.TabularSection.КонтактнаяИнформация
Document.РеализацияТоваровУслуг.TabularSection.Товары.Attribute.Количество
InformationRegister.КурсыВалют.Dimension.Валюта
AccumulationRegister.ТоварыНаСкладах
ScheduledJob.<Задание>.Schedule

Модули и методы

code_read, code_write, code_graph

CommonModule.ОбщегоНазначения
Catalog.Контрагенты.ObjectModule
Catalog.Контрагенты.ManagerModule
Document.РеализацияТоваровУслуг.ObjectModule
InformationRegister.КурсыВалют.RecordSetModule
Catalog.Контрагенты.Form.ФормаЭлемента               модуль формы
CommonModule.ОбщегоНазначения::ЗначениеРеквизитаОбъекта  метод

Русские суффиксы тоже принимаются: Справочник.Контрагенты.МодульОбъекта, Справочник.Контрагенты.МодульМенеджера, РегистрСведений.КурсыВалют.МодульНабораЗаписей.

Формы

form_read, form_write

Catalog.Контрагенты.Form.ФормаЭлемента
Catalog.Контрагенты.Form.ФормаЭлемента.Item.Наименование
Catalog.Контрагенты.Form.ФормаЭлемента.Attribute.Объект
Catalog.Контрагенты.Form.ФормаЭлемента.Command.<Команда>
Catalog.Контрагенты.Form.ФормаЭлемента.Attribute.<Реквизит>.Column.<Колонка>
CommonForm.<ОбщаяФорма>

Макеты

spreadsheet_read, spreadsheet_write

Document.РеализацияТоваровУслуг.Template.<Макет>
Document.РеализацияТоваровУслуг.Template.<Макет>.Cell.R4C4
Document.РеализацияТоваровУслуг.Template.<Макет>.Cell.R1C1:R5C3
Document.РеализацияТоваровУслуг.Template.<Макет>.Area.Заголовок
CommonTemplate.<ОбщийМакет>

Отчёты СКД

dcs_read, dcs_write, composition_settings_*

Report.<Отчет>.Template.<Схема>
Report.<Отчет>.Template.<Схема>.DataSet.<Набор>.Field.<Поле>
Report.<Отчет>.Template.<Схема>.Parameter.Период
Report.<Отчет>.Template.<Схема>.SettingsVariant.Основной.Settings
Report.<Отчет>.Template.<Схема>.DefaultSettings.Filter[0]

Права

rights_read, rights_write

Role.ПолныеПрава.Rights
Role.ПолныеПрава.Rights::Catalog.Номенклатура
Role.БазовыеПраваБСП.RestrictionTemplate.ДляОбъекта
Catalog.Номенклатура#roles

Угловые скобки <…> в примерах — место для имени вашего объекта.

Русские и английские имена

По-русски	По-английски
Справочник, Документ, Перечисление	Catalog, Document, Enum
РегистрСведений, РегистрНакопления	InformationRegister, AccumulationRegister
РегистрБухгалтерии, РегистрРасчета	AccountingRegister, CalculationRegister
ПланВидовХарактеристик, ПланСчетов	ChartOfCharacteristicTypes, ChartOfAccounts
Отчет, Обработка	Report, DataProcessor
ОбщийМодуль, ОбщаяФорма, ОбщийМакет	CommonModule, CommonForm, CommonTemplate
Константа, Роль, Подсистема	Constant, Role, Subsystem
ВнешняяОбработка, ВнешнийОтчет	ExternalDataProcessor, ExternalReport
Реквизит, ТабличнаяЧасть	Attribute, TabularSection
Измерение, Ресурс, ЗначениеПеречисления	Dimension, Resource, EnumValue
Форма, Макет, Команда	Form, Template, Command
Элемент, Параметр, Колонка	Item, Parameter, Column

Типичные ошибки

Нечётное число сегментов — Catalog.Номенклатура.Артикул: пропущен маркер Attribute.

Опечатка в имени. Инструмент не угадывает молча: ответ содержит секцию Did you mean с ближайшими именами. Пример — отказ dcs_write на наборе Продажы:

ответ инструмента

### 🟠 update — Report.Продажи.Template.СКД.DataSet.Продажы

- **status:** 🟠 rolled_back
- **fqn:** `Report.Продажи.Template.СКД.DataSet.Продажы`
- **operation:** `update`
- **rollback_reason:** Набор не найден: Продажы; контракт: dcs_read Report.Продажи.Template.СКД.DataSet.Продажы#help

#### Did you mean

- Продажи
- Остатки

Адрес формы в metadata_read. Формы читает form_read, макеты — spreadsheet_read, схемы компоновки — dcs_read.
Путь к файлу вместо адреса. Инструменты работают с моделью EDT, пути выгрузки им не нужны. Исключение — снапшоты: откат одного файла принимает путь <проект>/src/….