Как правило, изучение любого языка программирования начинается с примера написания первой простейшей программы (“Hello world!”). Делается это для того, чтобы наглядно показать работу с базовыми синтаксическими конструкциями. Мы не будем делать исключение из этого общепринятого способа подачи материала при изучении новой среды разработки и поэтому нашу первую статью следует рассматривать в этом же ключе. В ней мы подробно разберем ответы на следующие вопросы, касающиеся программирования на платформе «1С:Предприятие 8»:
- Где и при помощи чего писать программный код на встроенном языке 1С?
- Что такое программные модули, какие существуют правила работы с ними?
- Что такое переменная, как с ней работать, как и где её объявлять?
- Какие операторы сравнения, присваивания и условий существуют и как их применять?
- Булевы операции – что это и как с ними работать?
- Зачем нужны циклы и как их использовать?
Статья будет полезна всем тем, кто еще не знаком с разработкой на платформе «1С:Предприятие 8», но хочет научиться программировать на 1С.
Применимость
Материал актуален для платформы «1С:Предприятие 8» редакций 8.2. и 8.3.
Переменные и операторы
В этой статье мы приступаем к изучению встроенного языка 1С:Предприятие 8. Исполняемый код содержится в программных модулях.
Существует достаточно большое количество модулей, которые предназначены для обработки различных событий.
Так, вход пользователя в систему обрабатывается в одном модуле, а обработка нажатия пользователя на некоторую кнопку – в совершенно другом.
Таким образом, каждый модуль описывает поведение конфигурации в определенной точке. В модуле содержится, прежде всего, раздел описания переменных. Т.е. мы можем объявить в модуле некоторые переменные.
В дальнейшем они могут быть использованы в процедурах и функциях этого модуля. Если переменная определена с ключевым словом Экспорт, то она будет доступна вне данного модуля. Пример строки объявления переменных:
Перем Склад, Подразделение, Кладовщик Экспорт;
После объявления переменных содержится раздел процедур и функций.
За ними располагается раздел основной программы, который будет выполняться в момент обращения к данному модулю.
Например, в разделе основной программы можно осуществить инициализацию переменных, т.е. присвоить им некоторые начальные значения:
Состояние=1;
НовоеВыражение=2;
Результат=3;
Модуль можно представить, как комбинацию различных операторов, которые выполняют разные нужные нам действия.
Разделителем операторов является символ «;» (точка с запятой). Этот знак является признаком окончания оператора. Т.е. оператор может быть записан в таком виде:
Результат=100Х200
+400
-600;
При этом не важно, на скольких строках располагается оператор.
Конечно, чаще удобнее и нагляднее располагать оператор в одной строке, но иногда операторы являются достаточно длинными (число строк обоснованно может достигать нескольких десятков).
Точку с запятой можно не ставить в завершающем операторе данной конструкции, например, процедуры. Т.е. следующий код будет работать:
Процедура ВычислениеЗначения()
ИсходноеЗначение = 100;
ПромежуточноеЗначение = ИсходноеЗначение/5;
ИтоговоеЗначение = ИсходноеЗначение+ПромежуточноеЗначение
КонецПроцедуры
Однако лучше использовать точку с запятой в завершающем операторе. Не исключено, что со временем конструкция будет продолжена, и завершающий оператор окажется уже не завершающим. Придется специально отслеживать эту ситуацию.
Переменные предназначены для того, чтобы хранить некоторые значения любого типа данных. Они используются для промежуточного хранения информации, для обработки.
Практически в любом программном модуле, который выполняет некоторые действия, есть различные переменные. Типизация переменных по значениям в Платформе 1С:Предприятие 8 мягкая.
Например, переменная может содержать значение одного типа данных, а через несколько строк – другого типа:
Создан = Ложь;
Создан = Истина;
Создан =100;
В первых двух операторах значение переменных булевское, а в третьем оно меняется на числовое значение. Т.е. типизация зависит от того значения, которое присваивается данной переменной.
Описывать переменные можно двумя способами:
- неявный способ (упоминание в левой части оператора присваивания описывает данную переменную, нет предварительного описания переменной со словом Перем, т.е. нет специального раздела описания переменных);
- явное описание переменных (Перем КонтрольныеДанные;). Явное описание переменных используется, например, если предполагается последующая передача этой переменной в функцию.
Для названия переменных используется классическое описание идентификатора. Идентификатор состоит из букв, цифр и знаков подчеркивания. Начинаться идентификатор должен либо с буквы, либо со знака подчеркивания.
При этом название переменной должно отображать смысл данной переменной. Названия переменных из одной буквы (типа А, В, С) являются плохими примерами. Они не отражают суть переменных.
Примеры правильного названия переменных: Счетчик (увеличивающаяся переменная для цикла), Контрагент. Если имя переменной содержит несколько слов, то каждое новое слово, для наглядности, следует начинать с большой буквы.
В названии переменных нельзя использовать зарезервированные слова, такие как Процедура, Функция, Цикл, КонецЦикла и т.д. (эти конструкции выделяются в программном модуле красным цветом).
Зарезервированные слова – это операторы встроенного языка и их достаточно небольшое количество. Все они представлены в Синтакс-помощнике .
Следует отметить, что типы данных к зарезервированным словам не относятся (например, Массив, Булево, Истина, Ложь). Система такие имена переменных воспримет корректно.
Для написания программного кода регистр не имеет никакого значения. Например, слово Процедура можно писать как с большой, так и с маленькой буквы. Более того, большие и маленькие буквы можно чередовать внутри слова.
Для Платформы это не имеет никакого значения. Тем не менее, по правилам хорошего тона начало слова нужно писать с большой буквы, все остальные буквы маленькими.
По поводу языка. Можно использовать и русский язык, и английский, и комбинацию двух языков. Если кому-то удобно, можно спокойно использовать английский язык для написания программного кода, а также комбинировать русский и английский языки. Для Платформы это не важно.
Многие названия на английском языке довольно сложно помнить. При использовании комбинации двух языков ухудшается читаемость программного кода.
Булевы операции
В операторах сравнения очень часто используется булевская логика, которая возвращает значение Истина или Ложь.
Например, в условном операторе можно сравнивать: Если Событие = Продажа Тогда алгоритм пойдет по одной ветке (т.е. при значении Истина), по условию Ложь выполняется другая ветка алгоритма.
Условия могут быть достаточно сложными, они могут комбинироваться, при этом применяются следующие операторы: И, ИЛИ, и НЕ. Так, для оператора И:
Истина И Истина = Истина;
Истина И Ложь = Ложь;
Ложь И Истина = Ложь;
Ложь И Ложь = Ложь.
Для опрератора ИЛИ достаточно, чтобы один из операндов был равен Истина, тогда и значение комбинации будет Истина. Значение Ложь получается только в том случае, когда оба операнда Ложь.
Оператор НЕ просто инвертирует текущее значение (Ложь в Истину, Истину в Ложь).
С помощью комбинации данных операторов можно строить достаточно сложные условия. При составлении сложных условных операторов следует учитывать приоритеты.
Высший приоритет имеет оператор НЕ, следующим идет оператор И, а за ним оператор ИЛИ. То, что заключено в скобки, имеет самый высший приоритет и выполняется в первую очередь.
Например, расставим приоритеты (последовательность выполнения) для операций в приведенном выражении:
НЕ(Условие1 ИЛИ Условие2) И Условие3 ИЛИ Условие4
1. Результат1 = (Условие1 ИЛИ Условие2);
2. Результат2 = НЕ Результат1;
3. Результат3 = Результат2 И Условие1;
4. Результат = Результат3 ИЛИ Условие4;
Существует правило преобразования:
НЕ (Условие1 ИЛИ Условие2) = НЕ Условие1 И НЕ Условие2.
Однако не следует всегда стремиться упростить выражение, поскольку зачастую, по логике, проще читается выражение развернутое.
Оператор присваивания
Не следует путать оператор присваивания с равенством, не смотря на то, что у них одинаковое написание.
Принцип работы оператора присваивания таков, что левому значению (переменной с левой части) присваивается то значение, которое находится справа от знака равенства. Разберем пример:
Переменная1 = Переменная2 = Переменная3;
Переменной1 присваивается значение равенства из булевской логики, т.е. Истина, если Переменная2 = Переменная3, или Ложь в обратном случае.
При тестировании на должность начинающего программиста довольно часто используется задача: поменять значения двух переменных местами.
Данная задача решается с использованием оператора присваивания и имеет два решения.
Решение №1 с использованием временной переменной:
ВременнаяПеременная = Переменная1;
Переменная1 = Переменная2;
Переменная2 = ВременнаяПеременная;
Решение №2:
Переменная1 = Переменная1 + Переменная2;
Переменная2 = Переменная1 – Переменная2;
Переменная1 = Переменная1 – Переменная2;
Условный оператор
Есть такой оператор Если, после которого необходимо описать некоторое условие (само условие может быть достаточно большим). После условия следует слово Тогда и выполняемые операторы.
Далее может следовать ключевое слово Иначе и серия других операторов. Если разных условий несколько, можно использовать серию ключевых слов ИначеЕсли (см. пример ниже). Вся конструкция обязательно завершается ключевым словом КонецЕсли , после чего следует знак точки с запятой.
Кроме простого и множественного условия существует сокращенная форма условного оператора: ?(Условие, Выражение1, Выражение2);
Если условие истинное, то будет выполняться Выражение1 , в противном случае – Выражение2 . Пример кода: ДорогойТовар = ?(Товар.Цена>100000, Истина, Ложь);
На практике вместо записей сравнения со значением Истина (Ложь ) типа:
Если Переменная = Истина Тогда
и
Если Переменная = Ложь Тогда
реально используются эквивалентные записи:
Если Переменная Тогда
и
Если НЕ Переменная Тогда
Циклические операторы
Для любого вида цикла обязательно явное указание окончания этого цикла с помощью ключевого слова КонецЦикла . Существует несколько типов циклов.
Цикл по счетчику – цикл с фиксированным количеством повторений. Условием выхода из цикла является превышение граничного значения. Пример использования для расчета значения А!
А = 5;
Факториал = 1;
Для Счетчик = 1 По А Цикл
Факториал = Факториал * Счетчик;
КонецЦикла;
Цикл по условию – выполняется пока истинно условие данного цикла. Пример:
ОстатокСуммы = 1000;
ЦенаДополнительногоТовара = 243;
Количество = 0;
Пока ОстатокСуммы>0 Цикл
Количество = Количество+1;
ОстатокСуммы = ОстатокСуммы – Количество*ЦенаДополнительногоТовара;
ЦенаДополнительногоТовара = ЦенаДополнительногоТовара * 0.8;
КонецЦикла
Количество = Количество-1;
Данный цикл вычисляет, сколько единиц товара можно купить на данную сумму (1000 рублей), если после покупки каждой единицы товара предыдущая его цена умножается на коэффициент 0,8. Изначальная цена товара – 243 рубля.
Примером ошибки при использовании данного вида цикла новичками является вечный цикл, когда изначально условие цикла истинно, а в рамках самого цикла оно никак не изменяется.
Цикл по коллекциям (другое название Для каждого).
В Платформе существует достаточно большое количество коллекций (это такие контейнеры, которые содержат элементы определенного типа).
Обойти элементы коллекции можно с помощью цикла специального вида.
Например, существует массив чисел, необходимо посчитать сумму всех элементов массива:
Сумма = 0;
Для каждого Элемент Из Массив Цикл
Сумма=Сумма+Элемент;
КонецЦикла;
Для циклов существуют специальные операторы: Продолжить и Прервать .
Если в некоторой точке цикла выполнение дальнейших операторов данного витка становится бессмысленным, то чтобы вернуться на начало цикла и организовать его следующий виток используется оператор Продолжить .
Оператор Прервать позволяет закончить выполнение цикла, даже если условие цикла истинно.
На этом мы завершаем наше первое знакомство с разработкой на внутреннем языке 1С.
А как же Hello World? Мы же его еще не написали, да? Да, но ничто не мешает вам сделать это самостоятельно, т.к. знаний УЖЕ достаточно. Ну а если не получается, то можете подглядеть сюда.
Сейчас программа 1С существует в разных версиях и обличьях, люди работают в «семерке» т.е. в 1С 7.7 и в «восьмерке» которые бывают 8.0, 8.1, 8.2 и 8.3. На практике, на текущий момент 99.9% пользователей программы 1С работают в 7.7, 8.2, и 8.3 , чем же они отличаются?
Программа 1С 7.7 известная многим своим уже довольно устаревшим интерфейсом, все-же она имеет преимущество в размерах баз и в скорости запуска и работ, а значит имеет место быть на рынке программ автоматизации учета, хотя сейчас данную программу уже и не продают, но люди ей пользуются, и фирма 1С до сих пор поддерживает эту программу, т.е. для нее выходят обновления.
Но тема статьи все же не о 7.7 а об отличиях 8.2 и 8.3. (и для информации отличие между 7.7 и 8.* значительны на столько, что базы для семерки не запустятся на платформе 8.* и наоборот, т.е. 7.7 и 8.* это как-бы совсем разные программы, а вот 8.2 и 8.3 очень похожи, просто 8.3 новее)
Программа 1С состоит из платформы 1С и баз 1С, т.е. платформа 1С это программа которая запускает базы 1С.
Для пользователя: когда мы кликаем по ярлыку 1С и открывается список баз 1С, мы видим часть платформы 1С или когда мы выбираем базу и кликаем по кнопке «Конфигуратор» т.е. заходим в конфигуратор 1С мы также можно сказать видим часть платформы 1С, но когда мы открываем базу нажатием на копку «1С:Предприятие» мы уже видим базу, с ее настройками, «менюшками», кнопками, картинками и т.п. то это уже база 1С которая бывает разной в зависимости от ее типа, т.е. конфигурации базы 1С
База 1С состоит из конфигурации (т.е. ее настроек) и данных (т.е. информации в ней).
Существуют разные конфигурации 1С для разного учета, т.е., например, для бухгалтерского учет может быть конфигурация под названием «Бухгалтерия предприятия» или другие, для торговли может использоваться конфигурация например «Управление торговлей» или «Розница» или другие, для учета кадров и расчета зарплаты, например «Зарплата и управление персоналом», также существуют конфигурации для комплексного учета, например для автоматизации завода.
Конфигураций существуют много, несколько сотен разных конфигураций для разного учета.
Все эти конфигурации могут создаваться для работы в 1С 7.7 или 8.2 или 8.3 в чем же отличия и зачем тут написано про конфигурации если 8.2 и 8.3 и даже 7.7 это платформы? Сейчас разберемся.
Каждая платформа имеет в себе разные возможности для создания конфигураций, и чем выше версия платформы, тем больше у этой платформы функционала и возможностей.
Если нам нужна база 1С с конфигурацией скажем «Бухгалтерия предприятия», с версией релиза например «3.0.60.44» и мы попытаемся найти о ней информацию, то мы выясним что для работы этой конфигурации и этого релиза на потребуется платформа не ниже чем 8.3, более того не ниже чем 8.3.10.2466, это значит платформа 8.2 нам уже не подойдет!
Конфигураций для платформы 1С 8.* и существует много но их можно разделить на 2 подвида это конфигурации (1) c «обычными формами», и (2) c «управляемыми формами»
«Обычные» — значит такие же как и были раньше, например похожие на 1С 7.7, а «Управляемые» это более современные формы, более красивые, которыми легче управлять при их создании.
Как понять в моей базе 1С формы обычные или управляемые?
Если в верху программы вы видите строку «менюшек» с названиями такие как «Файл», «Правка», или «Операции», «Сервис», «Окна», «Справка», а главное вы можете нажать на них и вниз «выпадет» подменю с выбором подпунктов, значит у вас конфигурация с обычными формами.
Если у вас в верху нет подобных «менюшек», но есть в верху или слева либо в других частях программы ссылки, на на веб-сайте, т.е. вы на них наводите и они тут же становятся подчеркнутыми, они могут иметь названия такие как «Главное», или «Продажи», «Закупки», «Администрирование» или «НСИ и администрирование» или другие подобные ссылки или картинки, и при нажатии на них у вас не «выпадает» список подменю, а открывается в центре программы информация или отдельное окно, значит у вас конфигурация с «управляемыми формами», они как правило более красивые и современные на вид. Если вы знаете что у вас интерфейс «Такси», значит это точно управляемые формы.
Ранее, когда еще не было платформы 8.3 а была только 8.2 и обычные формы, тогда только начали разрабатываться конфигурации на управляемых формах, появилась платформа 8.3 и у чуть позже у многих людей платформа 8.3 начала ассоциироваться с управляемыми формами, а уже платформа 8.2 с обычными. Так и укрепилось понятие, что у кого-то 1С 8.2 (т.е. база 1С с конфигурацией на обычных формах)
, а у кого-то 1С 8.3 (т.е. база 1С с конфигурацией на управляемых формах).
На самом деле платформа 8.3 новее чем 8.2 а значит может работать со всеми конфигурациями для 1С 8.*, НО! Если у вас платформа 8.3, а база с конфигурацией на обычных формах, то про вас могут сказать что у вас 1С 8.2 и это важно понимать!
Также важно понимать что у вас может быть платформа 8.2 а конфигурация на управляемых формах, то про вас могут сказать что у вас 1С 8.3! Многим так быстрее, удобнее и привычнее.
Т.е. большинству без разницы какая у них платформа и если у них база с обычными формами — то это 1С 8.2! если с управляемыми — то 8.3!
Исходя из данного факта и устоявшегося мнения в терминах, на нашем сайте вы можете встретить обработки 8.2 или 8.3 это не означает что для обработки важно какая у вас платформа, это означает что она, обработка, будет работать либо в базе с обычными формами либо только с управляемыми , а бывают еще универсальные обработки у них в названии будет написано (8.2 и 8.3) или (8.2/8.3) или (8.2-8.3) или (8.*)
Ниже примеры некоторых популярных конфигураций 1С на обычных формах т.е. называют 1С 8.2:
— Бухгалтерия предприятием 2.0.*.*
— Управление торговлей 10.3.*.*
— Розница 1.1.*.*
— Зарплата и управление персоналом 2.5.*.*
Теперь примеры некоторых популярных конфигураций 1С на управляемых формах т.е. такие называют 1С 8.3:
— Бухгалтерия предприятием 3.0.*.*
— Управление торговлей 11.*.*.*
— Розница 2.*.*.*
— Зарплата и управление персоналом 3.*.*.*
— Управление нашей фирмой 1.6.*.*
Краткая версия всей статьи или ответ на вопрос: какая у меня 1С 8.2 или 8.3?
Если у вас в базе 1С после того как вы ее откроете в верху есть строка из «менюшек» с названиями к примеру «Файл», «Правка», или «Операции», «Сервис», «Окна», «Справка», и при нажатии вниз «выпадет» подменю с выбором подпунктов, то такую базу называют 1С 8.2 и для нее могут подойти только те обработки, отчеты, расширения, в названиях которых есть «8.2» и не подойдут те обработки, в названии которых есть «8.3»
Если нет такой строки из «менюшек», а есть ссылки, при наведении на которых эти ссылки сразу подчеркиваются, они могут иметь названия Главное» или «Руководителю» или «Продажи», «Закупки», «Администрирование» или «НСИ и администрирование» или другие подобные ссылки или даже картинки. значит — это база 1С 8.3 и для нее могут подойти только те обработки, отчеты, расширения, в названиях которых есть «8.3» и не подойдут те обработки в названии которых есть «8.2»
Исключение это универсальные обработки, отчеты в названиях которых есть и 8.2 и 8.3 т.е. в названии будет написано (8.2 и 8.3) или (8.2/8.3) или (8.2-8.3) или (8.*)
К полям запроса можно применять различные функции. В этом разделе я рассмотрю наиболее часто применяемые (лично мною) из них.
ДАТАВРЕМЯ - задает константное поле с типом Дата. Синтаксис:
ДАТАВРЕМЯ(<Год>,<Месяц>,<День>,<Час>,<Минута>,<Секунда>)
Запрос.Текст =
"ВЫБРАТЬ
| ДАТАВРЕМЯ(2013, 1, 1) КАК ОМГ";//1 января 2013
РАЗНОСТЬДАТ
- возвращает разность 2-х дат в указанном измерении (год, месяц, день, час, минута, секунда). Синтаксис:
РАЗНОСТЬДАТ(<Дата1>, <Дата2>, <Тип>)
Запрос.Текст =
"ВЫБРАТЬ
| РАЗНОСТЬДАТ(ДАТАВРЕМЯ(2013, 2, 28), ДАТАВРЕМЯ(2013, 1, 1), ДЕНЬ)
| КАК ДнейДоКонцаЗимы";
ЗНАЧЕНИЕ - задает константное поле с предопределенной записью одной из таблиц БД, также можно передать пустую ссылку. Синтаксис:
ЗНАЧЕНИЕ(<Имя>)
Запрос.Текст =
"ВЫБРАТЬ
//предопределенный элемент справочника
| ЗНАЧЕНИЕ(Справочник.Валюты.Рубли) КАК Рубль,
//пустая ссылка на документ
| ЗНАЧЕНИЕ(Документ.СчетНаОплатуПокупателю.ПустаяСсылка) КАК ПустойСчет,
//значение перечисления
| ЗНАЧЕНИЕ(Перечисление.ПолФизическихЛиц.Мужской) КАК Мужчина,
//предопределенный счет из плана счетов
| ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.Товары) КАК Счет_41";
ВЫБОР - аналог конструкции ЕСЛИ для языка запросов 1С. Синтаксис:
ВЫБОР
КОГДА <Выражение> ТОГДА <Выражение>
ИНАЧЕ <Выражение>
КОНЕЦ
Запрос.Текст =
"ВЫБРАТЬ
//если цена меньше 100, то запрос все равно вернет 100
//в противном случае запрос вернет реальную цену
| ВЫБОР
| КОГДА Товары.Цена > 100
| ТОГДА Товары.Цена
| ИНАЧЕ 100
| КОНЕЦ КАК Цена
|ИЗ
ССЫЛКА <Имя таблицы>
Запрос.Текст =
"ВЫБРАТЬ
//если тип значения регистратора документ Приходная,
//тогда запрос вернет "Поступление товаров", иначе "Реализация товаров"
| ВЫБОР
| КОГДА Остатки.Регистратор ССЫЛКА Документ.Приходная
| ТОГДА ""Поступление товаров""
| ИНАЧЕ ""Реализация товаров""
| КОНЕЦ КАК ВидДвижения
|ИЗ
| РегистрНакопления.Остатки КАК Остатки";
МЕЖДУ - проверяет значение на вхождение в диапозон. Синтаксис:
МЕЖДУ <Выражение> И <Выражение>
Запрос.Текст =
//получим все товары в диапазоне цен от 100 до 1000
"ВЫБРАТЬ
| Товары.Товар
|ИЗ
|ГДЕ
| Товары.Цена МЕЖДУ 100 И 1000";
В и В ИЕРАРХИИ - проверяют наличие значения в передаваемом списке. В ИЕРАРХИИ также развернет иерархические элементы вниз и поищет значение среди подчиненных элементов. Синтаксис:
В(<СписокЗначений>), В ИЕРАРХИИ(<СписокЗначений>)
Запрос.Текст =
//получим все субсчета 41-го и 10-го счета
"ВЫБРАТЬ
| Хозрасчетный.Ссылка КАК Счет
|ИЗ
| ПланСчетов.Хозрасчетный КАК Хозрасчетный
|ГДЕ
| Хозрасчетный.Ссылка В ИЕРАРХИИ (ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.Товары),
| ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.Материалы))";
ПОДОБНО - позволяет сравнивать строку с шаблоном, используется когда строка поиска жестко не определена. Построение шаблона:
- % (процент): последовательность, содержащая любое количество произвольных символов
- _ (подчеркивание): один произвольный символ
- [...] (в квадратных скобках один или несколько символов): любой одиночный символ из перечисленных внутри квадратных скобок. В перечислении могут задаваться диапазоны, например a-z, означающие произвольный символ, входящий в диапазон, включая концы диапазона
- [^...] (в квадратных скобках значок отрицания, за которым следует один или несколько символов): любой одиночный символ, кроме тех, которые перечислены следом за значком отрицания
Синтаксис:
ПОДОБНО "<ТекстШаблона>"
Запрос.Текст =
//найдем все стулья в справочнике номенклатура
"ВЫБРАТЬ
| Товары.Товар
|ИЗ
| Справочник.Товары КАК Товары
|ГДЕ
| Товары.Наименование ПОДОБНО ""тул%""";
//этот запрос вернет Стул, стул, стульчик, стул офисный и т.д.,
//но стол в этом списке не окажется
ЕСТЬNULL - если поле не определено, то определяет его в указанное выражение. Синтаксис:
ЕСТЬNULL(<Выражение>, <Выражение>)
Запрос.Текст =
//Если поле не определено (NULL)? то присвоим ему пустую ссылку
"ВЫБРАТЬ
| ЕСТЬNULL(Товары.Ссылка, ЗНАЧЕНИЕ(Справочник.Товары.ПустаяСсылка)) КАК Товар
|ИЗ
| Справочник.Товары КАК Товары";
Замечу, что NULL следует обязательно обрабатывать, т.к. это очень "капризный" тип (в системе "1С:Предприятие 8" определен специальный тип NULL с одним элементом). Если вы попытаетесь сравнить со значением данного типа или присвоить его, то обязательно нарветесь на ошибку, поэтому не забывайте о данной конструкции. Когда может выскочить NULL:
- после соединения таблиц, кроме внутреннего (о соединениях следующая статья);
- после выбора реквизитов определенных только для групп справочников и наоборот;
- после выбора графы журнала документов, в то время как у текущего документа нет реквизитов, включенных в состав этой графы.
Это далеко не полный список функций языка запросов 1С 8, если заинтересует работа каких-либо еще - пишите в комментариях.
В этой статье мы хотим обсудить с Вами все функции языка запросов 1с , а также конструкции языка запросов . Чем же отличается функция от конструкции? Функция вызывается со скобками и возможными параметрами в них, а конструкция пишется без скобок. Безусловно все конструкции и функции языка запросов 1с делают процесс получения данных гибким и многофункциональным. Данные функции и конструкции применимы к полям запроса, а некоторые также применимы в условиях.
Функции языка запросов 1с
Поскольку понятное описание функций языка запросов 1с встречается намного реже, чем описание конструкций, мы решили начать рассматривать именно функции. Теперь давайте разберем каждую по отдельности, описав ее назначение, синтаксис и пример использования, итак:
1. Функция ДАТАВРЕМЯ - данная функция создает константное поле с типом "Дата".
Синтаксис: ДАТАВРЕМЯ(<Год>,<Месяц>,<День>,<Час>,<Минута>,<Секунда>)
Пример использования:
2. Функция РАЗНОСТЬДАТ - возвращает разность двух дат в одном из измерений (год, месяц, день, час, минута, секунда). Измерение передается в параметре.
Синтаксис: РАЗНОСТЬДАТ(<Дата1>, <Дата2>, <Тип>)
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | РАЗНОСТЬДАТ(ДАТАВРЕМЯ(2015, 4, 17), ДАТАВРЕМЯ(2015, 2, 1), ДЕНЬ) | КАК КолвоДней";
3. Функция ЗНАЧЕНИЕ - задает константное поле с предопределенной записью из базы данных, также можно получить пустую ссылку любого типа.
Синтаксис: ЗНАЧЕНИЕ(<Имя>)
Пример использования:
Запрос.Текст = "ВЫБРАТЬ //предопределенный элемент | ЗНАЧЕНИЕ(Справочник.Валюты.Доллар) КАК Доллар, //пустая ссылка | ЗНАЧЕНИЕ(Документ.ПоступлениеТоваровУслуг.ПустаяСсылка) КАК Поступление, //знач. перечисления | ЗНАЧЕНИЕ(Перечисление.ЮрФизЛицо.ФизЛицо) КАК ФизЛицо, //предопределенный счет | ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.Материалы) КАК Счет_10" ;
4. Функция ВЫБОР - перед нами аналог конструкции ЕСЛИ который используется в коде, только эта используется в запросах 1С.
Синтаксис: ВЫБОР КОГДА <Выражение> ТОГДА <Выражение> ИНАЧЕ <Выражение> КОНЕЦ
Пример использования:
Запрос.Текст = //если сумма больше 7500, тогда должна быть скидка 300 рублей, //поэтому если условие срабатывает то функция //возвращает Сумма - 300 //в противном случае запрос вернет просто Сумма "ВЫБРАТЬ | ВЫБОР | КОГДА ТЧПоступления.Сумма > 7500 | ТОГДА ТЧПоступления.Сумма - 300 | ИНАЧЕ ТЧПоступления.Сумма | КОНЕЦ КАК СуммаСоСкидкой |ИЗ | Документ.ПоступлениеТоваровУслуг.Товары КАК ТЧПоступления";
5. Функция ВЫРАЗИТЬ - позволяет выразить константное поле определенным типом.
Синтаксис: ВЫРАЗИТЬ(НазваниеПоля КАК НазваниеТипа)
Пример использования:
Запрос.Текст = "ВЫБРАТЬ РАЗЛИЧНЫЕ | Продажи.Регистратор.Номер, | ВЫБОР | КОГДА Продажи.Регистратор ССЫЛКА Документ.Расходная | ТОГДА ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.Расходная) | ИНАЧЕ ВЫБОР | КОГДА Продажи.Регистратор ССЫЛКА Документ.Реализация | ТОГДА ВЫРАЗИТЬ(Продажи.Регистратор КАК Документ.Реализация) | КОНЕЦ | ... | КОНЕЦ КАК Номер | ИЗ | РегистрНакопления.Закупки КАК Закупки";
Еще есть вариант использования функции ВЫРАЗИТЬ в полях смешанных типах, где такие встречаются? Самый простой пример это "Регистратор" у любого регистра. Так зачем нам может понадобиться уточнять тип в регистраторе? Давайте рассмотрим ситуацию когда мы из регистратора выбираем поле "Номер", из какой таблицы будет выбран номер? Правильный ответ из всех! Поэтому чтобы наш запрос работал быстро следует указывать явный тип с помощью функции ВЫРАЗИТЬ
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | ВЫРАЗИТЬ(Номенклатура.Комментарий КАК Строка(300)) КАК Комментарий, | ВЫРАЗИТЬ(Номенклатура.Сумма КАК Число(15,2)) КАК Сумма |ИЗ | Справочник.Номенклатура КАК Номенклатура";
6. Функция ISNULL (альтернативное написание ЕСТЬNULL) - если поле имеет тип NULL, то оно заменяется на второй параметр функции.
Синтаксис: ЕСТЬNULL(<Поле>, <ПодставляемоеЗначение>)
Пример использования:
Также отметим что тип NULL желательно ВСЕГДА заменять на какое-то значение, т.к. сравнение с типом NULL всегда дает ЛОЖЬ даже если вы сравниваете NULL с NULL. Чаще всего значения NULL образуются в результате соединения таблиц (все виды соединений кроме внутреннего).
Запрос.Текст = //Выбираем всю номенклатуру и остатки по ней //если остатокв но какой-то номенклатуре нет то будет поле //NULL которое заменится значением 0 "ВЫБРАТЬ | Ном.Ссылка, | ЕСТЬNULL(ТоварыНаСкладахОстатки.ВНаличииОстаток, 0) КАК Остаток |ИЗ | Справочник.Номенклатура КАК Ном | ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ТоварыНаСкладах.Остатки КАК ТоварыНаСкладахОстатки | ПО (ТоварыНаСкладахОстатки.Номенклатура = Ном.Ссылка)";
7. Функция ПРЕДСТАВЛЕНИЕ - позволяет получить представление поля запроса.
Синтаксис: ПРЕДСТАВЛЕНИЕ(<НаименованиеПоля>)
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | ПРЕДСТАВЛЕНИЕ(СвободныеОстаткиОстатки.Номенклатура) КАК Номенклатура, | ПРЕДСТАВЛЕНИЕ(СвободныеОстаткиОстатки.Склад) КАК Склад, | СвободныеОстаткиОстатки.ВНаличииОстаток |ИЗ | РегистрНакопления.СвободныеОстатки.Остатки КАК СвободныеОстаткиОстатки";
Конструкции в языке запросов 1с
Выше мы рассмотрели с Вами функции языка запросов 1с , теперь пришло время рассмотреть конструкции в языке запросов 1с , они не менее важны и полезны, приступаем.
1. Конструкция ССЫЛКА - представляет из себя логический оператор проверки ссылочного типа. Наиболее часто встречается при проверки поля составного типа на конкретный тип. Синтаксис: ССЫЛКА <Имя таблицы>
Пример использования:
Запрос.Текст = //если тип значения регистратора документ Приходная, //тогда запрос вернет "Поступление товаров", иначе "Реализация товаров" "ВЫБРАТЬ | ВЫБОР | КОГДА Остатки.Регистратор ССЫЛКА Документ.ПоступлениеТоваровУслуг | ТОГДА ""Приход"" | ИНАЧЕ ""Расход"" | КОНЕЦ КАК ВидДвижения |ИЗ | РегистрНакопления.ОстаткиТоваровНаСкладах КАК Остатки" ;
2. Конструкция МЕЖДУ - данный оператор проверяет входит ли значение в указанный диапазон.
Синтаксис: МЕЖДУ <Выражение> И <Выражение>
Пример использования:
Запрос.Текст = //получим всю номенклатуру код которой лежит в диапазоне от 1 до 100 "ВЫБРАТЬ | Номенклатура.Ссылка |ИЗ | Справочник.Номенклатура КАК Номенклатура |ГДЕ | Номенклатура.Код МЕЖДУ 1 И 100" ;
3. Конструкция В и В ИЕРАРХИИ - проверяют находится ли значение в передаваемом списке (в качестве списка могут передаваться массивы, таблицы значений и т.д.). Оператор В ИЕРАРХИИ позволяет просматривать иерархию (пример использования ПланСчетов).
Синтаксис: В(<СписокЗначений>), В ИЕРАРХИИ(<СписокЗначений>)
Пример использования:
Запрос.Текст = //выбираем все субсчета счета "ВЫБРАТЬ | Хозрасчетный.Ссылка КАК Счет |ИЗ | ПланСчетов.Хозрасчетный КАК Хозрасчетный |ГДЕ | Хозрасчетный.Ссылка В ИЕРАРХИИ ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.Товары)";
4. Конструкция ПОДОБНО - эта функция позволяет нам сравнивать строку с шаблоном строки.
Синтаксис: ПОДОБНО "<ТекстШаблона>"
Варианты шаблона строки:
% - последовательность, содержащая любое количество произвольных символов.
Один произвольный символ.
[...] - любой одиночный символ, либо последовательность символов из перечисленных внутри квадратных скобок. В перечислении могут задаваться диапазоны, например a-z, означающие произвольный символ, входящий в диапазон, включая концы диапазона.
[^...] - любой одиночный символ, либо последовательность символов из перечисленных внутри квадратных скобок кроме тех, которые перечислены следом за значком отрицания.
Пример использования:
Запрос.Текст = //найдем всю номенклатуру которая содержит корень ТАБУР и начинается //либо с маленькой либо с большой буквы т "ВЫБРАТЬ | Номенклатура.Ссылка |ИЗ | Справочник.Номенклатура КАК Номенклатура |ГДЕ | Товары.Наименование ПОДОБНО ""[Тт]абур%""" ;
5. Конструкция РАЗРЕШЕННЫЕ - этот оператор позволяет выбрать только те записи из БД, на которые вызывающий имеет право чтения. Данные права настраиваются на уровне записей (RLS).
Синтаксис: РАЗРЕШЕННЫЕ пишется после ключевого слова ВЫБРАТЬ
Пример использования:
Запрос.Текст = "ВЫБРАТЬ РАЗРЕШЕННЫЕ | Контрагенты.Ссылка |ИЗ | Справочник.Контрагенты КАК Контрагенты";
6. Конструкция РАЗЛИЧНЫЕ - позволяет выбрать записи в которых отсутствуют повторные записи.
Синтаксис: РАЗЛИЧНЫЕ пишется после ключевого слова ВЫБРАТЬ
Пример использования:
Запрос.Текст = //выбирает записи на которые есть права у читающего "ВЫБРАТЬ РАЗЛИЧНЫЕ | Контрагенты.Наименование |ИЗ | Справочник.Контрагенты КАК Контрагенты" ;
Также Конструкция РАЗЛИЧНЫЕ может использоваться с оператором РАЗРЕШЕННЫЕ и другими операторами.
Пример использования:
Запрос.Текст = //выбирает различные записи на которые есть права у читающего "ВЫБРАТЬ РАЗРЕШЕННЫЕ РАЗЛИЧНЫЕ | Контрагенты.Наименование |ИЗ | Справочник.Контрагенты КАК Контрагенты";
7. Конструкция ПЕРВЫЕ - выбирает указанное в параметре число записей из результата запроса.
Синтаксис: ПЕРВЫЕ <число>
Пример использования:
Запрос.Текст = //выбирают первые 4 номера ГТД из справочника "ВЫБРАТЬ ПЕРВЫЕ 4 | НомераГТД.Ссылка |ИЗ | Справочник.НомераГТД КАК НомераГТД";
8. Конструкция ДЛЯ ИЗМЕНЕНИЯ - позволяет заблокировать таблицу, работает только в транзакциях (актуально только для автоматических блокировок).
Синтаксис: ДЛЯ ИЗМЕНЕНИЯ <НаименованиеТаблицы>
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | СвободныеОстаткиОстатки.Номенклатура, | СвободныеОстаткиОстатки.Склад, | СвободныеОстаткиОстатки.ВНаличииОстаток |ИЗ | РегистрНакопления.СвободныеОстатки.Остатки КАК СвободныеОстаткиОстатки |ДЛЯ ИЗМЕНЕНИЯ | РегистрНакопления.СвободныеОстатки.Остатки";
9. Конструкция УПОРЯДОЧИТЬ ПО - упорядочивает данные по определенному полю. Если полем является ссылка то при установке флага АВТОУПОРЯДОЧИВАНИЕ будет происходить сортировка по представлению ссылки, если флаг выключен то ссылки сортируются по старшинству адреса ссылки в памяти.
Синтаксис: УПОРЯДОЧИТЬ ПО <НаименованиеПоля> АВТОУПОРЯДОЧИВАНИЕ
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | СвободныеОстаткиОстатки.Номенклатура КАК Номенклатура, | СвободныеОстаткиОстатки.Склад КАК Склад, | СвободныеОстаткиОстатки.ВНаличииОстаток |ИЗ | РегистрНакопления.СвободныеОстатки.Остатки КАК СвободныеОстаткиОстатки | |УПОРЯДОЧИТЬ ПО | Номенклатура |АВТОУПОРЯДОЧИВАНИЕ";
10. Конструкция СГРУППИРОВАТЬ ПО - используется для группировки строк запроса по определенным полям. Числовые поля должны использоваться с любой агрегатной функцией.
Синтаксис: СГРУППИРОВАТЬ ПО <НаименованиеПоля1>, .... , <НаименованиеПоляN>
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | ТоварыНаСкладах.Номенклатура КАК Номенклатура, | ТоварыНаСкладах.Склад, | СУММА(ТоварыНаСкладах.ВНаличии) КАК ВНаличии |ИЗ | РегистрНакопления.ТоварыНаСкладах КАК ТоварыНаСкладах | |СГРУППИРОВАТЬ ПО | ТоварыНаСкладах.Номенклатура, | ТоварыНаСкладах.Склад";
11. Конструкция ИМЕЮЩИЕ - позволяет применить агрегатную функцию к условию выборки данных, похожа на конструкцию ГДЕ.
Синтаксис: ИМЕЮЩИЕ <агрегатная функция с условием>
Пример использования:
Запрос.Текст = //выбирает сгруппированные записи где поле ВНаличии больше 3 "ВЫБРАТЬ | ТоварыНаСкладах.Номенклатура КАК Номенклатура, | ТоварыНаСкладах.Склад, | СУММА(ТоварыНаСкладах.ВНаличии) КАК ВНаличии |ИЗ | РегистрНакопления.ТоварыНаСкладах КАК ТоварыНаСкладах | |СГРУППИРОВАТЬ ПО | ТоварыНаСкладах.Номенклатура, | ТоварыНаСкладах.Склад | |ИМЕЮЩИЕ | СУММА(ТоварыНаСкладах.ВНаличии) > 3" ;
12. Конструкция ИНДЕКСИРОВАТЬ ПО - используется для индексации поле запроса. Запрос с индексацией дольше выполняется, но ускоряет поиск по индексированным полям. Можно использовать только в виртуальных таблицах.
Синтаксис: ИНДЕКСИРОВАТЬ ПО <Поле1, ... , ПолеN>
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | Тз.НаименованиеОС, | Тз.НомерПапки, | Тз.КодОС, | Тз.Срок, | Тз.Тип |ПОМЕСТИТЬ ДанныеТз |ИЗ | &Тз КАК Тз | |ИНДЕКСИРОВАТЬ ПО | Тз.НаименованиеОС, | Тз.КодОС";
13. Конструкция ГДЕ - позволяет наложить условие на любые поля выборки. В результат попадут записи только удовлетворяющие условию.
Синтаксис: ГДЕ <Условие1 ОператорЛогСоединения УсловиеN>
Пример использования:
Запрос.Текст = //выбираются все записи у которых КомпенсацияОстаток <> 0 и //СуммаДляРасчКомпОстаток > 100 "ВЫБРАТЬ | КомпенсацияРПОстатки.Контрагент, | КомпенсацияРПОстатки.Ребенок, | КомпенсацияРПОстатки.КомпенсацияОстаток, | КомпенсацияРПОстатки.СуммаДляРасчКомпОстаток |ПОМЕСТИТЬ ДанныеТз |ИЗ | РегистрНакопления.КомпенсацияРП.Остатки КАК КомпенсацияРПОстатки |ГДЕ | КомпенсацияРПОстатки.КомпенсацияОстаток <> 0 | И КомпенсацияРПОстатки.СуммаДляРасчКомпОстаток > 100" ;
14. Конструкция ИТОГИ... ПО ОБЩИЕ - применяется для подсчета итогов, в конструкции указываются поля по которым будут считаться итоги и агрегатные функции применяемые к итоговым полям. При использовании итогов на каждое поле следующее после конструкции ИТОГИ производится группировка данных. Есть необязательная конструкция ОБЩИЕ, ее использование также обеспечивает дополнительную группировку. Пример результата запроса вы увидите ниже.
Синтаксис: ИТОГИ <АгрегатнаяФункция1, ... , АгрегатнаяФункцияN> ПО <ОБЩИЕ> <Поле1, ... , ПолеN>
Пример использования:
Запрос.Текст = "ВЫБРАТЬ | Расчеты.ДоговорКонтрагента.ВидДоговора КАК ВидДоговора, | Расчеты.ДоговорКонтрагента КАК Договор, | Расчеты.Контрагент, | Расчеты.СуммаВзаиморасчетовОстаток КАК Остаток |ИЗ | РегистрНакопления.ВзаиморасчетыСКонтрагентами.Остатки КАК Расчеты |ИТОГИ | СУММА(Остаток) |ПО | ОБЩИЕ, | ВидДоговора";
На рисунке обведены группировки которые образовались в ходе выполнения запроса, самая верхняя относится к секции ОБЩИЕ, а вторая к полю ДоговорКонтрагентаВидДоговора.
Здравствуйте дорогие читатели. Я уже писал о таких примитивных типах данных как NULL и Строка, а сегодня рассмотрим примитивный тип данных Число (Number) .
Числовым у нас может быть реквизит объекта конфигурации или переменные в .
Максимально допустимая разрядность числа составляет 38 знаков, длина целой части не может превышать 32 символа, точность — 10 символов. Хотя в переменных можно оперировать числами превышающих разрядность в 38 символов, но в ИБ (информационную базу) можем записывать значения с длинной целой части не больше 32-х знаков.
Над данными числового типа применимы операции: +, -, *, /, (), %(остаток от деления нацело 10%3=1).
Математические функции для чисел можно посмотреть в синтакс помощнике
Общее описание встроенного языка-> Встроенные функции-> Функции по работе с типом Число
Из всех функции, которые там приведены лично мне пока пришлось работать только с двумя:
Окр(<Число>, <Разрядность>, <РежимОкругления>)
Функция округляет исходное число до нужной разрядности в соответствии с заданным режимом округления.
Параметры: <Число> (обязательный), Исходное число. Остальные параметры не обязательны.
Цел(<Число>) — Функция вычисляет целую часть переданного числа, полностью отсекая дробную часть.
Пример: МожноКупить = Цел (Наличность / Цена );
Если вы сталкивались в задачах с другими функциями, напишите примеры в комментариях.
Часто на практике встречается преобразование типов данных из строки в число, для этих целей есть функция Число().
Функция Число()
— Преобразует полученный параметр (параметр обычно строкового типа) в значение типа Число.
Пример: КонтрольноеЧисло
=
Число
(Прав
(СтраховойНомер
,
2
));
Типа Булево преобразуется в число:
Ложь преобразуется в 0;
Истина преобразуется в 1.
Приоритет арифметических операций:
1) ()
2) Унарные арифметические операции (+, -)
3) *, /, %
4) Бинарные арифметические операции (+, -)
5) Операции сравнения (>,>=,
6) НЕ
7) И
ИЛИ
Приведу еще пару функций которые полезны при работе с Числом
Формат(<Значение>, <ФорматнаяСтрока>)
Функция формирует удобное для чтения представление значений.
Параметры: <Значение> (обязательный) Тип параметра: Число; Дата; Булево.
Форматную строку удобно задавать, вызвав: Конструктор форматной строки
Макс(<Значение1>,…,<ЗначениеN>)
Функция определяет максимальное значение из полученных параметров.
Параметры: <Значение1>,…,<ЗначениеN> (обязательный) и могут иметь один Тип: Число; Строка; Дата; Булево.
Пример:
// Пример для чисел
A = Макс(1 , 2 , 3 ); // A = 3
Мин(<Значение1>,…,<ЗначениеN>) Из полученных параметров функция определяет минимальное значение.
