Fluent API

// ── Базовая цепочка: создать → заполнить → провести ───────────────────────
Ссылка = A1sDocs.On("ВыпускПродукцииУслуг",
        A1sDS.Of(
            "Дата",        '20260201',
            "Организация", МояОрг,
            "Склад",       СкладГП))
    .Set("Комментарий", "Корпус А — февраль 2026")
    .AddRows("Продукция", ТЗКвартиры)
    .Post();

// ── Несколько ТЧ ─────────────────────────────────────────────────────────
Ссылка = A1sDocs.On("РеализацияТоваровУслуг",
        A1sDS.Of("Дата", ТекущаяДата(), "Контрагент", Контрагент))
    .Set("Договор",    Договор)
    .Set("Склад",     Склад)
    .AddRows("Товары",  ТЗТовары)
    .AddRows("Услуги",  ТЗУслуги)
    .Post();

// ── Write вместо Post — записать без проведения ───────────────────────────
Ссылка = A1sDocs.On("ВыпускПродукцииУслуг",
        A1sDS.Of("Дата", '20260201', "Организация", МояОрг))
    .AddRows("Продукция", ТЗКвартиры)
    .Write();  // черновик — не проводим

// ── Fluent с LoadRows (авторазрешение строк) ──────────────────────────────
Ссылка = A1sDocs.On("ВыпускПродукцииУслуг",
        A1sDS.Of("Дата", '20260201', "Организация", МояОрг))
    .LoadRows("Продукция", МассивСтрокИзJSON)  // строки → ссылки
    .Post();

// ── Обернуть существующий и изменить ─────────────────────────────────────
A1sDocs.On(ДокСсылка)
    .Set("Комментарий", "Исправлено вручную")
    .Post(Истина);  // Force=Истина — перепровести даже если уже проведён

// ── Заменить всю ТЧ существующего документа ──────────────────────────────
A1sDocs.On(ДокСсылка)
    .ClearRows("Продукция")       // очистить старые строки
    .AddRows("Продукция", НоваяТЗ) // загрузить новые
    .Post(Истина);

// ── On с Header: обернуть и сразу изменить несколько реквизитов шапки ────
A1sDocs.On(ДокСсылка,
    A1sDS.Of(
        "Комментарий",   "Откорректировано",
        "Ответственный", НовыйОтвет))
    .Post(Истина);

// ── Передать объект если он уже открыт ───────────────────────────────────
ДокОбъект = A1sDocs.GetObject(ДокСсылка); // открыт ранее
A1sDocs.On(ДокОбъект)           // обёртка без лишнего GetObject
    .LoadRows("Продукция", НовыеДанные)
    .Post(Истина);

// ── Создать новую номенклатуру ────────────────────────────────────────────
НомСсылка = A1sCatalogs.On("Номенклатура")
    .Set("Наименование",      "Квартира 401")
    .Set("Родитель",          ГрКвартиры)
    .Set("ВидНоменклатуры",  ВидКвартира)
    .Set("ЕдиницаИзмерения", ЕдШт)
    .Set("Площадь",          48.5)
    .Set("Этаж",             5)
    .Write();

// ── Передать начальные реквизиты сразу в On() ─────────────────────────────
КонтрСсылка = A1sCatalogs.On("Контрагенты",
        A1sDS.Of("Наименование", "ООО Ромашка", "ИНН", "7707083893"))
    .Set("КПП",             "770701001")
    .Set("ВидКонтрагента", ВидЮрЛицо)
    .Write();

// ── Создать элемент с ТЧ (например, у справочника есть ТЧ «Контакты») ────
Ссылка = A1sCatalogs.On("Контрагенты")
    .Set("Наименование", "ООО Ромашка")
    .AddRow("Контакты",
        A1sDS.Of("Вид", "Email", "Значение", "info@romashka.ru"))
    .AddRow("Контакты",
        A1sDS.Of("Вид", "Телефон", "Значение", "+7 495 000-00-00"))
    .Write();

// ── Обернуть существующий и изменить один реквизит ───────────────────────
A1sCatalogs.On(НомСсылка)
    .Set("Цена", 3750000)
    .Write();

// ── Обернуть с немедленным Set в On() ────────────────────────────────────
A1sCatalogs.On(НомСсылка,
        A1sDS.Of("Цена", 3750000, "Статус", СтатусАктив))
    .Write();

// ── Заменить ТЧ существующего ─────────────────────────────────────────────
A1sCatalogs.On(КонтрСсылка)
    .ClearRows("Контакты")
    .AddRows("Контакты", НовыеКонтакты)
    .Write();

// ── Простая сборка структуры ──────────────────────────────────────────────
Шапка = A1sDS.On()
    .Set("Организация", МояОрг)
    .Set("Дата",        ТекущаяДата())
    .Set("Склад",       СкладГП)
    .Value();
// → обычная Структура {Организация, Дата, Склад}

// ── SetIf: добавить поле только при выполнении условия ────────────────────
Фильтр = A1sDS.On()
    .Set("Организация", МояОрг)
    .SetIf("Склад",        Склад,        ЗначениеЗаполнено(Склад))
    .SetIf("Контрагент",   Контрагент,   ЗначениеЗаполнено(Контрагент))
    .SetIf("ПремиумКлиент", Истина,       ЕстьПодписка)
    .Value();

// ── SetMany: добавить несколько ключей из структуры ───────────────────────
Параметры = A1sDS.On()
    .Set("Версия", "2.1.0")
    .SetMany(A1sDS.Of("Хост", "prod-server", "Порт", 8080))
    .Value();

// ── ToFixed: неизменяемая структура-константа ─────────────────────────────
Константы = A1sDS.On()
    .Set("MaxRetries",  3)
    .Set("TimeoutSec",  30)
    .Set("BatchSize",   100)
    .ToFixed();
// Константы.MaxRetries = 5 → ОШИБКА: ФиксированнаяСтруктура нельзя изменить

// ── Очистить ответ API: убрать служебные поля, переименовать ──────────────
ОтветAPI = A1sDS.Of(
    "first_name", "Иван",    "last_name",  "Петров",
    "email",      "i@p.ru",  "token",      "eyJ...",
    "_internal", 42,        "role",       "admin");

ПубличныйПрофиль = A1sDS.On(ОтветAPI)
    .Omit("token, _internal")            // убрать чувствительное
    .Rename(A1sDS.Of(
        "first_name", "Имя",
        "last_name",  "Фамилия",
        "email",      "Email",
        "role",       "Роль"))
    .Value();
// → { Имя: "Иван", Фамилия: "Петров", Email: "i@p.ru", Роль: "admin" }

// ── Defaults: применить умолчания к пользовательским настройкам ──────────
НастройкиПользователя = A1sDS.Of("Хост", "prod-server"); // только хост

ИтоговаяКонфигурация = A1sDS.On(НастройкиПользователя)
    .Defaults(A1sDS.Of(
        "Хост",          "localhost",  // перезапишется "prod-server"
        "Порт",          8080,         // добавится
        "Таймаут",       30,           // добавится
        "SSL",           Ложь,         // добавится
        "ПулСоединений", 10))          // добавится
    .Value();
// → { Хост: "prod-server", Порт: 8080, Таймаут: 30, SSL: Ложь, ПулСоединений: 10 }

// ── Слить данные из нескольких источников ────────────────────────────────
БазовыеДанные    = /* из БД */;
КэшДанные       = /* из кэша */;
СессионныеДанные = /* из сессии */;

ПолныеДанные = A1sDS.On(БазовыеДанные)
    .Merge(КэшДанные)             // перезапишет совпадающие ключи
    .Merge(СессионныеДанные)       // высший приоритет
    .Set("ДатаЗагрузки", ТекущаяДата())
    .Omit("ВнутренниеДанные")
    .Value();

// ── Построить массив шаг за шагом ─────────────────────────────────────────
Результат = A1sAR.On()
    .Add(1).Add(2).Add(3).Add(2).Add(1)
    .RemoveDuplicates()
    .Sort()
    .Value();
// → [1, 2, 3]

// ── Трансформация существующего массива ───────────────────────────────────
СырыеДанные = A1sAR.Of(Ном1, Неопределено, Ном2, Ном1, Неопределено, Ном3);

ЧистыйСписок = A1sAR.On(СырыеДанные)
    .PickFilled()            // убрать Неопределено и пустые
    .RemoveDuplicates()      // убрать дубли
    .Value();
// → [Ном1, Ном2, Ном3]

// ── Объединить и обработать ───────────────────────────────────────────────
ВсяНоменклатура = A1sAR.On(НомДок1)
    .Concatenate(НомДок2)
    .Concatenate(НомДок3)
    .RemoveDuplicates()
    .Reverse()
    .Value();

// ── Построить список условно ──────────────────────────────────────────────
Действия = A1sAR.On()
    .Add("Проведение")
    .AddIf("Отправить уведомление", НужноУведомление)
    .AddIf("Обновить склад",       ЕстьДвижениеТМЦ)
    .AddIf("Печать документа",    НужнаПечать)
    .Value();
Сообщить("Будут выполнены: " + A1sAR.Join(Действия, ", "));