Как писать команды в 1С: синтаксис, примеры и ошибки

Работа с 1С: Предприятие неизбежно связана с написанием команд — будь то простые операции в конфигураторе, сложные запросы к базе данных или автоматизация бизнес-процессов. Однако даже опытные пользователи иногда сталкиваются с синтаксическими ошибками, непониманием логики выполнения или неэффективным кодом. Эта статья поможет разобраться, как правильно формировать команды в 1С, избегать распространённых ловушек и оптимизировать работу с платформой.

Мы рассмотрим не только базовый синтаксис языка 1С: Предприятие 8.3, но и нюансы, которые часто упускают из виду: от различий между клиентским и серверным контекстом до тонкостей работы с транзакциями и временными таблицами. Особое внимание уделено практическим примерам — каждый раздел содержит готовые кодовые блоки, которые можно адаптировать под свои задачи. Если вы только начинаете осваивать программирование в 1С или хотите систематизировать знания, эта инструкция станет полезным справочником.

1. Основы синтаксиса команд в 1С: что нужно знать с нуля

Язык 1С: Предприятие относится к семейству процедурных языков с элементами объектно-ориентированного программирования. Его синтаксис имеет много общего с Pascal или Basic, но есть и уникальные особенности, связанные с работой в среде 1С. Вот ключевые правила, которые необходимо усвоить:

📌 Регистрозависимость: команды и имена переменных не чувствительны к регистру. Например, ВыбратьСтроки() и выбратьстроки() — это одно и то же. Однако для удобства чтения кода рекомендуется придерживаться единого стиля (например, CamelCase для методов).
📌 Точка с запятой: в конце каждой команды ставится ;. Это обязательное правило, хотя платформа иногда прощает её отсутствие в интерактивном режиме.
📌 Комментарии: однострочные начинаются с //, многострочные — с / ... /. Комментарии игнорируются интерпретатором, но критически важны для поддержки кода.
📌 Типизация: переменные могут быть строго типизированными (например, Перем МояДата Тип Дата;) или динамическими (тип определяется по значению).

Особенность 1С — разделение кода на клиентский (выполняется на стороне пользователя) и серверный (выполняется на сервере 1С). Например, обращение к базе данных должно происходить на сервере, иначе возникнет ошибка. Пример базовой команды с учётом контекста:

Процедура ПримерКоманды()
// Клиентский код
Сообщить("Начало выполнения");

// Серверный вызов
Результат = ПолучитьДанныеСервер();
КонецПроцедуры

&НаСервере
Функция ПолучитьДанныеСервер()
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Первые 10 Номенклатура.Наименование КАК Товар";
РезультатЗапроса = Запрос.Выполнить();
Возврат РезультатЗапроса.Выгрузить();
КонецФункции

Критическая ошибка новичков: попытка выполнить запрос к базе данных напрямую в клиентском коде. Это приведёт к исключению "Ошибка при вызове метода контекста (Выполнить)". Всегда разделяйте логику на клиентскую и серверную части!

2. Команды для работы с данными: выборка, добавление, изменение

Основная задача 1С — обработка данных, поэтому умение писать команды для манипуляции информацией в базе критически важно. Рассмотрим ключевые операции:

2.1. Запросы к базе данных

Для выборки данных используется объект Запрос. Его синтаксис напоминает SQL, но с особенностями 1С. Пример простого запроса:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Справочник.Контрагенты.Наименование КАК Контрагент,
|   Справочник.Контрагенты.ИНН КАК ИНН
|ИЗ
|   Справочник.Контрагенты КАК Контрагенты
|ГДЕ
|   Контрагенты.ПометкаУдаления = ЛОЖЬ
|УПОРЯДОЧИТЬ ПО
|   Контрагент";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Обратите внимание на:

🔹 Использование символа | для переноса строки в тексте запроса (улучшает читаемость).
🔹 Псевдонимы полей (КАК Контрагент) обязательны, если имя поля совпадает с ключевым словом.
🔹 Условие ПометкаУдаления = ЛОЖЬ исключает удалённые объекты (аналог WHERE в SQL).

2.2. Добавление и изменение данных

Для модификации данных используются методы объектов. Например, чтобы добавить новый элемент в справочник:

НовыйКонтрагент = Справочники.Контрагенты.СоздатьЭлемент();
НовыйКонтрагент.Наименование = "ООО Ромашка";
НовыйКонтрагент.ИНН = "1234567890";
НовыйКонтрагент.Записать();

Для изменения существующего элемента:

Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");
Если Контрагент.Пустая() Тогда
Сообщить("Контрагент не найден!");
Иначе
Контрагент.Адрес = "г. Москва, ул. Ленина, 1";
Контрагент.Записать();
КонецЕсли;

2.3. Транзакции: как избежать ошибок при изменении данных

Транзакции обеспечивают целостность данных при выполнении нескольких операций. Если одна из команд в транзакции завершится ошибкой, все изменения будут отменены. Пример:

НачатьТранзакцию();
Попытка
Документ = Документы.ЗаказПокупателя.СоздатьДокумент();
Документ.Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");
Документ.Дата = ТекущаяДата();
Документ.Записать();

// Если здесь произойдёт ошибка, документ не будет записан
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка: " + ОписаниеОшибки());
КонецПопытки;

⚠️ Внимание: Длинные транзакции (более 10 секунд) могут блокировать базу данных для других пользователей. Разбивайте сложные операции на меньшие транзакции или используйте УстановитьБлокировкуДанных() для конкретных объектов.

3. Работа с коллекциями и массивами: команды для обработки данных

В 1С часто приходится обрабатывать наборы данных — будь то результаты запроса, элементы справочников или массивы. Для этого используются циклы, методы коллекций и специализированные функции.

3.1. Циклы `Для Каждого` и `Пока`

Пример обхода выборки из запроса:

Выборка = РезультатЗапроса.Выбрать();
Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Контрагент + " (ИНН: " + Выборка.ИНН + ")");
КонецЦикла;

Для работы с массивами:

МассивТоваров = Новый Массив;
МассивТоваров.Добавить("Молоко");
МассивТоваров.Добавить("Хлеб");

Для Каждого Товар Из МассивТоваров Цикл
Сообщить("Товар: " + Товар);
КонецЦикла;

3.2. Методы коллекций

У объектов типа Массив, Структура или Соответствие есть полезные методы:

📦 Добавить() — добавляет элемент в коллекцию.
🔍 Найти() — ищет элемент по значению.
🧹 Очистить() — удаляет все элементы.
🔄 Сортировать() — сортирует массив.

Пример использования Структуры для хранения пар "ключ-значение":

ДанныеКонтрагента = Новый Структура;
ДанныеКонтрагента.Вставить("ИНН", "1234567890");
ДанныеКонтрагента.Вставить("Адрес", "г. Москва, ул. Ленина, 1");

Сообщить(ДанныеКонтрагента.ИНН); // Выведет: 1234567890

Проверьте, что коллекция не пустая (Массив.Количество() > 0)

Используйте Попытка...Исключение при обращении к элементам по индексу

Для больших массивов (>1000 элементов) используйте Пока вместо Для Каждого (быстрее)

Очищайте коллекции после использования, если они больше не нужны (Очистить())

-->

3.3. Агрегатные функции

Для анализа данных в коллекциях удобно использовать встроенные функции:

Функция	Описание	Пример
`Максимум()`	Возвращает максимальное значение	`МаксЗначение = Массив.Максимум();`
`Минимум()`	Возвращает минимальное значение	`МинЗначение = Массив.Минимум();`
`Сумма()`	Суммирует элементы	`Итого = Массив.Сумма();`
`Среднее()`	Вычисляет среднее арифметическое	`СрЗначение = Массив.Среднее();`

4. Команды для работы с документами и регистрами

Документы и регистры — основа учётных систем в 1С. Команды для работы с ними имеют свои особенности, связанные с проводками, движениями и бизнес-логикой.

4.1. Создание и проведение документов

Пример создания документа "Реализация товаров и услуг":

Док = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
Док.Дата = ТекущаяДата();
Док.Контрагент = Справочники.Контрагенты.НайтиПоНаименованию("ООО Ромашка");

// Добавляем строку табличной части
СтрокаТоваров = Док.Товары.Добавить();
СтрокаТоваров.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Молоко");
СтрокаТоваров.Количество = 10;
СтрокаТоваров.Цена = 50;
СтрокаТоваров.Сумма = СтрокаТоваров.Количество * СтрокаТоваров.Цена;

Док.Записать();
Док.Провести();

Важный нюанс: метод Провести() генерирует движения по регистрам. Если документ не проведён, изменения в регистрах не применятся!

4.2. Работа с регистрами накопления

Регистры накопления хранят данные о остатках и оборотах. Пример записи в регистр "ТоварыНаСкладах":

Движение = Движения.ТоварыНаСкладах.Добавить();
Движение.Период = ТекущаяДата();
Движение.Склад = Справочники.Склады.ОсновнойСклад;
Движение.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Молоко");
Движение.Количество = 10;

Для чтения данных из регистра используется запрос:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   РегистрНакопления.ТоварыНаСкладах.Номенклатура КАК Товар,
|   СУММА(РегистрНакопления.ТоварыНаСкладах.Количество) КАК Остаток
|ИЗ
|   РегистрНакопления.ТоварыНаСкладах КАК ТоварыНаСкладах
|ГДЕ
|   ТоварыНаСкладах.Склад = &Склад
|СГРУППИРОВАТЬ ПО
|   ТоварыНаСкладах.Номенклатура";
Запрос.УстановитьПараметр("Склад", Справочники.Склады.ОсновнойСклад);
Результат = Запрос.Выполнить();

⚠️ Внимание: При работе с регистрами учитывайте периодичность. Например, если регистр имеет периодичность "по дням", запрос без указания периода вернёт данные за весь период, что может привести к некорректным остаткам.

5. Отладка и обработка ошибок: команды для диагностики

Ошибки в командах 1С — неизбежная часть разработки. Умение их диагностировать и обрабатывать сэкономит часы времени. Рассмотрим ключевые инструменты.

5.1. Конструкция `Попытка...Исключение`

Базовый способ перехвата ошибок:

Попытка
// Код, который может вызвать ошибку
Документ = Документы.ЗаказПокупателя.НайтиПоНомеру("000123");
Если Документ.Пустая() Тогда
ВызватьИсключение "Документ не найден!";
КонецЕсли;
Исключение
Сообщить("Ошибка: " + ОписаниеОшибки());
// Логирование ошибки в журнал
ЗаписатьВЖурналРегистрации(ОписаниеОшибки(), УровеньЖурнала.Ошибка);
КонецПопытки;

5.2. Отладчик 1С: команды для пошагового выполнения

Для запуска отладчика используйте:

🛠️ Отладка.ТочкаОстанова(); — установит точку останова в коде.
🛠️ Отладка.Прервать(); — приостановит выполнение.
🛠️ Отладка.Вывести(Переменная); — выведет значение переменной в отладочное окно.

Пример использования:

Процедура ТестоваяПроцедура()
Перем а, б;
а = 10;
б = 0;

Отладка.ТочкаОстанова(); // Здесь выполнение прервётся

// Проблемный код
Результат = а / б; // Деление на ноль
КонецПроцедуры

5.3. Журнал регистрации

Для логирования ошибок и событий используйте ЗаписатьВЖурналРегистрации():

ЗаписатьВЖурналРегистрации( "Ошибка при проведении документа " + Документ.Номер, УровеньЖурнала.Ошибка, , , "МойМодуль.ПровестиДокумент()"

);

Просмотреть журнал можно в конфигураторе: Администрирование → Журнал регистрации.

💡

Если ошибка возникает только у конкретного пользователя, проверьте его права в ролях. Часто проблема кроется не в коде, а в недостаточных разрешениях на объект (например, отсутствует право на чтение справочника).

6. Оптимизация команд: как писать эффективный код

Неоптимизированные команды могут тормозить работу 1С, особенно в больших базах. Следующие советы помогут улучшить производительность.

6.1. Избегайте лишних обращений к базе

Плохой пример (многократное обращение к справочнику):

Для Каждого Строка Из ТаблицаТоваров Цикл
Товар = Справочники.Номенклатура.НайтиПоНаименованию(Строка.Наименование);
Если Товар.Пустая() Тогда
Продолжить;
КонецЕсли;
// ... обработка
КонецЦикла;

Оптимизированный вариант (загрузка всех данных за один запрос):

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Наименование, Ссылка ИЗ Справочник.Номенклатура";
Результат = Запрос.Выполнить();
СправочникТоваров = Новый Соответствие;
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
СправочникТоваров.Вставить(Выборка.Наименование, Выборка.Ссылка);
КонецЦикла;

6.2. Используйте временные таблицы

Для сложных отчётов или обработок данных удобно использовать временные таблицы. Они создаются в памяти и работают быстрее, чем постоянные таблицы базы.

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Товары.Номенклатура КАК Товар,
|   СУММА(Товары.Количество) КАК Итого
|ПОМЕСТИТЬ ВТ_ИтогиПоТоварам
|ИЗ
|   Документ.РеализацияТоваровУслуг.Товары КАК Товары
|ГДЕ
|   Товары.Ссылка ДАТАВРЕМЯ > &НачалоПериода
|СГРУППИРОВАТЬ ПО
|   Товары.Номенклатура";

Запрос.УстановитьПараметр("НачалоПериода", НачалоДня(ТекущаяДата()));
Запрос.Выполнить();

Теперь можно работать с временной таблицей ВТ_ИтогиПоТоварам в последующих запросах.

6.3. Кэширование часто используемых данных

Если какие-то данные (например, курсы валют или справочники) редко меняются, их можно кэшировать в памяти:

Процедура ПолучитьКурсВалюты(Валюта) Экспорт
Если КурсыВалют = Неопределено Тогда
КурсыВалют = Новый Соответствие;
Запрос = Новый Запрос("ВЫБРАТЬ Валюта, Курс ИЗ РегистрСведений.КурсыВалют");
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
КурсыВалют.Вставить(Выборка.Валюта, Выборка.Курс);
КонецЦикла;
КонецЕсли;
Возврат КурсыВалют[Валюта];
КонецПроцедуры

💡

Оптимизация команд в 1С — это не только скорость, но и уменьшение нагрузки на сервер. Всегда проверяйте, можно ли сократить количество запросов к базе или перенести вычисления на клиентскую сторону.

7. Типичные ошибки при написании команд и как их избежать

Даже опытные разработчики иногда допускают ошибки, которые ведут к падению системы или некорректным данным. Разберём самые распространённые.

7.1. Неправильное использование контекста

Ошибка: попытка выполнить серверный код на клиенте.

// НЕПРАВИЛЬНО: запрос к базе в клиентском коде
Процедура КлиентскаяПроцедура()
Запрос = Новый Запрос("ВЫБРАТЬ Первые 10 Номенклатура.Наименование");
Результат = Запрос.Выполнить(); // ОШИБКА!
КонецПроцедуры

Исправленный вариант:

Процедура КлиентскаяПроцедура()
Данные = ПолучитьДанныеСервер(); // Вызов серверной функции
КонецПроцедуры

&НаСервере
Функция ПолучитьДанныеСервер()
Запрос = Новый Запрос("ВЫБРАТЬ Первые 10 Номенклатура.Наименование");
Возврат Запрос.Выполнить().Выгрузить();
КонецФункции

7.2. Забытые транзакции

Если транзакция не закрыта (ЗафиксироватьТранзакцию() или ОтменитьТранзакцию()), это может привести к блокировке базы.

НачатьТранзакцию();
Попытка
// ... код
Возврат; // Забыли закрыть транзакцию!
Исключение
ОтменитьТранзакцию();
КонецПопытки;

7.3. Неправильная работа с датами

В 1С даты хранятся в формате Дата, а не Строка. Частая ошибка — сравнение дат как строк:

// НЕПРАВИЛЬНО
Если ТекущаяДата() > "01.01.2023" Тогда // Сравнение строки и даты!
// ...
КонецЕсли;

Правильно:

Если ТекущаяДата() > Дата(2023, 1, 1) Тогда
// ...
КонецЕсли;

7.4. Утечки памяти

Если не очищать коллекции или не закрывать файлы, это может привести к утечкам памяти. Пример правильной работы с файлами:

Чтение = Новый ЧтениеТекста;
Попытка
Чтение.Открыть("C:\temp\file.txt");
Текст = Чтение.Прочитать();
Исключение
Сообщить("Ошибка чтения файла!");
КонецПопытки;
Чтение.Закрыть(); // Важно закрыть файл!

Что будет, если не закрыть транзакцию?

Если транзакция не закрыта явно, 1С автоматически откатит её через 30 секунд (по умолчанию). Однако в это время база данных будет заблокирована для других пользователей, что может привести к тормозам или ошибкам "Таблица заблокирована".

8. Полезные команды для автоматизации рутинных задач

1С позволяет автоматизировать многие рутинные операции. Вот несколько полезных команд, которые сэкономят время.

8.1. Пакетная обработка документов

Пример массового проведения документов за период:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Документ.ЗаказПокупателя.Ссылка КАК Ссылка
|ИЗ
|   Документ.ЗаказПокупателя КАК Документ
|ГДЕ
|   Документ.Дата МЕЖДУ &Начало И &Конец
|   И Документ.Проведен = ЛОЖЬ";

Запрос.УстановитьПараметр("Начало", НачалоДня(ТекущаяДата() - 30));
Запрос.УстановитьПараметр("Конец", КонецДня(ТекущаяДата()));
Результат = Запрос.Выполнить();

Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Док = Выборка.Ссылка.ПолучитьОбъект();
Док.Провести();
КонецЦикла;

8.2. Экспорт и импорт данных

Пример экспорта данных в Excel:

Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Товар");
Таблица.Колонки.Добавить("Количество");

// Заполняем таблицу данными
// ...

// Экспорт в Excel
Excel = Новый Excel8Document;
Excel.WriteTable(Таблица);
Excel.Save("C:\temp\отчёт.xlsx");

8.3. Работа с файлами

Пример чтения и записи текстовых файлов:

// Запись в файл
Запись = Новый ЗаписьТекста;
Запись.Открыть("C:\temp\log.txt", "Добавление");
Запись.ЗаписатьСтроку("Тестовая строка");
Запись.Закрыть();

// Чтение из файла
Чтение = Новый ЧтениеТекста;
Чтение.Открыть("C:\temp\log.txt");
Текст = Чтение.Прочитать();
Чтение.Закрыть();

8.4. Отправка email из 1С

Пример отправки письма через SMTP:

Почта = Новый Почта;
Сообщение = Новый ПочтовоеСообщение;
Сообщение.Адресат = "example@mail.ru";
Сообщение.Тема = "Отчёт по продажам";
Сообщение.Текст = "Привет! В приложении отчёт.";
Сообщение.Вложения.Добавить("C:\temp\отчёт.xlsx");

Почта.Отправить(Сообщение, "smtp.mail.ru", 25, "login", "password");

⚠️ Внимание: При работе с внешними сервисами (email, API) учитывайте настройки антивируса и фаервола. Они могут блокировать исходящие соединения из 1С. Также не храните пароли в открытом виде в коде — используйте ХранилищеПараметров.

FAQ: Частые вопросы по командам в 1С

Как написать команду для выборки данных с группировкой?

Используйте конструкцию ГРУППИРОВАТЬ ПО в запросе. Пример:

Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Наименование КАК Товар,
|   СУММА(Товары.Количество) КАК Итого
|ИЗ
|   Документ.РеализацияТоваровУслуг.Товары КАК Товары
|ГДЕ
|   Товары.Ссылка ДАТАВРЕМЯ > &На

Как правильно писать команды в 1С: синтаксис, примеры и типичные ошибки