О разделе
Длинные листинги (от ~15 строк) вынесены в каталог code.spirzen.ru и подгружаются в статьях через ExternalCodeEmbed. Короткие фрагменты остаются прямо в markdown. Диаграммы mermaid и интерактивные примеры — на странице или в play.spirzen.ru.
Раздел описывает платформу 1С:Предприятие и встроенный язык (BSL, Built-in Script Language). Материалы идут от установки и первой кнопки к метаданным, запросам, регистрам и обмену с внешними системами. История компании и обзор продуктов — в Истории 1С и Экосистеме.
База перед стартом — Что такое код и как он работает. Там разобраны код, компиляция, интерпретация и типы исполняемых файлов. В этом разделе те же идеи применяются к конфигуратору и модулям 1С.
Ключевые термины
| Термин | Кратко | Подробнее |
|---|---|---|
| Платформа | Среда запуска — движок, СУБД, клиент, конфигуратор | Платформа 1С |
| Конфигурация | Прикладное решение — справочники, документы, отчёты, код | Архитектура и мета-объекты |
| Информационная база (ИБ) | Экземпляр программы с данными пользователей | Первая программа |
| Метаданные | Описание объектов в дереве конфигуратора | практикум "мини-склад" |
| BSL | Встроенный язык — процедуры, функции, запросы | Синтаксис, типы данных |
| Проведение | Запись движений документа в регистры | Регистры, объекты |
| Управляемая форма | Интерфейс с разделением клиентского и серверного кода | Управляемые формы |
Учебные примеры используют условные имена (Справочники.Сотрудники, Документы.ПоступлениеТоваров). В вашей базе подставьте реальные объекты из дерева метаданных.
С чего начать
| Шаг | Материал | Результат |
|---|---|---|
| 1 | Первая программа | Установленная платформа, внешняя обработка, первый запуск |
| 2 | Платформа 1С | Понимание связки платформа / конфигурация / ИБ |
| 3 | Синтаксис + типы данных | Чтение и написание простых процедур |
| 4 | практикум "мини-склад" | Справочник, документ, регистр, проведение |
Учебную платформу 8.3 можно скачать в каталоге бесплатных продуктов 1С. Справка по методам встроенного языка — на its.1c.ru (нужна регистрация) и в Синтакс-помощнике конфигуратора (F1 на ключевом слове).
Рекомендуемый порядок чтения
Блок 1 — основа
Блок 2 — конфигурирование
Блок 3 — данные и интерфейс
- Коллекции значений, управляемые формы, таблицы
- Выборки и запросы, выборки объектов, регистры
- Печать, макеты и отчёты, ошибки и отладка
Блок 4 — интеграция
- Интеграция — хаб
- HTTP и API — JSON, HTTP-сервисы, HTTP-запросы, OData, SOAP, FTP и почта
- Обмен данными — внешние источники, планы обмена и РИБ, универсальный обмен
- Компоненты и XML — внешние компоненты, Automation, XML и XDTO
Связи между статьями
| Тема | Статьи |
|---|---|
| Устройство платформы | 1, 112 |
| Практика в конфигураторе | 121, 1121 |
| Язык BSL | 113, 114, 115, 116 |
| Чтение и запись данных | 117, 118, 123, 124 |
| Интерфейс и вывод | 122, 125, 126 |
| Надёжность | 119 |
| Внешний мир | 120 и статьи 128–139, 1310 |
Частые ошибки при старте
| Ситуация | Что сделать |
|---|---|
| Перескакиваете между языками программирования | Доведите первую программу до рабочего запуска, затем сравнивайте с Python или C# |
| Читаете без конфигуратора | После каждой статьи повторите 1–2 конструкции в пустой учебной ИБ |
| Сразу открываете типовую "Бухгалтерию" | Начните с пустой конфигурации или мини-склада, иначе дерево метаданных перегрузит |
| Код не виден в отладчике | Проверьте, что отладка подключена к нужному сеансу — см. ошибки и отладка |
Что попробовать
- Первая программа — кнопка и
Сообщить(). - мини-склад — документ с проведением в регистр остатков.
- Три незнакомых термина из таблицы выше — найдите статьи по ссылкам.
- Итоги раздела — самопроверка по FAQ.
Как проходить раздел
Цикл на одну тему:
- Прочитать статью.
- Повторить пример в конфигураторе.
- Сверить результат на экране с ожиданием.
- Перейти к связанной статье из таблицы "Связи".
Так термины из справочника привязываются к конкретным объектам в дереве метаданных.
Чеклист после раздела
- Объясняете, чем отличаются платформа, конфигурация и информационная база.
- Знаете, в каком модуле писать код и когда нужны
&НаКлиентеи&НаСервере— см. управляемые формы. - Читаете простой запрос на языке запросов 1С и понимаете, какие строки вернутся — см. выборки и запросы.
- Оборачиваете рискованный участок в
Попытка … Исключение … КонецПопытки— см. обработка ошибок. - Можете набросать шаги HTTP-обмена с внешним API — см. интеграцию.
Затруднение по двум и более пунктам — повторите связанную статью из таблицы "Связи" с практикой в конфигураторе.
Платформа 1С
Платформа 1С - архитектура среды исполнения, назначение и место в автоматизации бизнес-процессов.
История 1С
История 1С - развитие платформы, ключевые этапы роста и влияние на цифровизацию бизнеса и госсектора.
Экосистема 1С
Экосистема 1С - продукты платформы, инструменты разработки, внедрение и сопровождение корпоративных решений.
Архитектура и мета-объекты 1С
Архитектура платформы 1С, объекты метаданных, регистры, модули и исполнение прикладного кода.
Конфигурирование — мини-склад
Пошаговое создание учебной конфигурации: справочники, документ, регистры, проведение, подсистемы и роли.
Синтаксис и пунктуация 1С
Синтаксис и пунктуация 1С - базовые правила записи кода, операторы и структура выражений.
Переменные и типы данных 1С
Типизация, набор правил определения типа данных значений языка.
Управление потоком выполнения 1С
Управление потоком выполнения в 1С - последовательность операций, ветвления и контроль выполнения сценариев.
Функции и процедуры 1С
Функции и процедуры 1С - различия, правила использования и организация переиспользуемой бизнес-логики.
Объекты и классы 1С
Объекты и классы 1С - модель метаданных, экземпляры объектов и работа с прикладными сущностями.
Работа с базами данных 1С
Данные — это конкретные записи, созданные пользователями или автоматически системой в рамках определённых объектов. Каждая запись имеет уникальный идентификатор и соответствует описанию в метаданных.
Обработка ошибок 1С
Обработка ошибок в 1С - перехват исключений, диагностика сбоев и устойчивые сценарии обработки.
Интеграция и взаимодействие 1С
Хаб по интеграции 1С:Предприятия 8.3 — выбор механизма, карта статей, чеклисты и обмен между базами.
Первая программа на 1С
Гайд по установке и настройке с написанием первой программы и её запуском.
Управляемые формы 1С
Управляемые формы: реквизиты, элементы, команды, директивы &НаКлиенте и &НаСервере, вызовы между контекстами.
Выборки данных 1С
Выборка справочников и документов: обход элементов, сравнение с языком запросов, когда что применять.
Регистры 1С — записи, срезы, остатки
Набор записей регистра, срез последних и первых, виртуальные таблицы Остатки и Обороты в запросах.
Таблицы значений и табличные части 1С
ТаблицаЗначений, табличная часть документа, элемент Таблица на форме, ограничения тонкого клиента.
Печать, макеты и отчёты 1С
Табличный документ и макеты, простые отчёты, СКД, динамические списки на формах.
Коллекции значений 1С
Массив, Структура, Соответствие и СписокЗначений — создание, обход, операции и типичные паттерны.
JSON в интеграции 1С
Три уровня работы с JSON на платформе 8.3 — потоковая запись, сериализация коллекций и прикладных типов через XDTO.
HTTP-сервисы 1С
Публикация REST API из конфигурации 8.3 — метаданные HTTP-сервиса, шаблоны URL, обработчики и коды ответа.
HTTP-запросы из 1С
Вызов внешних REST API и HTTP-сервисов из BSL — HTTPСоединение, HTTPS, заголовки, таймауты и разбор ответа.
OData в 1С
Стандартный REST-интерфейс 1С:Предприятия 8.3 — публикация, URL ресурсов, $filter, $select и типичные ошибки.
XML и XDTO в интеграции 1С
Файловый обмен XML, XDTO-сериализация, передача файлов клиент↔сервер, ZIP-архивы.
Web-сервисы 1С (SOAP)
Публикация и вызов SOAP Web-сервисов на платформе 8.3 — WSDL, XDTO, URL ws/, отличия от HTTP-сервисов.
Сеансы интернет-сервисов 1С
Переиспользование сеансов HTTP-, Web- и OData-сервисов — пул сеансов, заголовок IBSession, производительность.
FTP и электронная почта в 1С
Обмен файлами через FTPСоединение и отправка писем через ИнтернетПочта — типовые сценарии интеграции.
Внешние источники данных 1С
Подключение сторонних СУБД через ODBC — объект ВнешнийИсточникДанных, DSN, запросы, СКД и настройка в проде.
Планы обмена и РИБ 1С
Обмен между информационными базами 1С — план обмена, узлы, регистрация изменений, РИБ и XML-сообщения.
Универсальный обмен данными 1С
Произвольный обмен между базами 1С и внешними системами — XML, транзакции, односторонний обмен, регламентные задания, EnterpriseData.
Внешние компоненты 1С
Подключение Native API компонент — ККТ, сканеры, драйверы; установка, макет ZIP, сервер и клиент.
Automation и внешнее соединение 1С
COM Automation Server/Client, V83.ComConnector, запуск 1С из Excel и встраивание веб-клиента.
С — итоги
Краткие итоги раздела 1С — платформа, BSL, метаданные, запросы, интеграция и типичные ошибки новичка.
С — о разделе
Платформа 1С:Предприятие, встроенный язык BSL, метаданные, запросы, проведение документов, интеграция через JSON, HTTP и OData.
В подборках
Статья входит в тематические подборки и блок "С чего начать?" на главной. Соседние шаги того же маршрута:
Бэкенд и серверная разработка — PowerShell — о разделе, Bash — о разделе, Julia — о разделе, R — о разделе, Dart — о разделе, Nim — о разделе.
ERP, 1С и отраслевое ПО — Отраслевое ПО — итоги, Платформа 1С, Adobe, Внедрение ERP — о разделе, Отраслевое программное обеспечение, Аналитика — о разделе.