A1sCatalogs — справочники без повторяющегося CRUD-кода

// Намерение: Проверяет, является ли значение справочником (ссылка или объект).
// Граница: Обязательные параметры: Value
// Результат: Boolean.

Успешно = A1sCatalogs.IsCatalog(Value);

// Намерение: Проверяет, является ли значение ссылкой на справочник.
// Граница: Обязательные параметры: Value
// Результат: Boolean.

Успешно = A1sCatalogs.IsRef(Value);

// Намерение: Проверяет, является ли значение объектом справочника.
// Граница: Обязательные параметры: Value
// Результат: Boolean.

Успешно = A1sCatalogs.IsObject(Value);

// Намерение: Возвращает объект справочника из ссылки или объекта.
// Граница: Обязательные параметры: Value
// Результат: CatalogObject | Undefined.

Результат = A1sCatalogs.GetObject(Value);

// Намерение: Возвращает ссылку на справочник из ссылки или объекта.
// Граница: Обязательные параметры: Value
// Результат: CatalogRef | Undefined.

Ссылка = A1sCatalogs.GetRef(Value);

// Намерение: Менеджер справочника по имени.
// Граница: Обязательные параметры: Name
// Результат: CatalogManager.

Результат = A1sCatalogs.Manager("Name");

// Намерение: Пустая ссылка справочника.
// Граница: Обязательные параметры: Name
// Результат: CatalogRef.

Ссылка = A1sCatalogs.Empty("Name");

// Намерение: Создаёт новый элемент справочника и заполняет реквизиты из структуры.
// Граница: Обязательные параметры: Name
// Результат: CatalogObject.

Товар = A1sCatalogs.Of("Номенклатура", A1sDS.Of(
      "Наименование", "Квартира 101",
      "Родитель", ГруппаКвартиры,
      "ЕдиницаИзмерения", Шт));
  A1sCatalogs.Write(Товар);

// Намерение: Создаёт группу (папку) справочника.
// Граница: Обязательные параметры: Name, Description
// Результат: CatalogObject.

Группа = A1sCatalogs.CreateGroup("Номенклатура", "Квартиры — корпус А");
  A1sCatalogs.Write(Группа);

// Намерение: Копирует существующий элемент с возможностью переопределения реквизитов.
// Граница: Обязательные параметры: ItemRef
// Результат: CatalogObject.

Копия = A1sCatalogs.Copy(ШаблонТовара, A1sDS.Of("Наименование", "Квартира 202"));

// Намерение: Подключается к существующему элементу справочника: из ссылки возвращает объект, объект возвращает как есть. Симметрична Of() — та создаёт, эта подключает.
// Граница: Обязательные параметры: ItemOrRef
// Результат: CatalogObject.

// Получить объект и изменить вручную:
  Объект = A1sCatalogs.OfRef(ТоварСсылка);
  Объект.Цена = 5000;
  Объект.Записать();

  // С немедленным заполнением:
  Объект = A1sCatalogs.OfRef(ТоварСсылка,
      A1sDS.Of("Цена", 5000, "ВидНоменклатуры", ВидТовар));
  Объект.Записать();

// Намерение: Создаёт новый элемент справочника и заполняет реквизиты с авторазрешением строк в ссылки. Комбинирует Of + FillAuto. Строковые значения разрешаются через EnsureByType по метаданным реквизита. Симметрична A1sDocs.OfAuto.
// Граница: Обязательные параметры: Name
// Результат: CatalogObject.

Товар = A1sCatalogs.OfAuto("Номенклатура",
      A1sDS.Of("Наименование", "Квартира 101",
               "ЕдиницаИзмерения", "шт",     ← строка → EnsureByType автоматически
               "Родитель",        ГрКвартиры));
  A1sCatalogs.Write(Товар);

// Намерение: Находит элемент по наименованию. Если не найден — создаёт, заполняет, записывает. Ключевой паттерн для создания номенклатуры на лету при заполнении документов.
// Граница: Обязательные параметры: Name, Description
// Результат: CatalogRef.

// При загрузке квартир в документ — создаёт если не существует:
  Кв101 = A1sCatalogs.Ensure("Номенклатура", "Квартира 101",
      A1sDS.Of("Родитель", ГрКвартиры, "ЕдиницаИзмерения", Шт));

  // Далее используем в документе:
  A1sDocs.AddRow(Док, "Продукция", A1sDS.Of("Номенклатура", Кв101, "Количество", 1));

  // Контрагент — найти или создать:
  Покупатель = A1sCatalogs.Ensure("Контрагенты", "ООО Ромашка",
      A1sDS.Of("ИНН", "7707083893", "КПП", "770701001"));

// Намерение: Находит элемент по коду. Если не найден — создаёт, заполняет, записывает.
// Граница: Обязательные параметры: Name, Code
// Результат: CatalogRef.

Валюта = A1sCatalogs.EnsureByCode("Валюты", "840",
      A1sDS.Of("Наименование", "Доллар США"));

// Намерение: Находит группу по наименованию. Если не найдена — создаёт, записывает.
// Граница: Обязательные параметры: Name, Description
// Результат: CatalogRef.

ГрКвартиры = A1sCatalogs.EnsureGroup("Номенклатура", "Квартиры — корпус А");
  ГрПитание = A1sCatalogs.EnsureGroup("НоменклатурныеГруппы", "ПИТАНИЕ");

// Намерение: Массовое создание: для каждого наименования в массиве — Ensure. Возвращает массив ссылок (параллельный входному).
// Граница: Обязательные параметры: Name, Descriptions
// Результат: Array.

Имена = A1sAR.Of("Квартира 101", "Квартира 102", "Квартира 103");
  Ссылки = A1sCatalogs.EnsureBatch("Номенклатура", Имена,
      A1sDS.Of("Родитель", ГрКвартиры));

// Намерение: Находит или создаёт элемент, определяя справочник по типу реквизита метаданных. Ключевой паттерн Data-Driven: код не знает имя справочника — он берёт его из метаданных.
// Граница: Обязательные параметры: TypeValue, Description
// Результат: CatalogRef.

// Универсальная привязка: не хардкодим "Номенклатура", берём тип из метаданных ТЧ
  МетаТЧ = Документы.ОтчётПроизводства.ТабличныеЧасти.Продукция;
  ТипРеквизита
          = МетаТЧ.Реквизиты.Номенклатура.Тип;  //✏

  // EnsureByType сам поймёт, что нужен справочник "Номенклатура"
  Ссылка
          = A1sCatalogs.EnsureByType(
                  ТипРеквизита,
                  "Квартира 101");  //▶️

// Намерение: Upsert-паттерн: находит элемент и ОБНОВЛЯЕТ реквизиты, или создаёт новый. В отличие от Ensure (который пропускает найденный), EnsureUpdate всегда синхронизирует данные. Идеально для регулярной загрузки прайс-листов, ГИС ЖКХ, CRM-синхронизации.
// Граница: Обязательные параметры: Name, Description
// Результат: CatalogRef.

// Синхронизация прайс-листа: обновит цену у существующих, создаст новые
  Для Каждого Позиция Из ПрайсЛист Цикл  //⟳
      A1sCatalogs.EnsureUpdate(
              "Номенклатура",
              Позиция.Наименование,
              A1sDS.Of(
                      "ЦенаПродажи", Позиция.Цена,
                      "Площадь",     Позиция.Площадь,
                      "Родитель",    ГруппаКвартир));  //▶️
  КонецЦикла;

// Намерение: Трансформирует "сырую" структуру данных (из JSON/Excel) в структуру для A1sDocs.AddRow: строковые значения полей из Scheme заменяются на ссылки через Ensure. Декларативный альтернативный подход к ручному созданию ссылок в цикле загрузки.
// Граница: Обязательные параметры: SourceData
// Результат: Structure.

// Декларируем схему один раз — цикл загрузки не трогаем при изменениях
  СхемаЗагрузки
          = A1sDS.Of(
                  "Номенклатура",     "Номенклатура",
                  "ЕдиницаИзмерения", "КлассификаторЕдиницИзмерения");  //✏

  Для Каждого Строка Из ДанныеJSON Цикл  //⟳
      // MapRow сам найдёт/создаст "шт" → ссылку, "Кв 101" → ссылку
      ДляДокумента
              = A1sCatalogs.MapRow(
                      Строка,
                      СхемаЗагрузки);  //▶️
      A1sDocs.AddRow(Док, "Продукция", ДляДокумента);
  КонецЦикла;

// Намерение: Возвращает массив уникальных заполненных ссылок из поля ТЧ документа. Используется для постобработки после загрузки: обновить все справочники, встреченные в документах.
// Граница: Обязательные параметры: DocRef, TabName, FieldName
// Результат: Array.

// Собрать все уникальные квартиры из загруженных документов и массово обновить
  Для Каждого ДокСсылка Из ЗагруженныеДоки Цикл  //⟳
      Квартиры
              = A1sCatalogs.PickFromDocument(
                      ДокСсылка,
                      "Продукция",
                      "Номенклатура");  //▶️
      A1sCatalogs.UpdateAll(Квартиры, A1sDS.Of("ЭтапСтроительства", ЭтапСдано));
  КонецЦикла;

// Намерение: Заполняет реквизиты элемента из структуры.
// Граница: Обязательные параметры: Item, Data
// Результат: CatalogObject.

A1sCatalogs.FillAttrs(ТоварОбъект, A1sDS.Of("Цена", 5000, "ВидНоменклатуры", ВидТовар));

// Намерение: Заполняет реквизиты элемента из структуры.
// Граница: Обязательные параметры: Item, Data
// Результат: CatalogObject.

A1sCatalogs.Fill(ТоварОбъект, A1sDS.Of("Цена", 5000, "ВидНоменклатуры", ВидТовар));

// Намерение: Заполняет реквизиты элемента с автоматическим разрешением строк в ссылки. Аналог Fill, но строковые значения реквизитов-справочников разрешаются через EnsureByType по типу из метаданных. Используется транслятором DSL когда в SET есть строковые значения.
// Граница: Обязательные параметры: Item, Data
// Результат: CatalogObject.

// DSL: ENSURE Cat "Контрагенты" BY "ООО Ромашка"
  //      SET
  //        ИНН         = "7701234567"      ← строка-примитив → как есть
  //        ГруппаРиска = "Средний"          ← строка → ENSURE "ГруппыРиска" авто
  A1sCatalogs.FillAuto(
          КонтрагентОбъект,
          A1sDS.Of(
                  "ИНН",        "7701234567",
                  "ГруппаРиска","Средний"));  //

// Намерение: Устанавливает значение одного реквизита.
// Граница: Обязательные параметры: Item, Key, Value
// Результат: CatalogObject.

Результат = A1sCatalogs.Set(Ссылка, "Key", Value);

// Намерение: Добавляет одну строку в табличную часть элемента.
// Граница: Обязательные параметры: Item, TabName, RowData
// Результат: Number.

Результат = A1sCatalogs.AddRow(Ссылка, "Товары", Параметры);

// Намерение: Добавляет одну строку в ТЧ с автоматическим разрешением строк в ссылки. Типы реквизитов берутся из метаданных ТЧ — не нужно знать имена справочников. Используется транслятором DSL когда строки ТЧ содержат строковые значения ссылочных полей.
// Граница: Обязательные параметры: Item, TabName, RowData
// Результат: Number.

// Штрихкоды — поле ТипШтрихкода ссылается на справочник,
  // но нам не нужно писать EnsureByType вручную:
  A1sCatalogs.AddRowAuto(
          НоменклатураОбъект,
          "Штрихкоды",
          A1sDS.Of(
                  "Штрихкод",      "4607132101517",
                  "ТипШтрихкода",  "EAN13"));  //  ← строка → ENSURE автоматически

// Намерение: Добавляет несколько строк из ТаблицыЗначений или массива структур.
// Граница: Обязательные параметры: Item, TabName, Source
// Результат: Number.

Результат = A1sCatalogs.AddRows(Ссылка, "Товары", Source);

// Намерение: Очищает табличную часть.
// Граница: Обязательные параметры: Item, TabName
// Результат: —.

A1sCatalogs.ClearRows(Ссылка, "Товары");

// Намерение: Экспортирует табличную часть в массив структур.
// Граница: Обязательные параметры: Item, TabName
// Результат: Array.

Массив = A1sCatalogs.ExportRows(Ссылка, "Товары");

// Намерение: Количество строк в табличной части.
// Граница: Обязательные параметры: Item, TabName
// Результат: Number.

Результат = A1sCatalogs.RowCount(Ссылка, "Товары");

// Намерение: Загружает массив структур в ТЧ с авторазрешением строк в ссылки. Для каждой строки вызывает AddRowAuto — типы берутся из метаданных ТЧ. Аналог A1sDocs.LoadRows для табличных частей справочников.
// Граница: Обязательные параметры: Item, TabName, Rows
// Результат: Number.

// Загрузить штрихкоды из JSON с авторазрешением ТипШтрихкода:
  A1sCatalogs.LoadTabRows(
          НоменклатураОбъект,
          "Штрихкоды",
          МассивИзJSON);  //

// Намерение: Очищает ТЧ и загружает строки с авторазрешением ссылок.
// Граница: Обязательные параметры: Item, TabName, Rows
// Результат: Number.

Результат = A1sCatalogs.SetLoadTabRows(Ссылка, "Товары", Rows);

// Намерение: Загружает строки табличной части после переименования полей через A1sDS.RenameFields.
// Граница: Обязательные параметры: Item, TabName, Rows, FieldMapping
// Результат: Number.

// JSON содержит "barcode", "type" — а в ТЧ "Штрихкод", "ТипШтрихкода"
  A1sCatalogs.LoadTabRowsMapped(
          НоменклатураОбъект,
          "Штрихкоды",
          МассивИзJSON,
          A1sDS.Of(
                  "barcode", "Штрихкод",
                  "type",    "ТипШтрихкода"));  //

// Намерение: Очищает ТЧ и загружает строки с переименованием и авторазрешением ссылок.
// Граница: Обязательные параметры: Item, TabName, Rows, FieldMapping
// Результат: Number.

Результат = A1sCatalogs.SetLoadTabRowsMapped(Ссылка, "Товары", Rows, "Наименование");

// Намерение: Записывает элемент и возвращает ссылку.
// Граница: Обязательные параметры: Item
// Результат: CatalogRef.

Ссылка = A1sCatalogs.Write(Ссылка);

// Намерение: Пометка/снятие пометки удаления.
// Граница: Обязательные параметры: ItemRef
// Результат: CatalogRef.

Ссылка = A1sCatalogs.MarkForDeletion(Ссылка);

// Намерение: Обновляет реквизиты элемента. Принимает структуру полей ИЛИ имя поля + значение (обратная совместимость с v1).
// Граница: Обязательные параметры: ItemRef, FieldsOrName
// Результат: Boolean.

// Новый стиль (структура):
  A1sCatalogs.Update(ТоварСсылка, A1sDS.Of("Цена", 5000, "Активен", Истина));

  // Старый стиль (одно поле) — по-прежнему работает:
  A1sCatalogs.Update(ТоварСсылка, "Цена", 5000);

// Намерение: Массовое обновление реквизитов. Принимает структуру полей ИЛИ имя поля + значение (обратная совместимость с v1).
// Граница: Обязательные параметры: Items, FieldsOrName
// Результат: Structure.

Данные = A1sCatalogs.UpdateAll(Ссылка, "Наименование");

// Намерение: Массовая пометка удаления.
// Граница: Обязательные параметры: Items
// Результат: Structure.

Данные = A1sCatalogs.MarkForDeletionBatch(Ссылка);

// Намерение: Перемещает элемент в другую группу.
// Граница: Обязательные параметры: ItemRef, NewParent
// Результат: CatalogRef.

Ссылка = A1sCatalogs.Move(Ссылка, Ссылка);

// Намерение: Массовое перемещение элементов.
// Граница: Обязательные параметры: Items, NewParent
// Результат: Structure.

Данные = A1sCatalogs.MoveBatch(Ссылка, Ссылка);

// Намерение: Находит элемент по наименованию. Если указан Parent — ищет в конкретной группе.
// Граница: Обязательные параметры: Name, Description
// Результат: CatalogRef.

Ссылка = A1sCatalogs.ByName("Name", "Товар");

// Намерение: Находит элемент по коду.
// Граница: Обязательные параметры: Name, Code
// Результат: CatalogRef.

Ссылка = A1sCatalogs.ByCode("Name", "000001");

// Намерение: Находит элемент по значению реквизита.
// Граница: Обязательные параметры: Name, AttrName, Value
// Результат: CatalogRef.

Ссылка = A1sCatalogs.ByAttr("Name", "Наименование", Value);

// Намерение: Находит элемент по GUID ссылки.
// Граница: Обязательные параметры: Name, GUIDStr
// Результат: CatalogRef.

Ссылка = A1sCatalogs.ByGUID("Name", Идентификатор);

// Намерение: Находит элементы по списку наименований (строка через разделитель).
// Граница: Обязательные параметры: Name, DescriptionList
// Результат: Array.

Валюты = A1sCatalogs.ByNameList("Валюты", "USD,EUR,CNY");

// Намерение: Выбрать несколько элементов по наименованиям (массив).
// Граница: Обязательные параметры: CatalogName, Names
// Результат: Array.

Группы = A1sCatalogs.PickByName("НоменклатурныеГруппы",
      A1sAR.Of("ПРОЖИВАНИЕ", "ПИТАНИЕ", "ПРОЧИЕ УСЛУГИ"));

// Намерение: Выбрать несколько элементов по кодам (массив).
// Граница: Обязательные параметры: CatalogName, Codes
// Результат: Array.

Товары = A1sCatalogs.PickByCode("Номенклатура",
      A1sAR.Of("000001", "000002", "000003"));

// Намерение: Выбрать элементы по значению реквизита (массив значений).
// Граница: Обязательные параметры: CatalogName, AttrName, Values
// Результат: Array.

Контрагенты = A1sCatalogs.PickByAttr("Контрагенты", "ИНН",
      A1sAR.Of("7701234567", "7707654321"));

// Намерение: Выбрать предопределённые элементы (массив имён).
// Граница: Обязательные параметры: CatalogName, PredefinedNames
// Результат: Array.

Виды = A1sCatalogs.PickPredefined("ВидыНоменклатуры",
      A1sAR.Of("Товар", "Услуга", "Работа"));

// Намерение: Все элементы в группе (включая вложенные).
// Граница: Обязательные параметры: CatalogName, GroupRef
// Результат: Array.

Массив = A1sCatalogs.AllInGroup("Номенклатура", Ссылка);

// Намерение: Все элементы подчинённого справочника по владельцу.
// Граница: Обязательные параметры: CatalogName, OwnerRef
// Результат: Array.

Массив = A1sCatalogs.AllByOwner("Номенклатура", Ссылка);

// Намерение: Возвращает Соответствие (Наименование → Ссылка) для переданных наименований. Ненайденные элементы в результат не включаются.
// Граница: Обязательные параметры: CatalogName, Names
// Результат: Map.

// По именам получить соответствие для быстрой адресации:
  Группы = A1sCatalogs.MapByName("НоменклатурныеГруппы",
      A1sAR.Of("ПРОЖИВАНИЕ", "ПИТАНИЕ", "ПРОЧИЕ УСЛУГИ"));

  // Использование:
  A1sDocs.AddRow(Док, "Продукция",
      A1sDS.Of("НоменклатурнаяГруппа", Группы["ПИТАНИЕ"], "Количество", 1));

// Намерение: Возвращает Соответствие (Наименование → Ссылка): ищет, при отсутствии — создаёт. Все переданные имена гарантированно присутствуют в результате.
// Граница: Обязательные параметры: CatalogName, Names
// Результат: Map.

// Получить или создать статьи ДДС — вернуть соответствие:
  СтатьиДДС = A1sCatalogs.EnsureMapByName(
      "СтатьиДвиженияДенежныхСредств",
      A1sAR.Of("Основная деятельность", "Капиталовложения", "Финансовая деятельность"),
      A1sDS.Of("Вид", Перечисления.ВидыСтатейДДС.Прочее));

  // Использование:
  .Set("СтатьяДДС", СтатьиДДС["Капиталовложения"])

// Намерение: Возвращает Соответствие (Код → Ссылка) для переданных кодов. Ненайденные элементы в результат не включаются.
// Граница: Обязательные параметры: CatalogName, Codes
// Результат: Map.

Валюты = A1sCatalogs.MapByCode("Валюты", A1sAR.Of("840", "978", "156"));
  .Set("ВалютаРасчётов", Валюты["840"])  // USD

// Намерение: Возвращает Соответствие (Код → Ссылка): ищет, при отсутствии — создаёт. Все переданные коды гарантированно присутствуют в результате.
// Граница: Обязательные параметры: CatalogName, Codes
// Результат: Map.

Валюты = A1sCatalogs.EnsureMapByCode("Валюты",
      A1sAR.Of("840", "978", "156"),
      A1sDS.Of("Наименование", "?")); // Наименование обновится при создании

// Намерение: Возвращает Соответствие (ЗначениеРеквизита → Ссылка) для переданных значений. Запрос выполняется одним обращением к базе — эффективен для больших наборов.
// Граница: Обязательные параметры: CatalogName, AttrName, Values
// Результат: Map.

// По ИНН получить соответствие контрагентов за один запрос:
  КонтрагентыПоИНН = A1sCatalogs.MapByAttr(
      "Контрагенты", "ИНН",
      A1sAR.Of("7701234567", "7707654321", "7708572512"));

  Для Каждого Строка Из ДанныеИмпорта Цикл
      Контрагент = КонтрагентыПоИНН[Строка.ИНН];
      Если Контрагент <> Неопределено Тогда
          // нашли — используем
      КонецЕсли;
  КонецЦикла;

// Намерение: Возвращает Соответствие (Наименование → Ссылка) запросом — эффективно для больших наборов (один запрос вместо N вызовов НайтиПоНаименованию).
// Граница: Обязательные параметры: CatalogName, Names
// Результат: Map.

// 50 наименований — один запрос вместо 50 обращений к НайтиПоНаименованию:
  СтатьиMap = A1sCatalogs.MapByNameQ("СтатьиЗатрат", МассивИменИзJSON);
  .Set("СтатьяЗатрат", СтатьиMap["Материалы"])

// Намерение: Версия EnsureMapByName с пакетным запросом для поиска существующих. Сначала находит всё одним запросом, затем создаёт только отсутствующие.
// Граница: Обязательные параметры: CatalogName, Names
// Результат: Map.

// 20 групп номенклатуры — создать отсутствующие, вернуть все разом:
  Группы = A1sCatalogs.EnsureMapByNameQ(
      "НоменклатурныеГруппы",
      A1sAR.Of("ПРОЖИВАНИЕ", "ПИТАНИЕ", "ПРОЧИЕ УСЛУГИ", "СПОРТ"));

  НоваяСтрока.НоменклатурнаяГруппа = Группы["ПИТАНИЕ"];

// Намерение: Массив ссылок по произвольному условию.
// Граница: Обязательные параметры: Name
// Результат: Array.

Активные = A1sCatalogs.Refs("Номенклатура",
      "НЕ ПометкаУдаления И ВидНоменклатуры = &Вид",
      A1sDS.Of("Вид", ВидТовар), "Наименование");

// Намерение: Подсчёт элементов по условию.
// Граница: Обязательные параметры: Name
// Результат: Number.

Результат = A1sCatalogs.Count("Name");

// Намерение: Проверка существования элементов по условию.
// Граница: Обязательные параметры: Name
// Результат: Boolean.

Успешно = A1sCatalogs.Exists("Name");

// Намерение: Элементы верхнего уровня.
// Граница: Обязательные параметры: Name
// Результат: Array.

Массив = A1sCatalogs.TopLevelItems("Name");

// Намерение: Родитель элемента.
// Граница: Обязательные параметры: ItemRef
// Результат: CatalogRef | Undefined.

Ссылка = A1sCatalogs.Parent(Ссылка);

// Намерение: Дочерние элементы.
// Граница: Обязательные параметры: ItemRef
// Результат: Array.

Массив = A1sCatalogs.Children(Ссылка);

// Намерение: Уровень элемента в иерархии (0 = корень).
// Граница: Обязательные параметры: ItemRef
// Результат: Number.

Результат = A1sCatalogs.Level(Ссылка);

// Намерение: Полный путь элемента в иерархии.
// Граница: Обязательные параметры: ItemRef
// Результат: String.

Текст = A1sCatalogs.Path(Ссылка);

// Намерение: Проверка наличия дочерних элементов.
// Граница: Обязательные параметры: ItemRef
// Результат: Boolean.

Успешно = A1sCatalogs.HasChildren(Ссылка);

// Намерение: Проверяет, является ли элемент группой.
// Граница: Обязательные параметры: ItemRef
// Результат: Boolean.

Успешно = A1sCatalogs.IsGroup(Ссылка);

// Намерение: Проверяет пустая ли ссылка.
// Граница: Обязательные параметры: Name, Value
// Результат: Boolean.

Успешно = A1sCatalogs.IsEmpty("Name", Value);

// Намерение: Проверяет помечен ли на удаление.
// Граница: Обязательные параметры: ItemRef
// Результат: Boolean.

Успешно = A1sCatalogs.IsMarkedForDeletion(Ссылка);

// Намерение: Проверка уникальности кода.
// Граница: Обязательные параметры: Name, Code
// Результат: Boolean.

Успешно = A1sCatalogs.IsCodeUnique("Name", "000001");

// Намерение: Детальная информация об элементе.
// Граница: Обязательные параметры: ItemRef
// Результат: Structure.

Данные = A1sCatalogs.Details(Ссылка);

// Намерение: Тип реквизита шапки справочника.
// Граница: Обязательные параметры: CatName, AttrName
// Результат: TypeDescription.

// Разрешить строку в ссылку по типу реквизита шапки
  Тип = A1sCatalogs.AttrType("Номенклатура", "ВидНоменклатуры");
  Ссылка = A1sCatalogs.EnsureByType(Тип, "Товар");

// Намерение: Возвращает описание реквизитов справочника как массив структур.
// Граница: Обязательные параметры: CatName
// Результат: Array.

Массив = A1sCatalogs.AttrSchema("CatName");

// Намерение: Тип реквизита табличной части справочника.
// Граница: Обязательные параметры: CatName, TabName, AttrName
// Результат: TypeDescription.

Тип = A1sCatalogs.TabAttrType("Номенклатура", "Штрихкоды", "ТипШтрихкода");
  Ссылка = A1sCatalogs.EnsureByType(Тип, "EAN13");

// Намерение: Схема всех реквизитов табличной части справочника. Каждый элемент: {Имя, Тип, ТипСтрока, ЭтоСправочник, ИмяСправочника}.
// Граница: Обязательные параметры: CatName, TabName
// Результат: Array.

// Перед загрузкой данных — распечатать схему ТЧ для ТЗ
  Схема = A1sCatalogs.TabSchema("Номенклатура", "Штрихкоды");

// Намерение: Имена реквизитов табличной части справочника.
// Граница: Обязательные параметры: CatName, TabName
// Результат: Array.

Массив = A1sCatalogs.TabColumnNames("CatName", "Товары");

// Намерение: Количество справочников в конфигурации.
// Граница: Параметров нет.
// Результат: Number.

Результат = A1sCatalogs.MetaCount();

// Намерение: Массив имён всех справочников конфигурации.
// Граница: Параметров нет.
// Результат: Array.

Массив = A1sCatalogs.MetaNames();

// Намерение: Проверяет, является ли справочник иерархическим.
// Граница: Обязательные параметры: Name
// Результат: Boolean.

Успешно = A1sCatalogs.IsHierarchical("Name");

// Намерение: Проверяет, имеет ли справочник владельца.
// Граница: Обязательные параметры: Name
// Результат: Boolean.

Успешно = A1sCatalogs.HasOwner("Name");

// Намерение: Имена табличных частей справочника.
// Граница: Обязательные параметры: Name
// Результат: Array.

Массив = A1sCatalogs.TabNames("Name");

// Намерение: Создаёт fluent-обёртку A1sDP_Catalogs для цепочечных вызовов. Если передана строка — создаёт новый элемент. Если ссылка/объект — оборачивает.
// Граница: Обязательные параметры: Name
// Результат: DataProcessorObject.A1sDP_Catalogs.

// Новый элемент:
  Ссылка = A1sCatalogs.On("Номенклатура")
      .Set("Наименование", "Квартира 101")
      .Set("Родитель", ГрКвартиры)
      .Write();

  // Существующий:
  A1sCatalogs.On(ТоварСсылка)
      .Set("Цена", 5000)
      .Write();

// Намерение: Подключается к СУЩЕСТВУЮЩЕМУ элементу справочника и возвращает fluent-обёртку. Принимает ссылку или объект.
// Граница: Обязательные параметры: ItemOrRef
// Результат: DataProcessorObject.A1sDP_Catalogs.

A1sCatalogs.OnRef(ТоварСсылка)
      .Set("Цена", 5000)
      .Set("ВидНоменклатуры", ВидТовар)
      .Write();

// Намерение: Самотест модуля A1sCatalogs.
// Граница: Параметров нет.
// Результат: Boolean.

Успешно = A1sCatalogs.SelfTest();