М. Г. Радченко, Е. Ю. Хрусталева

«1С:Предприятие.Элемент». Возможности встроенного языка, 2 издание

М. Г. Радченко, Е. Ю. Хрусталева

«1С:Предприятие.Элемент». Возможности встроенного языка, 2 издание

Электронная книга в формате ePub; ISBN 978-5-9677-3570-7.

Версия издания от 07.07.2025.

Электронный аналог издания "«1С:Предприятие.Элемент». Возможности встроенного языка, 2 издание"
(ISBN978-5-9677-3568-4, М.: ООО "1С-Паблишинг", 2025; артикул печатной книги по прайс-листу фирмы "1С": 4601546149275; по вопросам приобретения печатных изданий издательства "1С-Паблишинг" обращайтесь к партнеру "1С", обслуживающему вашу организацию, или к другим партнерам фирмы "1С".)

---

Эта книга адресована специалистам, разрабатывающим прикладные решения на платформе «1С:Предприятие 8». Она содержит сжатое описание особенностей языка разработки, который используется в технологии «1С:Предприятие.Элемент».
Основная цель издания – помочь максимально быстро начать разработку на этом языке, овладев новыми возможностями, подходами и не упустив при этом ничего важного.
Книга содержит значительное количество коротких и простых примеров, которые позволят быстрее и легче понять особенности языка. Для создания примеров использовалась версия 8.0 технологии «1С:Предприятие.Элемент».

© ООО «1С-Паблишинг», 2025
© Оформление. ООО «1С-Паблишинг», 2025

Все права защищены.
Материалы предназначены для личного индивидуального использования приобретателем.
Запрещено тиражирование, распространение материалов, предоставление доступа по сети к материалам без письменного разрешения правообладателей.
Разрешено копирование фрагментов программного кода для использования в разрабатываемых прикладных решениях.

---

Издательство ООО "1С-Паблишинг"
1127434, Москва, Дмитровское ш., д. 9.
Тел.: (495) 681-02-21.
publishing@1c.ru, http://books.1c.ru/
Фирма "1С"
123056, Москва, а/я 64, Селезневская ул., 21.
Тел.: (495) 737-92-57.
1c@1c.ru, http://www.1c.ru/

Введение

Встроенный язык технологии «1С:Предприятие.Элемент» – это язык разработки, который базируется на встроенном языке платформы «1С:Предприятие 8», но имеет ряд существенных отличий от него. Например:

• язык является статически типизированным;
• в языке присутствует иерархия типов;
• нет разделения на функции и процедуры – используется единое ключевое слово метод;
• поддерживается перегрузка методов;
• поддерживаются пользовательские структуры, перечисления и исключения и т. д.

Далеко не всегда у вас есть возможность спокойно и вдумчиво изучить всю документацию. Чаще всего хочется сразу же попробовать те или иные возможности языка, о которых вы уже где-то когда-то слышали. Именно для этого и предназначена книга, которую вы держите в руках.

С одной стороны, не вдаваясь в глубокие подробности, она рассказывает о новых возможностях языка.

С другой стороны, в книге описаны важные и заметные изменения, с которыми вам придется столкнуться буквально с первых шагов в новом языке.

Простые и короткие примеры позволят вам быстрее и легче понять особенности нового языка.

Вся информация в книге сгруппирована по нескольким разделам, от простого к сложному: от элементарных синтаксических отличий – к сложным функциональным типам и запросам.

Термины, используемые в книге

В книге будут использоваться следующие термины и понятия:

• Значение – этот термин используется в общепринятом смысле: элемент данных, являющийся одним из возможных членов типа данных, который может соответствовать некоторому состоянию переменной или константе соответствующего типа.
• Тип – это множество допустимых значений и контракт.
• Экземпляр – это значение типа.
• Контракт – набор свойств и методов, присущих тому или иному типу, а также поведение этих свойств и методов.
• Переменная – это ссылка на область памяти, которая хранит значение какого-либо типа. Для идентификации переменной служит ее имя.
• Метод – это фрагмент кода на встроенном языке, к которому можно обратиться из другого места модуля или из другого модуля. О том, что метод что-либо возвращает, можно судить по тому, что у метода описан тип возвращаемого значения.
• Параметр – это имя переменной, через которую тело метода получает доступ к значению, которое предоставляется методу во время его вызова (аргумент).
• Операция – этот термин используется в общепринятом смысле: конструкция в языках программирования, аналогичная по записи математическим операциям, то есть специальный способ записи некоторых действий. Наиболее часто применяются арифметические, логические и строковые операции. Операция выполняется над одним или несколькими операндами.
• Операнд – это значение, над которым выполняется операция.
• Инструкция – это наименьшая автономная часть встроенного языка; команда или набор команд. Программа обычно представляет собой последовательность инструкций. Например, инструкцию присваивания можно представить строкой: А = 4 + 2.
• Выражение – это математическая, логическая или строковая формула, по которой вычисляется значение. Выражение может состоять из констант, переменных и вызовов методов, связанных символами логических, арифметических и других операций.
• Ключевое слово – это слово, которое нельзя использовать в качестве имени переменной или метода. Оно зарезервировано для использования только в синтаксических конструкциях языка. Например: если, возврат и т. д.
• Литерал – это значение, записанное прямо в тексте программы.
• Язык «1С:Предприятия» – это встроенный язык платформы «1С:Предприятие 8». Он позволяет разработчику описывать собственные алгоритмы функционирования прикладного решения.
• Язык «Элемента» – это встроенный язык технологии «1С:Предприятие.Элемент». Он используется:
  • для написания скриптов, автоматизирующих администрирование систем, основанных на платформе «1С:Предприятие 8»;
  • для решения алгоритмических задач, возникающих при создании и модификации приложений, использующих технологию «1С:Предприятие.Элемент».

Глава 1. Синтаксические отличия

Ввод английских символов без переключения раскладки клавиатуры

В языке «1С:Предприятия» использовались символы, которые обычно расположены в английской раскладке клавиатуры. Это, например, такие символы:

‹ и › – логические операции «меньше» и «больше», например:

Если ТекСтрока › ВсегоСтрок Тогда

| – символ продолжения текстового литерала, например:

Запрос.Текст = "ВЫБРАТЬ

| Наименование

|ИЗ

| Справочник.Товары";

[ и ] – обращение к элементу коллекции по индексу или имени, например:

Возврат ВыделенныеЭлементы[0];

' – одинарные кавычки – обрамляли литералы даты, например:

НачалоПериода = '20170323104525';

& – амперсанд – использовался в директивах компиляции, например:

&НаКлиенте

# – решетка – использовалась в инструкциях препроцессора, например:

#Если ВебКлиент Тогда

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

Теперь в средах разработки, использующих язык «Элемента», реализована возможность вводить символы из английской раскладки, не переключаясь на нее, – так называемый Alt-ввод.

Во всех случаях, где это возможно, используется одно и то же правило. Чтобы ввести английский символ, удерживайте клавишу Alt и нажмите ту клавишу, на которой находится нужный вам английский символ.

Такая возможность реализована не для всех английских символов, а только для тех, которые используются в языке «Элемента». Например:

• Для ввода вертикальной черты |, которая используется, например, при перечислении типов, используйте Alt + \;

пер ПеременнаяСоставногоТипа: Число|Булево = 3

• Для ввода фигурных скобок { и }, которые используются, например, при включении в строковый литерал вычисляемых выражений, используйте Alt + 9 и Alt + 0;

пер ТекстСообщения = "Объем %{100*50*70/2} литров"

• Для ввода угловых скобок ‹ и ›, которые используются, например, в логических выражениях, используйте Alt + б и Alt + ю;

если Счетчик ‹ 7

возврат

;

• Для ввода квадратных скобок [ и ], которые используются, например, в литерале массива, используйте Alt + х и Alt + ъ, а для указания типа элементов массива – Alt + б и Alt + ю;

пер МассивЧисел = ‹Число›[0, 1, 2]

• Кроме перечисленных символов есть и другие, которые вы можете ввести аналогичным образом:
  • амперсанд & – Alt + 7;
  • коммерческое at (собака) @ – Alt + 2;
  • апостроф ' – Alt + э.

Регистрозависимый синтаксис

В языке «1С:Предприятия» можно было писать имя переменной в разных регистрах. Компилятор воспринимал оба варианта написания как одну и ту же переменную. Например:

ИмяДокумента = "Доходы"

Имядокумента = "Расходы"

Теперь в языке «Элемента» переменные, отличающиеся регистром букв, будут являться разными переменными. Например, переменная ИмяДокумента, объявленная выше и отличающаяся регистром одной буквы, – это другая переменная (рис. 1.1):

Рис. 1.1. Неправильное написание имени переменной

Поэтому в третьей строке будет получена ошибка – «Переменная "Имядокумента" не определена», так как там происходит обращение к переменной Имядокумента, которая еще не объявлена.

Особенности именования переменных в языке «Элемента»

В языке «Элемента» нельзя объявить две переменные, имена которых отличаются только регистром букв. При попытке сделать это вы получите ошибку «Переменная с именем "Имядокумента" уже определена». Например, (рис. 1.2):

Рис. 1.2. Неправильное объявление имени переменной

Ключевые слова

В языке «1С:Предприятия» в ключевых словах можно было использовать как строчные, так и прописные буквы. Несмотря на то что писать можно было как угодно, для повышения «читабельности» ключевые слова обычно писали в стиле CamelCase. Это значит, что если имя состоит из одного слова, то оно пишется с прописной буквы, остальные буквы – строчные. Если имя состоит из нескольких слов, – они пишутся слитно без пробелов, при этом каждое слово внутри пишется с прописной буквы. Например, ключевые слова Если, Возврат и КонецЕсли:

Если Счетчик ‹ 7 Тогда

Возврат;

КонецЕсли;

Теперь в языке «Элемента» все ключевые слова нужно писать строчными буквами. Например:

если Счетчик ‹ 7

возврат

;

Если вы попробуете написать слово «Возврат» с прописной буквы, то получите ошибку «Переменная "Возврат" не определена» (рис. 1.3).

Рис. 1.3. Неправильное написание ключевого слова

Это говорит о том, что среда разработки не воспринимает слово «Возврат» (написанное с прописной буквы) как ключевое слово. Она думает, что это переменная, которую вы забыли определить.

Почему в языке «Элемента» принято писать ключевые слова строчными буквами? Дело в том, что пока вы работаете с текстом программы в среде разработки, он раскрашивается, и преимущество того, что ключевые слова пишутся строчными буквами, вам не очень заметно (рис. 1.4).

Рис. 1.4. Подсвеченный фрагмент кода в среде разработки

Но как только вы столкнетесь с системами контроля версий или другими инструментами, в которых подсветка языка «Элемента» отсутствует, вы увидите, что ключевые слова в нижнем регистре значительно упрощают чтение программы (рис. 1.5).

Рис. 1.5. Неподсвеченный фрагмент кода

Многострочные комментарии

В языке «1С:Предприятия», чтобы закомментировать несколько строк, идущих подряд, нужно было установить символ комментария в начале каждой строки. Например:

// Начало комментариев

// Вторая строка комментариев

// Конец комментариев

Это можно было сделать вручную, установив комментарий в каждой строке, или с помощью команд меню, выделив блок кода, а затем установив или сняв комментарии одной командой. Если блок комментируемого кода был большой, то такая операция была не очень удобна.

Теперь в языке «Элемента» существуют отдельные служебные символы, которые позволяют комментировать блок кода. Это символы «/*» в начале и «*/» в конце. Например:

/* Начало комментариев

Вторая строка комментариев

Конец комментариев */

Таким образом, если нужно закомментировать большой фрагмент кода, вы ставите в его начале «/*», а потом просто пролистываете до нужного места и ставите в конце «*/». Все, что находится между этими символами, будет оформлено как комментарий.