Документация, структура, стиль API и правила надёжности.
Единый контракт кодаОткрыть все стандарты↗Пять независимых модулей, точные сигнатуры, примеры и справочники.
Выберите объект задачиВыбрать модуль↗Методика фиксации смысла, допустимых состояний, границ и доказательства.
Смысловой слой над кодомОткрыть MILA↗Книга, блог, маршруты и практические сценарии.
От первого запуска до архитектурыНачать за 5 минут↗Из материка шаблонного кода — на остров читаемых решений.
Ничего не найдено. Попробуйте другое слово.
A1sCode превращает работу со структурами, массивами, справочниками и документами в короткие, читаемые и проверяемые сценарии. Библиотека, стандарты и MILA сохраняют не только код — они сохраняют смысл решения.
// Намерение: подготовить номенклатуру и провести выпуск из Excel
// Повторный запуск безопасен: Ensure* не создаёт дубли
Гр = A1sCatalogs.EnsureGroup(
"Номенклатура", "Корпус А");
A1sCatalogs.EnsureBatch(
"Номенклатура", Имена,
A1sDS.Of("Родитель", Гр));
A1sDocs.On("ВыпускПродукцииУслуг",
A1sDS.Of(
"Дата", '20260201',
"Организация", МояОрг))
.LoadRows("Продукция", ДанныеExcel)
.Post();Большая часть типового фрагмента отвечает не на вопрос «что делает бизнес», а на вопросы платформы: как найти, проверить, создать, заполнить, записать и не забыть обработать исключение.
Выборка = Справочники.Номенклатура.НайтиПоКоду(Код);
Если НЕ ЗначениеЗаполнено(Выборка) Тогда
Объект = Справочники.Номенклатура.СоздатьЭлемент();
Объект.Код = Код;
Объект.Наименование = Имя;
Объект.Родитель = Родитель;
Объект.Записать();
Иначе
Объект = Выборка.ПолучитьОбъект();
КонецЕсли;Разработчик читает процедуру платформы и самостоятельно восстанавливает бизнес-намерение.
Номенклатура = A1sCatalogs.Ensure(
"Номенклатура", "Код", Код,
A1sDS.Of(
"Наименование", Имя,
"Родитель", Родитель));Сокращение строк — только следствие. Главное: операция стала законченной и узнаваемой мыслью.
A1sCode соединяет исполняемые операции, правила качества, сохранение намерения и передачу практики в одну систему.
Модули A1sCode дают готовые операции над структурами, коллекциями, справочниками и документами.
Выбрать модуль →Стандарты A1sCode задают XML-док, SyntaxMarks, именование, регионы, сложность и логирование.
Открыть стандарты →MILA фиксирует WHAT, TYPE, WHY, EDGE и HOW рядом с кодом — до того, как контекст исчезнет.
Понять MILA →Cookbook и обучение превращают частный опыт в интерактивные сценарии, тесты и маршруты.
Перейти к практике →Он не скрывает платформу и не заменяет BSL. Он добавляет над ними общий словарь решений, явные границы и проверяемый контекст.
BSL остаётся языком исполнения. A1sCode становится языком прикладных намерений.Прочитать о читаемом коде →
Подключайте только нужный модуль. Каждый домен получает предсказуемый API, живые примеры и единый способ читать операцию.
Структуры, пары ключ-значение и преобразование данных.
Вместо ручного копирования полей код сначала оставляет разрешённые ключи, затем подставляет значения по умолчанию.
Разрешённые = A1sDS.Pick(
СтрокаExcel, "Код,Наименование,Цена");
Данные = A1sDS.Defaults(
Разрешённые,
A1sDS.Of(
"Цена", 0,
"Валюта", "RUB"));OfOfFixedOfKeysOfQueryStringZipPatchPickOmitRenameRenameFieldsGetOrInsertGetOrInsertEvalGetOrInsertPathDefaultsMergeMergeFixedConcatenateCopyDeepCopyFillToFixedResetDeepFlattenKeysNestKeysHasKeyHasKeysIsEmptyGetKeysGetValuesEqualsGroupByIntersectionDifferenceSanitizeSanitizeTreeRowsToJSONSelfTestOnМассивы, множества, фильтрация, типизация и Fluent-цепочки.
Каждый шаг решает одну понятную задачу: убрать Неопределено, удалить дубли, отсортировать и соединить.
Теги = A1sAR.PickNotNull(ИсходныеТеги);
Теги = A1sAR.RemoveDuplicates(Теги);
СтрокаТегов = A1sAR.Join(
A1sAR.Sort(Теги), ", ");OfOfNOfFixedChunkFlattenInsertRemoveAtSortReverseResetDeepResetConcatenateRemoveDuplicatesUnionIntersectionDifferencePickByTypeOmitByTypePickNotNullGetTypesIsHomoTypedConvertToFirstLastContainsIndexOfJoinEqualsEqualsDeepOnSelfTestСправочники: поиск, создание, идемпотентный upsert и пакетные операции.
Группа и элементы справочника создаются только при отсутствии. Один и тот же импорт можно запускать повторно.
Группа = A1sCatalogs.EnsureGroup(
"Номенклатура", "Корпус А");
Квартиры = A1sCatalogs.EnsureBatch(
"Номенклатура", ИменаКвартир,
A1sDS.Of("Родитель", Группа));IsCatalogIsRefIsObjectGetObjectGetRefManagerEmptyOfCreateGroupCopyOfRefOfAutoEnsureEnsureByCodeEnsureGroupEnsureBatchEnsureByTypeEnsureUpdateMapRowPickFromDocumentFillAttrsFillFillAutoSetAddRowAddRowAutoAddRowsClearRowsExportRowsRowCountLoadTabRowsSetLoadTabRowsLoadTabRowsMappedSetLoadTabRowsMappedWriteMarkForDeletionUpdateUpdateAllMarkForDeletionBatchMoveMoveBatchByNameByCodeByAttrByGUIDByNameListPickByNamePickByCodePickByAttrPickPredefinedAllInGroupAllByOwnerMapByNameEnsureMapByNameMapByCodeEnsureMapByCodeMapByAttrMapByNameQEnsureMapByNameQRefsCountExistsTopLevelItemsParentChildrenLevelPathHasChildrenIsGroupIsEmptyIsMarkedForDeletionIsCodeUniqueDetailsAttrTypeAttrSchemaTabAttrTypeTabSchemaTabColumnNamesMetaCountMetaNamesIsHierarchicalHasOwnerTabNamesOnOnRefSelfTestДокументы: шапка, табличные части, запись, проведение и пакетная обработка.
Шапка и строки готовятся до записи. Последняя строка кода выражает бизнес-результат — проведённый документ.
Док = A1sDocs.Of(
"ВыпускПродукцииУслуг",
A1sDS.Of(
"Дата", '20260201',
"Организация", МояОрг));
A1sDocs.LoadRows(
Док, "Продукция", ДанныеExcel);
Ссылка = A1sDocs.Post(Док);IsDocumentIsRefIsObjectGetObjectGetRefOfOfAutoOfBaseCopyOfRefFillFillAutoSetUpdateAddRowAddRowsClearRowsSetRowsExportRowsRowCountAddRowAutoLoadRowsSetLoadRowsLoadRowsMappedSetLoadRowsMappedAddRowsMapWritePostUnpostMarkForDeletionPostAllUnpostAllProcessAllUpdateAllByNumberByAttrByGUIDMapByNumberMapByNumberDateMapByAttrEnsureByNumberDateEnsureDocumentEnsureMapByNumberDateAllInPeriodAllPostedAllUnpostedAllByBasePickByAttrRefsCountExistsIsPostedIsEmptyDetailsUnpostedDocsAttrTypeAttrSchemaTabAttrTypeTabSchemaManagerEmptyMetaCountMetaNamesTabNamesTabColumnNamesOnOnRefSelfTestЗапросы, параметры, выгрузка результатов, Query Builder и временные таблицы.
Цепочка явно разделяет источник, условия, сортировку и форму результата. Параметры устанавливаются безопасно внутри Fluent API.
Товары = A1sQ.On()
.Select("Ссылка, Наименование")
.From("Справочник.Номенклатура")
.Where("НЕ ПометкаУдаления")
.WhereLike("Наименование", "молоко", "Contains")
.OrderBy("Наименование")
.Unload();OnCreateQNewQQIsValidValidateCreateQWithTempsCreateAndLoadCreateQEnhancedCreateQSafeGetParamsGetQParamsParseParamsSetQParamsBuildQByParamsBuildQProcessQueryParamsExecuteQFirstRowFirstRowQValueQExecuteQSafeUnloadSafeExistsQCountQGetTableStructureValuesQArrayQStructureQMapQGroupedQUnloadMultipleIsEmptyResultIsNotEmptyResultUnloadIsEmptyTableUnloadColumnBuildSearchQuerySearchForChoiceAutoChoiceDataStandardChoiceProcessingQuickCatalogSearchQuickDocumentSearchShowSearchExamplesChainQSelectFromWhereWithParamOrderByTopBuildPagedUnloadUnloadToJSONProfiledUnloadUnloadTempUnloadAllTempsGetTempsTT_CreateTT_ColumnsTT_ExistsTT_HasColumnTT_HasColumnsDestroyTempDestroyAllTempsResetTempManagerBuildByQTExecuteByQTUnloadByQTQTEscapeLikeQuerySeparatorCombineQTLikePatternBuildWhereTP_HasFieldTP_FieldsTP_ValidateFieldsTP_GetFieldTypeТест_TT_ФункцииТест_TP_ФункцииSelfTestSelfTest_ByQTGetBalancesQueryTextExecuteBatchUnloadBatchSelectDocsSelectCatalogItemsЧем больше кода создают команды и ИИ, тем важнее общий интерфейс, который удерживает намерение, контракт и доказательство корректности.
Ensure, Pick, Merge, LoadRows и Post становятся узнаваемыми действиями между проектами.
Сценарии собираются из стабильных операций, а не заново из десятков служебных строк.
Можно подключить один модуль и заменить один повторяющийся фрагмент без переписывания конфигурации.
Документация, граничные случаи, тесты и примеры живут рядом с исполняемым решением.
Код меньше зависит от памяти конкретного автора: стандарты и MILA сохраняют модель решения.
ИИ получает стабильный API, машиночитаемую документацию, явные ограничения и проверочные примеры.
Система усиливает платформу там, где повторяемая механика заслоняет предметный смысл.
92 интерактивных примера показывают не только вызовы API, но и путь от функции к паттерну, проекту и проверяемой границе.
A1sDS и A1sAR: фабрики, выборка, слияние и коллекции.
A1sDS.Of("Дата", Дата, "Сумма", Сумма)На практике: собирать данные без ручной вставки ключейEnsure, upsert, маппинг и иерархия A1sCatalogs.
A1sCatalogs.EnsureBatch(...)На практике: импортировать справочники повторяемоШапка, табличные части, запись и проведение A1sDocs.
A1sDocs.Of(...) → LoadRows(...) → Post(...)На практике: собирать документ как цельный сценарийExcel, JSON, синхронизация и пакетная обработка.
Excel → нормализация → объект 1СНа практике: комбинировать модули в прикладных задачахЦепочки On().Set().AddRows().Post().
A1sDocs.On(...).Set(...).Post()На практике: читать цепочку как последовательность решенийТиповые ошибки, диагностика и SelfTest.
A1sAR.SelfTest()На практике: проверять контракт модуля до внедренияЗастройщик, гостиница, ресторан, ЖКХ и CRM.
EnsureGroup + EnsureBatch + PostНа практике: строить законченные проектные сценарииБыстрый поиск по всей библиотеке.
поиск → сигнатура → пример → контрактНа практике: быстро находить нужную функциюБудущая роль A1sCode опирается на работающие модули, опубликованные правила и обучающие маршруты.
Независимые домены данных и объектов 1С.
Открыть → Стандарты9 страниц правилXMLDOC, SyntaxMarks, API, структура и качество.
Открыть → MILAСпецификация и протоколыМанифест, Core Spec, Testing, Learning и AI Protocol.
Открыть → Практика8 частей · 92 примераИнтерактивный путь от функции до проекта.
Открыть →Примеры соединяют данные, справочники и документы в одну историю, чтобы смысл не распадался на отдельные карточки функций.
Входная таблица превращается в документ только после того, как шапка и все строки подготовлены.
A1sDS.OfA1sDocs.OfLoadRowsPostШапка = A1sDS.Of(
"Дата", '20260201',
"Организация", МояОрг);
Док = A1sDocs.Of(
"ВыпускПродукцииУслуг", Шапка);
A1sDocs.LoadRows(
Док, "Продукция", ДанныеExcel);
Ссылка = A1sDocs.Post(Док);Каждая строка обновляет существующую номенклатуру либо создаёт новую по одному явному правилу.
EnsureGroupEnsureUpdateA1sDS.OfГруппа = A1sCatalogs.EnsureGroup(
"Номенклатура", "Импорт прайса");
Для Каждого Позиция Из ПрайсЛист Цикл
A1sCatalogs.EnsureUpdate(
"Номенклатура", Позиция.Наименование,
A1sDS.Of(
"Цена", Позиция.Цена,
"Родитель", Группа));
КонецЦикла;Сценарий явно показывает, какие данные разрешены и какие значения должны появиться при отсутствии.
PickDefaultsOfРазрешённые = A1sDS.Pick(
СтрокаExcel,
"Код,Наименование,Цена");
Нормализованные = A1sDS.Defaults(
Разрешённые,
A1sDS.Of(
"Цена", 0,
"Валюта", "RUB"));Четыре действия над массивом читаются как конвейер преобразования, а не как вложенные служебные циклы.
PickNotNullRemoveDuplicatesSortJoinТеги = A1sAR.PickNotNull(ИсходныеТеги);
Теги = A1sAR.RemoveDuplicates(Теги);
СтрокаТегов = A1sAR.Join(
A1sAR.Sort(Теги), ", ");Вместо поиска и создания каждой позиции вручную библиотека применяет единый контракт ко всему набору.
EnsureGroupEnsureBatchA1sAR.OfГруппа = A1sCatalogs.EnsureGroup(
"Номенклатура", "Корпус А");
Квартиры = A1sCatalogs.EnsureBatch(
"Номенклатура",
A1sAR.Of("Кв101", "Кв102", "Кв103"),
A1sDS.Of("Родитель", Группа));Массовая операция возвращает массив ошибок: сбой отдельного документа не теряется и может быть показан оператору.
PostAllA1sAR.JoinОшибки = A1sDocs.PostAll(
СписокДоков, Ложь);
Если Ошибки.Количество() > 0 Тогда
Сообщить(
A1sAR.Join(Ошибки, Символы.ПС));
КонецЕсли;Установить, подключить модуль и запустить первый сценарий.
Быстрый старт → 02 · НайтиВыбрать объект: структура, массив, справочник или документ.
Карта модулей → 03 · СтандартизироватьВвести общую документацию, именование, маркеры и правила ошибок.
Стандарты → 04 · ОсмыслитьПройти пять уроков MILA от WHAT и WHY до EDGE → TEST.
Микро-курс →A1sCode Island станет визуальной картой библиотеки, стандартов, MILA и обучения: у каждого модуля — свой город, у каждого маршрута — понятная точка назначения.
Карта острова готовится · вернуться к началу ↑Подключите один модуль к существующему проекту, замените один шаблонный фрагмент и сравните, насколько яснее стал сценарий.