Во второй и третьей главе даются основы программирования в 1С: мы познакомимся с **примитивными типами**, научимся задавать переменный и узнаем **основные конструкции** языка программирования в 1С (условия, циклы, процедуры и т.д.)

4) изучим **основные объекты конфигурации** (метаданные), которые часто применимы при разработке.

5) **управляемыми формами**. Сама по себе тема управляемых форм очень объёмна, мы же освоим тот минимум, который необходим для начальной работы.

6) **объектных типах**. Узнаем, что такое Объект, Ссылка и многие другие интересные понятия.

7-8) **универсальные коллекции значений**: массивы, структуры, таблицы значений и многое другое.

9) **способы получения данных**. При помощи выборок и запросов. Язык запросов в этой книге дан в том минимуме, который позволит Вам двигаться успешно дальше в изучении этого интересного инструмента.

10) **регистрами сведений и накоплений**.

11) работать **с печатными формами**, отчётами, динамическими списками, то есть со всем тем, что выводит пользователю конечную информацию.

раб https://file:///D:/Книги/1С/Низамутдинов И/Книга3ред/

Ссылка на файл на рабочем столе

## (3) 1.1) Глава 1. Работа со справкой.pdf

открыть в конфигураторе: перейдите Главное меню – Справка – Синтакс-помощник

.

стр41 осталось создать обработчик команды «ПриветМир». Для этого необходимо опять **зайти в палитру свойств команды** (чтобы палитра открылась, необходимо кликнуть по команде мышкой, палитра свойств откроется в правой части рабочего стола) и у свойства «Действие» нажать на кнопку «Лупа» (см. рис. 1.7.12).

Откроется окно, где будет предложено выбрать место создания обработчика команды (см. рис. 1.7.13). Оставляем «Создать на клиенте» и нажимаем кнопку «Ок» (см. рис. 1.7.13).

После этого в модуле формы будет создана процедура «ПриветМир» (см. рис. 1.7.14).

Рис. 1.7.14

Напишем в ней следующий код (см. листинг 1.7.1).

```csharp

&НаКлиенте

Процедура ПриветМир(Команда)

Предупреждение("Привет, мир!!!");

КонецПроцедуры

```

Листинг 1.7.1

Это процедура предупреждение и в ней текст «Привет, Мир!». Сохраним обработку!

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

Рис. 1.7.15

В результате запустится «1С: Предприятие» в пользовательском режиме (основной режим, где работают пользователи). В этом пользовательском режиме откроем только что созданную обработку. Для этого необходимо выполнить команду Открыть, которая находится по следующему пути: Сервис и настройки – Файл (см. рис. 1.7.16), в результате откроется окно Открытие, в котором нужно найти файл внешней обработки с расширением epf в том месте, куда Вы её сохранили. Открываем (на предупреждение безопасности отвечаем «Да»), нажимаем на кнопку Привет мир (см. рис. 1.7.17), и выйдет Ваше первое предупреждение (см. рис. 1.7.18).

Рис. 1.7.16 Рис. 1.7.17 и Рис. 1.7.18

.

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

Научимся работать с отладкой на примере той обработки, которую сделали в предыдущей части («Привет, Мир»). Для этого переделаем код в команде «ПриветМир» формы обработки. Присвоим переменным некоторые значения.

```csharp

&НаКлиенте

Процедура ПриветМир(Команда)

А = 10;

B = "Текст";

Предупреждение("Привет, мир!!!");

КонецПроцедуры

```

Листинг 1.8.1

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

Для того, чтобы отладка работала, она должна быть подключена. Если у Вас на панели конфиурации вместо кнопки «Начать отладку» (см. рис. 1.8.1) кнопка «Продолжить отладку» (см. рис. 1.8.2), то конфигуратор подключен к отладке.

рис.1.8.1 1.8.2

Отладка подключится автоматически, если Вы запустите из конфигуратора пользовательский режим «1С: Предприятия», нажав на кнопку Начать отладку (см. рис. 1.8.1).

Но иногда бывают ситуации, когда нужно отладить уже запущенное приложение (например, когда пользовательский режим был запущен отдельно от конфигуратора). В конфигураторе можно посмотреть, подключены какие-либо сеансы к отладке или нет. Для этого следует воспользоваться окном «Предметы отладки». Открыть это окно можно через «Главное меню» - «Отладка» - «Подключение».

Окно Пердметы отладки разделено на две части: в верхней части все доступные сеансы, а в нижней те сеансы, которые уже подключены к отладке.

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

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

В открывшемся окне установим в параметрах Откладка в текущем сеансе и Откладка при перезапуске значение Разрешена (протокол TCP/IP), а затем нужно последовательно нажать на кнопки Применить и ОК.

Если окно «Предметы отладки» уже открыто, то нажмите кнопку «Обновить» (см. рис. 1.8.7), чтобы подключенный сеанс появился в верхнем окне (см. рис. 1.8.8).

У нас доступные предметы отладки без пользователя, потому что мы его не завели, позже, когда научимся создавать пользователей (в четвёртой главе), колонка Пользователь будет заполнена. В окне две строки с отладкой – тонкий клиент и сервер, пока не обращая внимания на этот факт, подключим оба предмета. Для того чтобы нужный предмет отладки получился, следует выделить нужную строку и нажать на кнопку Подключить.

После всех подключений предметы отладки исчезнут в верхнем окне и появятся в нижнем.

После этого можно спокойно работать с отладкой.

Если же пользовательское приложение «1С: Предприятие» не запущено, то его можно запустить из конфигуратора, нажав на кнопку Начать отладку панели Конфигурация.

Рис. 1.8.10

.

стр48 Подключать отладку мы научились, научимся с ней работать.

Запустим пользовательский режим «1С: Предприятия», используя кнопку Начать отладку, откроем модуль формы, созданной в седьмой части обработки, и установим точку останова в начале процедуры ПриветМир. Для установки точки останова нужно установить курсор на первую строку тела процедуры (где начинается текст А = 10;, см. листинг 1.8.1) и нажать на кнопку Точка останова одноимённой панели (см. рис. 1.8.11), или выполнить команду Точка останова по пути Главное меню – Отладка (см. рис. 1.8.12).

Рис. 1.8.11

Рис. 1.8.12

После этих действий на поле слева напротив нужной строки кода появится красный кружок, это и есть точка останова.

Рис. 1.8.13

Учитывайте следующий момент: точку останова нужно **устанавливать на строке, где написан какой-то код**. Если установите точку останова на пустой строке (или где комментарий), то она не сработает.

Если сейчас мы в пользовательском режиме «1С: Предприятия» у запущенной обработки нажмём на кнопку Привет мир, то в конфигураторе, рядом с этой точкой останова, появится стрелочка (см. рис. 1.8.14). Это значит, что точка останова сработала, и Вы можете начать отладку процедуры. В это время работа пользовательского режима «1С: Предприятия» остановится (как бы зависнет).

Рис. 1.8.14

Передвигаться по коду можно с помощью кнопок панели:

«Шагнуть в» (F11) – переходим на следующую строку кода. Но если в текущей (там, где стрелка) строке процедура или функция, созданная разработчиком конфигурации или обработки (об этом в третьей главе), то зайдём «внутрь» этой процедуры или функции.

Рис. 1.8.15

«Шагнуть через» (F10) – переходим на следующую строку кода. Если в текущей строке метод, созданный разработчиком, то не заходим в этот метод.

Рис. 1.8.16

«Шагнуть из» (Shift + F11) – если нам не посчастливилось зайти в собственный метод, то при помощи этой кнопки можно из него выйти.

Рис. 1.8.17

«Идти до курсора» (Shift + F10) – можно установить курсор на любой строке кода, и после нажатия на эту кнопку отладка перейдет на неё.

Рис. 1.8.18

Заметьте, код выполнится только после того, как мы пройдем его! Т.е. если мы сейчас на строке, где переменной А присваивается значение 10, то оно еще не присвоилось. Для выполнения этого кода (присвоение значения), нужно перейти на следующую строку.

С движением по отладке разобрались. Потренируйтесь отлаживать Ваш пусть даже маленький код (удобнее всего это делать с помощью клавиш).

Научимся смотреть на значения переменных. Для этого дойдем в отладке до нижней строки кода и посмотрим значения переменных А и В.

Рис. 1.8.19

Посмотреть значения той или иной переменной можно **двумя способами**.

Первый - используя окно «Вычислить выражение». Путь к этому окну: «Главное меню» - **«Отладка» - «Вычислить выражение»**.

Рис. 1.8.20

В открывшемся окне введите нужную переменную и нажмите на кнопку «Рассчитать». 52стр.<<

Рис. 1.8.21

Второй способ узнать значение нужной переменной - используя Табло. Оно открывается по следующему пути: «Главное меню» - «**Отладка» - «Табло**».

Рис. 1.8.22

Табло откроется внизу конфигуратора, и Вы можете в него вводить любые переменные (в колонку Выражение). 53стр.<<

Рис. 1.8.23

И в табло, и в «Вычислить выражение» можно производить различные действия над переменными.

Рис. 1.8.24

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

.

Всего существует шесть основных примитивных типов языка программирования 1С: **число, строка, дата, булево** (истина-ложь), а также типы **Неопределенно**, **NULL** и **Тип**.

55

Для тех, кто изучал другие языки программирования: в языке программирования 1С не надо явно задавать тип переменной. Достаточно просто указать для данной переменной какое-нибудь значение (число, строку, булево значение), и она автоматически присвоит себе данный тип.

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

Итак, первый примитивный тип Число. Это могут быть любые числа: целые и дробные числа, положительные и отрицательные.

Например: 23; 23.4; 233.33333. Можно использовать любые цифры, дробная часть разделяется символом «.» (**точка**). По справочной информации, максимальная разрядность числа 38 знаков. Так как основные задачи в 1С не связаны с астрономическими расчетами и т.п., то этой разрядности будет достаточно.

Над типом Число определены главные математические операции: **сложение, вычитание, умножение, деление**. Вот как они выглядят:

2 + 2

3 - 4

5*6

7/2

Рис. 2.1.2

Подробно об операциях с числами Вы узнаете в части 4 этой главы.

.

.

Второй примитивный тип - это тип Строка. Строка - это любой набор символов **заключенный в кавычки**: . Строки могут быть однострочные и многострочные (текст).

Однострочная строка будет выглядеть так:

Я помню чудное мгновенье

А многострочная строка задается следующим образом:

"Я помню чудное мгновенье

| Передо мной явилась ты

| Как мимолетное виденье

| Как гений чистой красоты"

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

Для строк есть операция сложения, выполняемая оператором «Плюс» (+). Это значит, что при сложении строки «Мама мыла » и строки «раму» получится строка "Мама мыла раму":

Мама мыла + "раму" = "Мама мыла раму".

Пустая строка задаётся следующим образом: "" (две сдвоенных кавычки без пробела).

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

Третий примитивный тип – это тип Дата. Значения данного типа содержат дату григорианского календаря с 1 января 1 года нашей эры. Так что если кто-то изобретет машину времени, то сможет на языке 1С написать программу для ведения бухгалтерии Понтия Пилата. Дата в языке программирования 1С задается в виде строки цифр в следующем **формате 'ГГГГММДДччммсс'**,

где:

ГГГГ – четыре цифры года включая тысячелетие и век, например, 2013 или 1997;

ММ - две цифры месяца, например, 02 – это февраль, а 12 – декабрь;

ДД - две цифры даты, например, 01 – первое число, или 23 – двадцать третье число;

чч - две цифры часов в 24-часовом формате, к примеру: 01 – час ночи, 13 – час дня;

мм – две цифры минут, к примеру: 30 – 30 минут, 01 – 1 минута;

сс – две цифры секунд, 20 - это 20 секунд, и так далее.

Также дату можно задавать в таком виде: 'ГГГГММДД'. При данном формате часы, минуты и секунды будут равны нулю.

Пустая дата задается следующим образом: '00000000000000' .

Таким образом, если Вы родились 20 января 1989 г., то задать данную дату на языке программирования 1С можно двумя способами:

19890120' или '19890120000000'.

А если Вы хотите просто задать время 1 час 30 минут, то будет следующий вид: '00010101013000'. Подробно об операциях с датами Вы узнаете в части 6 этой главы.

Четвертый примитивный тип - это тип Булево. Булево - это логический тип, у которого всего два значения - Истина и Ложь.

**Истина

Ложь**

На данном этапе обучения этого достаточно. Более подробно об операциях с данным типом Вы узнаете в соответствующей части настоящей главы.

Ну и напоследок осталось два типа - это NULL и Неопределено.

Тип NULL – значения данного типа используются исключительно для определения **отсутствующих значений при работе с запросами**. С языком запросов мы научимся работать в девятой главе.

Тип Неопределено применяется, когда надо использовать **пустое значение, не принадлежащее ни к одному другому типу**. Данный тип так и задается.

А = Неопределено;

Итак, мы разобрали примитивные типы языка программирования 1С.

Переменная - это **идентификатор определенный некоторым типом**, способный менять свое значение в ходе выполнения программы.

.

Делается это двумя способами:

Первый: переменная может быть **объявлена явным образом**, тогда она сразу начинает свое существование. Пишем **оператор Перем**, название этой переменной, потом либо запятая и название другой переменной, либо точка с запятой.

Перем НашаПеременная1;

Перем НашаПеременная2;

Перем НашаПерененнаяЗ;

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

Второй способ: переменная может быть **объявлена неявным образом**. Тогда просто пишем название переменной и присваиваем ей какое-нибудь значение.

Например:

НашаПеременная1 = "Привет";

НашаПеременная2 = 12.12;

Символ «=» (равно) - это операция присваивания. То есть какой-то переменной присваивается определенное значение.

Обращаю внимание тех, кто изучал другие языки программирования. Непосредственно при написании кода в конфигураторе 1С не нужно явно задавать тип переменной. Достаточно просто указать для данной переменной какое-нибудь значение (число, строку, булево значение), и данная переменная автоматически присвоит себе данный тип. Кроме того, в языке 1С переменная (явно или неявно заданная) может по желанию разработчика в любом месте поменять свой тип.

Первый пример, это вывод сообщения «Привет, Мир!». Сделаем мы это с помощью оператора Сообщить.

Создайте обработку, форму, команду формы «ВывестиСообщение», разместите команду на форме, и создайте обработчик этой команды на клиенте (подробно об этом см. глава 1, часть 7, стр. 38), напишите в обработчике команды следующий код:

**Сообщить("Привет, мир!");**

```csharp

&НаКлиенте

Процедура ВывестиСообщение(Команда)

Сообщить("Привет, мир!");

КонецПроцедуры

```

Листинг 2.2.1

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

Сохраним и запустим обработку в «1С:Предприятии».

Мы видим, что **в нижней части экрана открылось окно «Сообщения»** и в нем вышел наш текст «Привет, Мир!».

Рис. 2.2.1

Таким образом мы видим, что процедура Сообщить - это встроенная процедура Конфигуратора 1С, которая выводит текстовую информацию в окно сообщений.

59стр.

.

.

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

Процедура Предупреждение работает только тогда, когда в свойство конфигурации «Режим использования модальности» установлено значение «Использовать» (см. глава 1, часть 6, стр. 34) или "Использовать с предупреждениями". Иначе нужно использовать процедуру «ПоказатьПредупреждение».

Создайте новую команду формы «ВывестиПредупреждение», разместите её на форме, создайте обработчик команды и внутри обработчика команды «ВывестиСообщение» напишите следующий код:

```csharp

&НаКлиенте

Процедура ВывестиПредупреждение(Команда)

Предупреждение("Привет, мир!");

КонецПроцедуры

```

Листинг 2.2.2

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

Рис. 2.2.2

Видите: вышло окно с кнопкой «ОК» и нашей надписью.

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

Какие еще особенности есть у данной процедуры? 60стр.<<

Это таймаут и заголовок окна. Таймаут задает время в секундах, в течение которого окно будет открыто, а заголовок - это непосредственно заголовок данного окна. По умолчанию таймаут равен 0, это означает, что время не ограничено.

Измените обработку.

```csharp

&НаКлиенте

Процедура ВывестиПредупреждение(Команда)

Предупреждение("Привет, мир!",5,"Наш заголовок");

КонецПроцедуры

```

Листинг 2.2.3

Запустите ее заново и посмотрите, что получилось:

Рис. 2.2.3

Окно откроется, и через несколько секунд закроется.

А можно написать и так:

```csharp

&НаКлиенте

Процедура ВывестиПредупрежденке(Команда)

Предупреждение("Привет, мкр!",,"Наш заголовок");

КонецПроцедуры

```

Листинг 2.2.4

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

```csharp

&НаКлиенте

Процедура ВывестиПредупреждение(Команда)

Предупреждение("Привет, мир!",5,"Наш заголовок");

Сообщить("Привет, мир!");

КонецПроцедуры

```

Листинг 2.2.5 61стр.<<

Не в модальном режиме нужно использовать "ПоказатьПредупреждение"

Резюме

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

62стр.<<

Этой таймаут и заголовок окна. Таймаут задаёт время в секундах, в течение которого окно будет открыто, а заголовок – это непосредственно заголовок данного окна. По умолчанию таймаут равен 0, это означает, что время не ограничено.

```Предупреждение("Привет, мир!",5,"Наш заголовок");

ПоказатьПредупреждение(,"Привет, мир!",5,"Наш заголовок");

```

Перед тем, как мы начнем изучать числа, строки и даты более подробно, нам нужно будет освоить одну маленькую, но очень важную тему. Это переменные типа Булево. Создайте новую обработку, форму, команду формы и т.д.

**Булево** - это **признак истинности или ложности** какого-нибудь утверждения.

Например, утверждение «5 меньше 7» истинно.

А утверждение, что 5 = 7 ложно.

Как же присваиваются значения переменным типа булево? Делается это очень просто.

Первый способ:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

А = Ложь;

Б = Истина;

Сообщить(А);

Сообщить(Б);

КонецПроцедуры

```

Листинг 2.3.1

Посмотрите, как выводится все это в окно сообщений.

Рис. 2.3.1

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

Второй способ: они могут представляться в виде какого-либо выражения, например:

63стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

А = 5 > 7;

Б = 5 < 7;

Сообщить(А);

Сообщить(Б);

КонецПроцедуры

```

Листинг 2.3.2

Смотрим, что выйдет в окно сообщений.

Сообщения:

- Нет

- Да

Рис. 2.3.2

Ответьте, почему вышли такие сообщения?

.

Всего в языке программирования 1С существует три операции над переменными типа булево: это **НЕ, И, ИЛИ**.

Для того чтобы их понять, рассмотрим три таблицы:

Первая операция – **НЕ**, Логическое отрицание. Данная операция меняет булево значение на противоположное.

Понять функционирование данной операции Вам поможет следующая таблица:

Табл. 2.3.1 64стр.<<

Следующая операция – **И**, конъюнкция. Данная операция возвращает истину только тогда, когда оба значения истинны.

С = А И Б

Понять функционирование данной операции Вам поможет следующая таблица:

Третья операция – ИЛИ – дизъюнкция. Дизъюнкция возвращает истину тогда, когда хотя бы одно значение истинно.

С = А ИЛИ Б

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

Впоследствии Вы освоите эти логические операции и легко будете ими манипулировать.

Для наглядности я приведу пару примеров из таблиц на языке программирования 1С (для этого я создал новую обработку): 65стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

А = Ложь;

Б = Истина;

С = Не А;

Сообщить(С);

С = А И Б;

Сообщить(С);

С = А Или Б;

Сообщить(С);

КонецПроцедуры

```

Листинг 2.3.3

Смотрим, что получилось.

Сообщения:

- Да

- Hет

- Да

Рис. 2.3.3

Теперь самостоятельно выполните все операции из таблиц и проверьте, правда ли там написана.

А можно ли выполнять данные операции подряд?

Да, можно, данные операции будут выполняться слева направо.

И иметь следующий **уровень старшинства**:

Первый: в первую очередь выполняются операции **в скобках**

Второй: Операция **НЕ**

Третий: Операция **И**

Четвертый: Операция **ИЛИ**.

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

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

А = Ложь;

Б = Истина;

С = Ложь;

Д = А и (С или Б);

Сообщить(Д);

КонецПроцедуры

```

Листинг 2.3.4

В данном случае сначала будет работать операция И между А и С.

Смотрим таблицу А – Ложь, С – Ложь, результат А И С будет Ложь.

Следующим шагом будет выполнение операции ИЛИ между Ложью (Результат предыдущей операции) и значением Б, которое Истина.

Результат будет Истина.

Сообщения:

- Да

Рис. 2.3.4.

А если нам надо, чтобы прошла сначала операция ИЛИ между С и Б, а потом только операция И между А и тем, что получилось, то для этого необходимо использовать скобки.

Смотрим:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

А = Ложь;

Б = Истина;

С = Ложь;

Д = А и (С или Б) ;

Сообщить(Д);

КонецПроцедуры

```

Листинг 2.3.5

Результат диаметрально противоположный. Почему? 67стр.<<

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

т.к. С - Ложь, а Б – Истина, результат будет Истина (см табл. 1.3.3). Потом между значением А (которое Ложь) и значением Истина (результатом предыдущей операции) выполняется операция И. Результат будет Ложь (см табл. 1.3.2).

Рис. 2.3.5

Рассмотрим еще один пример со скобками и операцией НЕ

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду3(Команда)

А = Ложь;

Б = Истина;

Д = Не А Или Б;

Сообщить(Д);

Д = Не (А Или Б);

Сообщить(Д)

КонецПроцедуры

```

Листинг 2.3.6

Посмотрите, какой будет результат, и попробуйте сами его объяснить, используя вышеприведенные таблицы (табл. 1.3.1 – 1.3.3).

.

Теперь мы рассмотрим более подробно операции сравнения.68стр.<< Это:

**Больше**: >

**Меньше**: <

**Больше или равно**: >=

**Меньше или равно**: <=

**Не равно**: <>

**Равно**: =

Все эти операции применимы для всех примитивных типов.

Рассмотрим их для чисел.

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Д = 5 > 5;

Сообщить("5 > 5 это - ");

Сообщить(Д);

Д = 5 >= 7;

Сообщить("5 >= 7 это - ");

Сообщить(Д);

Д = 6 < 8;

Сообщить("6 < 8 это - ");

Сообщить(Д);

Д = 7 <= 9;

Сообщить("7 <= 9 это - ");

Сообщить(Д);

Д = 7 <> 10;

Сообщить("7 <> 10 это - ");

Сообщить(Д);

Д = 7 = 7;

Сообщить("7 = 7 это - ");

Сообщить(Д);

КонецПроцедуры

```

Листинг 2.3.7

Смотрим, что получилось.

Сообщения

- 5> 5 это -

- Нет

- 5 >= 7 это -

- Нет

- 6 < 8 это -

Рис. 2.3.6

Точно так же с данными операциями сравнения можно применять операции НЕ, ИЛИ, Скомпонуем из вышеприведенного примера следующий:

69стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

Д = (5 > 5) И (5 >= 7);

Сообщить(Д);

Д = (6 < 8) Или (7 <= 9) ;

Сообщить(Д);

Д = Не (7 <> 10) Или (7 = 7) ;

Сообщить(Д);

КонецПроцедуры

```

Листинг 2.3.8

Смотрим, что получилось. Объясните данный результат.

Сообщения

— Нет

— Да

— Да

Рис. 2.3.7

70стр.<<

.

.

Теперь о порядке выполнения операций. **Сначала выполняются операции умножения и деления, потом операции сложения и вычитания. Операции умножения и деления выполняются слева направо.**

...

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

Создайте новую обработку, в которой Вы будете проводить все манипуляции с переменными, как Вы делали в предыдущих частях (форму обработки, команду и обработчик команды).

Зададим простые переменные:

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды(Команда)

Перем А, Б, С;

Перем Д, Г, Е;

КонецПроцедуры

```

Листинг 2.4.1

Теперь присвоим им числа и выполним элементарные операции.

```csharp

А = 10;

Б = 12;

С = 3;

Д = А + Б - С;

Г = А * Б;

Е = А/Б;

```

Листинг 2.4.2

И выведем результат в окно сообщений.

Сообщить(Д);

Сообщить(Г);

Сообщить(Е);

Листинг 2.4.3

```csharp

Процедура ВыполнениеКоманды(Команда)

Перем А, Б, С;

Перем Д, Г, Е;

А = 10; Б = 12; С = 3;

Д = А + Б - С;

Г = А * Б;

Е = А/Б;

Сообщить(Д);

Сообщить(Г);

Сообщить(Е);

КонецПроцедуры

```

Сохраняем обработку и смотрим на результат. 71стр.<<

Рис. 2.4.1

Теперь о порядке выполнения операций. Сначала выполняются операции умножения и деления, потом операции сложения и вычитания. Операции умножения и деления выполняются слева направо.

К примеру, в операции

Е = А/Б/С;

сначала будет А делиться на Б, потом все это поделится на С.

А при операции

Е = А - Б/С;

сначала Б поделим на С, а потом это все вычтем из А.

Что же нам сделать, если в выражении

Е = А/Б/С;

сначала надо поделить Б на С, а потом все это поделить на А? Или в другом выражении сначала вычесть А из Б, а потом поделить на С? Для этого нам пригодятся операторные скобки.

Запишем так:

Е = А/(Б/С);

или: 72стр.<<

Е = (А - Б)/С;

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

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды2(Команда)

Перем А, Б, С;

Перем Д, Г, Е;

А = 23;

Б = 7;

С = 4;

Е = А/Б/С;

Д = А - Б/С;

Сообщить("А/Б/С = ");

Сообщить(Е);

Сообщить("А - Б/С = ");

Сообщить(Д);

Е = А/(Б/С);

Д = (А - Б)/С;

Сообщить("А/(Б/С) = ");

Сообщить(Е);

Сообщить("(А - Б)/С = ");

Сообщить(Д);

КонецПроцедуры

```

Листинг 2.4.4

Посмотрим результат:

Сообщения:

— А/Б/С =

— 0.8214285714285714285714285715

— А - Б/С =

— 21,25

— А/(Б/С) =

— 13,14285714

— (А - Б)/С =

— 4

Рис. 2.4.2

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

.

Следующий оператор, который нас интересует, это оператор %.

Например: 73стр.<<

в данном случае берется **остаток от деления А на Б**.

Например:

```csharp

10 % 7 = 3.

23 % 7 = 2.

```

При помощи этого оператора Вы можете проверить кратно одно число другому или нет: если одно число кратно другому, то остаток от деления будет 0.

Узнаем при помощи этого оператора, кратно ли число 22 двум и четырем (см. листинг 2.4.5).

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды3(Команда)

Перем А, Б, С;

Перем Д, Г, Е;

А = 22;

Б = 2;

С = 4;

Д = А % Б;

Г = А % С;

Сообщить("А % Б = ");

Сообщить(Д);

Сообщить("А % С = ");

Сообщить(Г);

КонецПроцедуры

```

Листинг 2.4.5

Сообщения:

— А % Б =

— 0

— А % С =

— 2

Рис. 2.4.3

Начнем изучать функции языка программирования 1С для чисел.

74стр.<<

длина уже включает в себя точность.

79-81

.

.

Функция **Окр**

Данная функция округляет число до нужного количества знаков после запятой. Если мы напишем:

Окр(12.122123, 3)

то результат будет 12,122.

А при

Окр(12.122123, 1)

результат будет 12.1,

А при

Окр(12.122123, 0)

результат будет 12.

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

Посмотрим, как это работает (я это сделал в новой обработке).

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды(Команда)

В = Окр(12.122123,3);

Сообщить(В);

В = Окр(12.124623,1);

Сообщить(В);

В = Окр(12.124623,0);

Сообщить(В);

КонецПроцедуры

```

Листинг 2.4.6

Теперь смотрим, что у нас получилось. Запустите обработку в «1С:Предприятии».

Сообщения:

-12,122

-12,1

-12

Рис. 2.4.4

75стр.<<

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

РежимОкругления.Окр15как10 и

РежимОкругления.Окр15как20

В первом случае число 1,5 округляется до 1 в меньшую сторону, во втором случае число 1,5 округляется до 2 в большую сторону.

Рассмотрим пример:

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды2(Команда)

В = Окр(12.1345,3, РежимОкругления.Окр15как10);

Сообщить(В);

В = Окр(12.1345,3, РежимОкругления.Окр15как20);

Сообщить(В);

КонецПроцедуры

```

Листинг 2.4.7

Теперь посмотрим, что получилось. Запустите обработку в «1С:Предприятии».

Сообщения:

-12,134

-12,135

Рис. 2.4.5

Как Вы уже поняли, режим округления необязательный параметр, т.е. можно его опустить, если Вам это не критично.

.

.

**Функция Цел**

Следующая функция - это функция Цел. Данная функция отсекает дробную часть от целого числа. Напишите следующий код: 76стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем А,Б,С;

А = 23;

Б = 7;

С = 4;

В = Цел(442.11344554);

Сообщить(В);

В = Цел(0.12341);

Сообщить(В);

В = Цел ((А*С)/Б);

Сообщить(В);

КонецПроцедуры

```

Листинг 2.4.8

Теперь посмотрите, что получилось.

Сообщения:

— 442

— 0

— 13

Рис. 2.4.6

.

.

Следующая нужная нам функция - это возведение в степень, функция **Pow**.

Она имеет следующий синтаксис:

**Pow(x,y)**

Это x^y.

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

Рассмотрим примеры:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

В = Pow(100,0.2);

Сообщить(В);

В = Pow(100,5);

Сообщить(В);

В = Pow(100,-2);

Сообщить(В);

В = Pow(100,0);

Сообщить(В);

В = Pow(0,100);

Сообщить(В);

КонецПроцедуры

```

Листинг 2.4.9 77стр.<<

Теперь посмотрите, что получилось.

Сообщения:

-2,511886432

- 10 000 000 000

-0,0001

-1

0

Рис. 2.4.7

Еще одна интересная для нас функция - это квадратный корень **SQRT**. Пишется она в виде

**Sqrt(Х)**,

где Х – не отрицательное число.

Несколько примеров:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду3(Команда)

В = Sqrt(100);

Сообщить(В);

В = Sqrt(9);

Сообщить(В);

В = Sqrt(7);

Сообщить(В);

КонецПроцедуры

```

Листинг 2.4.10

Теперь посмотрите, что получилось.

Сообщения:

-10

-3

-2,645751311

Рис. 2.4.8

78стр.<<

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

В этом уроке мы научимся вводить числа интерактивно, с помощью специального окна ввода. Выполняется это функцией **ВвестиЧисло**. Она возвращает *Истина*, если число введено, и *Ложь*, если нет. Как пользоваться данной возможностью этой функции, мы узнаем в следующей главе, в части, посвященной условиям. Пока же будем использовать данную функцию для интерактивного ввода чисел.

*Так же, как и процедура «Предупреждение», этот метод работает только в режиме включенной модальности!*

Разберем данную функцию:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем А;

ВвестиЧисло(А, "Введите число А",5,2);

КонецПроцедуры

```

Первым параметром задается переменная, в которую будет записано число, нами введенное.

Вторым параметром задается заголовок окна, которое выйдет пользователю.

Третий параметр - длина числа.

Четвертый параметр - точность.

Обратите Ваше внимание, что длина числа - это общая длина вместе с цифрами перед запятой и после запятой. В нашем случае это будет число типа 200,11 или 99,11, но никак не 1201,12.

Обязательным является только первый параметр. Потому функция вполне может быть и в таком виде:

ВвестиЧисло(А);

Листинг 2.4.12

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

79стр.<<

Введите число А

ОК Отмена

Рис. 2.4.9

Теперь перепишите все примеры, которые мы изучили в четвертой части этой главы, с возможностью ввода чисел.

Итак, мы рассмотрели основные функции, которые необходимы для повседневной работы в программе 1С. Есть и еще функции типа вычисления синуса или косинуса, но они очень редко применяемы. Кому интересно, может посмотреть соответствующий раздел справки.

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

*Резюме*

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

80стр.<<

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

Зададим три переменных типа строка (напомню, они задаются посредством написания текста в кавычках).

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

ПеремФамилия = "Иванов";

ПеремИмя = "Петр";

ПеремОтчество= "Васильевич";

КонецПроцедуры

```

Листинг 2.5.1

Первая операция, которую мы разберем, это **сложение строк**, или операция конкатенации:

```csharp

ПеремФИОПолностью = ПеремФамилия + " " + ПеремИмя + " " + ПеремОтчество;

```

Листинг 2.5.2

Добавляем процедуру Сообщить, чтобы посмотреть что получилось.

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

ПеремФамилия = "Иванов";

ПеремИмя = "Петр";

ПеремОтчество= "Васильевич";

ПеремФИОПолностью = ПеремФамилия + " " + ПеремИмя + " " + ПеремОтчество; Сообщить(ПеремФИОПолностью);

КонецПроцедуры

```

Листинг 2.5.3

Сохраните обработку, запустите и посмотрите, что вышло в окно сообщений.

Сообщения:

— Иванов Петр Васильевич

Рис. 2.5.1 81стр.<<

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

Т.е. можно написать и так:

```csharp

ПеремФИОПолностью = "Фамилия: " + ПеремФамилия + ", имя: " + ПеремИмя + ", отчество " + ПеремОтчество;

```

Листинг 2.5.4

Подправьте предыдущий код,

и в окно сообщений должна выйти следующая надпись:

Сообщения:

— Фамилия Иванов, имя Петр, отчество Васильевич

Рис. 2.5.2

Теперь рассмотрим очень интересный и нужный для нас набор системных значений - это *Символы*. Всего данный набор содержит 6 значений, и мы поочередно рассмотрим некоторые из них на примере Иванова Петра Васильевича. Добавляйте код из листингов в Вашу обработку и смотрите, что будет выходить в окно сообщений.

Первое значение - это **Возврат каретки**, т.е. текст переносится на новую строку в начало.

```csharp

ПеремФИОПолностью = ПеремФамилия + Символы.ВК + ПеремИмя + Символы.ВК + ПеремОтчество;

```

Листинг 2.5.5

— Иванов

Петр

Васильевич

Рис. 2.5.3

Следующее значение - это **Горизонтальная табуляция**, имитирует нажатие клавиши «*Tab*» на клавиатуре при написании текста.

```csharp

ПеремФИОПолностью = ПеремФамилия + Символы.Таб + ПеремИмя + Символы.Таб + ПеремОтчество;

```

Листинг 2.5.6

— Иванов Петр Васильевич

Рис. 2.5.4 82стр.<<

Продолжаем, теперь символ пробела, называется **Символ непрерывного пробела**.

```csharp

ПеремФИОПолностью = ПеремФамилия + Символы.НПП + ПеремИмя + Символы.НПП + ПеремОтчество;

```

Листинг 2.5.7

— Иванов Петр Васильевич

Рис. 2.5.5

Следующий символ, который нас интересует, это **Перенос строки**:

```csharp

ПеремФИОПолностью = ПеремФамилия + Символы.ПС + ПеремИмя + Символы.ПС + ПеремОтчество;

```

Листинг 2.5.8

— Иванов

Петр

Васильевич

Рис. 2.5.6

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

```csharp

СтрокаСПереносом = "Тут мы будем переносить строку

|вот мы на новой строке";

Сообщить(СтрокаСПереносом);

```

Листинг 2.5.9

- Тут мы будем переносить строку

вот мы на новой строке

Рис. 2.5.7

Символ *Возврат каретки* и *перенос строки* абсолютно идентичен.

Символы *Перевод формы* и *Вертикальная табуляция* в данном уроке мы рассматривать не будем. А пока поэкспериментируйте с изученным набором символов, попробуйте использовать разные комбинации символов.

У многих новичков возникает вопрос, как задать кавычки непосредственно в тексте. Сделать это очень просто. Смотрим пример: 83стр.<<

```csharp

ФИО = "Иванов Иван Иванович по кличке ""Иваныч""";

Сообщить(ФИО);

```

Листинг 2.5.10

— Иванов Иван Иванович по кличке "Иваныч"

Рис. 2.5.8

Все очень просто: пишем сдвоенные кавычки и внутри нужное слово.

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

ПеремФамилия = "Иванов";

ПеремИмя = "Петр";

ПеремОтчество= "Васильевич";

ПеремФИОПолностью = "Фамилия: " + ПеремФамилия +

, имя: + ПеремИмя +

, отчество + ПеремОтчество;

Сообщить(ПеремФИОПолностью);

ПеремФИОПолностью = ПеремФамилия + Символы.ВК +

ПеремИмя + Символы.ВК +

ПеремОтчество;

Сообщить(ПеремФИОПолностью);

ПеремФИОПолностью = ПеремФамилия + Символы.Таб +

ПеремИмя + Символы.Таб +

ПеремОтчество;

Сообщить(ПеремФИОПолностью);

ПеремФИОПолностью = ПеремФамилия + Символы.НПП +

ПеремИмя + Символы.НПП +

ПеремОтчество;

Сообщить(ПеремФИОПолностью);

ПеремФИОПолностью = ПеремФамилия + Символы.ПС +

ПеремИмя + Символы.ПС +

ПеремОтчество;

Сообщить(ПеремФИОПолностью);

СтрокаСПереносом = "Тут мы будем переносить строку

|вот мы на новой строке";

Сообщить(СтрокаСПереносом);

ФИО = "Иванов Иван Иванович по кличке ""Иваныч""";

Сообщить(ФИО);

КонецПроцедуры

```

стр89 3ред

Научимся создавать поля ввода строк на форме. Для этого мы снова забежим немного вперёд в работу с формами (см. Глава 5, часть 3, стр 320).

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

После нажатия на иконку будет создан новый реквизит формы и справа откроется палитра свойств этого реквизита.

Переименуем реквизит. Для этого в палитре свойств, которая отрыта справа, изменим поле Имя. По умолчанию в этом поле значение Реквизит1, у нас будет значение Фамилия. После изменения свойств название реквизита на закладке Реквизиты изменится.

Свойства Тип и Длина оставим такими, какими они установились по умолчанию. По умолчанию всем новым реквизитам формы устанавливается тип Строка, который нам и нужен.

Следующим шагом поместим новый реквизит на форму, для этого необходимо выделить созданный реквизит и, удерживая нажатой левую клавишу мышки, «перетащить» его на закладку Элементы левого верхнего окна формы в корень Форма.

В результате на форме появится поле ввода, которое будет связано с реквизитом формы.

Мы создали реквизит формы и можем обращаться к нему напрямую в обработчиках команд формы. Проверим это. Создадим команду, которую назовём, как всегда, ВыполнитьКоманду, и поместим её на форму.

В обработчике команды просто выведем в сообщение то, что у нас введено в поле ввода, которое связано с реквизитом формы, то есть мы выведем в сообщении значение реквизита формы.

```&НаКлиенте

Процедура ВыполнитьКомакду(Команда)

Сообщить(Фамилия);

КонецПроцедуры

```

Проверим работу новой обработки.

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

.

Разберем, каким образом пользователю вводить интерактивно (без участия формы) строки.

Для этого мы будем использовать функцию **ВвестиСтроку**. Она возвращает

*Истину*, если строка введена, и *Ложь*, если нет. В последующих главах мы узнаем, как использовать данное свойство функции.

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем ПеремФамилия;

ВвестиСтроку(ПеремФамилия,"Введите фамилию",100,Истина);

Сообщить(ПеремФамилия);

КонецПроцедуры

```

Листинг 2.5.11

Так же, как и процедура «Предупреждение», этот метод работает только в режиме включенной модальности!

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

(Введите фамилию)

Рис. 2.5.9 84стр.<<

Введите в нее любую фамилию, имя, отчество, нажмите кнопку «ОК» и посмотрите, что получится.

Разберем теперь данную функцию. Она имеет следующий синтаксис:

**ВвестиСтроку(<Строка>, <Подсказка>, <Длина>, <Многострочность>)**

Где:

«*Строка*» - это переменная, в которую мы запишем введенное пользователем значение;

«*Подсказка*» - это заголовок окна;

«*Длина*» - это длина строки, т.е. максимальное количество символов, которое поместится в окно;

«*Многострочность*» - это признак многострочности. Если он указан Истина, то можно вводить несколько строк, это, по сути, текст. Измените параметр на Истина. В результате выйдет следующее окно:

Введите фамилию

Рис. 2.5.10

Обязательным является только первый параметр. Т.е. данную функцию можно написать и так:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем ПеремФамилия;

ВвестиСтроку(ПеремФамилия);

Сообщить(ПеремФамилия);

КонецПроцедуры

```

Листинг 2.5.12

Посмотрите, что получится в этом случае. 85стр.<<

Теперь Вам небольшое задание: переделайте код, показанный выше с фамилией, именем, отчеством, так, чтобы данные значения вводились пользователем самостоятельно.

.

.

Функция **СтрДлина**

Так, с самими строками разобрались, с интерактивным вводом строк понятно - теперь перейдем к изучению функций и процедур для работы со строками.

Первая наша функция будет СтрДлина. Данная функция возвращает длину строки, т.е. количество символов в строке, включая пробелы, возвраты кареток, переносы, табуляции и т.д.

Напишите в обработке следующий код (обработку лучше создать новую):

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

#Область Функция_СтрДлина

Перем ПеремФИОПолностью;

ВвестиСтроку(ПеремФИОПолностью, "Введите ФИО",200,Истина);

ПеремДлина = СтрДлина(ПеремФИОПолностью);

Сообщить("СтрДлина (" + ПеремФИОПолностью + ") = " + ПеремДлина);

#КонецОбласти

КонецПроцедуры

```

Листинг 2.5.13

Теперь введем любое ФИО и смотрим результат:

Сообщения:

СтрДлина (Петр Николаевич Иванов) = 22

Рис. 2.5.11

Как видим, длина строки «*Петр Николаевич Иванов*» - 22 символа.

Функция простая, и каких-то особых комментариев не требуется.

.

.

Функции **СокрЛ, СокрП, СокрЛП**

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

«Иванов Иван Иванович»

И много пробелов в конце строки.

Для того чтобы отсечь все эти не нужные пробелы, есть специальные функции: 86стр.<<

**СокрЛ(<Строка>) – отсекает пробелы слева**

**СокрП(<Строка>) – отсекает пробелы справа**

**СокрЛП(<Строка>) – отсекает пробелы справа и слева**

Чтобы продемонстрировать возможность этих функций, напишите в обработке такой код:

```csharp

Процедура ВыполнитьКоманду2(Команда)

Перем НачСтроки, КонСтроки, ФИО;

НачСтроки = "НачСтр/";

КонСтроки = "/КонСтр";

ВвестиСтроку(ФИО, "Введите ФИО");

Сообщить(НачСтроки + ФИО + КонСтроки);

КонецПроцедуры

```

Листинг 2.5.14

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

Введите ФИО

Иванов Иван Алексеевич

Рис. 2.5.12

Результат должен получиться следующим:

Сообщения:

— НачСтр/ Иванов Иван Алексеевич /КонСтр

Рис. 2.5.13

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

Чтобы показать это, допишите следующий код: 87стр.<<

ФИОСокрЛ = СокрЛ(ФИО);

ФИОСокрП = СокрП(ФИО);

ФИОСокрЛП = СокрЛП(ФИО);

Сообщить("СокрЛ: " + НачСтроки + ФИОСокрЛ + КонСтроки);

Сообщить("СокрП: " + НачСтроки + ФИОСокрП + КонСтроки);

Сообщить("СокрЛП: " + НачСтроки + ФИОСокрЛП + КонСтроки);

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

#Область Функции_СокрЛ_СокрП_СокрЛП

Перем НачСтроки, КонСтроки, ФИО;

НачСтроки = "НачСтр/";

КонСтроки = "/КонСтр";

ВвестиСтроку(ФИО, "Введите ФИО");

Сообщить(НачСтроки + ФИО + КонСтроки);

ФИОСокрЛ = СокрЛ(ФИО);

ФИОСокрП = СокрП(ФИО);

ФИОСокрЛП = СокрЛП(ФИО);

Сообщить("СокрЛ: " + НачСтроки + ФИОСокрЛ + КонСтроки);

Сообщить("СокрП: " + НачСтроки + ФИОСокрП + КонСтроки);

Сообщить("СокрЛП: " + НачСтроки + ФИОСокрЛП + КонСтроки);

#КонецОбласти

КонецПроцедуры

```

Листинг 2.5.15

Посмотрите, как должно получиться:

Посмотрите, как должно получиться:

— СокрЛ: НачСтр/Иванов Иван Алексеевич /КонСтр

— СокрЛ: НачСтр/ Иванов Иван Алексеевич/КонСтр

— СокрЛП: НачСтр/Иванов Иван Алексеевич/КонСтр

Рис. 2.5.14

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

Используйте данные функции в том коде, где Вы вводите ФИО отдельно, попробуйте ставить лишние пробелы, и посмотрите, что из этого у Вас получится.

.

.

Функции **Лев, Прав**

Рассмотрим функции Лев и Прав.

Данные функции выбирают нужное количество символов слева и справа строки соответственно.

Рассмотрим функцию Лев. Данная функция выбирает слева нужное количество символов. Она пишется в таком виде:

**Лев(<Строка>,<КоличествоСимволов>)**

Где:

«*Строка*» – та строка, которую функция обрабатывает;

«*КоличествоСимволов*» – количество символов, которые будут выбраны.

Разберем это на уже знакомом примере с фамилиями. Внесите в Вашу обработку следующий код: 88стр.<<

```csharp

Процедура ВыполнитьКоманду3(Команда)

ПеремФамилия = "Иванов";

ПеремИмя = "Петр";

ПеремОтчество = "Сергеевич";

ФИОКратко = ПеремФамилия + " " +

Лев(ПеремИмя,1) + ". " +

Лев(ПеремОтчество,1) + ".";

Сообщить(ФИОКратко);

КонецПроцедуры

```

Рис. 2.5.15

Выйти должна следующая строка:

Сообщения:

— Иванов П. С

Рис. 2.5.16

Рассмотрим другой пример.

Имеем, к примеру, автомобильные номера вида «ва345укRU23». По условиям задачи код региона всегда будет состоять из двух символов. Надо получить номер без кода региона.

```csharp

Номер = "ва345укRU23";

НомерБезКода = Лев(Номер,7);

Сообщить(НомерБезКода);

```

Листинг 2.5.16

Смотрим.

Данный код должен выводить следующий результат:

Сообщения:

— ва345ук

Рис. 2.5.17

Теперь перейдем к функции Прав. Эта функция выбирает справа нужное количество символов. Она пишется в таком виде:

**Прав(<Строка>,<Количество символов>)**

Где:

*«Строка*» – та строка, которую функция обрабатывает.

«*Количество символов*» – количество символов, которые будут выбраны.

Рассмотрим ее на нашем примере с номером, только на этот раз получим код региона. 89стр.<<

```csharp

Номер = "ва345укRU23";

КодРегиона = Прав(Номер,4);

Сообщить(КодРегиона);

```

Листинг 2.5.17

Данный код должен выводить следующий результат:

Сообщения:

- RU23

Рис. 2.5.18

А теперь, используя функцию *Лев* и *Прав*, получите три цифры номера.

Рассмотрим другой пример, который использует также функцию СтрДлина. Иногда некоторые поставщики товар выгружают с артикулом перед наименованием, выглядит это, к примеру, так:

**«34221 Ручка шариковая» или**

**«23444 Тетрадь в клетку, 12 листов»**

Мы знаем, что артикул всегда состоит из 5 символов, нам надо их отсечь. Как это сделать?

Для этого нам надо отобрать справа количество символов, равное длине названия без артикула. Сделать это необходимо так: узнать длину строки и вычесть из нее 5 (длина артикула априори всегда такая).

Товар1 = "34221 Ручка шариковая";

Товар2 = "23444 Тетрадь в клетку, 12 листов";

НаимТовар1 = СокрЛП(Прав(Товар1,СтрДлина(Товар1) - 5));

НаимТовар2 = СокрЛП(Прав(Товар2,СтрДлина(Товар2) - 5));

Сообщить(НаимТовар1);

Сообщить(НаимТовар2);

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду3(Команда)

#Область Функция_ЛЕВ

ПеремФамилия = "Иванов";

ПеремИмя #ERROR!

ПеремОтчество = "Сергеевич";

ФИОКратко = ПеремФамилия + " " +

Лев(ПеремИмя,1) + ". " +

Лев(ПеремОтчество,1) + ".";

Сообщить(ФИОКратко);

Номер = "ва345укRU23";

НомерБезКода = Лев(Номер,7);

Сообщить(НомерБезКода);

#КонецОбласти

#Область функция_ПРАВ

Номер = "ва345укRU23";

КодРегиона = Прав(Номер,4);

Сообщить(КодРегиона);

Товар1 = "34221 Ручка шариковая";

Товар2 = "23444 Тетрадь в клетку, 12 листов";

НаимТовар1 = СокрЛП(Прав(Товар1,СтрДлина(Товар1) - 5));

НаимТовар2 = СокрЛП(Прав(Товар2,СтрДлина(Товар2) - 5));

Сообщить(НаимТовар1);

Сообщить(НаимТовар2);

#КонецОбласти

КонецПроцедуры

```

Листинг 2.5.18

На выходе должны получиться следующие строки:

Сообщения:

— Ручка шариковая

— Тетрадь в клетку. 12 листов

Рис. 2.5.19 90стр.<<

Пытливый читатель спросит, почему я вычел 5, а не 6 вместе с пробелом, а потом не применил функцию *СокрЛП*. Дело в том, что в условиях задачи сказано, что длина артикула 5, а не 6. То, что между артикулом и названием стоит пробел, это не более чем особенность выгрузки.

Может вполне быть и так:

Товар1 = "34221 Ручка шариковая";

Товар2 = "23444Тетрадь в клетку, 12 листов";

Что тогда получится, если Вы будете вычитать из длины 6?

А теперь потренируйтесь и получите отдельно артикул и отдельно общее наименование и выведите это в окно сообщений.

.

.

Функция **Сред**

В предыдущем примере я Вас попросил получить из номера три цифры, используя функции Прав и Лев. Сейчас я расскажу, как можно это сделать проще. Для этого мы будем использовать функцию Сред. Данная функция выберет из строки нужное количество символов, начиная с определенного номера. Она имеет следующий синтаксис:

**Сред(<Строка>,<Номер первого символа>, <Количество выбираемых символов>)**

Разберем данную функцию подробно.

«Строка» – это наша строка.

«Номер первого символа» - это номер, с которого начинается наша выборка.

«Количество выбираемых символов» - это количество выбираемых символов.

Теперь измените пример с номером:

```csharp

Номер = "ва345укRU23";

НомерЦифры = Сред(Номер,3,3);

Сообщить(НомерЦифры);

```

Листинг 2.5.19

И посмотрите, как работает данный код.

Разберем еще один пример со знакомыми нам уже артикулами: 91стр.<<

```csharp

Товар1 = "34221 Ручка шариковая";

Товар2 = "23444 Тетрадь в клетку, 12 листов";

Артикул1 = Сред(Товар1,1,5);

Артикул2 = Сред(Товар2,1,5);

Сообщить(Артикул1);

Сообщить(Артикул2);

```

Листинг 2.5.20

В этом примере также первый параметр в функциях «Сред» – наша строка, второй - это начало артикула (это первый символ), а третий – длина самого артикула.

Сообщения:

-34221

-23444

Рис. 2.5.20

Теперь задание. Используя данную функцию, получите название товара. Подсказка: нужно применять функцию СтрДлина.

.

.

Продолжаем изучение функций строк, и следующая функция - это СтрНайти. Данная функция находит вхождение искомой подстроки в строку поиска и возвращает номер первого символа искомой подстроки в строке поиска. Если подстрока не найдена, возвращается 0.

Продолжаем изучение функций строк, и следующая функция - это Найти. Данная функция находит вхождение искомой подстроки в строку поиска и возвращает номер первого символа искомой подстроки в строке поиска. Если подстрока не найдена, возвращается 0.

Функция имеет следующий синтаксис

**СтрНайти(<Исходная строка>,<Строка поиска>)**

Где:

«Исходная строка» – строка, в которой будем искать подстроку;

«Строка поиска»– сама подстрока поиска.

Теперь запишите в Вашей обработке следующий код:

```csharp

Номер = "ва345укRU23";

НомерНачRU = Найти(Номер,"RU");

Сообщить(НомерНачRU);

```

Листинг 2.5.21

Запустите обработку, и Вы увидите, что функция возвратила цифру 8. Это и есть номер символа, с которого начинается наша искомая строка. 92стр.<<

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

Рассмотрим еще пример. Уже более практичный. Нам необходимо отделить имя от фамилии в строке.

Напишите следующий код в форме Вашей обработки:

```csharp

ФамилияИмя1 = "Иванов Алексей";

ФамилияИмя2 = "Маликова Анна";

НомПроб1 = Найти(ФамилияИмя1," ");

НомПроб2 = Найти(ФамилияИмя2," ");

Имя1 = Сред(ФамилияИмя1, НомПроб1 + 1, СтрДлина(ФамилияИмя1) - НомПроб1 + 1);

Имя2 = Сред(ФамилияИмя2, НомПроб2 + 1, СтрДлина(ФамилияИмя2) - НомПроб2 + 1);

Сообщить(Имя1);

Сообщить(Имя2);

```

Листинг 2.5.22

Разберем данный код. Первое, мы вычислили номер первого пробела. Теперь нам необходимо, зная эту информацию, получить имя контрагента. Используем функцию Сред. Первый параметр – наша строка, второй параметр - номер пробела плюс один (поскольку имя начинается со следующего символа, то прибавим единицу), а третий параметр - это длина оставшегося имени. Ее мы получим, если вычтем из общей длины строки номер, с которого начинается пробел, и прибавим единицу (нам не нужна длина вместе с пробелом).

Сообщения:

— Алексей

— Анна

Рис. 2.5.21

Теперь используя данную функцию получите фамилию контрагента.

.

.

Функция **СтрЗаменить**

Еще одна функция, которая нам тоже много будет помогать, это функция СтрЗаменить. Данная функция ищет определенную подстроку, и если она найдена, то меняет ее на другую подстроку. Она имеет следующий синтаксис: 93стр.<<

**СтрЗаменить(<Строка>,<Подстрока поиска>,<Подстрока замены>)**

Где:

«*Строка*» - это та строка, с которой ведется работа;

«*ПодСтрокаПоиска*» – та строка, которую нужно найти;

«*ПодСтрокаЗамены*» – на что будет заменена «ПодСтрокаПоиска», если будет найдена.

Сделайте следующий пример:

```csharp

ФИО = "Иванов Петр Григорьевич";

ФИОСлит = СтрЗаменить(ФИО," ","");

ФИОСлит2 = СтрЗаменить(ФИО," ","_");

Сообщить(ФИОСлит);

Сообщить(ФИОСлит2);

```

Листинг 2.5.23

В заданной строке мы либо вообще уберем пробел, либо заменим его символом подчеркивания. Посмотрите, как он у Вас выполнится.

— ИвановПетрГригорьевич

— Иванов_Петр_Григорьевич

Рис. 2.5.22

Еще пара примеров на данную функцию:

```csharp

МногоСтрок = "Первая строка

|Вторая строка

|Третья строка";

ОднаСтрока = СтрЗаменить(МногоСтрок,Символы.ПС,Символы.НПП); Сообщить(ОднаСтрока);

```

Листинг 2.5.24

Теперь, наоборот, допишем к вышеприведенному коду:

```csharp

МногоСтрок2 = СтрЗаменить(ОднаСтрока,Символы.НПП,Символы.ПС);

Сообщить(МногоСтрок2);

```

Листинг 2.5.25

Самостоятельно в ФИО, сделайте Фамилию Имя и Отчество на новой строке, и чтобы после каждого слова стояла точка.

94стр.<<

Функция СтрЧислоВхождений

Немного похожая функция - это **СтрЧислоВхождений**. Она вычисляет число вхождений строки поиска в заданной строке.

Имеет следующий синтаксис:

**СтрЧислоВхождений(<Строка>,<Подстрока Поиска>)**

«Строка» - это та строка, с которой работает данная функция.

«Подстрока поиска» - это строка, количество вхождений которой вычисляет данная функция.

Рассмотрим пример:

```csharp

ФИО = "Иванов Петр Григорьевич";

ЧислоПробелов = СтрЧислоВхождений(ФИО," ");

Сообщить("Пробел встречается в строке " + ЧислоПробелов + " раз");

```

Листинг 2.5.26

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

Сейчас мы рассмотрим функции для работы с многострочными строками.

Это функции СтрЧислоСтрок и СтрПолучитьСтроку.

.

.

Функция **СтрЧислоСтрок**

Начнем с функции СтрЧислоСтрок.

**СтрЧислоСтрок(<Строка>)**

Она имеет только один параметр - это сама строка, а возвращает количество строк в заданной строке, если она многострочная. И 1, если это одна строка.

Сделайте пример с использованием данной функции: 95стр.<<

```csharp

МногоСтрок = "Первая строка

|Вторая строка

|Третья строка";

КолСтрок1 = СтрЧислоСтрок(МногоСтрок);

Сообщить(МногоСтрок);

Сообщить("В этой строке " + КолСтрок1 + " строки");

ОднаСтрока = СтрЗаменить(МногоСтрок,Символы.ПС,Символы.НПП); КолСтрок2 = СтрЧислоСтрок(ОднаСтрока);

Сообщить(ОднаСтрока);

Сообщить("В этой строке " + КолСтрок2 + " строки");

```

Листинг 2.5.27

У Вас должен получиться следующий результат:

Сообщения:

— Первая строка Вторая строка Третья строка

— В этой строке 3 строки

— Первая строка Вторая строка Третья строка

— В этой строке 1 строки

Рис. 2.5.23

Эта функция простая, и у Вас не должно возникнуть вопросов.

Следующая функция СтрПолучитьСтроку. Эта функция получает из многострочной строки строку с заданным номером.

Она имеет следующий синтаксис:

**СтрПолучитьСтроку(<Строка>,<Номер строки>)**

Где:

«Строка» - это заданная строка;

«Номер строки» - номер строки, которая будет возвращена (нумерация строк ведется с 1).

Если номер будет больше количества строк или равен нулю, то ничего не вернется, при этом ошибки тоже не будет. Функция вернет пустую строку.

Сделайте в Вашей обработке следующий пример:

```csharp

МногоСтрок =

"Первая строка

|Вторая строка

|Третья строка;"

ВтораяСтрока = СтрПолучитьСтроку(МногоСтрок,2);

Сообщить(ВтораяСтрока);

```

Листинг 2.5.28 96стр.<<

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

Посмотрите самостоятельно, как будет работать этот код.

Небольшое задание: поразбивайте, как мы это делали прежде, ФИО на строки, и получите какую-нибудь строку с помощью этой функции. Номер строки можете задавать интерактивно с помощью функции ВвестиЧисло. Сделайте так, чтобы пользователь мог вводить только целые числа.

.

.

Теперь рассмотрим три очень похожие функции – **НРег, ВРег, ТРег**.

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

Задаются они очень просто:

**НРег(<Строка>)

ВРег(<Строка>)

ТРег(<Строка>)**

Сделайте следующий пример:

```csharp

ФИО = "Иванов Петр Григорьевич";

ФИОВРег = ВРег(ФИО);

ФИОНРег = НРег(ФИО);

ФИОТРег = ТРег(ФИО);

Сообщить(ФИОВРег);

Сообщить(ФИОНРег);

Сообщить(ФИОТРег);

```

Листинг 2.5.29

Результат должен быть следующим:

Сообщения:

— ИВАНОВ ПЕТР ГРИГОРЬЕВИЧ

— Иванов петр Григорьевич

— Иванов Петр Григорьевич

Рис. 2.5.24 97стр.<<

Функции простые. Теперь небольшое задание. В предыдущем примере, где несколько строк, приведите первую строку в верхний регистр, вторую - в нижний регистр, третью - в титульный регистр.

.

.

И самая последняя функция, которую мы рассмотрим, будет **ПустаяСтрока**.

Она имеет один параметр - саму строку, и **возвращает Истина, если строка пустая, и возвращает Ложь, если строка содержит символы**.

Пустую строку можно задать, написав сдвоенные кавычки : "", пробела между ними быть не должно.

Сделайте следующий пример:

```csharp

ФИО = "Иванов Петр Григорьевич";

ФИО2 = "";

ПризнакПустСтр1 = ПустаяСтрока(ФИО);

ПризнакПустСтр2 = ПустаяСтрока(ФИО2);

Сообщить(ПризнакПустСтр1);

Сообщить(ПризнакПустСтр2);

```

Листинг 2.5.30

И посмотрите, что у нас получается.

Резюме

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

98стр.<<

Наша дата—ТОЛЬКО датуу, в ноле Наше время — только время, а в ноле Наша дата и время — дату и время.

Функция ВвестиДату

Итак, в этой части нашей главы мы разберем переменные типа Дата.

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

Из первой части мы знаем, что переменные вводятся либо в виде 'ГГГГММДДччммсс', либо в виде 'ГГГГММДД' (см. стр. 56). Сейчас мы рассмотрим, как их вводить интерактивно и в дальнейшем в этой части главы все переменные типа Дата будем вводить интерактивно.

***

**Функция ВвестиДату**

Первым делом мы рассмотрим функцию **ВвестиДату**. Она возвращает Истина, если введена дата, или Ложь, если нет.

Данная функция имеет следующий синтаксис:

**ВвестиДату(<Дата>, <Подсказка>, <ЧастьДаты>)**

Где:

«Дата» - это переменная, в которую будет записана дата;

«Подсказка» – текстовая строка - интерактивная подсказка на форме;

«Часть даты» – задает то, в каком виде будет записана дата.

Разберем последний параметр подробно.

Он задается в виде системного перечисления ЧастьДаты, у которого имеются три значения: Время, Дата и ДатаВремя.

**ЧастьДаты.Время

ЧастьДаты.Дата

ЧастьДаты.ДатаВремя**

Для лучшего понимания выполните следующий пример:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату", ЧастиДаты.Дата);

Сообщить(НашаДата);

КонецПроцедуры

```

Листинг 2.6.1 99стр.<<

Разберем данный код.

Сначала мы задаем переменную. Потом пишем функцию для интерактивного ввода даты, где первым параметром задаем вновь созданную дату, вторым - заголовок интерактивного окна, третьим – в каком виде будет задаваться дата пользователем.

Запустите обработку и введите любую дату.

Введите дату

22.10.2017

Рис. 2.6.1

Изменим значение третьего параметра на *ЧастиДаты.ДатаВремя*, и посмотрим, в каком формате Вы сможете вводить дату (самостоятельно попробуйте со значением *ЧастиДаты.Время*).

Введите дату

22.10.2017 22:11:22

Рис. 2.6.2

Нажимаем кнопку «ОК», и выходит следующее сообщение:

Сообщения:

- 22.10.2017 22:11:22

Рис. 2.6.3

Это не очень красиво и читаемо. Так получилось, потому что функция Сообщить конвертировала дату в строку, один к одному как есть. Чтобы такого не происходило, мы разберем функцию, которая будет конвертировать тип Дата в тип Строка по нужным нам правилам. 100стр.<<

.

.

Функция **Формат**

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

У данной функции следующий синтаксис:

**Формат(<Значение>, <ФорматнаяСтрока>)**

Где:

«Значение» – это значение нашей переменной;

«ФорматнаяСтрока» – строковое значение, которое включает в себя параметры вывода на экран.

Рассмотрим функцию применительно к датам. Для этого сделайте следующий пример:

```csharp

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату", ЧастиДаты.ДатаВремя);

НашаДатаСтрока = Формат(НашаДата,"ДФ = ""дд.ММ.гггг""");

Сообщить(НашаДатаСтрока);

```

Листинг 2.6.2

Посмотрите, как дата вышла в окно сообщений:

Сообщения

- 22.12.2016

Рис. 2.6.4

Разберем форматную строку применительно к датам. Как Вы видите, данная форматная строка имеет тип «Строка».

У любой форматной строки в данной функции должно быть имя. В рассматриваемом случае оно - **ДФ**. И значение - "**дд.ММ.гггг**". Поскольку значение должно быть в кавычках, и мы знаем из предыдущей части, что кавычки внутри строки задаются двойными кавычками, то мы ставим двойные кавычки вокруг значения. Если бы мы вводили значение интерактивно, то оно имело бы следующий вид ДФ="дд.ММ.гггг".

Рассмотрим имена форматной строки для даты.

ДФ – формат даты. Данный формат можно компоновать из множества различных

значений. Все значения: 101стр.<<

o д (d) - день месяца (цифрами) без лидирующего нуля;

o дд (dd) - день месяца (цифрами) с лидирующим нулем;

o ддд (ddd) - краткое название дня недели *);

o дддд (dddd) - полное название дня недели *);

o М (M) - номер месяца (цифрами) без лидирующего нуля;

o ММ (MM) - номер месяца (цифрами) с лидирующим нулем;

o МММ (MMM) - краткое название месяца *);

o ММММ (MMMM) - полное название месяца *);

o к (q) - номер квартала в году;

o г (y) - номер года без века и лидирующего нуля;

o гг (yy) - номер года без века с лидирующим нулем;

o гггг (yyyy) - номер года с веком;

o ч (h) - час в 12-часовом варианте без лидирующих нулей;

o чч (hh) - час в 12-часовом варианте с лидирующим нулем;

o Ч (H) - час в 24-часовом варианте без лидирующих нулей;

o ЧЧ (HH) - час в 24-часовом варианте с лидирующим нулем;

o м (m) - минута без лидирующего нуля;

o мм (mm) - минута с лидирующим нулем;

o с (s) - секунда без лидирующего нуля;

o сс (ss) - секунда с лидирующим нулем;

o вв (tt) - отображение половины дня AM/PM (действительно только для языков конфигурирования, поддерживающих 12-часовой вариант представления времени).

Регистр в данном написании важен!

Запоминать эти значения не нужно, их можно найти в синтаксис-помощнике функции «Формат» (для того чтобы перейти в синтаксис-помощник нужной функции, необходимо установить курсор на эту функцию и нажать комбинацию клавиш Ctrl+F1, в появившемся списке выбрать пункт «Глобальный контекст/Функции форматирования/Формат»).

Теперь о том, как компоновать формат даты из них. Делается это очень просто.

Можем написать вот так:

**Формат(НашаДата,"ДФ = ""дд- ММММ-гггг """);**

**Формат(НашаДата,"ДФ = ""ММММ-гггг """);**

Или даже вот так:

**Формат(НашаДата,"ДФ = ""ММММ-гггг/дд(гг) """);**

Т.е. в этих кавычках значения Вы можете скомпоновать любую дату или время так, как Вам нравится, но не рекомендую использовать слова и буквы, чтобы не получился такой казус: 102стр.<<

```csharp

НашаДатаСтрока = Формат(НашаДата,"ДФ = ""День: дд, месяц: ММММ""");

```

Листинг 2.6.3

Запускаем. Вот как некрасиво вышло:

Сообщения:

- День 20. ОеОяц Октябрь

Рис. 2.6.5

Поэтому используйте только спецсимволы.

Рассмотрим следующее имя - **ДЛФ**, это локальный формат даты, который указывает вариант отображения частей даты. Их всего пять значений:

Д – дата цифрами

ДД – дата с месяцем прописью

ДВ – дата с временем

В - время

ДДВ – дата с месяцем прописью и временем.

В этом варианте нет таких широких возможностей для творчества. Задается все просто.

Например: ДЛФ = ДД.

Сделайте следующий пример:

```csharp

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату", ЧастиДаты.ДатаВремя);

НашаДатаСтрока = Формат(НашаДата,"ДЛФ = Д"); Сообщить(НашаДатаСтрока);

НашаДатаСтрока = Формат(НашаДата,"ДЛФ = ДД"); Сообщить(НашаДатаСтрока);

НашаДатаСтрока = Формат(НашаДата,"ДЛФ = ДВ"); Сообщить(НашаДатаСтрока);

НашаДатаСтрока = Формат(НашаДата,"ДЛФ = В"); Сообщить(НашаДатаСтрока);

НашаДатаСтрока = Формат(НашаДата,"ДЛФ = ДДВ"); Сообщить(НашаДатаСтрока);

```

Листинг 2.6.4

Введем следующее значение: 103стр.<<

Введите дату

20.07.2007 13:30:35

Рис. 2.6.6

И получим такой результат:

— 20.07.2007

— 20 июля 2007 г

— 20.07.2007 13:30:35

— 13:30:35

— 20 июля 2007 г. 13:30:35

Рис. 2.6.7

.

.

В платформе 8.3 есть возможность не **набирать форматную строку вручную, а использовать для этих целей конструктор** форматной строки. Чтобы создать форматную строку при помощи конструктора форматной строки, нужно во втором параметре функции Формат написать две кавычки и поставить между ними курсор (см. рис. 2.6.8).

```Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату", ЧастиДаты.ДатаВремя);

НашаДатаСтрока - Формат(НашаДата,"I");

``` Рис. 2.6.8

После этого вызвать контекстное меню, нажав правую клавишу мышки, где выбираем пункт «Конструктор форматной строки» (см. рис. 2.6.9).

104стр.<<

Конструктор Форматной строки...

Рис. 2.6.9

В открывшемся конструкторе нас интересует закладка «Дата», в которой Вы можете выбрать как свободный формат даты, так и локальный (см. рис. 2.6.10).

Рис. 2.6.10

После нажатия кнопки «ОК» нужный формат даты встанет в форматную строку (см. рис. 2.6.11).

ДФ="dd/ММ/уу"

Рис. 2.6.11

Итак, мы рассмотрели, как нам красиво выводить даты на экран, следующим шагом перейдем непосредственно к функциям, работающим с датами.

105стр.<<

Вычитание дат

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

Рассмотрим пример:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду4(Команда)

Перем Дата1, Дата2;

ВвестиДату(Дата1,"Введите первую дату", ЧастиДаты.ДатаВремя);

ВвестиДату(Дата2,"Введите вторую дату", ЧастиДаты.ДатаВремя);

РазницаДат = Дата1 - Дата2;

Сообщить("Между " + Формат(Дата1,"ДЛФ=DT") + "

|и " + Формат(Дата2,"ДЛФ=DT") + "

| " + РазницаДат + " секунд");

КонецПроцедуры

```

Листинг 2.6.5

Выведем результат на экран.

Сообщения:

- Между 12.09.2016 22:32.22

и 10.08.2015 23:10:00

34 471 342 секунд

Рис. 2.6.12

Понятно, что количество секунд - это не информативные данные, а как узнать ровное количество дней между датами, мы узнаем немного позже. Наберитесь терпения.

.

.

Функции **Год, Месяц, День, Час, Минута, Секунда**

Рассмотрим ряд похожих функций для работы с типом дата.

Это функции:

**Год(<Дата>), Месяц(<Дата>), День(<Дата>),

Час(<Дата>), Минута(<Дата>), Секунда(<Дата>)**

У данных функций один параметр – дата, а возвращают они число, которое соответствует году, месяцу, дню, часу, минуте и секунде соответственно. Рассмотрим пример для наглядности.106стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду5(Команда)

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату", ЧастиДаты.ДатаВремя);

ПеремГод = Год(НашаДата);

ПеремМес = Месяц(НашаДата);

ПеремДень = День(НашаДата);

ПеремЧас = Час(НашаДата);

ПеремМин = Минута(НашаДата);

ПеремСек = Секунда(НашаДата);

Сообщить("В дате " + Формат(НашаДата,"ДЛФ=DT") + "

|Год - " + ПеремГод + "

|Месяц - " + ПеремМес + "

|День - " + ПеремДень+ "

|Час - " + ПеремЧас + "

|Минута - " + ПеремМин + "

|Секунда - " + ПеремСек);

КонецПроцедуры

```

Листинг 2.6.6

На выходе должен получиться следующий результат:

- В дате 12.09.2012 23.10.12

Год - 2 012

Месяц - 9

День - 12

Час - 23

Минута - 10

Секунда -12

Рис. 2.6.13

.

Функции НачалоГода, НачалоДня, НачалоКвартала, НачалоМесяца, НачалоНедели, НачалоЧаса, НачалоМинуты

Теперь рассмотрим еще ряд похожих друг на друга функций. Это:

**НачалоГода(<Дата>), НачалоКвартала(<Дата>),

НачалоМесяца(<Дата>), НачалоНедели(<Дата>),

НачалоДня(<Дата>), НачалоЧаса(<Дата>),

НачалоМинуты(<Дата>)**

107стр.<<

Все они возвращают дату и время начала периода, именем которого они называются. Т.е. если мы берем эту дату 12.09.2012, то функция *НачалоГода* возвратит дату 01.01.2012, а функция **НачалоНедели** возвратит дату 10.09.2012. Чтобы было наглядно, мы рассмотрим очень простой пример:

```csharp

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату", ЧастиДаты.ДатаВремя);

ДатаНачГода = НачалоГода(НашаДата);

ДатаНачКвартала = НачалоКвартала(НашаДата);

ДатаНачМесяца = НачалоМесяца(НашаДата);

ДатаНачНедели = НачалоНедели(НашаДата);

ДатаНачДня = НачалоДня(НашаДата);

ДатаНачЧаса = НачалоЧаса(НашаДата);

ДатаНачМинуты = НачалоМинуты(НашаДата);

НашаДатаФормат = Формат(НашаДата,"ДЛФ=DT");

Сообщить ("Мы ввели дату " + НашаДатаФормат);

Сообщить ("НачалоГода( " + НашаДатаФормат + " ) = " + ДатаНачГода);

Сообщить ("НачалоКвартала( " + НашаДатаФормат + " ) = " + ДатаНачКвартала);

Сообщить ("НачалоМесяца( " + НашаДатаФормат + " ) = " + ДатаНачМесяца);

Сообщить ("НачалоНедели( " + НашаДатаФормат + " ) = " + ДатаНачНедели);

Сообщить ("НачалоДня( " + НашаДатаФормат + " ) = " + ДатаНачДня);

Сообщить ("НачалоЧаса( " + НашаДатаФормат + " ) = " + ДатаНачЧаса);

Сообщить ("НачалоМинуты( " + НашаДатаФормат + " ) = " + ДатаНачМинуты);

```

Листинг 2.6.7

Посмотрим, какой результат на выходе.

Сообщения:

- Мы ввели дату 12.09.2006 15:10:56

- НачапоГода( 12.09.2006 15:10:56 ) = 01.01.2006 0:00:00

- НачапоКвартала( 12 09.2006 15:10:56 ) = 01.07.2006 0:00:00

- НачапоМесяца( 12.09.2006 15:10:56 ) = 01.09.2006 0:00:00

- НачапоНедепи( 12.09.2006 15:10:56 ) = 11.09.2006 0:00:00

- НачапоДня( 12.09.2006 15:10:56 ) = 12.09.2006 0:00:00

- НачапоЧаса( 12 09 2006 15Ю56 ) = 12 09 2006 15 00 00

- НачапоМинуты( 12.09.2006 15:10:56 ) = 12.09.2006 15:10:00

Рис. 2.6.14

Еще один пример. Есть у нас две даты, и нужно получить количество дней между ними, причем сразу целое. Можно, конечно, вычесть даты, потом поделить 3600, умноженное на 24, и округлить до целого. Но я не рекомендую Вам это делать, т.к. разница между датами 108стр.<<

12 августа 2012 23:59:59, и 13 августа 2012 07:33:40 будет меньше одного дня, и при округлении или выделении целого получится 0.

Поэтому лучше сделать все проще. Получить начало дня первой даты, потом начало дня второй даты и вычесть первую из второй.

Посмотрим пример, демонстрирующий это:

```csharp

Перем Дата1, Дата2;

ВвестиДату(Дата1,"Введите первую дату", ЧастиДаты.ДатаВремя);

ВвестиДату(Дата2,"Введите вторую дату", ЧастиДаты.ДатаВремя);

Дата1НачалоДня = НачалоДня(Дата1);

Дата2НачалоДня = НачалоДня(Дата2);

КолДней = (Дата1НачалоДня - Дата2НачалоДня)/(3600*24);

Сообщить("Между " + Формат(Дата1,"ДЛФ=DT") + " и

|" + Формат(Дата2,"ДЛФ=DT") + " " + КолДней + " дней");

```

Листинг 2.6.8

Результат должен получиться следующим:

Сообщения:

- Между 12 10 2016 23 00 00 и 02.09 2016 12:50:00 40 дней

Рис. 2.6.15

.

.

Функции **КонецГода, КонецДня, КонецКвартала, КонецМесяца, КонецНедели, КонецЧаса, КонецМинуты**

Теперь рассмотрим противоположные функции, это:

**КонецГода(<Дата>), КонецКвартала(<Дата>),

КонецМесяца(<Дата>), КонецНедели(<Дата>),

КонецДня(<Дата>), КонецЧаса(<Дата>) и

КонецМинуты(<Дата>)**

Все они возвращают дату и время конца периода, именем которого они называются.

Т.е. если мы берем эту дату 12.09.2012 12.12.02, то функция КонецГода возвратит дату 31.12.2012 23.59, а функция КонецНедели возвратит дату 16.09.2012 23.59.59. Рассмотрим очень простой пример: 109стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду7(Команда)

Перем НашаДата;

ВвестиДату(НашаДата,"ВведитеДату",ЧастиДаты.ДатаВремя);

ДатаКонецГода = КонецГода(НашаДата);

ДатаКонецКвартала = КонецКвартала(НашаДата);

ДатаКонецМесяца = КонецМесяца(НашаДата);

ДатаКонецНедели = КонецНедели(НашаДата);

ДатаКонецДня = КонецДня(НашаДата);

ДатаКонецЧаса = КонецЧаса(НашаДата);

ДатаКонецМинуты = КонецМинуты(НашаДата);

НашаДатаФормат = Формат(НашаДата,"ДЛФ = ДДВ");

Сообщить("Мы ввели дату " + НашаДатаФормат);

Сообщить("КонецГода("+ НашаДата + ") = " + ДатаКонецГода);

Сообщить("КонецКвартала("+ НашаДата + ") = " + ДатаКонецКвартала);

Сообщить("КонецМесяца(" + НашаДата + ") = " + ДатаКонецМесяца);

Сообщить("КонецНедели(" + НашаДата + ") = " + ДатаКонецНедели);

Сообщить("КонецДня(" + НашаДата + ") = " + ДатаКонецДня);

Сообщить("КонецЧаса(" + НашаДата + ") = " + ДатаКонецЧаса);

Сообщить("КонецМинуты(" + НашаДата + ") = " + ДатаКонецМинуты);

КонецПроцедуры

```

Листинг 2.6.9

- Мы ввели дату 10 сентября 2006 г. 20:12:50

- КонецГода(10.09.2006 20.12.50) -3112.2006 23.59.59

- КонецКвартала(10.09 2006 20:12:50) = 30.09.2006 23:59:59

- КонецМесяца(10.09.2006 20:12:50) = 30.09.2006 23:59:59

- КонецНедели(10.09.2006 20:12:50) = 10.09.2006 23:59:59

- КонецДня(10.09.2006 20:12:50) = 10.09.2006 23:59:59

- КонецЧаса(10.09.2006 20:12:60) = 10.09.2096 20:59:59

- КонецМинуты(10.09.2006 20:12:50) = 10.09.2006 20:12:59

Рис. 2.6.16

Для тренировки попробуйте разницу дат сделать с помощью функции КонецДня.

.

.

Функции **ДеньГода, ДеньНедели, НеделяГода**

Рассмотрим еще три похожие функции, это:

**ДеньГода(<Дата>)

ДеньНедели(<Дата>)

НеделяГода(<Дата>)** 110стр.<<

У них один параметр, и они возвращают соответственно номер дня года, номер дня недели и номер недели года указанной даты.

Рассмотрим простой пример:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду8(Команда)

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату",ЧастиДаты.Дата);

НомерДняГода = ДеньГода(НашаДата);

НомерДняНедели = ДеньНедели(НашаДата);

НомерНеделиГода = НеделяГода(НашаДата);

Сообщить("День " + Формат(НашаДата,"ДЛФ = ДД") + " является |" + НомерДняГода + " днем в году. |" + НомерДняНедели + " днем в недели. |Неделя этого дня: " + НомерНеделиГода + " неделя в году.");

КонецПроцедуры

```

Листинг 2.6.10

Выводим все это на экран.

Сообщения:

День 20 августа 2015 г является

232 днем в году.

4 днем в недели.

Неделя этого дня: 34 неделя в году.

Рис. 2.6.17

.

.

**Функция ДобавитьМесяц**

Разберем очень важную функцию для работы с датами - это функция **Добавить месяц**.

Она имеет следующий синтаксис:

**ДобавитьМесяц(<Дата>,<Количество мМесяцев>)**

Дата - это заданная дата.

Количество месяцев - этот параметр имеет тип число – количество месяцев, которые прибавляются или отнимаются (если число отрицательное) от заданной даты.

Рассмотрим пример. Пользователь задает некоторую дату, и нам надо получить начало следующего месяца после этой даты, начало следующего квартала и начало следующего года. 111стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду9(Команда)

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату",ЧастиДаты.Дата);

НачалоТекущегоМесяца = НачалоМесяца(НашаДата);

НачалоСледующегоМесяца = ДобавитьМесяц(НачалоТекущегоМесяца,1);

НачалоТекущегоКвартала = НачалоКвартала(НашаДата);

НачалоСледующегоКвартала = ДобавитьМесяц(НачалоТекущегоКвартала,3);

НачалоТекущегоГода = НачалоГода(НашаДата);

НачалоСледующегоГода = ДобавитьМесяц(НачалоТекущегоГода,12);

Сообщить("Вы ввели следующую дату: " + Формат(НашаДата,"ДЛФ = ДД"));

Сообщить("Начало следующего месяца от этой даты: " + Формат(НачалоСледующегоМесяца,"ДЛФ = ДД"));

Сообщить("Начало следующего квартала от этой даты: " + Формат(НачалоСледующегоКвартала,"ДЛФ = ДД"));

Сообщить("Начало следующего года от этой даты: " + Формат(НачалоСледующегоГода,"ДЛФ = ДД") + ".");

КонецПроцедуры

```

Листинг 2.6.11

И выводим все это на экран.

Сообщения:

— Вы ввели следующую дату: 20 ноября 2013 г

— Начало следующего месяца от этой даты: 1 декабря 2013 г

— Начало следующего квартала от этой даты: 1 января 2014 г

— Начало следующего года от этой даты: 1 января 2014 г

Рис. 2.6.18

Обращаю Ваше внимание, что данный код можно было написать короче, здесь я написал так, чтобы Вам было более понятно.

Вот короткий вариант: 112стр.<<

```csharp

Перем НашаДата;

ВвестиДату(НашаДата,"Введите дату",ЧастиДаты.Дата);

НачалоСледующегоМесяца = ДобавитьМесяц(НачалоМесяца(НашаДата),1);

НачалоСледующегоКвартала = ДобавитьМесяц(НачалоКвартала(НашаДата),3);

НачалоСледующегоГода = ДобавитьМесяц(НачалоГода(НашаДата),12);

Сообщить("Вы ввели следующую дату: " + Формат(НашаДата,"ДЛФ = ДД"));

Сообщить("Начало следующего месяца от этой даты: " + Формат(НачалоСледующегоМесяца,"ДЛФ = ДД"));

Сообщить("Начало следующего квартала от этой даты: " + Формат(НачалоСледующегоКвартала,"ДЛФ = ДД"));

Сообщить("Начало следующего года от этой даты: " + Формат(НачалоСледующегоГода,"ДЛФ = ДД") + ".");

```

Листинг 2.6.12

Теперь для тренировки получите начало предыдущего месяца, предыдущего квартала, предыдущего года от введенной даты.

.

.

Функция **ТекущаяДата()**

И, под конец, простая функция – ТекущаяДата(). У нее нет никаких параметров. Функция возвращает текущую системную дату на компьютере.

Рассмотрим простой пример:

```csharp

ДатаТекущая = ТекущаяДата();

Сообщить("На данный момент текущая дата " + Формат(ДатаТекущая, "ДЛФ = ДДВ"));

```

Листинг 2.6.13

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

Резюме

На этом наше знакомство с типом Дата закончилось. В данной части Вы узнали все необходимое для работы в программе 1С с типом Дата. Тип Дата Вам будет встречаться очень часто, поскольку «1С:Предприятие» - программа для автоматизации учетных систем, а они все работают с датами. Поэтому если Вам не понятна работа с данным типом, то лучше углубленно изучить его, используя дополнительные материалы. 113стр.<<

Часть 7. Функции преобразования и общие функции для примитивных типов

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

***

Функции преобразования

В данной части мы рассмотрим только три вида преобразования: из строки в число, из числа в строку, чисел и строк в дату.

***

Преобразование из числа в строку

Делается это достаточно просто:

**Строка(1.212)**

Рассмотрим пример:

```csharp

&НаКлиенте

Процедура ПреобразованиеИзЧислаВСтроку(Команда)

Перем ПеремЧисло;

Надпись = "Наше число - ";

ПеремЧисло = 1.22112;

ПеремСтрока = Строка(ПеремЧисло);

НадписьСЧислом = Надпись + ПеремСтрока;

Сообщить(НадписьСЧислом)

КонецПроцедуры

```

Листинг 2.7.1

В данном примере мы сначала задаем переменную и присваиваем строковое значение переменной Надпись и числовое значение переменной ПеремЧисло. Далее, преобразуем число в строку. Складываем две строки. Выводим в окно сообщений.

Результат должен быть следующим: 114стр.<<

Сообщения:

— Наше число-1.22112

Рис. 2.7.1

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

```csharp

Перем ПеремЧисло;

Надпись = "Наше число - ";

ПеремЧисло = 1.22112;

НадписьСЧислом = Надпись + ПеремЧисло;

Сообщить(НадписьСЧислом)

```

Листинг 2.7.2

то он выдаст точно такой же результат.

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

Сделайте следующий пример:

```csharp

&НаКлиенте

Процедура ПреобразованиеИзЧислаВСтроку2(Команда)

Перем ПеремЧисло1,ПеремЧисло2;

Надпись = "Наше число - ";

ПеремЧисло1 = 1.22112;

ПеремЧисло2 = 1.213444;

НадписьСЧислом = Надпись + Строка(ПеремЧисло1+ПеремЧисло2); Сообщить(НадписьСЧислом);

КонецПроцедуры

```

Листинг 2.7.3

Сообщения:

Наше число - 2.434564

Рис. 2.7.2 115стр.<<

Потом сложите их без оператора Строка, и посмотрите, что получится.

Преобразование из строки в число

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

Выполняется оно просто: пишется слово **Число** и внутри в скобках строка в виде числа.

Рассмотрим пример:

```csharp

&НаКлиенте

Процедура ПреобразованиеИзСтрокиВЧисло(Команда)

Перем ПеремСтрока1, ПеремСтрока2;

ПеремСтрока1 = "45";

ПеремСтрока2 = "34";

ПеремЧисло1 = Число(ПеремСтрока1);

ПеремЧисло2 = Число(ПеремСтрока2);

Сообщить(ПеремСтрока1 + " + "+ ПеремСтрока2 + " = " + Строка(ПеремЧисло1 + ПеремЧисло2));

КонецПроцедуры

```

Листинг 2.7.4

Объясним данный код: задаем две переменные и присваиваем им строковые значения в виде цифр. Преобразуем их в числа. Потом в сообщении их складываем и выводим в окно.

Сообщения:

- 45 + 34 = 79

Рис. 2.7.3

В реальности на моей практике такая задача стояла, и не раз, когда приходилось обрабатывать различные выгрузки из Excel, DBF, XML. Но это уже предмет немножко другого разговора. 116стр.<<

.

.

Для преобразования в дату используется функция **Дата**. У нее есть два синтаксиса: для строк и для чисел.

Рассмотрим синтаксис для строк. Для того, чтобы преобразовать строку в дату, она должна иметь следующий вид (его мы разбирали в ч 5.): «ГГГГММДДЧЧММСС».

Это может выглядеть так:

**Дата("20120922200202");**

Синтаксис для чисел будет следующим:

**Дата(Год,Месяц,День,Час, Минута,Секунда).**

Обязателен в данном формате только первый параметр. Потому можно написать и в таком виде:

**Дата(Год,Месяц, День)**

Или

**Дата(Год,Месяц)**

Или

**Дата(Год)**

Сделайте следующий пример:

```csharp

&НаКлиенте

Процедура ПреобразованиеВДату(Команда)

Дата1 = Дата("20120909110012");

Дата2 = Дата(2012,09,09,11,0,12);

Дата3 = Дата(2012,09,09);

Сообщить(Формат(дата1,"ДЛФ = ДДВ"));

Сообщить(Формат(дата2,"ДЛФ = ДДВ"));

Сообщить(Формат(дата3,"ДЛФ = ДДВ"));

КонецПроцедуры

```

Листинг 2.7.5

В данном примере мы задаем даты в двух разных видах и выводим это все в окно сообщений. Поэкспериментируйте самостоятельно с различными способами задания дат. 117стр.<<

Сообщения:

- 9 сентября 2012 г. 11:00:12

- 9 сентября 2012 г 11:00:12

- 9 сентября 2012 г 0:00:00

Рис. 2.7.4

И напоследок в этом уроке мы изучим общие функции, которые работают для всех переменных примитивного типа.

стр126

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

Например, так:

```csharp

Информация = "Гражадани " + ФИО + " должен " + Долг + " р. ";

```

Где ФИО и Долг – это строка и число соответственно.

Но можно поступить более гибко, используя метод СтрШаблон. Этот метод

возвращает строку с подставленными параметрами. В качестве первого параметра этого метода выступает строка, а остальные параметры – это те параметры, которые присутствуют в строке.

В самой строке в функции параметр обозначается символом %, а после него номер параметра. Например: "Фамилия: %1, имя: %2, отчество: %3".

Для демонстрации реализуем следующую задачу: на форме обработки (создадим новую) разместим два реквизита ФИО (тип Строка) и Долг (тип Число), а также команду Информация. При выполнении команды будем выводить строку следующего вида: «Иванов должен 10 р. 45 коп.»

Обработку и форму Вы, надеюсь, создали самостоятельно. На форме создадим два реквизита: ФИО (тип Строка) и Долг (тип Число (длина 10, точность 2)), а также команду Информация. Всё это разместим на форме (см. рис. 2.7.6).

Сначала найдём остаток в копейках целый. То есть если мы вводим 10.45, то нужно получить число 45. Для этого будем использовать оператор получения остатка от деления – %.

Мы умножем весь наш долг на 100 и получим остаток от деления полученного произведения на 100. Если у нас было число 10.45, то мы получили 1045, а остаток от деления числа 1045 на 100 будет 45.

```csharp

&НаКлиенте

Процедура Информация(Команда)

Остаток = (Долг * 100) % 100;

ЦелыйДолг = Долг - Остаток/100;

КонецПроцедуры

```

А потом вычислим целый долг без дробной части.

Следующим шагом при помощи метода СтрШаблон получим строку, в которой подставим значение из реквизита ФИО, а также значения переменных ЦелыйДолг и Остаток, и выведем эту строку в сообщение.

```csharp

Информация — СтрШаблон ("Гражданин %1 должен 2% Р- 3% коп.",

ФИО,ТекущаяДата, ЦелыйДолг, Остаток);

Сообщить(Информация);

```

Посмотрим, как работает наш код.

Сообщения: X

— Гражданин Иванов С В должен 1 011 р 23 коп.

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

.

.

Функции **Мин, Макс**

Начнем с функции Мин, данная функция возвращает минимальное значение из ряда параметров. Параметры могут быть как одного типа, так и разных типов. Если параметры будут разных типов, то они будут преобразовываться в тип первого параметра, если преобразование будет невозможным, то сгенерируется ошибка.

Число возвращается минимальное, строка - самая маленькая по длине, дата – самая ранняя, булево – ложь.

```csharp

&НаКлиенте

Процедура ФункцияМин(Команда)

ЧислоМин = Мин(12.11,221,34556,0.11,-2222);

СтрокаМин= Мин("ааа","аа","ууууу","ццццццццц");

ДатаМин = Мин('20120122090934','20110122090934','19990122090934','20240522090934');

БулевоМин = Мин(Истина, Ложь, Ложь,Истина);

Сообщить("Минимальное число =" + ЧислоМин);

Сообщить("Минимальная строка =" + СтрокаМин);

Сообщить("Минимальное дата =" + Формат(ДатаМин,"ДЛФ = ДДВ")); Сообщить("Минимальное булево =" + БулевоМин);

КонецПроцедуры

```

Листинг 2.7.6

В данном примере мы получаем минимальные значения чисел, строк, дат и булево. Поэкспериментируйте самостоятельно, задавая в данные функции значения разных типов. 118стр.<<

Сообщения:

— Минимальное число =-2 222

— Минимальная строка =аа

— Минимальное дата =22 января 1999 г. 9:09:34

— Минимальное булево =Нет

Рис. 2.7.5

Следующая функция – это функция **Макс**. Она возвращает максимальное значение из ряда параметров. Параметры аналогичны параметрам функции Мин.

Самостоятельно повторите последний пример, только с функцией Макс, с примерами из листинга 1.7.6 должен получиться результат, как на рисунке 1.7.6.

Сообщения:

— Максимальное число =34 556

— Максимальная строка =ццццццццц

— Максимальная дата =22 мая 2024 г 9:09:34

— Максимальное булево =Да

Рис. 2.7.6

Резюме

В этой части Вы научились преобразовывать строки в числа и наоборот, а также получать тип *Дата*, используя строковые и числовые типы. Функция *Мин* и *Макс* будет полезна Вам при работе с датами, поскольку часто приходится из нескольких дат выбирать самую раннюю или самую позднюю дату.

119стр.<<

Третья глава у нас очень объемная по знаниям, в ней мы научимся работать с конструкцией *Если*, разберем два вида цикла, будем пробовать делать собственные процедуры и функции и освоим такой нужный оператор как Попытка.

***

Давай представим, что ты хочешь приготовить пирог. Условие "Если" это как проверка: "если у меня есть все ингредиенты, тогда я могу приступать к приготовлению". "Тогда" это как дальнейшие действия: "если у меня есть все ингредиенты, тогда я начну смешивать их в тесто". "ИначеЕсли" это как вариантный план: "если у меня нет всех ингредиентов, то я пойду в магазин, чтобы купить недостающее". Таким образом, оператор условия "Если…Тогда…ИначеЕсли" помогает тебе принимать решения, основываясь на том, что у тебя есть или нет.

***

Часть 1. Условие: **Если…Тогда…ИначеЕсли**

Начнем мы с очень необходимого оператора, без которого просто никуда. Это оператор условия *Если…Тогда*.

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

Простейший вариант данного оператора будет следующим:

Если <Условие> тогда

[Операция1];

………..

[ОперацияN];

………..

КонецЕсли;

Рассмотрим подробнее. Для того чтобы начали выполняться операции внутри конструкции Если…Тогда, нужно, чтобы Условие принимало значение Истина. Если Условие принимает значение Ложь, то программа не будет заходить внутрь конструкции. Все просто. Теперь пример.

Создайте самостоятельно обработку, форму и в обработчике команды формы напишем следующий код:

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды(Команда)

Перем Число1;

ВвестиЧисло(Число1,"ВведитеЧисло");

Если Число1 > 0 тогда

Сообщить("Число " + Число1);

Сообщить("Больше нуля");

КонецЕсли;

КонецПроцедуры

```

Листинг 3.1.1 120стр.<<

В данном коде мы указали, что если введенное число больше нуля, то выводим сообщение. В противном случае ничего не делаем.

Сохраните обработку и посмотрите, как она работает.

ВведитеЧисло

10

Сообщении.

— Число 10

— Больше нуля

Рис. 3.1.1

Это самый примитивный вариант использования данного оператора.

Условие для данного оператора может быть каким угодно, главное, чтобы возвращалось значение типа Булево.

Например, может быть такой вариант:

**Если Число1 > 1 и Число1 < 10 тогда….**

Или такой вариант:

**Условие = Число1 > 1 и Число1 < 10;**

**Если Условие тогда…**

И так далее, более подробно про работу с булевыми операторами смотрите главу 2, часть 3 (см. стр. 63).

Продолжаем изучать дальше конструкцию «Если…». Что если нам надо выполнить какие-нибудь операции, когда выполняется наше условие, и другие операции, когда оно не выполняется? Для этого нам помогает оператор условия Иначе. 121стр.<<

Рассмотрим схему:

Если <Условие> тогда

[Операция1];

………..

[ОперацияN];

Иначе

[Операция_2];

……….

[Операция_N]

КонецЕсли;

В данном случае выполнение программы после оператора *Иначе* будет, когда Условие примет значение Ложь.

Доработайте Ваш пример:

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды2(Команда)

Перем Число1;

ВвестиЧисло(Число1,"ВведитеЧисло");

Если Число1 > 0 тогда

Сообщить("Число " + Число1);

Сообщить("Больше нуля");

иначе

Сообщить("Число " + Число1);

Сообщить("Равно нулю или меньше нуля");

КонецЕсли;

КонецПроцедуры

```

Листинг 3.1.2

В вышеприведенном коде мы вводим некоторое число в программу, после, как в предыдущем примере, пишем условие, что если это число больше нуля, то выводим соответствующее сообщение. Но также пишем оператор Иначе, после которого сообщаем, что число меньше или равно нулю. Запустите данную обработку и посмотрите, как она работает.

Опять усложним текущий пример. Что если нам необходимо вывести сообщение, когда число равно нулю, или, к примеру, равно 10?

Для этого мы используем условную конструкцию **ИначеЕсли …Тогда**.

122стр.<<

Рассмотрим схему:

```

Если <Условие> тогда

[Операция1];

………..

[ОперацияN];

ИначеЕсли <Условие2> тогда

[Операция_2];

………..

[Операция_2N];

ИначеЕсли <Условие3> тогда

[Операция_2];

………..

[Операция_2N];

.

Иначе

[Операция_N];

……….

[Операция_NN]

КонецЕсли;

```

Операторов *ИначеЕсли…*Тогда внутри условия может быть бесконечное множество, оператор *Иначе* всегда должен быть один и идти после всех операторов *ИначеЕсли…Тогда*.

Теперь усложните Ваш пример:123стр.<<

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды3(Команда)

Перем Число1;

ВвестиЧисло(Число1,"ВведитеЧисло");

Если Число1 >= 1 тогда

Сообщить("Число " + Число1);

Сообщить("Больше или равно единицы");

ИначеЕсли Число1 >0 и Число1 < 1 тогда

Сообщить("Число " + Число1);

Сообщить("Меньше 1, но больше 0");

ИначеЕсли Число1 = 0 тогда

Сообщить("Число " + Число1);

Сообщить("Равно нулю");

иначеСообщить("Число " + Число1);

Сообщить("Меньше нуля");

КонецЕсли;

КонецПроцедуры

```

Листинг 3.1.3

В данном примере мы проверяем, больше или равно единицы введенное нами число, если да, то сообщаем об этом. Потом проверяем, входит ли оно в интервал от 0 до 1, если да, то сообщаем. Следующим шагом проверяем, равно ли оно нулю, если да, то сообщаем. И если число не удовлетворяет всем вышеприведенным условиям, т.е. число меньше нуля, выводим сообщение об этом.

ВведитеЧисло

0,35

Сообщения.

- Число 0.36

— Меньше 1. но больше О

Рис. 3.1.2

Обращаю Ваше внимание, что условия *ИначеЕсли* будут выполняться только в том случае, когда не выполнились все предыдущие условия. Подправьте для примера Ваш код:

```csharp

Перем Число1;

ВвестиЧисло(Число1,"ВведитеЧисло");

Если Число1 > 0 тогда

Сообщить("Число " + Число1);

Сообщить("Больше или равно единицы");

ИначеЕсли Число1 >0 и Число1 < 1 тогда

Сообщить("Число " + Число1);

Сообщить("Меньше 1, но больше 0");

ИначеЕсли Число1 = 0 тогда

Сообщить("Число " + Число1);

Сообщить("Равно нулю");

иначеСообщить("Число " + Число1);

Сообщить("Меньше нуля");

КонецЕсли;

```

Листинг 3.1.4 124стр.<<

Если мы изменим первое условие, что *Число1* больше 0, то программа никогда не зайдет во второе условие. Так как, к примеру, число 0.6 больше нуля, и выполнится код под этим условием, после чего происходит выход из оператора.

Обратите внимание на один момент, если в Условии идет сразу переменная типа булево, то не надо писать так:

**Если НашеУсловие = Истина тогда…**

**Если НашеУсловие = Ложь тогда…**

Достаточно просто написать условие, например:

**Если НашеУсловие тогда…**

Или

**Если Не НашеУсловие тогда….**

Теперь переделайте предыдущий пример. Создайте переменную типа булево с нужным условием и подставляйте ее в конструкцию *Если…Тогда*.

Закончим разбирать данный оператор. Попробуйте сами усложнить последний пример (листинг 3.1.4), добавив различные дополнительные сравнения.

Теперь изучим похожий оператор, но несколько упрощенный – Вычислить выражение по условию. Он имеет следующий синтаксис:

**?(<Условие>,<Выражение1>,<Выражение2>)**

Где:

«Условие» – это логическое выражение, в зависимости от результата которого будет возвращено либо Выражение1, либо Выражение2;

«Выражение1» – возвращается, если логическое выражение Истина;

«Выражение2» – возвращается, если логическое выражение Ложь;

Рассмотрим пример. Вводим некоторое число, и надо вывести сообщение, больше оно нуля или меньше.125стр.<<

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды4(Команда)

Перем Число1;

ВвестиЧисло(Число1,"Введите число");

Сообщение = ?(Число1 > 0,"Число " + Строка(Число1) + " больше 0",

Число + Строка(Число1) + " меньше или равно 0");

Сообщить(Сообщение);

КонецПроцедуры

```

Листинг 3.1.5

В изучаемом примере первый параметр оператора «?» это наше условие: *Число1 >0*, второй параметр – строка с текстом, что наше число больше нуля, оно будет возвращаться, если первый параметр будет Истина. И третий параметр – строка с текстом, что наше число ноль или меньше нуля, оно будет возвращаться, если первый параметр будет Ложь.

Посмотрите, как она работает.

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

```csharp

&НаКлиенте

Процедура ВыполнениеКоманды5(Команда)

Перем Число1;

ВвестиЧисло(Число1,"Введите число");

ЧислоДляКорня = ?(Число1 < 0, Число1*(-1),Число1);

Корень = Окр(Sqrt(ЧислоДляКорня),5);

Сообщить("Корень из модуля числа " + Строка(Число1) + " равен " + Строка(Корень));

КонецПроцедуры

```

Листинг 3.1.6

Разберите данный пример самостоятельно.

Резюме

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

126стр.<<

Часть 2. Цикл: Для…Цикл

Итак, начнем изучать циклы. Что такое вообще Цикл?

***

Цикл – **действие, выполняемое определенное количество раз**. Под действием понимается один или несколько операторов.

Рис. 3.2.1

Изучите рисунок 3.2.1, он как раз применим к осваиваемой теме. Пока идет перечисление какого-нибудь параметра от одного значения до другого, то выполняются определенные действия. Как только параметр достигает максимального значения, мы выходим из цикла и продолжаем выполнение программы.

.

.

**цикл "Для...Цикл" это как раздача конфет в коробке - ты делаешь одно и то же действие для каждой конфеты в коробке.**

***

Первый цикл который мы изучим, будет цикл Для…Цикл.

Данный оператор имеет следующий синтаксис (пока мы его рассмотрим в самом общем виде, а углублять будем по мере изучения):

```csharp

Для ИмяПеременной = Выражение1 по Выражение2 цикл

//операторы

КонецЦикла.

```

Где:

«ИмяПеременной» – это переменная счетчик цикла, его значение увеличивается на единицу при каждом повторении цикла;

«Выражение1» – числовое выражение, оно задает начальное значение, которое присваивается счетчику цикла при первом обходе. Может быть любое целое число;

«Выражение2» – максимальное значение счетчика цикла. Когда переменная ИмяПеременной становится больше Выражение2, программа выходит из цикла, т.е. операторы внутри конструкции Для …Цикл больше не выполняются. Может быть любое целое число;

«Цикл» – ключевое слово, которое открывает тело цикла;

«КонецЦикла» – ключевое слово, которое закрывает тело цикла; 127стр.<<

Итерация – каждый обход цикла.

Все, что находится между ключевыми словами Цикл и КонецЦикла, будет выполняться, пока ИмяПеременной находится в интервале от Выражение1 до Выражение2.

Обращаю внимание, что Выражение1 всегда должно быть меньше или равно Выражение2.

Создайте самостоятельно обработку, форму, и в обработчике команды формы напишите следующий код:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду1(Команда)

Для н = 1 по 10 цикл;

Сообщить("н = " + н);

КонецЦикла;

КонецПроцедуры

```

Листинг 3.2.1

В данном примере мы создали цикл Для…Цикл, где счетчик цикла называется «н», и начальное его значение равно 1, а конечное его значение равно 10.

И при каждом обходе цикла, выводим сообщение о том, чему равно «н».

Сохраните обработку, запустите и посмотрите, что у Вас выйдет в окно сообщений.

Циклы можно вкладывать друг в друга. Сделайте следующий пример:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

Для н = 1 по 5 цикл

Для к = 1 по 3 Цикл

Сообщить("н.к = " + н + "." + к );

КонецЦикла;

КонецЦикла;

КонецПроцедуры

```

Листинг 3.2.2

Как работает такой цикл? Сначала выполняется внешний цикл, т.е. переменной «н» присваивается значение 1, потом полностью выполняется внутренний цикл, т.е. значение «к» проходит от 1 до 7, после этого управление передается опять на внешний цикл.

Сохраните обработку и посмотрите, что получится. 128стр.<<

Сообщения:

— н.к = 1.1

— н.к = 1.2

— н.к = 1.3

— н.к = 2.1

— н.к = 2.2

Рис. 3.2.2

Если Вам трудно понять очередность внешнего и внутреннего цикла, поставьте самостоятельно сообщения перед внутренним циклом, и после него, тогда все встанет на свои места.

Значения Выражение1 и Выражение2 могут задаваться пользователем в виде переменных.

Сделайте следующий пример:

```csharp

&НаКлиенте Процедура ВыполнитьКоманду3(Команда)

Перем Выражение1, Выражение2;

ВвестиЧисло(Выражение1,"Введите выражение1",2,0);

ВвестиЧисло(Выражение2,"Введите выражение2 (больше выражение1)",2,0);

Если Выражение1 > Выражение2 тогда

Предупреждение("Выражение1 должно быть больше выражение2");

иначе

Для н = Выражение1 по Выражение2 цикл

Сообщить(" н = " + н);

КонецЦикла;

КонецЕсли;

КонецПроцедуры

```

Листинг 3.2.3

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

.

.

Продолжим изучение цикла *Для..Цикл*. И углубим нашу схему, введя оператор **Прервать**.

Данный оператор прерывает выполнение цикла в любой его точке. После выполнения данной команды управление передается оператору, следующему после ключевого слова *КонецЦикла*. 129стр.<<

С данным оператором конструкция цикла будет иметь следующий вид:

```csharp

Для ИмяПеременной = Выражение1 по Выражение2 цикл

//операторы

Прервать.

//операторы

КонецЦикла.

```

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

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду4(Команда)

Для н = 1 по 10 цикл

к = 1/н;

Сообщить("к = " + Окр(к,3));

Прервать;

КонецЦикла;

КонецПроцедур

```

Листинг 3.2.4

Сохраните обработку и посмотрите, как она работает. Должен быть следующий результат:

Сообщения:

- к = 1

Рис. 3.2.3

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

Смотрим еще один пример:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду5(Команда)

Для н = - 10 по 10 цикл

Если н = 0 тогда

Прервать;

КонецЕсли;

к = 1/н;

Сообщить("к = " + Окр(к,3));

КонецЦикла;

КонецПроцедуры

```

Листинг 3.2.5 130стр.<<

В этом примере наш цикл следует от *-10* до *10*, в том случае, когда счетчик цикла равняется нулю, мы выходим из цикла, чтобы не сгенерировалась исключительная ситуация.

.

.

Напоследок, мы разберем оператор **Продолжить**. Еще углубим схему конструкции.

```csharp

Для ИмяПеременной = Выражение1 по Выражение2 цикл

//операторы

Продолжить;

//операторы

Прервать.

//операторы

КонецЦикла.

```

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

Операторы Прервать и Продолжить применимы во всех циклах платформы 1С!

Сделайте следующий пример, и посмотрите результат его работы:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду6(Команда)

Для н = 1 по 10 цикл

к = 1/н;

р = 1/(Pow(н,2));

Сообщить("1/н = " + Окр(к,3));

КонецЦикла;

КонецПроцедуры

```

Листинг 3.2.6

А теперь подправьте наш пример:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду6(Команда)

Для н = 1 по 10 цикл

к = 1/н;

р = 1/(Pow(н,2));

Сообщить("1/н = " + Окр(к,3));

Продолжить;

Сообщить("--------------------");

Сообщить("1/н^2 = " + Окр(р,3));

КонецЦикла;

КонецПроцедуры

```

Листинг 3.2.7 131стр.<<

Выполните обработку. Как видите, сообщение о делении единицы на «н» в квадрате не выходит, потому что оператор Продолжить передал управление в начало цикла.

Также оператор Продолжить можно выполнять внутри условия.

Сделайте следующий пример:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду7(Команда)

Для н = - 10 по 10 цикл

Если н = 0 тогда

Продолжить;;

КонецЕсли;

к = 1/н;

Сообщить("1/н = " + Окр(к,3));

КонецЦикла;

КонецПроцедуры

```

Листинг 3.2.8

В данном примере при «н» равном нулю, мы не прерываем цикл, как это делали в предыдущем уроке, а просто начинаем его заново, чтобы не сгенерировалась ошибка.

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

.

.

Давай представим, что у тебя есть школьный автобус, который ездит, чтобы забирать детей домой. Цикл "Пока...Цикл" можно сравнить с работой водителя автобуса. Водитель говорит: "Пока в автобусе есть дети, я буду ездить и забирать их домой". Условие - это как вопрос водителю: "Есть ли еще дети в автобусе?" Если ответ "Да", то водитель продолжает ездить и забирать детей (тело цикла - действие водителя). Это продолжается до тех пор, пока есть дети в автобусе. Как только все дети выйдут, цикл "Пока...Цикл" завершается. Таким образом, цикл "Пока...Цикл" это как работа водителя автобуса: он будет ездить и забирать детей до тех пор, пока есть дети в автобусе.

***

Рассмотрим еще один цикл, это цикл с условием **Пока…Цикл**. Принцип его работы мы разберем на следующей схеме:

Условие - Да - Тело цикла

- Нет

Рис. 3.3.1

Посмотрите на данную схему: перед телом цикла задается какое-нибудь условие, пока данное условие истинно, выполняется тело цикла, в противном случае программа выходит из цикла. Рассмотрим синтаксис данного оператора в программе 1С.

```csharp

Пока <Условие> Цикл

//операторы

Продолжить;

//операторы

Прервать;

КонецЦикла;

```

Разберем данный оператор. Ключевое слово *Пока* задает некоторое условие, оно должно иметь тип булево, после данного условия следует ключевое слово *Цикл*, открывающее тело цикла, а закрывает тело цикла ключевое слово *КонецЦикла*.

Операторы *Продолжить* и *Прервать* обладают теми же функциями, как и в предыдущем цикле *Для…Цикл*. Это переход в начало цикла и выход из цикла соответственно.

Перед тем, как рассматривать примеры цикла *Пока...Цикл*, мы изучим Рекурсию переменных. 133стр.<<

.

.

Рекурсия – **определение нового значения параметров при помощи старого** значения, используя единый идентификатор.

Посмотрим, как это выглядит.

и = 0;

и = и + 1;

В этом случае переменная «и» увеличивает сама себя на 1.

Сделаем самый элементарный пример, и на нем же изучим рекурсию и цикл Пока…Цикл. Пример таков: нам необходимо вывести ряд чисел от *0* до *100* с шагом *5 (0,5,10,15 и т.д.)*.

Циклом *Для…Цикл*, который мы изучали в предыдущей части, сделать этот пример можно: нужно при помощи оператора *%* определять, кратен ли текущий счетчик цикла 5 или нет, и исходя из этого выводить сообщение. Но гораздо проще и понятнее будет сделать данную задачу, используя цикл *Пока...Цикл*.

Создайте самостоятельно обработку, форму и в обработчике команды формы напишем следующий код:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду1(Команда)

н = 0;

Шаг = 5;

Пока н <= 100 Цикл

Сообщить("н =" + н);

н = н + Шаг;

КонецЦикла;

КонецПроцедуры

```

Листинг 3.3.1

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

После этого мы задаем условие цикла: что он будет выполняться, пока переменная «н» меньше или равна ста. То есть если переменная «н» меньше или равна 100, то программа будет заходить в тело цикла и выполнять операторы в цикле. Как только данное условие перестанет выполняться, то будут исполняться операторы после ключевого слова КонецЦикла. Выводим сообщение чему равно «н». Последний шаг – выполняем рекурсию переменной, увеличивая ее на шаг равный 5.

Сохраните обработку, запустите и посмотрите, как работает данный код.

Рекурсивно можно вычитать, умножать и делить переменные (для типа число). Рекурсивный вызов возможен также для строк и дат.

Еще один пример на рекурсию. Нам надо получить «н» факториал. 134стр.<<

**5! = 1 * 2 * 3 * 4 * 5**

```csharp

&НаКлиенте

Процедура ВычислениеФакторила(Команда)

Перем н;

ВвелиЧисло = ВвестиЧисло(н,"Введите число",1,0);

Если ВвелиЧисло тогда

Если н > 0 тогда

НачалоФакториала = 1;

Итерация = 0;

Пока Итерация < н цикл Итерация = Итерация + 1;

НачалоФакториала = НачалоФакториала*Итерация;

КонецЦикла;

Сообщить(Строка(н) + "! = " + Строка(НачалоФакториала));

КонецЕсли;

КонецЕсли;

КонецПроцедуры

```

Листинг 3.3.2

Разберем его. Получаем интерактивно некоторое целое число, проверяем, ввели мы его или нет, записываем введенное число в переменную «н».

Если число ввели, и если оно больше нуля, задаем переменную *НачалоФакториала*, которая равна единице и которая будет рекурсивно увеличиваться, и переменную *Итерация*.

Определяем наш цикл, он будет работать пока переменная Итерация меньше переменной «н». Т.е. если мы «н» задали равным 5, то цикл будет выполняться при следующих значениях переменной *Итерация* : *0,1,2,3,4*.

Сразу же в начале тела цикла увеличиваем переменную *Итерация* на *1*.

И последний шаг: внутри цикла рекурсивно вызываем переменную *Факториал*, умножая ее на переменную *Итерация*.

Т.е. в первом шаге цикла: *НачалоФакториала* = 1 * 1.

Во втором шаге цикла: *НачалоФакториала* = 1 * 2.

В третьем шаге цикла: *НачалоФакториала* = 2 * 3.

И так далее.

В конце выводим сообщение.

Разберите данный пример, если он Вам не понятен. Разберите его в отладке, посмотрите, как изменяются переменные.

Самостоятельно измените пример так, чтобы *Итерация* начиналась с 1, поменяйте условие цикла или место рекурсии переменной *Итерация*, чтобы пример работал правильно. 135стр.<<

Сделайте еще один пример на цикл *Пока…Цикл*.

Мы имеем две даты, вторая дата старше первой, надо вывести все даты в промежутке между ними.

```csharp

&НаКлиенте

Процедура ВыводДат(Команда)

Перем ДатаНач, ДатаКон;

ДатаНачВведена = ВвестиДату(ДатаНач,"Введите начальную дату", ЧастиДаты.Дата); ДатаКонВведена = ВвестиДату(ДатаКон,"Введите конечную дату", ЧастиДаты.Дата);

Если ДатаНачВведена и ДатаКонВведена тогда

Если ДатаНач < ДатаКон тогда

Пока ДатаНач <= ДатаКон цикл

Сообщить(Формат(ДатаНач,"ДЛФ = ДД"));

ДатаНач = ДатаНач + 3600*24;

КонецЦикла;

иначеПредупреждение("Начальная дата должна быть раньше конечной даты");

КонецЕсли;

иначеПредупреждение("Вы не ввели одну из дат");

КонецЕсли;

КонецПроцедуры

```

Листинг 3.3.3

Разберем данный пример.

Первым делом мы задаем и интерактивно вводим переменные. Для того чтобы исключить ситуацию, когда пользователь не ввел переменную, мы делаем проверку. Если Вы забыли, то напоминаю, что функции *ВвестиДату*, *ВвестиСтроку*, *ВвестиЧисло* возвращают *Истину*, если пользователь ввел строку, число или дату, и возвращают *Ложь*, если нет.

В том случае, если обе переменные *ДатаНачВведена* и *ДатаКонВведена* принимают значение *Истина*, то мы заходим в условие, а если нет, то выдаем пользователю предупреждение.

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

После того как проверка прошла, начинает выполняться цикл. В условии цикла мы проверяем то, что дата начальная меньше или равна дате конечной. Если условие истинно, то заходим в тело цикла. В теле цикла мы первым делом выводим на экран начальную дату. А потом - внимание! - мы делаем то, что называется рекурсией переменных (о чем я вам рассказывал в начале этой части главы), но только применимо к датам. 136стр.<<

После данных манипуляций, ДатаНач увеличивается на один день. Опять проверяем наше условие, и если ДатаНач все еще меньше или равно ДатаКон, то идем в цикл, иначе выходим из него.

Запустите обработку и посмотрите, как она работает.

На этом мы закончим изучение циклов. Всего в языке программирования 1С существует три вида циклов. Два из них мы изучили в этом уроке. Третий цикл будем изучать в седьмой главе, когда будем проходить универсальные коллекции значений. Пока изучите и научитесь работать с циклом Пока…Цикл, изучите и освойте рекурсию переменных. Поскольку в практической работе Вам часто придется сталкиваться с данными вопросами. 137стр.<<

.

В данной части изучим работу с процедурами и функциями. Что такое процедура?

Процедура - это **идентификатор, выполняющий некоторые действия**, определенные пользователем или системные. Говоря простым языком: если мы пропишем внутри нашего кода некоторую процедуру (не важно, нами написанную или процедуру программы 1С), то когда выполнение программы дойдет до этой строки, тогда будут выполнены определенные действия. Рассмотрим уже известные нам процедуры *Сообщить* и *Предупреждение*. Из предыдущих примеров Вы видели, что при выполнении процедуры Сообщить в окно сообщений выходит текст, введенный в качестве первого параметра данной процедуры. А при выполнении процедуры Предупреждение появляется всплывающее окно с описанием текста, заданного в качестве параметра данной процедуры.

.

.

Функция - это **идентификатор, выполняющий некоторые действия**, определенные пользователем или системные, **и возвращающий значение определенного типа**. Как видите, функции отличаются от процедур только тем, что возвращают определенное значение. К примеру, функция *СтрДлина* вычисляет длину строки, которая передается в нее в качестве параметра, и возвращает это значение пользователю в виде числа. Или функция *ТекущаяДата* определяет системную дату компьютера и возвращает это значение в виде даты.

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

У многих может возникнуть вопрос: для чего необходимо самим писать процедуры или функции? Во-первых, Вы упростите свой код, если он будет описан с помощью процедур, такой код будет хорошо читаем и понятен для следующего разбора, причем, возможно, и Вами. Во-вторых, чтобы не писать много раз одно и то же в коде. Если у Вас один и тот же код повторяется несколько раз, то лучше его написать в процедуре или функции, а потом просто использовать данную процедуру или функцию в нужных местах. Так Вы не только сделаете хорошо читаемый код, но и подстрахуете себя от возможных ошибок. Понятно, что одно дело исправить ошибку в одном месте внутри процедуры или функции, а другое дело в 10 местах: Вы можете исправить в 9 местах, а в 10-м забыть или пропустить, в результате качество Вашей работы будет страдать.

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

```csharp

Процедура ИмяПроцедуры()

//оператор

КонецПроцедуры

```

138стр.<<

Разберем этот синтаксис. Ключевое слово Процедура идет всегда перед названием. После данного ключевого слова всегда идет название процедуры. Все названия процедур внутри одного

модуля должны быть уникальны. Поскольку в данном примере синтаксиса процедура представлена без параметров (их мы разберем позже), то просто пишем левую и правую скобку вместе. После этих скобок идут операторы, которые описывают те или иные действия внутри процедуры (для удобного чтения я рекомендую начинать писать их со следующей строки и делать отступ с помощью клавиши *«Tab»*). Ключевое слово *КонецПроцедуры* завершает код процедуры. Что бы Вы ни написали после этого ключевого слова, все это к этой процедуре не будет иметь никакого отношения.

Так же в предыдущих листингах Вы должны были обратить внимание на конструкцию &НаКлиенте. Это так называемая *директива компиляции*, с её помощью программист может задать, где будет выполняться его код, на сервере или на клиенте. Более подробно работу этой директивы мы разберем в пятой главе, посвященной работе с управляемыми формами. Пока же просто устанавливайте эту директиву перед началом всех процедур и функций, *которые Вы используете в модуле формы*. На данном этапе обучения Вам не стоит задумываться о её сути.

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

Создайте обработку, форму и в модуле формы напишите следующую процедуру:

```csharp

&НаКлиенте

Процедура СообщениеОНеправильномЧисле()

Сообщить("Введенное число меньше нуля");

Сообщить("Вычисление не будет произведено");

Сообщить("Задайте другие числа");

КонецПроцедуры

```

Листинг 3.4.1

А в обработчике команды формы нижеприведенный код:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем А, Б;

Если ВвестиЧисло(А,"Введите число А") тогда

Если А >= 0 тогда

КореньА = Sqrt(А);

Сообщить("Корень из числа А = " + Окр(КореньА,5)); иначеСообщениеОНеправильномЧисле();

КонецЕсли;

КонецЕсли;

Если ВвестиЧисло(Б,"Введите число Б") тогда

Если Б >= 0

тогда КореньБ = Sqrt(Б);

Сообщить("Корень из числа Б = " + Окр(КореньБ,5));

иначеСообщениеОНеправильномЧисле();

КонецЕсли;

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.2 139стр.<<

Разберем данный пример.

Мы вводим некоторое первое число *А*, проверяем на то, что оно введено. Я сразу написал функцию ВвестиЧисло как параметр оператора *Если*, чтобы оптимизировать код программы. Потом мы проверяем больше или равно нуля наше число, если да - то вычисляем корень, если нет - пишем вновь созданную процедуру, которая выводит целый ряд сообщений. Точно такие же действия проделываем с числом *Б*.

Запустите обработку и посмотрите, как работает данный код.

Сейчас пытливый читатель спросит: ведь эти два отрезка кода, когда вводим первое число и вычисляем корень, а потом второе число и вычисляем корень, очень похожи. Нельзя ли и их каким-нибудь образом сделать в виде процедуры? Да, можно.

Напишите в модуле формы следующую процедуру:

```csharp

&НаКлиенте

Процедура ИнтерактивноВВестиКореньИВычислить()

Перем А;

Если ВвестиЧисло(А,"Введите число") тогда

Если А >= 0 тогда

КореньА = Sqrt(А);

Сообщить("Корень из числа " + А + " = " + Окр(КореньА,5)); иначеСообщить("Введенное число меньше нуля");

Сообщить("Вычисление не будет произведено");

Сообщить("Задайте другие числа");

КонецЕсли;

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.3

А в обработчике команды код:

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду2(Команда)

ИнтерактивноВВестиКореньИВычислить();

ИнтерактивноВВестиКореньИВычислить();

КонецПроцедуры

```

Листинг 3.4.4

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

Посмотрев на это, пытливый читатель может задать новый вопрос: а если необходимо одно число задать интерактивно, а одно в программе, как мы поступим в этом случае, как это число передать в процедуру? 140стр.<<

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

А для этого мы рассмотрим наш более усложненный синтаксис. Обратите внимание: все, что касается параметров, справедливо и для процедур, и для функций. Просто сейчас мы рассмотрим данный вопрос на примере процедур.

Процедура ИмяПроцедуры(Параметр1, Параметр2, ….,ПараметрN)

КонецПроцедуры

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

Переделайте Ваш пример.

Измените процедуру ВычислитьКореньИВывести следующим образом:

```csharp

&НаКлиенте

Процедура ВычислитьКореньИВывести(ЧислоПодКорнем, НазваниеЧисла)

Если ЧислоПодКорнем >= 0 тогда

КореньА = Sqrt(ЧислоПодКорнем);

Сообщить("Корень из числа " + НазваниеЧисла + " = " + Окр(КореньА,5));

иначеСообщить("Число " + НазваниеЧисла + " меньше нуля");

Сообщить("Вычисление не будет произведено");

Сообщить("Задайте другие числа");

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.5

И создадим новую команду формы, в обработчике которой напишем следующий код:

```csharp

&НаКлиенте

Процедура ВычислитьКорень(Команда)

Перем А,Б;

А = 10.11;

ВычислитьКореньИВывести(А,"А");

Если ВвестиЧисло(Б, "Введите число Б") Тогда

ВычислитьКореньИВывести(Б,"Б");

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.6 141стр.<<

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

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

**ВычислитьКореньИВывести("А",А);**

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

Еще один момент - это то, что количество параметров заданных в процедуре при разработке, должно соответствовать количеству параметров при использовании данной процедуры в коде.

Т.е. нельзя написать так:

**ВычислитьКореньИВывести(А);**

Компилятор выдаст ошибку.

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

Звучит несколько сложно, но один простой пример прояснит картину.

Сделаем новую процедуру ВычислитьКореньПоМодулюИВывести:

```csharp

&НаКлиенте

Процедура ВычислитьКореньПоМодулюИВывести(ЧислоПодКорнем, НазваниеЧисла)

ЧислоПодКорнем = ?(ЧислоПодКорнем >=0,ЧислоПодКорнем,ЧислоПодКорнем*(-1));

КореньА = Sqrt(ЧислоПодКорнем);

Сообщить("Корень из модуля числа " + НазваниеЧисла + " = " + Окр(КореньА,5));

КонецПроцедуры

```

Листинг 3.4.7 142стр.<<

Создадим новую команду *«ВычислитьКореньПоМодулю»* и в её обработчике напишем следующий код:

```csharp

&НаКлиенте

Процедура ВычислитьКореньПоМодулю(Команда)

Перем А;

Если ВвестиЧисло(А, "Введите число А") Тогда

Сообщить("Число А = " + А);

ВычислитьКореньПоМодулюИВывести(А,"А");

Сообщить("Число А = " + А);

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.8

В данном примере если ЧислоПодКорнем меньше нуля, то мы его рекурсивно умножаем на минус единицу.

Число А = -10

Корень из модуля числа А = 3,16228

Число А = 10

Рис. 3.4.1

Запустите данный пример. И при вводе отрицательного числа будет изменено само число, которое Вы ввели.

В каких-то случаях Вас это не будет сильно волновать, но в других случаях Вы захотите, чтобы переменная, которую передаете в процедуру или функцию, оставалась прежней. Как это сделать? Смотрим следующий синтаксис:

Процедура ИмяПроцедуры(Знач Параметр1, Знач Параметр2, ….,Знач ПараметрN)

КонецПроцедуры

Ключевое слово *Знач* перед параметром означает, что данный параметр передается в процедуру по значению, т.е. изменение параметра внутри процедуры никак не повлияет на значение фактического параметра, который был передан в процедуру. Ключевое слово Знач является необязательным, т.е. переменная может передаваться как ссылочно, так и по значению.

Теперь измените Ваш предыдущий пример. Подправьте процедуру *«ВычислитьКореньПоМодулюИВывести»*

```csharp

Процедура ВычислитьКореньПоМодулюИВывести(Знач ЧислоПодКорнем, НазваниеЧисла)

ЧислоПодКорнем = ?(ЧислоПодКорнем >=0,ЧислоПодКорнем,ЧислоПодКорнем*(-1));

КореньА = Sqrt(ЧислоПодКорнем);

Сообщить("Корень из модуля числа " + НазваниеЧисла + " = " + Окр(КореньА,5));

КонецПроцедуры

```

Листинг 3.4.9 143стр.<<

Обработчик команды «*ВычислитьКореньПоМодулю*» не изменится.

Запустите обработку, и при вводе отрицательного числа посмотрите, изменится ли само введенное число или нет.

Число А = -100

Корень из модуля числа А = 10

Число А = -100

Рис. 3.4.2

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

Рассмотрим синтаксис.

Процедура ИмяПроцедуры(Параметр1 = Умол1, Параметр2 = Умол2, ….,ПараметрN = УмолN)

КонецПроцедуры

Разберем данный синтаксис. Такая форма описания параметра означает, что данный параметр имеет значение по умолчанию и тем самым он становится необязательным, т.е. когда мы будем писать данную процедуру в модуле, то вольны не указывать этот параметр.

Доработайте пример. В этот раз мы вычисляем корень числа и выводим его на экран с точностью до 5-го знака, но пользователь может менять точность.

Создадим новую процедуру *«ВычислитьКореньИВывестиСОкруглением»*

```csharp

&НаКлиенте

Процедура ВычислитьКореньИВывестиСОкруглением(Знач ЧислоПодКорнем, НазваниеЧисла, Точность = 5)

ЧислоПодКорнем = ?(ЧислоПодКорнем >=0,ЧислоПодКорнем,ЧислоПодКорнем*(-1));

КореньА = Окр(Sqrt(ЧислоПодКорнем),Точность);

Сообщить("Корень из модуля числа " + НазваниеЧисла + " = " + КореньА);

КонецПроцедуры

```

Листинг 3.4.10

Опять создадим новую команду «ВычислитьКореньСОкруглением», и в её обработчике напишем следующий код:

144стр.<<

```csharp

&НаКлиенте

Процедура ВычислитьКореньСОкруглением(Команда)

Перем А;

Если ВвестиЧисло(А, "Введите число А") Тогда

ВычислитьКореньИВывестиСОкруглением(А,"А");

ВычислитьКореньИВывестиСОкруглением(А,"А",7);

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.11

Разберем данный пример. Мы переделали нашу процедуру *ВычислитьКореньСОкруглением*, добавив параметр *Точность*, который по умолчанию равен *5*. Его мы используем для округления числа, которое получилось при извлечении квадратного корня. После этого мы используем процедуру два раза. Первый раз без третьего параметра, а второй раз с третьим параметром.

Сохраните обработку и запустите ее. И введите любое число.

Сообщения:

— Корень из модуля чиспа А = 15.81139

— Корень из модуля числа А = 15.8113883

Рис. 3.4.3

Как Вы видите, в первый раз значение вышло с точностью до 5-го знака, а второй до 7-го.

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

Рассмотрим следующий синтаксис:

Процедура ИмяПроцедуры(Знач Параметр1 = Умол1, Знач Параметр2 = Умол2, …., Знач ПараметрN = УмолN)

КонецПроцедуры

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

В этом примере, если Точность будет меньше 5, то будем выводить все равно с точностью равной 5.

Создадим новую процедуру «ВычислитьКореньИВывестиТочностьПять»:

145стр.<<

```csharp

&НаКлиенте

Процедура ВычислитьКореньИВывестиТочностьПять(Знач ЧислоПодКорнем, НазваниеЧисла, Знач Точность = 5)

ЧислоПодКорнем = ?(ЧислоПодКорнем >=0,ЧислоПодКорнем,ЧислоПодКорнем*(-1));Точность = ?(Точность < 5, 5, Точность);

КореньА = Sqrt(ЧислоПодКорнем);

Сообщить("Корень из модуля числа " + НазваниеЧисла + " = " + Окр(КореньА,Точность));

КонецПроцедуры

```

Листинг 3.4.12

Опять создадим новую команду «ВычислитьКореньСТочностьюПять», и в её обработчике напишем следующий код:

```csharp

&НаКлиенте

Процедура ВычислитьКореньСТочностьюПять(Команда)

Перем А;

Если ВвестиЧисло(А, "Введите число А") Тогда ВычислитьКореньИВывестиТочностьПять(А,"А"); ВычислитьКореньИВывестиТочностьПять(А,"А",3);

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.13

Разберите данный пример самостоятельно.

Рассмотрим последний оператор, который применим просто к процедурам, а не к их параметрам. Это оператор *Возврат*.

Рассмотрим синтаксис.

Процедура ИмяПроцедуры(Параметр1, Параметр2, ….,ПараметрN)

///операторы

Возврат;

//операторы

КонецПроцедуры

В данном синтаксисе, параметры могут задаваться каким угодно из вышеперечисленных способов. 146стр.<<

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

Сделайте пример. В этом примере Вы также будете вычислять квадратный корень числа, но если число отрицательное, то будет выполнен выход из процедуры (см. рис. 3.4.4).

Создадим процедуру «ВычислитьКореньТолькоПоложительныхЧисла»:

```csharp

&НаКлиенте

Процедура ВычислитьКореньТолькоПоложительныхЧисла(ЧислоПодКорнем, НазваниеЧисла)

Если ЧислоПодКорнем < 0 тогда

Предупреждение("Нельзя извлекать квадратный корень из отрицательного числа!");

Возврат;

КонецЕсли;

КореньА = Sqrt(ЧислоПодКорнем);

Сообщить("Корень из числа " + НазваниеЧисла + " = " + Окр(КореньА,5));

КонецПроцедуры

```

Листинг 3.4.14

Опять создадим новую команду «ВычислитьКореньПоложительногоЧисла» и в её обработчике напишем следующий код:

```csharp

&НаКлиенте

Процедура ВычислитьКореньПоложительногоЧисла(Команда)

Перем А;

Если ВвестиЧисло(А, "Введите число А") Тогда

ВычислитьКореньТолькоПоложительныхЧислел(А,"А");

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.15

Разберем данный пример. В самом начале процедуры мы проверяем, меньше ли нуля параметр *ЧислоПодКорнем* или нет. Если меньше нуля, то выводим предупреждение и посредством оператора Возврат выходим из процедуры.

Сохраните и перезапустите Вашу обработку. 147стр.<<

Нельзя извлекать квадратный корень из отрицательного числа!

ОК

Рис. 3.4.4

Обращаю Ваше внимание: что бы Вы ни написали после слова *Возврат*, все это выполняться уже не будет. Теперь самостоятельно напишите предупреждение после ключевого слова Возврат и посмотрите, что получится.

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

Рассмотрим синтаксис написания функции. Как я уже рассказывал, все, что мы изучили касательно параметров на примере процедур, абсолютно справедливо и для функций.

Итак, синтаксис функций.

Функция ИмяФункции(<Параметры>)

//операторы

Возврат ВозвращаемоеЗначение;

КонецФункции

Рассмотрим данный синтаксис. Ключевое слово *Функция* идет всегда перед названием функции. Поскольку все параметры мы разобрали на примере процедуры, не будем подробно останавливаться на этом. После параметров идут операторы, которые описывают те или иные действия внутри функции (для удобного чтения кода я рекомендую начинать писать их со следующей строки и делать отступ с помощью клавиши «*Tab*»). Основное отличие функции от процедуры в том, что ключевое слово *Возврат* не только завершает выполнение функции, но и возвращает определенное значение в то выражение, где использовалась данная функция. Ключевое слово *КонецФункции* завершает код функции. Как и в случае процедуры, все, что Вы написали после данного слова, не будет иметь к вашей функции никакого отношения.

Рассмотрим пример. Напишем функцию Сигнум, параметром которой является некоторое число, и она возвращает 1, если число больше нуля; ноль, если число равно нулю; и -1, если число меньше нуля.

Создайте в модуле формы следующую функцию: 148стр.<<

```csharp

&НаКлиенте

Функция Сигнум(ЧислоА)

Перем Сигн;

Если ЧислоА > 0 тогда

Сигн = 1;

ИначеЕсли ЧислоА = 0 тогда

Сигн = 0

ИначеЕсли ЧислоА < 0 тогда

сигн = -1

КонецЕсли;

Возврат Сигн;

КонецФункции

```

Листинг 3.4.16

Опять создадим новую команду «*ВычислитьСигнумЧисла*» и в её обработчике напишем следующий код:

```csharp

&НаКлиенте

Процедура ВычислитьСигнумЧисла(Команда)

Перем А;

Если ВвестиЧисло(А, "Введите число А") Тогда

В = Сигнум(А); Сообщить("Signum (" + А + ") = " + В);

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.17

Разберем данный код.

В модуле формы мы создали функцию, которая называется *Сигнум*, указываем, что у нее только один параметр, назовем его *ЧислоА*. После этого задаем переменную внутри функции, которую мы будем возвращать, назовем ее *Сигн*. Делаем сравнение, в результате которого *Сигн* становится равен либо единице, либо нулю, либо минус единице.

Смотрим основной код в обработчике команды «*ВычислитьСигнумЧисла*». Первым делом интерактивно вводим некоторое число *А*. В следующей строке используем Вашу вновь созданную функцию: передаем в нее переменную *А*, а возвращать она будет переменную *В*, значение которой выводим в сообщении..

Сохраните обработку и посмотрите, как работает Ваша функция.

Обращаю ваше внимание, что необязательно писать один Возврат и только в конце функции, вполне может быть и такой вид функции:

149стр.<<

```csharp

&НаКлиенте

Функция л_Сигнум(ЧислоА)

Если ЧислоА > 0 тогда

Возврат 1;

ИначеЕсли ЧислоА = 0 тогда

Возврат 0;

ИначеВозврат -1

КонецЕсли;

КонецФункции

```

Листинг 3.4.18

Как видно из данного примера, после каждого результата сравнения мы возвращали нужное нам значение.

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

Сделаем пример, с помощью которого Вы поймете данный тезис. В этом примере мы будем вычислять квадратный корень из числа и возвращать значение в виде параметра, а сама функция будет возвращать Истина, если удалось вычислить, и Ложь, если нет.

Напишите в модуле формы следующую функцию:

```csharp

Функция ВычислитьКвадратныйКорень(НазваниеЧислаПодКорнем, ЧислоПодКорнем, КореньЧисла)

Если ЧислоПодКорнем < 0 тогда

Сообщить("Нельзя вычислять корень из отрицательного числа");

Возврат Ложь; иначе

КореньЧисла = Окр(Sqrt(ЧислоПодКорнем),5);

Сообщить("Корень из числа " + НазваниеЧислаПодКорнем + " = " + КореньЧисла);

Возврат Истина;

КонецЕсли;

КонецФункции

```

Листинг 3.4.19

Опять создадим новую команду «ВычислитьКореньЧислаФункцией» и в её обработчике напишем следующий код:

```csharp

&НаКлиенте

Процедура ВычислитьКореньЧислаФункцией(Команда)

Перем А,Б;

Если ВвестиЧисло(А, "Введите число А") Тогда

ВычислитьКвадратныйКорень("А",А,Б);

КонецЕсли;

КонецПроцедуры

```

Листинг 3.4.20 150стр.<<

Разберем данный пример. Наша функция имеет три параметра: название числа под корнем, само число, которое будет под корнем, и корень из этого числа. Если число под корнем меньше нуля, то мы возвращаем Ложь, соответствующее сообщение и ничего не считаем, а если нет - то возвращаем Истина, вычисляем число и выводим соответствующее сообщение.

В основной процедуре мы задаем данную функцию в виде процедуры. Поскольку нам в этом случае не интересно, что она вернет, нам важно знать, какое будет число Б.

К примеру, мы можем использовать то, что возвращает эта функция для дальнейшей работы с числом Б, по аналогии как мы используем функцию ВвестиЧисло. Теперь сами измените данный пример и возведите в квадрат полученное число Б, если оно было вычислено.

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

Остался только момент про экспорт процедур и функции. Этот вопрос мы будем проходить в четвертой главе. 151стр.<<

.

.

В заключительной части третьей главы мы рассмотрим очень нужный и полезный оператор **Попытка… Исключение**. В чем суть этого оператора? Как Вы уже заметили из предыдущих примеров, в ходе выполнения программы могут возникать ошибки, такие как деление на ноль, корень из отрицательного числа и прочие. Мы эти ошибки обходили конструкцией *Если...Тогда*, но не всегда возможно применить данную конструкцию, чтобы обойти исключительную ситуацию. Поэтому в языке программирования 1С существует оператор Попытка…Исключение.

Рассмотрим его синтаксис.

Попытка

//операторы попытки

Исключение

//операторы исключения.

КонецПопытки

Разберем данный синтаксис.

Ключевое слово **Попытка открывает список операторов, выполнение которых может привести к исключительной ситуации**, все операторы между ключевыми словами Попытка и Исключение это Операторы попытки.

Ключевое слово Исключение открывает список операторов, которые будут выполняться в том случае, если вызвана исключительная ситуация операторами попытки. Т.е. если во время выполнения программы один из операторов попытки вызвал ошибку выполнения программы (исключительную ситуацию), то выполнение данного оператора прерывается и управление передается на первый Оператор исключения. Причем обращаю Ваше внимание, что управление будет передано и в том случае, если исключительную ситуацию вызвали функции и процедуры, разработанные программистом и применяемые в качестве операторов попытки. Естественно, что если ошибка произошла в процедуре или функции, то ее выполнение будет прервано.

Создайте обработку, форму, команду на форме и в обработчике команды сделайте следующий пример: 152стр.<<

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем А;

Если ВвестиЧисло(А,"Введите число А") тогда

Попытка

КореньЧислаяА = Sqrt(А);

Сообщить("Квадратный корень числа А = " + Окр(КореньЧислаяА,5));

Исключение Сообщить("Попытка извлечь корень из отрицательного числа");

КонецПопытки;

КонецЕсли;

КонецПроцедуры

```

Листинг 3.5.1

Разберем данный пример.

Как обычно, вводим интерактивно число, после чего пытаемся вычислить квадратный корень данного числа. Используем ключевые слова Попытка, Исключение, КонецПопытки. Эти ключевые слова всегда должны быть в наличии и представлены в такой очередности, как мы видим. Таким образом, в Вашем примере вычисление квадратного корня и вывод сообщения являются операторами попытки. Между словом Исключение и КонецПопытки располагаются операторы исключения. На эти операторы перейдет программа после вызова исключения. Операторы попытки, следующие после строки, когда, где была инициализирована ошибка, исполняться не будут.

Запустите вновь созданную обработку и посмотрите, как она работает.

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

Переделайте Ваш пример.

```csharp

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Перем А;

Если ВвестиЧисло(А,"Введите число А") тогда

Попытка КореньЧислаяА = Sqrt(А);

Сообщить("Квадратный корень числа А = " + Окр(КореньЧислаяА,5));

Исключение Сообщить("Попытка извлечь корень из отрицательного числа");

ВызватьИсключение;

КонецПопытки;

КонецЕсли;

КонецПроцедуры

```

Листинг 3.5.2

В данном примере после операторов исключения пишем оператор ВызватьИсключение. 153стр.<<

Сохраните, запустите и введите отрицательное число.

Должно выйти следующее окно:

Неправильное значение аргумента встроенной функции (Здгт.)

ОК Подробно

Рис. 3.5.1

Как видите, оператор исключения отработал, и сразу вышла ошибка о неправильном параметре.

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

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

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

Напишите в модуле формы следующую функцию:

```csharp

&НаКлиенте

Функция ВычеслитьИОкруглитьКорень(ЧислоПодКорнем,Точность = 5)

КореньЧисла = Окр(Sqrt(ЧислоПодКорнем),Точность);

Возврат КореньЧисла;

КонецФункции

```

Листинг 3.5.3

Создадим команду «ПолучитьПогрешностьОкругления» и в обработчике команды напишем следующий код: 154стр.<<

```csharp

&НаКлиенте

Процедура ПолучитьПогрешностьОкругления(Команда)

Перем А;

Если ВвестиЧисло(А,"Введите число А") тогда

Попытка А2 = Pow(ВычеслитьИОкруглитьКорень(А,10),2);

ПогрешностьОкругления = А - А2;

Сообщить("Погрешность окуругления = " + ПогрешностьОкругления);

Исключение Сообщить("Ошибка при вычислении");

КонецПопытки;

КонецЕсли;

КонецПроцедуры

```

Листинг 3.5.4

Сохраните и запустите Вашу обработку.

Если сделано все правильно, то Вы увидите, что при введении положительного числа выходит результат, а в случае отрицательного числа – сообщение об ошибке.

Разберите данный пример самостоятельно.

.

Сейчас мы рассмотрели оператор Попытка…Исключение. Теперь Вы сможете избегать неприятных ситуаций с возникновением ошибок. Особенно желательно использовать данный оператор **в критических моментах выполнения кода, например, при записи чего-либо в базу**.

Резюме

На этом третья глава закончилась. В ней Вы научились работать с условиями, а также освоили два из трех операторов цикла. После данного урока Вы сможете создавать собственные процедуры и функции, а также использовать оператор Попытка…Исключение в своей практике программирования. Удачи в изучении языка! 155стр.<<

Часть 1. Основы конфигурации

Часть 2. Модули

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

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

Часть 1. Основы конфигурации

(окно конфигурации)

Рис. 4.1.1 156стр.<<

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

Например, есть некоторая прикладная задача (а «1С:Предприятие» создано только для реализации прикладных задач), суть которой - это автоматизация бухгалтерского учета, или торгового учета, или любого другого учета, необходимого пользователю. Под эту задачу разрабатывается конфигурация, которая реализовывает в 1С модель данного учета.

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

На рисунке 4.1.1. приведена пустая конфигурация. Такая конфигурация бывает обычно перед началом какой-либо разработки. В реальном случае любая конфигурация всегда содержит какие-нибудь Метаданные.

Что такое Метаданные?

Метаданные - это **объекты конфигурации**. К примеру, конкретный справочник «Автомобили» это объект метаданных. Документ «Счет на оплату» – тоже объект метаданных.

У каждого объекта метаданных есть свой прототип, который определяет основные свойства и методы этого объекта метаданных. Как вы заметили из рисунка 4.1.1, конфигурация имеет древовидную структуру, где сама конфигурация это, по сути, корень дерева, а ветки «Справочники», «Документы», «Константы» и т.д. - это прототипы метаданных. Соответственно в рамках нужных прототипов и создаются определенные объекты метаданных. Например, в ветке «Справочники» будут созданы все справочники, т.е. объекты, необходимые для хранения постоянной или условной информации. У всех объектов, созданных в ветке «Справочники», будет примерно одинаковый набор свойств и методов (в зависимости от параметров конкретного объекта метаданных).

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

А для этого нам потребуется изучить основные прототипы метаданных.

И первый прототип, который мы изучим, это - Константы. 157стр.<<

(Константы в дереве конфигурации)

Рис. 4.1.2

Если Вы изучали другие языки программирования, то у Вас будет легкое недоумение от того, что константы в 1С не несут в себе такую же функциональную нагрузку, как в языках Паскаль, С и т.п. В конфигурации 1С константы **хранят в себе постоянную или условно постоянную** информацию, которая или никогда не изменяется, или изменяется очень редко. Это может быть, к примеру, название организации или ИНН организации и т.п. Основное отличие констант 1С в том, что пользователь в принципе может изменять данные константы по своему усмотрению. Для работы с константами в конфигурации имеется ветвь «Константы». Она выделена на рисунке 4.1.2.

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

(дереве конфигурации-Констранта-Добавить)

Рис. 4.1.3

Откроется окно "Свойства константы" (или палитра свойств констант).

Рис. 4.1.4. 158стр.<<

В этой форме вводим Имя константы (назовем ее НазваниеОрганизации) и Синоним – аналог имени, который будет отображаться пользователю. Тип константы (мы пока знаем только 4 типа) - выберем тип Строка. Длина - это длина строки, сделаем ее равной ста.

(окно)

Рис. 4.1.5

Допустимая длина может быть либо фиксированной, либо переменной. Переменная отличается от фиксированной тем, что если в первом случае Вы ввели при длине 100 символов строку из 20 символов, то в базе будет храниться строка из 20 символов, а в фиксированном случае будут храниться все 100 символов, остальные 80 заполнятся пробелами.

Вот мы создали первую константу. Создайте самостоятельно следующие константы: ДатаНачалаРаботыОрганизации (тип Дата, состав даты Дата, см. рис. 4.1.6), ПроцентНалогаНаПрибыль (тип Число с точностью до одной сотой).

Рис. 4.1.6

В итоге у Вас должен получиться следующий набор констант:

Рис. 4.1.7 159стр.<<

Для констант можно создать собственную форму.

Рис. 4.1.8

В открывшемся конструкторе формы оставляем все без изменения и нажимаем кнопку «Готово». Вышла форма констант, которая появилась в ветке «Общие»-«Общие формы».

Рис. 4.1.9. 160стр.<<

Рис. 4.1.10

Более подробно работу с формами мы рассмотрим в пятой и шестой главе.

После того, как Вы создадите константы и форму констант, у окна конфигурации появится знак «* (звездочка)» (см. рис. 4.1.11), это значит, что Ваша **конфигурация отредактирована, но не сохранена**. Чтобы ее сохранить, нужно нажать на кнопку «Сохранить» (см. рис. 4.1.12).

Рис. 4.1.11

Рис. 4.1.12 161стр.<<

.

.

После сохранения, у окна конфигурации появится знак «!» (см. рис. 4.1.13). Это значит, что **Ваша конфигурация сохранена, но не загружена в базу**.

Рис. 4.1.13

Почему так? Сделаем небольшое отступление. В базе 1С хранятся две конфигурации (даже три, если база на поддержке). Это конфигурация базы данных, т.е. те наборы метаданных, с которыми непосредственно работает пользователь. И просто конфигурация, с которой работает разработчик, назовем ее «конфигурация разработчика». Разработчик (программист) не может напрямую менять конфигурацию базы данных. Он работает только с конфигурацией разработчика. После того, как программист внесет все изменения, он может или обновить конфигурацию базы данных, нажав на соответствующую кнопку (см. рис. 4.1.13), или вернуться к конфигурации базы данных, нажав на пункт меню «Вернуться к конфигурации базы данных» (см. рис. 4.1.14), тогда все его изменения затрутся, и конфигурация разработчика будет идентична конфигурации базы данных.

Рис. 4.1.14

Рис. 4.1.15 162стр.<<

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

Рис. 4.1.16

В верхней панели у Вас появится меню «Сервис», раскрыв которое, Вы увидите пункт «Форма констант» (см. рис. 4.1.17).

Рис. 4.1.17

После нажатия на этот пункт откроется форма, которую мы создали ранее (см. рис. 4.1.18).

Рис. 4.1.18 163стр.<<

Введите в неё какие-нибудь данные и нажмите на кнопку «Записать», тем самым Ваши константы запишутся в базу данных. Почему так произошло, мы изучим позже, когда будем проходить объектные типы (шестая глава).

Изучим следующий прототип объектов конфигурации - это Справочники.

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

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

Применительно к автомобилям это может быть госномер, основной водитель, вид коробки передач (автоматическая или ручная) и т.п. Еще новая возможность справочников (в 1С 7.7. этого нет) - это возможность создавать табличные части, в которых хранится однотипная информация, количество которой может быть изменчивым. Например, для автомобиля это может быть комплектация: какой-то автомобиль может идти с подушкой безопасности и стеклоподъемниками, а какой-то просто со стеклоподъемниками.

Реквизитов и табличных частей может быть неограниченное количество.

Разберем поэтапно создание справочника. Первый справочник это МаркиАвтомобилей.

Кликаем правой кнопкой мышки на верхний элемент конфигурации «Справочники». И нажимаем кнопку «Добавить».

Рис. 4.1.19 164стр.<<

Открылся конструктор справочника. Вводим название справочника МаркиАвтомобилей и синоним (то, что будет видеть пользователь) Марки автомобилей.

Рис. 4.1.20

В этом справочнике не будет реквизитов, поэтому сразу идем на закладку «Данные» и выставляем длину кода 3, а длину наименования 10.

Рис. 4.1.21

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

Точно так же с такими же значениями стандартных реквизитов самостоятельно создайте справочник МоделиАвтомобилей. Подсказка: можете скопировать справочник МаркиАвтомобилей и поменять название.

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

Вновь открывается форма элемента справочника. Вносим название справочника: Автомобили, и идем на закладку «Данные». Длину кода оставим ту же, что и в предыдущем 165стр.<<

случае (3), длину наименования сделаем 50. Теперь создаем реквизиты. Первый реквизит ГодВыпуска, тип Дата (состав даты Дата), второй ГосНомер, тип Строка (длина 10).

Рис. 4.1.22

И третье, самое интересное, мы создаем реквизит Марка, тип которого Ссылка на справочник МаркаАвтомобиля.

Рис. 4.1.23

Точно так же добавьте реквизит Модель, тип которого Ссылка на справочник МоделиАвтомобилей.

Более подробно ссылочные типы мы будем разбирать в следующей главе. Напоследок создаем табличную часть и назовем ее ДополнительныеОпции. В табличной части создаем реквизит Опция с типом ссылка на справочник Опции (создайте самостоятельно, без реквизитов, длина кода 3, длина наименования 50). 166стр.<<

Рис. 4.1.24

И последний справочник, который создадим в этой части, это будет справочник Гаражи, у которого нет реквизитов, а длина кода и наименования такая же, как у справочника Опции.

Создайте его самостоятельно. Сохраните конфигурацию.

Рис. 4.1.25

Обновите базу данных.

Рис. 4.1.26

Теперь посмотрим, как выглядит наш справочник. И заполним его парой элементов. Запустите «1С:Предприятие». Все справочники появились в верхней панели (см. рис. 4.1.27). 167стр.<<

Рис. 4.1.27

Пока не создавайте никакие элементы справочников, сделаем это после того, как изучим все свойства этого прототипа.

.

.

У любого справочника можно создать Предопределенный элемент - это **элемент, который создан в конфигураторе, и с ним можно работать как с обычным элементом**. Этот элемент есть всегда, в платформе 8.2 его нельзя было пометить на удаление и удалить, в платформе 8.3. предопределенные объекты можно удалять в пользовательском режиме. Создадим два предопределенных элемента для справочника Марки автомобилей - «Российские» и «Иномарки».

Зайдите в форму справочника, для этого кликнув правой кнопкой мышки по справочнику Марки автомобилей, и выберете в открывшемся меню «Открыть предопределенные данные»

Рис. 4.1.28

В открывшемся списке добавьте новый элемент. 168стр.<<

Рис. 4.1.29

Точно так же создадим элемент «Иномарка».

Рис. 4.1.30

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

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

Рис. 4.1.31

Если мы создадим новый элемент в «1С:Предприятии» (см. рис. 4.1.32), то он отличаться от предопределенного будет по значку рядом с наименованием (см. рис. 4.1.33). 169стр.<<

Рис. 4.1.32

Рис. 4.1.33

.

.

В конфигурации 1С 8 можно разрабатывать Подчиненные справочники. В Подчиненном справочнике **каждый его элемент имеет владельца, который является элементом или группой другого справочника**. Элемент подчиненного справочника не может существовать без владельца.

Например, у нас есть два справочника «Марки автомобилей» и «Модели автомобилей». У марки автомобиля может быть несколько разных моделей, поэтому естественно их связать между собой. В этом случае справочник «Марки автомобилей» будет владельцем справочника «Модели автомобилей». Сделаем это.

Для этого зайдем в конструктор справочника «Модели автомобилей» и перейдем на закладку «**Владельцы**».170стр.<<

Рис. 4.1.34

Список владельцев пустой. Нажмите на карандаш, должно открыться окно выбора объектов, ставим флажок возле справочника «Марки автомобилей» и нажимаем «ОК».

Рис. 4.1.35

Использование подчинения оставляем Элементы.

Рис. 4.1.36

Сохраните конфигурацию и запустите «1С:Предприятие». Откроем справочник «Марки автомобилей» и зайдем в элемент, который создали в прошлом подразделе - Ford. 171стр.<<

Рис. 4.1.37

Как видите, вверху элемента справочника появилась команда «Модели автомобилей». Платформа автоматически разместила эту команду в панели навигации элемента справочника. Если мы сейчас по ней кликнем, то откроется список всех моделей автомобилей, у которых владелец текущей элемент справочника «Марки автомобилей». В нашем случае он пустой, и мы добавим какую-нибудь модель автомобиля (см. рис. 4.1.38).

Рис. 4.1.38

Рис. 4.1.39

Теперь создадим новую марку (пусть это будет KIA) и добавим для неё новую модель (пусть это будет Rio). 172стр.<<

Рис. 4.1.40

А теперь попробуем создать новый элемент справочника Автомобили, где выберем какую-нибудь марку (пусть будет Ford), и попробуем выбрать модель.

Рис. 4.1.41 173стр.<<

Рис. 4.1.42

Как видите, в форме выбора модели есть выбор и моделей Ford, и моделей KIA, что согласитесь, немного неудобно. Как же сделать так, чтобы в форме выбора были модели только для той марки, которая выбрана в реквизите элемента справочника. Для этого нам понадобится зайти в конфигураторе в свойства реквизита «Модель» справочника «Автомобили» (дважды кликнув левой клавишей мышки по реквизиту в дереве конфигурации). В открывшейся палитре свойств нас интересует свойство «Связи параметров выбора».

Рис. 4.1.43

При помощи этого свойства можно настроить зависимость выбираемых параметров от значений других реквизитов. Откроем форму «Связи параметров выбора», нажав на кнопку «…».

Рис. 4.1.44

Поскольку нам нужно установить связь реквизита Модель с реквизитом Марка, то перетащим этот реквизит из левой части в правую. 174стр.<<

Рис. 4.1.45

Нажмем кнопку «ОК» формы связи параметров выбора.

Рис. 4.1.46

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

Рис. 4.1.47

Как видите, вышла только одна модель, у которой владелец марка Ford.

Любой справочник можно сделать Иерархическим – это значит, что пользователь сможет создавать каталоги (или, говоря простым языком, папки), в которых будут содержаться элементы. 175стр.<<

Сделаем справочник Гаражи иерархическим. Для этого переходим на закладку «Иерархия» конструктора справочника и установим флаг «Иерархический».

Рис. 4.1.48

Иерархия у справочников бывает двух видов: **Иерархия групп и элементов** и просто **Иерархия элементов**.

Иерархия групп - это **каталоги, которые в себе содержат определенные элементы**. А что такое

Иерархия элементов? Это когда **один элемент подчинен другому**.

К примеру, у Вас есть большой гараж (ангар), в котором много маленьких гаражей. Вам необходимо вести учет автомобилей по большому гаражу, поскольку они могут храниться вне маленьких, а также учет по маленьким гаражам. В этом случае справочник Гаражи будет удобно сделать с Иерархией элементов. Но если Вам еще понадобится объединять гаражи по какой-то общей группе, по которой не будет вестись отдельного учета, то необходимо сделать Иерархию групп и элементов. Например, у Вас может быть каталог Авто База, в которой будут перечислены все гаражи.

Посмотрим, как выглядит иерархический справочник в «1С:Предприятии». Сохраним конфигурацию, обновим базу данных и зайдем в форму списка справочника «Гаражи».

Рис. 4.1.49

Как видите, в форме списка появилось две команды. «Создать» и «Создать группу». При выполнении команды «Создать» будет открыта форма на создание нового элемента, а при выполнении команды «Создать группу» - форма на создание группы (папки).

Создадим каталог Авто база 1. 176стр.<<

Рис. 4.1.50

Пишем наименование «База 1». Родитель пустой. Нажмем кнопку «Записать и закрыть», группа будет создана. Зайдите в папку, кликнув на нее два раза, и добавьте элемент. В этот раз выполним команду «Создать».

Рис. 4.1.51

Открылась форма, где уже родитель заполнен. Назовем элемент Гараж № 1.

Сохраним элемент.

Рис. 4.1.52

Как Вы видите, данный гараж находится в группе Авто база. 177стр.<<

.

.

Документы предназначены для **отражения определенных событий** в программе, которые имеют отношение к предметной области. Например, касательно учета автотранспорта, это могут быть события прибытия автомобиля в гараж, убытия из гаража и постановки на ремонт. Основными стандартными реквизитами документов являются *Номер документа* и *Дата документа*. Как и в случае со справочниками, остальная вспомогательная информация может храниться в реквизитах и табличных частях. Суть их такая же, как у реквизитов и табличных частей для справочников.

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

.

.

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

Создадим теперь четыре документа: Прибытие в гараж, Выбытие из гаража, Заправка топлива и Отчет о расходе топлива.

Впоследствии первый будет делать соответствующие движения по регистру накопления «Пробег автомобиля», а последние два по регистру накопления «Расход топлива», но мы дойдем до этого, когда будем разбирать регистры накопления.

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

Рис. 4.1.53

Открылось меню вновь созданного документа. Назовите Ваш документ ПрибытиеВГараж, синоним должен появиться автоматически. 178стр.<<

Рис. 4.1.54

Перейдите на закладку «Данные» и создайте три реквизита: Автомобиль, Гараж и Дата прибытия.

Рис. 4.1.55

Первый реквизит будет иметь тип Ссылка на справочник Автомобили, второй - тип Ссылка на справочник Гараж, а третий – Дата (состав Дата и время). 179стр.<<

Рис. 4.1.56

Точно так же создайте документ Выбытие из гаража. Реквизиты – Автомобиль, Гараж и ДатаВыбытия. Типы реквизитов аналогичны типам в документе Прибытие в гараж.

Теперь создайте документ Заправка топлива. Поначалу действуйте все так же. Создайте два реквизита: ДатаЗаправки с типом Дата (состав даты Дата) и ТипТоплива (ссылка на справочник ТипыТоплива, справочник ТипыТоплива создайте самостоятельно, без реквизитов, длина кода 3, длина наименования 10).

Создайте табличную часть Автомобили, где будет два реквизита: Автомобиль (тип Ссылка на справочник Автомобили) и Количество (тип Число(10,2)). Для этого идите в закладку Данные и кликните правой кнопкой мышки на Табличную часть. После нажмите на кнопку «Добавить».

Рис. 4.1.57

Табличная часть будет создана, переименуйте ее в «Автомобили» (сделать это можно в палитре свойств табличной части, чтобы в неё зайти, нужно дважды кликнуть мышкой по нужной табличной части). 180стр.<<

Рис. 4.1.58

И добавьте новый реквизит данной табличной части.

Рис. 4.1.59

Назовите его Автомобиль и присвойте тип Ссылка на справочник Автомобили.

Рис. 4.1.60

Точно так же добавьте реквизит Количество с типом Число (длинна 10, точность 0).

В дальнейшем число с длинной X, а точностью Y будем писать так: Число (X,Y).

Осталось создать документ «Отчет о расходе топлива», сделайте это самостоятельно, в этом документе будет точно такой же набор полей, как и в документе «Заправка топлива», только вместо ДатаЗаправки будет поле ДатаОтчета. 181стр.<<

Рис. 4.1.61

Мы создали все необходимые документы для нашей конфигурации. Зайдите в «1С:Предприятие» и попробуйте создать несколько разных документов.

.

Рассмотрим еще одну интересную особенность объектов 1С - это Ввод на основании. Что такое Ввод на основании? Это значит, что **на основе имеющегося объекта (документа или справочника) можно создать новый объект другого вида, причем часть полей нового объекта будут заполнены автоматически и взяты из основного объекта**. Данная особенность очень удобна, поскольку позволяет в некоторых случаях экономить пользователю время и исключает возникновение дополнительных ошибок.

Доработаем нашу конфигурацию так, чтобы на основании документа Прибытие в гараж можно было создать документ Выбытие из гаража, причем реквизит Автомобиль и Гараж заполнятся автоматически.

Для этого зайдите в менеджер объекта Выбытие из гаража. И перейдите на **закладку «Ввод на основании»**. 182стр.<<

Рис. 4.1.62

В верхнем окне «Вводится на основании» нажмите на карандаш, откроется окно выбора объектов.

Рис. 4.1.63

В окне выбора объектов, установите флажок напротив документа Прибытие в гараж и нажмите кнопку «ОК».

После этого в верхнем окне закладки «Ввод на основании» появится название выбранного документа: 183стр.<<

Рис. 4.1.64

А если Вы зайдете в аналогичную закладку менеджера документа «Прибытие в гараж», то увидите, что заполнено окно «Является основанием».

Рис. 4.1.65

Теперь Вам необходимо разработать механизм заполнения документа основания. Для этого необходимо создать в модуле объекта соответствующего документа процедуру Обработка основания.

Можно это сделать вручную, а можно воспользоваться конструктором. Мы воспользуемся конструктором. Для этого, не выходя из закладки «Ввод на основании» конструктора документа Выбытие из гаража, нажимаем на кнопку «**Конструктор ввода на основании**». 184стр.<<

Рис. 4.1.66

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

Рис. 4.1.67

В правом верхнем окне показаны реквизиты документа основания (Прибытие в гараж), а в нижнем окне реквизиты текущего документа Выбытие из гаража. При установке курсора на строку нужного поля нижнего в верхнем левом окне зеленым флажком будут отмечены реквизиты документа основания, тип которых совпадает с типом выделенного поля (см. рис. 4.1.67).

Чтобы совместить реквизит основного документа с реквизитом документа основания, необходимо выделить строку с нужным реквизитом в нижней таблице и дважды кликнуть на соответствующий реквизит левой верхней таблицы. Мы совместим реквизиты «Автомобиль – Автомобиль» и «Гараж – Гараж».

185стр.<<

Рис. 4.1.68

Нажмите «ОК», и процедура заполнения на основании будет создана автоматически.

Рис. 4.1.69

Сохраните конфигурацию и создайте документ Выбытие из гаража на основании документа Прибытие в гараж.

Следующий объект конфигурации, который мы рассмотрим, - это Журнал документов. Журнал документов, как ясно из названия, предназначен для просмотра документов. Как Вы уже увидели, в списке каждого документа можно посмотреть только документ одного вида. Иногда очень полезно видеть документы разных видов в одном месте. Для этого и необходим журнал документов. Каждый документ может быть отнесен к тому или иному журналу, либо быть вообще без журнала. В отличие от справочников и документов, журнал не добавляет новой информации в систему, а **служит только для отображения имеющейся информации**.

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

Для этого кликните правой кнопкой мышки по пункту «Журналы документов» в конфигурации и выберите пункт «Добавить». 186стр.<<

Рис. 4.1.70

Откроется форма журнала, где Вы назовете его ПрибытиеВыбытиеАвтомобилей.

Рис. 4.1.71

Осталось задать регистрирующие документы. Для этого заходим в закладку «Данные».

Рис. 4.1.72

Окошко «Регистрирующие документы» пустое, заполните его. Необходимо нажать на кнопку «Редактировать элемент списка» в виде карандашика, и в открывшемся окне выберите документы ПрибытиеВГараж и ВыбытиеИзГаража. 187стр.<<

Рис. 4.1.73

Нажмите «Закрыть». Журнал готов.

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

Рис. 4.1.74

Из формы журнала Вы видите, что у нас только номер, дата и тип документа, что, согласитесь, иногда бывает недостаточно. Добавим в журнал еще две колонки, это Гараж и Автомобиль. Для этого воспользуемся окном «Графы» на закладке конструктора журнала документов (см. рис. 4.1.75).

Рис. 4.1.75 188стр.<<

Добавим новую графу в журнал документов. Для этого нажмем на кнопку «Добавить» окна «Графы».

Рис. 4.1.76

Графа добавилась, теперь нам необходимо задать, какие поля документов будут отображаться в этой графе. Для этого в палитре свойств графы нужно нажать на кнопку «…» у свойства «Ссылки», после этого откроется окно, где нужно указать реквизиты документов журнала, которые должны отобразиться в данной графе (см. рис. 4.1.77).

Рис. 4.1.77

Графу можно переименовать.

Рис. 4.1.78 189стр.<<

После этих доработок журнал документов будет выглядеть гораздо интереснее:

Рис. 4.1.79

Самостоятельно добавьте новую графу, чтобы журнал выглядел следующим образом:

Рис. 4.1.80

.

.

Следующий объект конфигурации - это Перечисления. Перечислениями называют **объекты конфигурации**, которые **содержат в себе постоянные значения, не изменяемые в процессе работы с программой**. Перечисления задаются на этапе конфигурирования, и их нельзя менять пользователю во время работы программы.

Создайте перечисление Коробка передач с двумя значениями: Ручная и Автоматическая. И добавим данный реквизит в справочник Автомобили.

Для этого кликаете правой клавишей мышки по пункту «Перечисления» и выбираете «Добавить».

Рис. 4.1.81

У Вас откроется меню элемента перечисления. Назовите его КоробкаПередач. 190стр.<<

Рис. 4.1.82

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

Рис. 4.1.83

Значение создалось, назовите его Ручная.

Рис. 4.1.84

Точно так же создайте второе значение - Автоматическая.

Теперь перейдите в Ваш справочник Автомобили и добавьте новый реквизит Коробка передач, тип которого будет Ссылка на перечисление Коробка Передач. 191стр.<<

Рис. 4.1.85

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

Рис. 4.1.86

Вы научились создавать в конфигураторе справочники, перечисления, документы и журналы документов. Теперь плавно перейдем к изучению регистров. Вся информация, которая вводится с помощью документов, должна быть отражена в регистрах, для того чтобы впоследствии можно было ее извлечь и проанализировать. 192стр.<<

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

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

И первым делом мы рассмотрим регистр сведений. Более подробно о том, как работать с регистрами сведений, Вы узнаете в десятой главе. В этой главе мы изучим только моменты, связанные с конфигурированием регистра сведений.

Регистры сведений необходимы для **хранения различной информации**, которая может быть важна для прикладной области. Данная информация хранится в разрезе измерений, также она может изменяться во времени.

Регистры сведений, информация которых **изменяется во времени**, называются Периодическими. Периодичность может быть разной, может быть периодичность в секунду, минуту, час и т.д. максимум - год.

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

Основное отличие в использовании справочников и регистров сведений в том, что **в справочниках** должны храниться **объекты аналитики** (контрагенты, номенклатура, автомобили, виды топлива и т.д.), а **в регистре сведений** должны храниться **показатели для этих объектов**. Например, это может быть цена на топливо у того или иного поставщика. Или гараж по умолчанию, где должен стоять автомобиль. Причем у регистров сведений осуществляется контроль уникальности в разрезе измерений (чего нет у справочников). К примеру, если у нас будет непериодический регистр сведений «Цены на топливо» с измерениями «Тип топлива» и «Поставщик» и одним ресурсом – цена, то мы не сможем создать две одинаковых записи с одними и теми же наборами измерений «Тип топлива» и «Поставщик».

Кроме измерений у регистра сведений существуют Ресурсы и Реквизиты. Ресурс должен хранить основную информацию регистра сведений, т.е. те данные, ради которых он создан, а Реквизит содержит дополнительную второстепенную информацию о записи (так же как и Реквизит у регистра накопления).

Регистры сведений бывают подчиненные регистратору, тогда записи в них будут создаваться при проведении документов. И независимые, тогда пользователь сам может создавать записи. В первом случае Режим записи устанавливается **Подчинение регистратору**, а во втором – **Независимый**.

Создадим в нашей конфигурации регистр сведений «Основной гараж автомобиля», где измерение будет Автомобиль с типом Ссылка на справочник Автомобили, и ресурс: Гараж, этот регистр будет непериодическим. 193стр.<<

Для этого кликаете правой клавишей мышки по пункту конфигурации «Регистр сведений», в появившемся меню нажимаем «Добавить».

Рис. 4.1.87

Открывается форма регистра сведений, где Вы введите название ОсновнойГаражАвтомобиля, периодичность выберете Непериодический, а режим записи Независимый.

Рис. 4.1.88

Перейдите на закладку «Данные», где необходимо создать измерение Автомобиль, тип которого будет Ссылка на справочник Автомобили. Это будет Ваше единственное измерение. Добавьте ресурсы Гараж, тип Ссылка на справочник Гаражи.

Рис. 4.1.89

Рис. 4.1.90 194стр.<<

Почему мы сделали только одно измерение, «Автомобиль»? Очевидно из названия, что у автомобиля может быть только один гараж. Как следствие не должно быть двух записей регистра сведений с одинаковыми автомобилями и разными гаражами. Мы задали только одно измерение, поэтому может быть только одна запись с конкретным автомобилем, поскольку у регистров сведений обеспечивается уникальность в разрезе измерений.

.

.

Поскольку у нас основной гараж будет устанавливаться для конкретного автомобиля, то логичнее *привязать запись регистра сведений к конкретному элементу так, чтобы, когда мы удалим это элемент, удалилась и эта запись*. Делается это при помощи свойства измерения регистра сведений **Ведущее**.

Рис. 4.1.91

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

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

Проверим это. Сохраним конфигурацию, обновим базу данных и зайдем в один из элементов справочника «Автомобили».

Рис. 4.1.92 195стр.<<

Как видите, вверху элемента появилась гиперссылка «Основной гараж автомобиля», когда мы в неё перейдем, откроется форма записей регистра сведений «Основной гараж автомобиля», в которой мы можем добавить новую запись.

Рис. 4.1.93

Рис. 4.1.94

И мы не сможем добавить еще один основной гараж автомобиля. Выйдет ошибка.

Рис. 4.1.95

Перейдем к периодическим регистрам сведений. Для этого создадим периодический регистр сведений «Цены на топливо» с периодичностью – день.

196стр.<<

Рис. 4.1.96

С двумя измерениями «ТипТоплива» (ссылка на справочник «ТипыТоплива») и «ПоставщикТоплива» (ссылка на справочник «ПоставщикиТоплива», создайте самостоятельно (без реквизитов, длина кода 3, длина наименования 100)). И одним ресурсом – цена (число (10,2)).

Рис. 4.1.97

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

Рис. 4.1.98

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

Рис. 4.1.99

А если цена будет по дню меняться несколько раз? Как быть? Можно создать более маленькую периодичность (секунда). А можно сделать режим записи – подчиненный регистратору, а периодичность – по позиции регистратора.

Рис. 4.1.100

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

Для этого создадим новый документ «Установка цен на топливо» со следующими данными и настройками. 198стр.<<

Рис. 4.1.101

Рис. 4.1.102

Не забудьте поставить везде, где нужно ссылочные типы (определите это самостоятельно).

Более подробно работу с документами будем проходить в шестой главе.

Сейчас при помощи конструктора движений создадим обработку проведения по нашему регистру. Чтобы он открылся, нажмите на кнопку «Конструктор движений» в закладке «Движения».

Рис. 4.1.103 199стр.<<

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

Рис. 4.1.104

Подберем в измерение «ТипТоплива» и ресурс «Цена» соответствующие реквизиты из табличной части, а в измерение «ПоставщикТоплива» реквизит «Поставщик» из шапки.

Рис. 4.1.105 200стр.<<

Все сделали, теперь нажмем кнопку «ОК» и в модуле документа «Установка цен» автоматически будет создана процедура.

Рис. 4.1.106

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

Рис. 4.1.107

Рис. 4.1.108 201стр.<<

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

Рис. 4.1.109

Рис. 4.1.110

Рис. 4.1.111 202стр.<<

Рис. 4.1.112

Рис. 4.1.113

Как видите, у нас получилось несколько одинаковых записей с разными ценами. Почему такое стало возможным? Ведь «Период», по сути, тоже измерение, и по нему тоже должен вестись контроль уникальности записей. Потому что мы периодичность установили «По позиции регистратора», а позиция регистратора это не только дата документа, это момент времени, в который входит дата и время документа, а также ссылка на сам документ. У двух разных документов будет два разных момента времени, поэтому и возможна такая запись регистра сведений, как на рис. 4.1.113.

Регистр накопления **хранит в себе данные о движении различных материальных величин**, это может быть: прибытие и выбытие материалов, оборот денежных средств и т.п.

Вся информация о движении хранится в разрезе измерений, а сама информация об учете (количество, сумма и т.п.) хранится в ресурсах. Помимо этого есть реквизиты, в которых хранится прочая справочная информация. 203стр.<<

Основная функция регистра накопления заключается **в суммировании ресурсов**, т.е. если какая-либо информация хранится в регистре накопления, то Вы можете в любой момент извлечь сумму всех ресурсов по любым измерениям, которые Вам интересны.

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

Регистры накопления бывают двух видов. Это **Оборотные регистры** и **Регистры остатков**.

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

.

.

Регистры остатков **фиксируют движения двух видов: приход и расход**.

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

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

Это общая информация о регистрах. Теперь перейдем к их строению. Разберем сначала, что такое Измерения. Часто информацию нужно хранить в нескольких **разрезах**.

.

подошли к важной функции измерений - **возможности суммировать нужный ресурс по любому значению измерения**.

***

Например, нам необходима информация о наличии топлива в автомобилях. Само по себе топливо уже будет измерение, но просто сведения о топливе будут неполными. Нам необходимо знать, куда именно заправлено наше топливо, поэтому мы вводим еще одно измерение – автомобиль. Пусть топливо будет Аи95 и Аи92 (измерение Топливо), а автомобиль – Директора и Гл. инженера (измерение Автомобиль). Смотрим на таблицу 4.1.1*.

Топлива Автомобиль Количество, л.

Аи95 Директора 1

Аи92 Гл. инженер 2

Аи95 Гл. инженер 5

Табл. 4.1.1

* упростим, что разные виды топлива можно заправлять в один автомобиль, и вести по ним учет

Согласно таблице 3.1.1, топливо типа Аи95 заправлено в автомобили Директора и Гл. инженера, всего топлива этого вида заправлено 6 литров. А в автомобиль Гл. инженера 204стр.<<

заправлено топливо Аи92 и Аи95, всего 7 литров. Таким образом, мы подошли к важной функции измерений - **возможности суммировать нужный ресурс по любому значению измерения**.

Задача: создать регистр накопления

***

«Регистры накопления» - «Добавить»

#ERROR!

#ERROR!

#ERROR!

прописать сами движения

док Прибытие в гараж

#ERROR!

#ERROR!

***

Сейчас мы создадим регистр накопления. Это будет регистр оборотов ПробегАвтомобиля, у него будет одно измерение - Автомобиль, соответствующего типа, и один ресурс – Пробег типа число (10,0).

Для этого кликаете правой кнопкой мышки по пункту «Регистры накопления» и нажимаете «Добавить».

Рис. 4.1.114

Откроется форма регистра накопления. Введите наименование, синоним. Вид регистра установите Обороты.

Рис. 4.1.115

После переходите на закладку «Данные», где введите информацию об измерениях и ресурсах.

Рис. 4.1.116 205стр.<<

Следующим шагом необходимо отметить те документы, которые будут делать движения по данному регистру. Переходите на закладку «Регистраторы» и ставьте флажки напротив документа «Прибытие в гараж», именно этим документом будет фиксироваться пробег.

Рис. 4.1.117

В реквизиты документа «Прибытие в гараж» добавьте реквизит Пробег, с точно таким же типом, как и у ресурса Пробег вновь созданного регистра накопления (число (10,0)).

Для удобства и скорости можете этот ресурс просто «скопировать», а потом «вставить» в реквизиты документа «Прибытие в гараж», или вообще «перетащить»

Рис. 4.1.118

Закройте конструкторы регистра и документа.

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

Для этого в дереве документов выделяете нужный Вам документ (это будет Прибытие в гараж), кликаете правой кнопкой мыши и находите в меню подменю «**Конструкторы**», по нему перейдите в «**Конструкторы движений**» и запустите конструктор. 206стр.<<

Рис. 4.1.119

Открылась соответствующая форма, в которой Вы проставите соответствие измерений и ресурсов регистра с реквизитами документа.

Рис. 4.1.120

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

Сохраним конфигурацию, обновим базу данных и зайдем в какой-нибудь документ «Прибытие в гараж», заполним у него пробег и проведем. А после проведения, посмотрим, какие движения сделал этот документ по регистру накопления «Пробег автомобиля» (зайдите через «Все функции»). 207стр.<<

Рис. 4.1.121

Рис. 4.1.122

Сейчас создайте регистр накопления ТопливоВАвтомобилях. Это будет регистр остатков, у него будет два измерения – ТипТоплива и Автомобиль, соответствующих типов, и один ресурс – Количество типа число (10,2).

Рис. 4.1.123

Рис. 4.1.124

Регистраторами данного регистра будут документы «Заправка топлива» и «Отчет о расходе топлива». 208стр.<<

Рис. 4.1.125

Закройте конструктор регистра, сейчас пропишем движения, которые должны возникнуть при проведении документа «Заправка топлива». Уже знакомым Вам способом (рис. 4.1.119) откройте конструктор движений документа «Заправка топлива»

Рис. 4.1.126

У этого документа данные для движений по регистру накопления будем брать из табличной части Автомобили. Поэтому в поле «Табличная часть» конструктора выберем «Автомобили».

Рис. 4.1.127 209стр.<<

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

Подсказка: сопоставление можно выполнить автоматически, нажав на кнопку «Заполнить выражения», будет выполнено сопоставление по типу реквизитов и измерений (ресурсов, реквизитов).

Рис. 4.1.128

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

Если Вам не понятно, какое движение должен делать тот или иной документ, то руководствуйтесь следующим мнемо-правилом:

Если природа документа отражает увеличение какой-нибудь сущности где-либо (приход товара на склад, прием «налички» в кассу, начисление налога со сделки и т.п.), то этот документ должен делать движение прихода по регистру накопления. Если же природа документа отражает уменьшение какой-нибудь сущности где-либо (отгрузка товара, выдача «наличики» из кассы, оплата налога и т.п.), то этот документ должен делать движение расхода по регистру накопления.

Нажимаем кнопку «ОК», и будет создана обработка проведения с соответствующим кодом.

То же самое проделайте с документом «Отчет о расходе топлива», только ставим Тип движения регистра - Расход.

Рис. 4.1.129 210стр.<<

Сохраним конфигурацию, обновим базу данных, создадим и проведем документ «Заправка топлива».

Рис. 4.1.130

А также документ «Отчет о расходе топлива».

Рис. 4.1.131

И посмотрим, какие движения сделали эти документы.

Рис. 4.1.132 211стр.<<

.

.

**справочник, в котором элементы (характеристики) могут быть различных типов**

***

Рассмотрим такой интересный объект конфигурации, как план видов характеристик.

Часто при разработке прикладных решений могут появляться задачи добавления дополнительных характеристик для различных объектов учета. Например, у нас есть справочник Гаражи, вполне возможно, что в процессе работы нам понадобится хранить такую информацию, как место гаража, длина, ширина, тип гаража и т.д.

Всю дополнительную информацию можно хранить в реквизитах этого справочника, и это решение вполне имеет право на жизнь, но только в том случае, когда состав характеристик всегда будет один и тот же, и он заранее известен. Если же состав реквизитов будет постоянно меняться, то нам каждый раз придется переписывать конфигурацию: добавлять новый реквизит со всеми вытекающими последствиями (переписывание форм и т.п.).

Может быть и иная ситуация: у разных объектов может быть разный состав характеристик. Например, для какого-то гаража важно указать длину и ширину, а для какого-то эта информация не столь критична. Тогда часть реквизитов будут лишними.

Во всех этих случаях гораздо рациональнее использовать планы видов характеристик, в которых хранится дополнительная информация объектов аналитического учёта. Что такое план видов характеристик? По сути это такой **справочник, в котором элементы (характеристики) могут быть различных типов**. Например, есть характеристика Высота гаража, тип которой Число. В характеристику Высота гаража, можно записать только число и не более. Причем у одного плана видов характеристик **могут быть характеристики разных типов**. Таким образом, можно резюмировать: если у обычного справочника все элементы одного типа (ссылка на этот справочник), то у плана видов характеристик элементы могут быть разных типов, в зависимости от того, как настроено в конфигурации.

Реализуем следующую задачу: создадим возможность хранения различных характеристик справочника Гаражи. Характеристики могут быть в виде примитивных типов (например, количество мест в гараже), а также и в виде каких-то значений (например, расположение гаража: «Север», «Юг» и т.д.), которые могут создавать сами пользователи.

Для этого создадим план видов характеристик – ДополнительныеСвойстваГаражей.

Рис. 4.1.133 212стр.<<

Рис. 4.1.134

В конструкторе плана видов характеристик на закладке «Основные» обратите внимание на поле «Тип значения характеристик», в этом поле необходимо задать тип (или типы). Характеристики нашего нового плана вида характеристик будут только тех типов, которые указаны в этом поле. Если нажать на кнопку «…» данного поля, то выйдет окно редактирования типа данных.

Рис. 4.1.135

Где можно задать как конкретный тип, который будет у всех характеристик объекта, так и перечень типов (установить флаг «Составной тип данных»). Мы зададим все примитивные типы. 213стр.<<

Рис. 4.1.136

Но, в условиях задачи было сказано, что характеристики могут храниться в виде каких-то определенных значений, и у пользователя должна быть возможность выбрать одно из этих значений. Причем эти значения пользователь может задать самостоятельно. Где наиболее оптимально хранить значения той или иной характеристики? Причем так, чтобы эти значения не пересекались.

К примеру, если есть характеристика «Расположение гаража», которая содержит произвольные значения расположения гаража («Север», «Юг», «Запад» и т.д.), а также есть характеристика «Тип гаража», которая содержит произвольные значения типа гаража («Кирпичный», «Железный» и т.д.), значения этих характеристик не должны пересекаться. Если мы выбрали характеристику «Расположение гаража», то должны видеть только значения расположения, но никак не значения типа гаража.

Можно, конечно, создать отдельные справочники «Расположение гаража» и «Тип гаража», но мы не можем быть уверены, что потом не добавятся еще какие-либо новые характеристики, которые будут содержать произвольные значения, и нам опять не придется менять конфигурацию. Самым оптимальным решением будет создать единый справочник для хранения всех значений подобных характеристик. Этот справочник должен быть подчинен плану видов характеристик «ДополнительныеСвойстваГаражей». В этом случае у любой характеристики (элемента плана видов характеристик), тип которой «ссылка на подчиненный справочник», будет свой набор значений, ни с чем не пересекающийся.

Немного запутанно? Сейчас все станет понятно.

Создадим такой справочник и назовем его СвойстваГаражей (создайте самостоятельно, длина кода – 3, длина наименования -50). На закладке «Владельцы» установим единственного владельца, план видов характеристик «Дополнительные свойства гаражей» (см. рис. 4.1.137).

После создания справочника перейдем в план видов характеристик «Дополнительные свойства гаражей» и в поле «Тип значения характеристик» закладки «Основные» добавим новый тип – ссылку на справочник «Свойства гаражей» (см. рис. 4.1.138). Теперь мы сможем создать элементы (характеристики) нашего плана видов характеристик с этим типом, а также создать элементы справочника «Свойства Гаражей», подчиненные нужной характеристике. 214стр.<<

Рис. 4.1. 137

Рис. 4.1. 138

Но это еще не всё, в плане видов характеристик нужно указать, что значения характеристик хранятся именно в справочнике «Свойства гаражей». Указывается это в свойстве «Дополнительные значения характеристик» закладки «Основные». 215стр.<<

Рис. 4.1.139

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

И остался последний шаг: необходимо связать воедино гараж, дополнительные свойства гаража (характеристики) и значение этих свойств (характеристик). Поскольку когда мы создадим какие-то свойства гаражей, их значения, то эти данные и конкретные гаражи будут отдельно.

Мы сделаем это, используя непериодический и независимый регистр сведений, который назовем «ЗначениеСвойствГаражей».

Рис. 4.1.140

Сейчас нам нужно определить состав измерений и ресурсов. Самое очевидное создать три измерения: «Гараж» (тип ссылка на справочник Гаражи), «Свойство» (тип ссылка на план видов характеристик ДополнительныеСвойстваГаражей) и «Значение этого свойства». Но будет ли данный способ правильным? Очевидно, нет, т.к. возможна будет запись следующего вида:

216стр.<<

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

Создадим измерения.

Рис. 4.1.141

Рис. 4.1.142

У измерения «Гараж» установите свойство Ведущее.

И создадим ресурс «Значение», тип которого будет характеристика плана видов характеристик «Дополнительные свойства гаражей». 217стр.<<

Рис. 4.1.143

В результате в ресурсе Значение будут те значения характеристик, которые указаны в плане видов характеристик «Дополнительны свойства гаражей».

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

Создадим нашу первую характеристику Длина, тип которой будет Число.

Рис. 4.1.144

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

Создадим свойство Расположение, тип которого будет ссылка на справочник «Свойства гаражей». 218стр.<<

Рис. 4.1.145

И зададим значения этого свойства, для этого перейдем в подчиненный справочник «Свойства гаражей», нажав на команду «Свойства гаражей» формы элемента плана видов характеристик, где зададим несколько значений этого свойства.

Рис. 4.1.146

Аналогично создадим характеристику «Вид гаража» с типом ссылка на справочник «Свойства гаражей», и с некоторыми значениями.

Рис. 4.1.147

Все нужные на данный момент свойства гаражей созданы, должен получиться следующий список плана видов характеристик: 219стр.<<

Рис. 4.1.148

Попробуем при помощи регистра «Значение свойств гаражей» привязать какую-нибудь характеристику и её значение к определенному гаражу. Заходить в сам регистр не нужно, достаточно зайти в элемент справочника Гаражи и выполнить команду «Значение свойств гаражей», которая расположена вверху формы элемента.

Рис. 4.1.149

Создадим новую запись регистра, в которой выберем свойство «Вид гаража».

Рис. 4.1.150

Попробуем выбрать значение этого свойства. Нам сразу будет предложено выбрать тип данных. Что несколько неудобно, согласитесь. 220стр.<<

Рис. 4.1.151

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

Рис. 4.1.152

Приведем выбор значения в нормальный вид. Для этого вернемся в конфигуратор, и откроем палитру свойств ресурса Значение регистра сведений «Значение свойств гаражей».

В этой палитре нас интересуют два поля – Связь по типу и Связи параметров выбора (рис. 4.1.153). В свойстве Связь по типу необходимо указать измерение, которое будет определять тип значения нашего ресурса. В нашем случае это будет измерение Свойство (см. рис. 154). 221стр.<<

Рис. 4.1.153

Рис. 4.1.154

При помощи свойства Связи параметров выбора настраивается зависимость одних реквизитов от других (в нашем случае зависимость ресурса от измерения). В открывшейся форме

222стр.<<

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

Рис. 4.1.155

Тем самым мы настроим отбор по владельцу. И при выборе элементов справочника «Свойства гаражей» будут выходить только те элементы, владелец у которых указан в измерении Свойство текущей строки регистра. Сохраним конфигурацию, обновим базу данных и попробуем задать пару характеристик для справочника «Гаражи».

Рис. 4.1.156

Рис. 4.1.157 223стр.<<

С Обработками Вы уже знакомы. Мы с вами работаем с внешними обработками, но могут быть и обработки в составе конфигурации.

Рис. 4.1.158

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

Для этого кликаете правой клавишей мышки по пункту конфигурации «Обработки», в появившемся меню нажимаем «Добавить». Добавьте реквизит Автомобиль и табличную часть Гаражи.

Рис. 4.1.159 224стр.<<

Также можете создать на ней форму с данными реквизитами.

Рис. 4.1.160

Еще Вы можете вставить уже имеющуюся обработку в конфигурацию. Для этого кликнем правой кнопкой мышки по пункту конфигурации «Обработки» и выберем пункт «Вставить внешнюю обработку, отчет…».

Рис. 4.1.161

И найдите любую недавно созданную Вами обработку (из предыдущих глав) и выберете ее. Она станет в составе конфигурации. Сохраните конфигурацию и откройте обработку из меню операции.

Отчеты необходимы для анализа информации о деятельности предприятия. Более подробно отчеты Вы будете изучать в 11-й главе. Пока замечу, что отчеты могут быть сами по себе (внешние отчеты), а могут и входить в состав конфигурации.

Разберем основные метаданные ветки «Общие» дерева конфигурации, которые пригодятся в первоначальной работе. 225стр.<<

Параметры сеанса

Параметры сеанса - это **переменные, которые доступны в течение всего сеанса пользователя** в любом месте конфигурации. Например, в параметрах сеанса можно хранить текущего пользователя, или имя компьютера.

Создадим параметр сеанса, который назовем ИмяТекущегоКомпьютера. Для этого выделим ветку «Параметры сеанса» и в контекстном меню нажмем на пункт «Добавить».

Рис. 4.1.162

В правой части экрана откроется палитра свойств параметра сеанса, где укажем название, синоним и тип (Строка (50)).

Рис. 4.1.163

Определяются параметры сеанса в модуле сеанса, который мы будем проходить ниже (часть вторая текущей главы, стр. 247), где и научимся определять имя текущего компьютера.

.

.

Кроме примитивных и ссылочных типов (ссылочные типы будем проходить в шестой главе), в конфигураторе 1С можно задать предопределяемый тип. Например, у нас много где встречается такой реквизит как цена, которые имеет всегда тип «Число» (длина 10, точность 2). **Чтобы никогда не задумываться о параметрах числа для реквизитов**, где будут храниться цены, можно создать предопределенный тип, который назовем, как вариант, ТипДляЦен. И этот тип можно использовать во всех подобных реквизитах.

Создадим такой тип: выделим ветку «**Определяемые типы**» и нажмем кнопку «**Добавить**». 226стр.<<

Рис. 4.1.164

В правой части откроется палитра свойств определяемого типа, где мы зададим такие параметры как «Имя», «Синоним» и «Тип определяемого типа».

Рис. 4.1.165

Сейчас мы сможем у всех реквизитов конфигурации, в которых хранятся какие-либо цены, поменять тип. Для этого нужно зайти в палитру свойств нужного реквизита, нажать на кнопку «…» у свойства Тип, и выбрать нужный определяемый тип из папки «Определяемый Тип» окна редактирования типа данных.

Рис. 4.1.166

Поменяйте тип у всех оставшихся реквизитов «Цена» самостоятельно.

227стр.<<

.

В процессе разработки конфигурации могут возникать ситуации, когда у ряда объектов может быть одинаковый реквизит. Например, реквизит «Комментарий» или «Ответственный» у документов. В платформе 8.3 есть возможность создать несколько общих реквизитов, которые **разработчик может использовать в том или ином объекте на свое усмотрение**.

Создадим общий реквизит Комментарий, который будем использовать во всех документах (только документах). Для этого выделим ветку «Общие реквизиты» и нажмем кнопку «Добавить».

Рис. 4.1.167

После добавления общего реквизита справа откроется палитра свойств этого реквизита, где зададим имя, синоним и тип (неограниченная строка).

Рис. 4.1.168

Применение реквизита в объектах данных задается в категории Использование палитры свойств реквизита. Где нас интересуют два свойства – Состав и Автоиспользование. Разберемся со свойством Автоиспользование. Именно при помощи этого свойства мы определяем, как будет использоваться общий реквизит по умолчанию. Если установлено значение Использовать, то значит, что реквизит используется везде, и нужно задать объекты, в которых не нужно применять этот реквизит (при помощи свойства Состав). Если же установлено значение Не использовать, то 228стр.<<

наоборот – реквизит по умолчанию нигде не используется, и нужно задать объекты, где мы будем работать с этим реквизитом (при помощи свойства Состав).

Рис. 4.1.169

По умолчанию устанавливается значение Не использовать. Мы оставим значение этого реквизита по умолчанию и зададим состав объектов, где будет применять общий реквизит. Для этого нужно нажать на гиперссылку «Открыть» свойства «Состав», и откроется окно состава общих реквизитов, где в верхней части расположено дерево объектов метаданных, к которым можно применить общий реквизит, а в нижней – метаданные, к которым общий реквизит применен.

Рис. 4.1.170

Чтобы общий реквизит использовался в нужном объекте, необходимо в верхней части окна в колонке «Использование», установить Использовать. После этого объект отобразится в нижней части окна.

Сейчас, если мы откроем любой документ, к которому применили общий реквизит, то увидим этот реквизит на форме документа. 229стр.<<

Рис. 4.1.171

.

.

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

В нашей конфигурации создадим три роли: ПолныеПрава, Диспетчер, УчетчикТоплива.

У роли ПолныеПрава, как ясно из названия, будет полный набор прав на все метаданные. Запомните! Роль с полными правами всегда обязательно в конфигурации. У ролей «Диспетчер» и «Учетчик топлива» будет следующий набор прав:

Роль Объект метаданных Права

Диспетчер Справочники:

Марки автомобилей Полные

Модели автомобилей

Опции

Автомобили

Гаражи

Свойства гаражей

Тип топлива Чтение, просмотр

Поставщик топлива

Документы

Прибытие в гараж Полные

Выбытие из гаража

Заправка топлива Чтение, просмотр

Отчет о расходе топлива

Установка цен на топливо

Журналы документов

Прибытие-выбытие автомобилей Чтение, просмотр

ПВХ

Дополнительные свойства гаражей Полные

Регистры сведений

Основной гараж автомобиля Полные

Табл. 4.1.2

Первым делом создадим роль с полными правами. Для этого выделим ветку «Роли» и в контекстном меню нажмем пункт «Добавить». 231стр.<<

Рис. 4.1.172

У нас сразу же откроется палитра свойств роли и конструктор прав.

Рис. 4.1.173

Новую роль назовем ПолныеПрава. Для того, чтобы установить у этой роли права на все объекты, воспользуемся меню «Действия» конструктора прав, где нажмем на пункт «Установить все права». 232стр.<<

Рис. 4.1.174

Также рекомендую установить флаг «Устанавливать права для новых объектов», чтобы при создании нового объекта метаданных, роли «Полные права» добавлялись все права на этот объект.

Рис. 4.1.175

В списке прав конфигурации установим все права (флаг «Отметить все элементы»). 233стр.<<

Рис. 4.1.176

Всё! Роль с полными правами создана. Теперь создадим пользователя с полными правами. Перед этим необходимо обновить конфигурацию базы данных.

Для создания пользователя базы данных в конфигураторе нужно войти в список пользователей. Список пользователей доступен по следующему пути: «Главное меню» – «Администрирование» – «Пользователи».

Рис. 4.1.177 234стр.<<

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

Рис. 4.1.178

Введем имя «Администратор», все остальное оставим как есть и перейдем на закладку «Прочее».

Рис. 4.1.179

В этой закладке нас интересует список «Доступные роли». Пока в нем только одна роль - «Полные права». Поставим у этой роли флаг и нажмем кнопку «ОК» – пользователь создан. С этого момента, когда Вы будете входить в «1С:Предприятие» (без разницы, в пользовательский режим, или в конфигуратор), платформа потребует выбрать пользователя. Пока у нас только один пользователь – Администратор.

Рис. 4.1.180 235стр.<<

Теперь создадим ещё одну роль, точно так же, как и роль ПолныеПрава (см. рис. 4.1.172). Для новой роли дадим название Диспетчер и в открывшемся конструкторе прав установим право «Толстый клиент» у конфигурации, остальной набор прав для конфигурации оставим как есть.

Рис. 4.1.181

Теперь необходимо для ряда объектов установить полные права (см. табл. 4.1.2), а для ряда – урезанные: только для чтения и просмотра.

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

Установим у роли «Диспетчер» для справочника «Марки автомобилей» полные права (кроме интерактивного удаления). Найдем нужный справочник в дереве конфигурации конструктора прав роли. 236стр.<<

Рис. 4.1.182

Установим для этого элемента метаданных флажки всех прав, кроме права «Интерактивное удаление» и «Интерактивное удаление предопределенных».

.

.

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

Для быстрой отметки воспользуемся кнопкой «Пометить все элементы», а отметки прав «Интерактивное удаление» и «Интерактивное удаление предопределенных» снимем вручную. Должен получиться следующий набор прав:

Рис. 4.1.183 237стр.<<

Для документа «Прибытие в гараж» полный набор прав будет выглядеть следующим образом:

Рис. 4.1.184

А для справочника «Тип топлива» дадим права только на чтение и просмотр, в этом случае будет следующий набор прав:

Рис. 4.1.185

Теперь самостоятельно установите права на объекты согласно таблице 4.1.2 для роли Диспетчер, потом создайте роль УчетчикТоплива (не забудьте поставить право конфигурации Толстый клиент) и также самостоятельно установите права для этой роли согласно всё той же таблице 4.1.2. Для новых прав создайте пользователей «Диспетчер» и «Учетчик» с соответствующими наборами ролей. Проверьте доступ к объектам из таблицы 4.1.2.

238стр.<<

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

Для добавления общей картинки необходимо выделить соответствующий пункт ветки «Общие», вызвать контекстное меню и в этом меню нажать на кнопку «Добавить».

Рис. 4.1.186

После добавления откроется конструктор общей картинки, где можно внести название картинки, а также выбрать произвольную картинку из файловой системы, нажав на кнопку «Выбрать из файла» (см. рис. 4.1.187).

Рис. 4.1.187

После выбора картинкапоявится в конструкторе. 239стр.<<

Рис. 4.1.188

И соответствующий пункт появится в ветке «Общие картинки».

Рис. 4.1.189

В дальнейшем эту картинку можно использовать при работе с формами, подсистемами и пр.

И напоследок мы изучим Подсистемы. Как Вы заметили, обращаться к справочникам, документам и прочим объектам конфигурации, которые свалены в меню функций текущего раздела, не совсем удобно. Логичнее все объекты разбить по каким-то разделам. Сделать это можно при помощи объекта Подсистемы. Очень подробно работа с этим объектом дается в моей книге «Основы разработки в 1С: Такси. Разработка в управляемом приложении за 12 шагов». Здесь мы коснемся только самых общих моментов, необходимых для дальнейшей работы.

Прежде чем начать создавать подсистемы, определим, сколько их будет, как они будут называться и какие объекты войдут в их состав. Самое логичное - конструировать подсистемы по прикладным областям. В нашей конфигурации можно сделать три подсистемы: «Учет автомобилей», «Учет топлива» и «НСИ» (нормативно-справочная информация). Причем обратите внимание: подсистемы «Учет автомобилей» и «Учет топлива» по своей сути соответствуют ролям 240стр.<<

«Диспетчер» и «Учетчик топлива». Я распределю объекты конфигурации по подсистемам следующим образом (по аналогии с ролями):

Подсистема Обьект конфигурации

Учет автомобилей Справочники:

Марки автомобилей

Модели автомобилей

Опции

Автомобиль

Гаражи

Свойства гаражей

Документы:

Прибытие в гараж

Выбытие из гаража

Журнал:

Прибытие-выбытие автомобилей

Планы видов характеристик:

Дополнительные свойства гаражей

Регистры сведений:

Основной гараж автомобиля

Значение свойств гаражей

Регистры накопления:

Пробег автомобиля

Учет топлива Справочники:

Тип топлива

Поставщик топлива

Документы:

Заправка топлива

Отчет о расходе топлива

Установка цен на топливо

Регистры сведений:

Цены на топливо

Регистры накопления:

Топливо в автомобилях

НСИ Справочники:

Марии автомобилей

Модели автомобилей

Опции

Автомобиль

Гаражи

Свойства гаражей

Тип топлива

Поставщик топлива

Планы видов характеристик:

Дополнительные свойства гаражей

Регистры сведений:

Основной гараж автомобиля

Значение свойств гаражей

Константы и форма констант, перечисления.

общие картинки, параметры сеанса.

предопределяемые типы, роли

Табл. 4.1.3 241стр.<<

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

Рис. 4.1.190

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

Рис. 4.1.191

Если этот флаг включен, то Ваша подсистема будет отображена в виде закладке в пользовательском режиме «1С:Предприятия».

Следующим шагом мы привяжем наши объекты из таблицы выше к подсистеме. Для этого необходимо перейти на закладку «Состав» и в верхнем окне проставить флажки рядом с нужными объектами, в нижнем они отобразятся автоматически. 242стр.<<

Рис. 4.1.192

Самостоятельно создайте остальные подсистемы и настройте их состав согласно таблице выше. Если Вы забудете какой-либо объект включить в подсистему, то при обновлении базы данных выйдет соответствующее сообщение в конфигураторе.

Рис. 4.1.193

И последний шаг: обязательно проверьте у роли «Полные права», установилось ли у всех новых подсистем право на просмотр для этой роли, иначе зайдя под администратором, Вы не увидите закладок, которые привязаны к подсистемам.

Рис. 4.1.194 243стр.<<

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

Рис. 4.1.195

Для отображения разделов необходимо добавить соответствующую панель.

Рис. 4.1.196 244стр.<<

Рис. 4.1.197

Рис. 4.1.198 245стр.<<

Рис. 4.1.199

Установите для роли «Диспетчер» самостоятельно право на просмотр следующих подсистем: «Учет автомобилей» и «НСИ», а для роли «Учетчик топлива» - «Учет топлива» и «НСИ», и проверьте, как будет отображаться интерфейс при заходе в программу под пользователями «Диспетчер» и «Учетчик».

Более подробно о работе с подсистемами читайте в книге «Основы разработки в 1С: Такси. Разработка в управляемом приложении за 12 шагов».

Резюме

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

246стр.<<

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

Прежде чем рассматривать работу модулей, разберем небольшую тему - это локальные и глобальные переменные.

Локальные и глобальные переменные

Рассмотрим такое важное понятие в языке программирования, как Локальные и Глобальные переменные.

Что такое Локальные переменные? Это **любые переменные, описанные внутри процедуры или функции**. Как задаются переменные внутри процедур и функций, мы знаем: либо через слово Перем, либо если переменной сразу будет присвоено какое-нибудь значение (см. листинг 4.2.1).

```csharp

Процедура НашаПроцедура()

Перем А,Б;

В = 10;

Г = "Привет, мир!"

КонецПроцедуры

```

Листинг 4.2.1

В листинге 4.2.1 переменные А и Б заданы явным способом, а В через значение. Локальные переменные создаются при запуске процедуры или функции и уничтожаются, когда процедура или функция заканчивает свою работу. Т.е. Вы не сможете к переменным, заданным в процедуре НашаПроцедура, обратиться в другой процедуре или просто в модуле.

.

.

Теперь - как задать переменные глобально. Рассмотрим пример в рамках модуля формы (создайте новую обработку и форму). Для этого **в самом верху модуля формы пишем слово Перем и перечисляем переменные через запятую, а в конце пишем точку с запятой**. Так же, как и в случае процедур или функций, в модуле формы управляемого приложения перед переменными необходимо указывать директивы компиляции &НаКлиенте или &НаСервере. В этой части все переменные и методы в модуле формы будут выполняться в клиентском контексте (под директивой &НаКлиенте).

Директивы компиляции будем изучать в пятой главе.

Смотрите листинг 4.2.2. Переменные А,Б,В – заданы локально, а переменные А0,Б0,В0 – глобально. 247стр.<<

```csharp

&НаКлиенте

Перем А0, Б0;

&НаКлиенте

Перем В0;

&НаКлиенте

Процедура НашаПроцедура()

Перем А,Б;

В = 100;

КонецПроцедуры

```

Листинг 4.2.2

После того, как мы задали глобальные переменные в начале модуля, мы можем обращаться к ним в любой процедуре или функции модуля. Выполните пример с листинга 4.2.3. Самостоятельно создайте команду и обработчик команды в модуле формы.

```csharp

&НаКлиенте

Перем А, Б;

&НаКлиенте

Процедура ИзменитьЗначенияПеременных()

А = А + 100;

Б = А;

КонецПроцедуры

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Сообщить("А = " + А);

Сообщить("Б = " + Б);

ИзменитьЗначенияПеременных();

Сообщить("А = " + А);

Сообщить("Б = " + Б);

КонецПроцедуры

А = 10;

Б = -100;

```

Листинг 4.2.3

Разберем данный код. В начале нашего модуля мы задаем переменные А и Б. В конце модуля присваиваем им значения. Почему значения присваиваются в конце модуля? Потому что процедуры и функции должны описываться непосредственно перед кодом, который пишется в самом модуле. Да, в модуле формы мы можем написать почти любой код, и он выполнится во время открытия формы.

После мы создаем процедуру ИзменитьЗначенияПеременных, в которой манипулируем с нашими переменными. И в обработчике команды ВыполнитьКоманду работаем с нашими глобальными переменными. 248стр.<<

Рис. 4.2.1

Т.е. сначала переменные А и Б были такими, какими Вы задали их в конце модуля, но после выполнения процедуры ИзменитьЗначенияПеременных они изменились.

А что будет, если имея глобальную переменную, внутри процедуры или функции задать локальную переменную с таким же именем?

Выполните пример из листинга 4.2.4, и Вы увидите, что как А была равна 1, так и осталась. Потому что, задав явно переменную внутри процедуры, мы создали локальную переменную, пусть с тем же названием, но абсолютно другую. Как только процедура выполнилась, данная локальная переменная уничтожилась.

**Задание локальных переменных работает только в том случае, если Вы ее задали именно явно, через ключевое слово Перем.**

```csharp

&НаКлиенте Перем А;

&НаКлиенте

Процедура ВыполнитьКоманду(Команда)

Сообщить("А = " + А);

ИзменитьПеременную();

Сообщить("А = " + А);

КонецПроцедуры

&НаКлиенте

Процедура ИзменитьПеременную()

Перем А;

А = 10000;

КонецПроцедуры А = 1;

```

Листинг 4.2.4

Рис. 4.2.2 249стр.<<

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

Что такое Модуль? По-простому, Модуль - это **непосредственно та область, в которой программист пишет свои алгоритмы, процедуры и функции**. Но особенности программы 1С в том, что модуль это не только текстовый редактор, по сути, это программа на языке программирования 1С. И в зависимости от того, в каком модуле Вы опишете ту или иную процедуру, она будет выполняться на том или ином уровне.

К примеру, процедуры, написанные в модуле формы, будут работать только тогда, когда открыта или создана (это не одно и то же) данная форма. Вы не сможете обратиться к процедурам формы элемента справочника, если обратитесь программно к справочнику как объекту.

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

.

.

Контекст - **связь, каждого программный модуля с остальными объектами конфигурации**. Всего существует два вида контекста: Глобальный и Локальный. Глобальный контекст виден для всех, он, по сути, создает общую среду работы программы. Локальный контекст действует только в рамках данного объекта. Т.е., если мы создадим процедуру в рамках глобального контекста и назовем ее, к примеру, РасчетСебестоимости:

**РасчетСебестоимости()**

- то мы в любом месте программы можем написать имя данной процедуры, и она без проблем выполнится. А если мы создадим процедуру, назовем ее Рассчитать пробег:

**РассчитатьПробег()**

для объекта справочника Автомобили в модуле объекта этого справочника и **сделаем ее экспортной** (про экспорт процедур и функций мы узнаем позже), то обратиться к ней мы сможем **только через данный объект справочника**:

**ОбъектСправочника = СправочникСсылка.ПолучитьОбъект();

ОбъектСправочника. РассчитатьПробег();**

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

Начнем с самого низа - это уровень формы. 250стр.<<

.

.

Модуль формы должен содержать те **процедуры и функции, которые необходимы только для работы данной формы**. В управляемом приложении процедуры или функции модуля формы выполняются или в серверном контексте или в клиентском контексте. Смысл клиентского и серверного контекста мы будем проходить в следующей главе.

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

С модулем формы мы работали с самого начала курса, и Вы знаете, что попасть в модуль формы легко, для этого достаточно открыть форму и зайти в закладку «Модуль».

Рис. 4.2.3

.

А чтобы увидеть список всех процедур и функций модуля формы, необходимо сфокусироваться на модуле формы и выполнить команду «Процедуры и функции»

«Главное меню» – меню «**Текст» – «Процедуры и функции**»

Рис. 4.2.4 251стр.<<

После выполнения команды откроется список процедур и функций, которые уже есть в модуле формы. Причем в этом списке также присутствуют обработчики событий формы, которые не созданы (выделены треугольными скобками - < >). У созданных процедур и функций слева в списке отображается соответствующий значок.

Рис. 4.2.5

Более подробно работу с формами мы будем проходить в пятой главе.

.

.

Модуль объекта **предназначен для описания процедур и функций, которые необходимы для работы конкретного элемента объекта конфигурации**. Это может быть конкретный элемент справочника, или элемент документа.

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

Кроме того, в модуле объекта можно создавать и описывать обработчики событий, которые возникают при работе с объектом. Например, это может быть обработка события записи объекта, или обработка события проведения объекта (для документов).

Подробно обработчики событий объекта будем проходить в шестой главе. Пока же запомним, что все методы (процедуры и функции) модуля объекта можно разделить на две группы: это типовые обработчики различных событий объекта, и просто процедуры (функции) созданные разработчиками для осуществления каких-либо действий над экземпляром объекта (например, пересчет всех цен в табличной части после изменения типа цен в шапке документа). 252стр.<<

Это что касается документов и справочников. Когда же Вы работаете с обработками или отчетами, в модуле обработки и отчета должны быть описаны те процедуры и функции, к которым понадобиться доступ тогда, когда Вы программно обратитесь к этому отчету или обработке.

Как попасть в модуль объекта? Для элементов конфигурации это достаточно просто: в дереве метаданных выделяете интересующий Вас объект, кликаете правой кнопкой мышки и нажимаете на пункт «Открыть модуль объекта».

Рис. 4.2.6

Для внешних отчетов и обработок: находясь непосредственно в менеджере обработки, нажимаем на кнопку «Действия» и выбираем «Модуль объекта».

Рис. 4.2.7 253стр.<<

Для того чтобы посмотреть на полный список процедур и функций модуля объекта, необходимо сфокусироваться на данном модуле, и перейти «Текст» – «Процедуры и функции».

Рис. 4.2.8

Вы увидите все имеющиеся процедуры.

Рис. 4.2.9

Значками в левой части списка будут обозначены уже созданные процедуры и функции (в том числе обработчики событий), а треугольными скобками (< >) выделяются еще не созданные обработчики событий объекта.

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

**Обращаю Ваше внимание**, что для документов и справочников, если Вы будете делать какие-нибудь проверки при записи объекта или проверки на заполнение реквизитов при сохранении объекта, делайте это все на уровне объекта, а не формы. Поскольку возможны случаи, когда Вам придется записывать этот документ программно, и тогда Ваша проверка на форме не сработает. 254стр.<<

Если в модуле объекта описываются методы, предназначенные для работы с конкретным экземпляром объекта (подробно об экземплярах объектов в шестой главе), то в модуле менеджера объекта описываются методы, которые **не привязаны к конкретному экземпляру объекта**, но **привязаны к объекту в целом**.

Например, мы можем написать обработку печати товарной накладной документа в модуле объекта, и тогда для печати документа нам нужно будет каждый раз получать экземпляр этого документа. А можем написать обработку печати в модуле менеджера объекта и сделать её экспортной (об этом чуть позже), тогда достаточно передать ссылку (или массив ссылок) на распечатываемый документ в процедуру печати.

В случае, когда процедура печати в модуле объекта, код для печати будет выглядеть так:

ОбъектСправочника = СправочникСсылка.ПолучитьОбъект(); ОбъектСправочника.Печать();

А когда процедура печати в модуле менеджера объекта, код будет следующий:

Документы.ВыбытиеИзГаража.Печать(СсылкаНаДокумент);

Получить доступ в модуль менеджера объекта можно двумя способами (см. рис. 4.2.10 и 4.2.11).

Рис. 4.2.10 255стр.<<

Рис. 4.2.11

Кроме того, в модуле менеджера можно описывать обработчики некоторых типовых событий, которые могут возникать при работе с менеджером объекта (например, при получении данных выбора).

Общие модули можно найти в отдельной ветке конфигурации:

Рис. 4.2.12

В общем модуле Вы можете **описать процедуры и функции, которые будут доступны из любого места конфигурации**. В принципе, это их основная функция, т.е. если Вам необходимо проверять остатки товаров на складе при проведении документов, которых может быть несколько видов (реализация товаров, списание товаров и т.д.), то процедуру проверки будет практично 256стр.<<

написать именно в общем модуле, а потом вызывать в модуле объекта соответствующего документа при проведении.

Создайте общий модуль. Для этого необходимо выделить пункт «Модули» в ветке метаданных конфигурации «Общие», нажать правую кнопку мышки и выбрать команду «Добавить».

Рис. 4.2.13

Модуль будет создан и сразу же откроется окно свойств, где мы можем назвать его каким-нибудь именем (назовете его Основной) и установить некоторые настройки модуля.

Рис. 4.2.14

Первый флажок, который нас интересует - это Глобальный. Это значит, **что если установлен данный флажок, то процедуры и функции в этом модуле будут выполняться в рамках глобального контекста**. Как мы уже узнали ранее, можно будет просто в любом месте программы написать название функции и процедуры, и она будет выполняться.

Если же этой галочки не будет, то обратиться к процедуре или функции этого модуля можно будет через сам модуль.

Т.е. написать: 257стр.<<

Основной.ПроцедураРасчета();

.

.

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

Основной.ПроцедураРасчета(); Дополнительный.ПроцедураРасчета();

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

Флажок Клиент (управляемое приложение) устанавливается в том случае, когда процедуры или функции данного модуля должны быть доступны **в клиентском контексте при работе толстого клиента**.

Флажки Сервер и Внешнее соединение устанавливаются в том случае, когда процедуры и функции данного модуля будут **доступны в серверном контексте и во внешнем соединении**.

Это значит, что если Вы не поставите флажок Внешнее соединение, а в результате работы какое-нибудь внешнее соединение (например, обмен) будет использовать процедуру из этого модуля (к примеру, это может быть, если в результате обмена проводятся какие-нибудь документы, где при проведении используется Ваша функция), то программа выдаст ошибку.

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

Подробно о серверном и клиентском контексте - в пятой главе.

Если Вы установите флаг Вызов сервера, то Вы сможете методы этого модуля использовать **в клиентском контексте управляемой формы**. Это значит, что в клиентском контексте (директива компиляции &НаКлиенте) формы (или команды) у Вас будет доступен вызов процедур и функций этого общего модуля (без разницы, под толстым клиентом запущена форма или под тонким).

Ещё раз. Если мы установили флаг Клиент, то в клиентском контексте управляемой формы мы сможем использовать процедуры и функции общего модуля только под толстым клиентом. Если управляемая форма будет работать как под толстым клиентом, так и под тонким клиентом (или веб-клиентом), то для использования на этой форме процедур и функций общего модуля у этого модуля необходимо установить флаг Вызов сервера.

Когда установлен флаг Привилегированный, при выполнении процедур и функций **общего модуля будут отключены проверки прав пользователей**. Данный режим удобно использовать при выполнении каких-то глобальных и масштабных алгоритмов (например, контроль остатков по партиям). Поскольку очень часто при работе глобальных алгоритмов могут использоваться объекты (справочники, регистры сведений и т.д.), на которые у пользователя нет прав, поэтому 258стр.<<

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

И последний параметр общего модуля – повторное использование возвращаемых значений.

Рис. 4.2.15

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

Чтобы функции общего модуля кэшировались, в параметр Повторное использование возвращаемых значений необходимо установить или значение «На время вызова» (кэш будет использоваться, пока работает функция, которая вызвала метод общего модуля), или значение «На время сеанса» (кэш будет использоваться, пока работает пользователь).

И напоследок: у всех общих модулей есть одна особенность: Вы не сможете задать глобальные переменные этого модуля.

С общими модулями закончили.

Следующий уровень контекста - это модуль сеанса. 259стр.<<

.

.

Модуль сеанса необходим для **установки параметров сеанса**. В первой части этой главы мы создали единственный параметр сеанса в нашей конфигурации – «Имя текущего компьютера».

Рис. 4.2.16

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

Рис. 4.2.17

Впоследствии откроется модуль сеанса, в котором нас интересует один-единственный обработчик событий «Установка параметров сеанса». Создадим процедуру – обработчик события, для этого после открытия модуля выполним команду «Процедуры и функции» меню «Текст» (модуль должен быть активен). 260стр.<<

Рис. 4.2.18

В открывшемся окне выделяем единственную процедуру и нажимаем кнопку «Перейти».

Рис. 4.2.19

Будет создана процедура «УстановкаПараметровСеанса»

Рис. 4.2.20

Напишем в новой процедуре следующий код:

Процедура УстановкаПараметровСеанса(ТребуемыеПараметры) ПараметрыСеанса.ИмяТекущегоКомпьютера = ИмяКомпьютера(); КонецПроцедуры

Листинг 4.2.5 261стр.<<

Где ИмяКомпьютера() – функция глобального контекста, которая возвращает сетевое имя текущего компьютера.

А ПараметрыСеанса – коллекция, которая содержит параметры сеанса.

Проверим, как работает установка параметров сеанса. Для этого создайте обработку, форму и команду формы «ПолучитьПараметр», а также обработчик команды на клиенте и на сервере.

В обработчиках команды напишем следующий код:

&НаСервере Процедура ПолучитьПараметрНаСервере() Сообщить(ПараметрыСеанса.ИмяТекущегоКомпьютера); КонецПроцедуры &НаКлиенте Процедура ПолучитьПараметр(Команда) ПолучитьПараметрНаСервере(); КонецПроцедуры

Листинг 4.2.6

Сохраним конфигурацию, обновим базу данных, перезапустим «1С:Предприятие» в пользовательском режиме. Запустим обработку и посмотрим, как выполнится команда формы обработки.

Рис. 4.2.21

Рассмотрим модули самого верхнего уровня контекста - это модуль управляемого приложения и модуль обычного приложения.

В модулях управляемого и обычного приложения располагаются, как правило, процедуры и функции, **связанные с началом и окончанием работы программы**.

Методы в модуле управляемого приложения срабатывают тогда, когда идет запуск в режиме управляемого приложения. А методы в модуле обычного приложения отрабатывают тогда, когда идет запуск в режиме обычного приложения. В этом курсе мы рассматриваем работу 262стр.<<

управляемого приложения, и поэтому будем работать только с модулем управляемого приложения.

Естественно, данный модуль выполняется в рамках глобального контекста, тем самым все процедуры и функции, которые Вы объявите в модуле обычного приложения, будут доступны из любого места программы. Также они должны быть экспортными. Как попасть в модуль управляемого приложения? Есть два способа.

Первый. Необходимо выделить слово «Конфигурация» на самом верхнем уровне конфигурации и выбрать «Открыть модуль управляемого приложения».

Рис. 4.2.22

Второй. Зайти в палитру свойств конфигурации и нажать на гиперссылку «Открыть» свойства «Модуль управляемого приложения».

Рис. 4.2.23 263стр.<<

Рис. 4.2.24

Чтобы создать процедуры, которые будут выполняться при работе программы, перейдите в меню «Текст» – «Процедуры и функции», и увидите список процедур.

Рис. 4.2.25

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

Создадим методы «ПередНачаломРаботыСистемы» и «ПриНачалеРаботыСистемы».

```csharp

Процедура ПередНачаломРаботыСистемы(Отказ)

// Вставить содержимое обработчика.

КонецПроцедуры

Процедура ПриНачалеРаботыСистемы()

// Вставить содержимое обработчика.

КонецПроцедуры

```

Листинг 4.2.7

Вы видите, что у метода ПередНачаломРаботыСистемы есть параметр «Отказ», это значит, что у нас есть возможность отказаться от запуска программы. В этот метод можно ставить различные проверки (например, проверка лицензирования программы). 264стр.<<

Метод ПриНачалеРаботыСистемы необходим для выполнения различных действий при запуске программы. Это может быть подключение оборудования или открытие формы рабочего стола.

Точно так же создадим методы ПередЗавершениемРаботыСистемы и ПриЗавершенииРаботыСистемы:

```csharp

Процедура ПередЗавершениемРаботыСистемы(Отказ, ТекстПредупреждения)

// Вставить содержимое обработчика.

КонецПроцедуры

Процедура ПриЗавершенииРаботыСистемы()

// Вставить содержимое обработчика.

КонецПроцедуры

```

Листинг 4.2.8

Метод ПередЗавершениемРаботыСистемы возникает перед завершением работы управляемого приложения до закрытия главного окна. В этом методе есть параметр Отказ, который имеет тип Булево. Если данному параметру установить значение Истина, то работа программы не будет завершена.

Метод ПриЗавершенииРаботыСистемы вызывается самым последним. В этом методе необходимо выполнять действия, которые необходимы при выходе из программы: запись логов и т.п.

.

.

Резюмирую: **если процедура или функция экспортная (имеется ключевое слово Экспорт после параметров), то к этой функции можно обращаться вне** данного модуля. В противном случае она может быть использована только в том модуле, в котором описана.

***

Следующим пунктом мы изучим экспорт процедур и функций. Рассмотрим на примере общего модуля.

Для этого создадим общий модуль, который назовем «МатематическиеВычисления».

Рис. 4.2.26 265стр.<<

Установим у этого модуля флаг «Вызов сервера», для того чтобы методы из этого модуля можно было использовать в клиентском контексте формы. А также включим кэширование (параметр «Повторное использование возвращаемых значений»).

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

```csharp

Функция КореньМодуляЧисла(ЧислоПодКорнем)

МодульЧисла = ?(ЧислоПодКоронем >= 0, ЧислоПодКорнем,ЧислоПодКорнем*(-1));

Возврат Sqrt(МодульЧисла);

КонецФункции

```

Листинг 4.2.9

Естественно, возникнет вопрос: как обратиться к этой функции на какой-либо форме? Для этого необходимо сделать функцию экспортной. Осуществляется это посредством написания слова Экспорт после параметров, функция должна выглядеть так:

```csharp

Функция КореньМодуляЧисла(ЧислоПодКорнем)

Экспорт МодульЧисла = ?(ЧислоПодКоронем >= 0, ЧислоПодКорнем,ЧислоПодКорнем*(-1));

Возврат Sqrt(МодульЧисла);

КонецФункции

```

Листинг 4.2.10

Теперь создадим обработку, в которой будем вычислять квадратный корень модуля числа, используя функцию из общего модуля. Сделайте все как Вы уже умеете: создайте обработку, форму, команду формы (разместите её на форме), а также обработчик для этой команды. Перед этим не забудьте сохранить конфигурацию и обновить Вашу базу данных.

В обработчике команды будем получать некоторое число при помощи метода «ВвестиЧисло», вычислять корень этого числа и выводить сообщение.

```csharp

&НаКлиенте

Процедура ВычислитьКореньЧисла(Команда)

Перем ЧислоПодКорнем;

Если ВвестиЧисло(ЧислоПодКорнем,"Введите число") Тогда

КореньЧисла = МатематическиеВычисления.КореньМодуляЧисла(ЧислоПодКорнем); Сообщить(Окр(КореньЧисла,2));

КонецЕсли;

КонецПроцедуры

```

Листинг 4.2.11 266стр.<<

Запустите обработку и посмотрите, как она будет работать. После уберите слово Экспорт у названия метода КореньМодуляЧисла в общем модуле и попробуйте заново посчитать. Компилятор выдал ошибку.

Резюмирую: **если процедура или функция экспортная (имеется ключевое слово Экспорт после параметров), то к этой функции можно обращаться вне** данного модуля. В противном случае она может быть использована только в том модуле, в котором описана.

Заметьте, что компилятор дает подсказки: если после названия модуля написать точку и нажать клавишу «пробел», то выйдет список из всех экспортируемых процедур этого модуля (см. рис. 4.2.27).

Рис. 4.2.27

.

.

Экспорт переменных **осуществляется точно так же, как экспорт функций и процедур**: задается переменная в начале модуля и после описания переменной пишется слово Экспорт, после ставится точка с запятой.

Создадим в модуле управляемого приложения переменную «РазрядностьПоУмолчанию», в которой будем указывать число знаков дробной части при округлении. Присваивать значение этой переменной будем в процедуре ПриНачалеРаботыСистемы (см. листинг 4.2.12).

```csharp

Перем РаздрядностьПоУмолчанию Экспорт;

Процедура ПриНачалеРаботыСистемы()

РаздрядностьПоУмолчанию = 3;

КонецПроцедуры

```

Листинг 4.2.12

Переделаем код из листинга 4.2.11:

```csharp

&НаКлиенте

Процедура ВычислитьКореньЧисла(Команда)

Перем ЧислоПодКорнем;

Если ВвестиЧисло(ЧислоПодКорнем,"Введите число") Тогда

КореньЧисла = МатематическиеВычисления.КореньМодуляЧисла(ЧислоПодКорнем);

Сообщить(Окр(КореньЧисла,РаздрядностьПоУмолчанию));

КонецЕсли;

КонецПроцедуры

```

Листинг 4.2.13 267стр.<<

И напоследок изучим еще одну особенность модулей. Помимо процедур и функций, Вы в модуле можете написать любой код, который Вам нужен. Он будет выполняться тогда, когда будет активирован этот модуль. Если это модуль формы, то когда открыта форма, если модуль объекта - то тогда, когда было обращение к этому объекту (без разницы, программное или интерактивное).

Например, в имеющейся у нас конфигурации в модуле объекта справочника автомобилей напишите следующий код:

Рис. 4.2.28

Откройте теперь любой элемент справочника. Вышли сообщения, т.к. при обращении к объекту сразу идет выполнение модуля, если в нем есть код.

.

.

Но есть исключения. **Общие модули, модуль сеанса и модуль менеджера** служат только для описания процедур и функций.

И, по правилам языка, все процедуры и функции должны идти перед основным кодом модуля.

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

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

268стр.<<

В этой главе мы научимся работать с управляемыми формами. Информация в этой главе дается в таком объеме, чтобы Вы смогли начать работать с формами: создавать формы, размещать элементы и программировать на форме. Более подробно работа с управляемыми формами в частности и с управляемым приложением вообще разбирается в моей книге «**Основы разработки в 1С: Такси. Программирование управляемого приложения за 12 шагов**».

Создание форм - это самый базовый процесс, с которым столкнется любой, кто будет вести разработку под управляемым приложением.

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

У всех объектов есть определенный перечень основных форм. Причем количество и состав основных форм может отличаться в зависимости от прототипа объекта. Например, у справочников это – форма элемента, форма списка, форма группы, форма выбора и форма выбора группы (причем, форма группы и форма выбора группы будут доступны только иерархическим справочникам!). А у документов – форма документа, форма списка и форма выбора. По сути, для каждого типа формы должна быть **одна основная форма**. Но в то же время форм одного типа может быть несколько. Например, можно создать несколько форм списков справочника Автомобили и выбрать одну из этих форм основной.

Для чего необходимо устанавливать основные формы объекта? Основная форма всегда будет отображаться пользователю при выполнении стандартных команд (команды, которые определяют основные действия с объектом (подробнее см. «Основы разработки в 1С: Такси», часть 2, глава 2). Говоря простым языком: **основная форма будет всегда открываться по умолчанию** из интерфейса «1С:Предприятия». Например, основная форма списка справочника Автомобили отобразится, когда будет выполнена стандартная команда навигации, которая открывает форму списка номенклатуры (см. рис. 5.1.1). 269стр.<<

Рис. 5.1.1

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

Если основная форма у данного объекта не задана, то при выполнении стандартных команд будет открываться автоматически сгенерированная форма. Такое действие платформы в некоторых случаях разработчика может устраивать (например, если мы создали простой справочник). Но очень часто необходимо создать собственную основную форму.

Узнаем, где в конфигурации можно посмотреть на перечень основных форм объекта. Сделать это можно несколькими способами. Мы разберем один из них.

Самый простой способ - это с помощью редактора объекта метаданных (в основном это касается объектов таких метаданных, как справочники, документы, регистр, планы видов характеристик и т.д.). Открыть его можно дважды кликнув по объекту мышкой. В этом редакторе нас интересует закладка формы (см. рис. 5.1.2), где в верхней части обычно и расположены поля с основными формами этого объекта.

Рис. 5.1.2

На рис. 5.1.2 все поля основных форм пустые, потому что для справочника «Автомобили» не была создана ни одна форма. 270стр.<<

Я не буду в этой книге глубоко разбирать, какие типы форм бывают и чем они отличаются друг от друга. По сути, названия всех типов форм интуитивно понятны, и их предназначение без труда ищется в справочной информации.

Что такое основные формы, мы узнали. Теперь научимся создавать различные типы форм. Начнем мы с форм справочников и документов. Все формы создаются с помощью конструктора форм. Для каждого прототипа объекта (документы, справочники и т.д.) есть свой конструктор форм. Для документов – конструктор форм документов, для справочников – конструктор форм справочников и т.д. Вызвать этот конструктор можно несколькими способами (см. рис. 5.1.3, 5.1.4, 5.1.5), но в любом случае вызывать его нужно из того объекта, для которого Вы создаете форму.

Рассмотрим **три способа вызова конструктора**:

1) В дереве конфигурации выделить узел «Формы» ветки нужного объекта, вызвать контекстное меню и нажать кнопку «Добавить» (см. рис. 5.1.3);

2) В дереве конфигурации выделить нужный объект, вызвать контекстное меню, найти подменю «Добавить» и в этом подменю нажать на кнопку «Форма» (см. рис. 5.1.4);

3) В редакторе объекта, на закладке «Формы», в дереве форм нажать кнопку «Добавить» (см. рис. 5.1.5).

Рис. 5.1.3

Рис. 5.1.4 271стр.<<

Рис. 5.1.5

После вызова откроется конструктор формы. Для разных типов объектов конструктор может быть разной формы. Например, на рис. 5.1.6 представлен конструктор формы для справочника, а на рис. 5.1.7 – для документа.

Рис. 5.1.6

Рис. 5.1.7

Разберем первую страницу конструктора. Вверху формы нам предложено выбрать тип формы, которая будет создана. Как уже понятно, в зависимости от прототипа объекта (и даже вида прототипа) список типов форм может быть разный. Для справочников это один перечень форм, а для документов другой. Причем обратите внимание на рис. 5.1.5: иногда некоторые типы форм могут быть не доступны. Например, в случае справочника Автомобили недоступны следующие типы форм: форма группы справочника и форма выбора группы справочника, из-за того, что у этого справочника отключена иерархия. Если мы попытаемся создать форму для справочника «Гаражи» (у которого иерархия включена), то эти типы будут доступны.

С помощью свойства «Назначить форму основной» мы можем установить, что вновь созданная форма станет основной. Если у нас уже есть какая-то основная форма, то она никуда не 272стр.<<

денется, просто перезапишется основная форма объекта того типа, форму для которого мы создаем.

Имя – это индикатор формы. В рамках одного объекта не может быть двух форм с одинаковым именем.

Синоним - это свойство, определяет, как форма будет отображаться в пользовательском интерфейсе по умолчанию (может быть несколько форм с одинаковыми синонимами).

Раньше мы всегда на первой странице конструктора останавливались и нажимали кнопку «Готово». В этот раз мы продолжим изучать конструктор новых форм.

Создадим форму документа УстановкаЦенНаТопливо. Тип формы выберем – «Форма документа», назначим будущую форму основной, остальное оставим по умолчанию и нажмем на кнопку «Далее» (см. рис. 5.1.8).

Рис. 5.1.8

В следующем окне конструктора формы мы увидим все реквизиты, табличные части и реквизиты табличных частей объекта. Нам предлагается с помощью флажков отметить, какие реквизиты попадут на нашу форму, а какие нет. Если мы создаем форму документа, форму элемента справочника, форму обработки и т.д., то в списке реквизитов будут присутствовать и реквизиты шапки объекта, и табличные части объекта с реквизитами этих частей. А если мы создаем формы списка или выбора, то будут присутствовать только реквизиты шапки.

После выбора нужных реквизитов необходимо нажать на кнопку «Готово», и форма будет создана (см. рис. 5.1.9). 273стр.<<

Рис. 5.1.9

Обратите внимание: после того, как мы создали форму элемента, в свойство «Основная форма документа» записалась наша вновь созданная форма (см. рис. 5.1.10).

Рис. 5.1.10

Вы можете создавать какое угодно количество форм справочников и документов разных типов. Платформа также предоставляет возможность создания форм копированием. Для этого нужно выделить нужную форму, вызвать контекстное меню и в этом контекстном меню выбрать пункт «Копировать» (см. рис. 5.1.11). После этого будет создана новая форма, аналог скопированной, но под другим именем (см. рис. 5.1.12). В этом случае редактор создания форм открываться не будет. И новая форма не станет основной. Если разработчик желает сделать новую форму основной, то ему необходимо перевыбрать форму в соответствующем поле закладки формы редактора объекта (см. рис. 5.1.13). 274стр.<<

Рис. 5.1.11

Рис. 5.1.12

Рис. 5.1.13

С созданием форм все. Создайте самостоятельно форму справочника «Автомобили». А после приступайте ко второй части этой главы, где мы будем изучать командный интерфейс формы.

275стр.<<

В предыдущей части мы научились создавать формы объектов и узнали, что такое основная форма, как её задать и поменять. В этой части мы познакомимся с командным интерфейсом формы. Командный интерфейс формы разберем в самых общих чертах, чтобы иметь правильное представление об этом.

Но перед тем как начать изучать командный интерфейс форм, узнаем в общем виде, что такое команды и какие виды команд бывают.

Более подробно вопросы работы с командами в целом и командами формы разбираются во 2-й части книги «Основы разработки в 1С: Такси».

Что такое команда? Команда в понятиях платформы 1С это **объект, с помощью которого система выполняет некоторые действия**.

Все команды можно разделить на **две большие группы**: **глобальные команды** и **локальные команды формы**.

Глобальные команды **предназначены для работы с приложением в целом.** А локальные команды формы действуют **только в контексте конкретной формы**. Например, команда открытия формы списка справочника или документа – это глобальная команда, её можно выполнять практически из любого места конфигурации. А команда, которая обрабатывает нажатие на кнопку «Закрыть» формы документа, это локальная команда. Она действует только в контексте определенной формы.

Все команды можно разделить на **два вида, это навигационные команды и команды действия**.

**Навигационные** команды - это, как правило, **команды, необходимые для перемещения по приложению**. Это команды открытия форм списков документов, справочников и журналов документов.

**Команды действия** – **побуждают пользователя совершить какое-то новое действие**. Создать новый документ или справочник, открыть форму отчета или запустить обработку.

.

.

Также все глобальные команды можно разделить на **независимые и параметризируемые**.

**Независимые глобальные команды** – это **команды, которые выполняются для приложения в целом**. Например, открытие формы списка справочника.

**Параметризируемые глобальные команды** – это **команды, для выполнения которых нужен какой-то определенный параметр** (или несколько). Без этого параметра они выполняться не могут. Например, открытие формы регистра накопления с отбором по регистратору (параметр в этом случае – регистратор, какой-то документ).

После того, как Вы создали форму документа, справочника или любого другого объекта, на рабочем столе разработчика откроется редактор формы. На рис. 5.2.1

Вы видите редактор управляемой формы документа УстановкаЦенНаТопливо нашей конфигурации. 276стр.<<

Рис. 5.2.1

Редактор управляемой формы разбит на три окна (см. рис. 5.2.1).

• Окно 1 разбито на две закладки: «Элементы» и «Командный интерфейс»

o «Элементы» - все элементы формы в том порядке, в каком они расположены на форме.

o«Командный интерфейс» - команды, которые могут выполняться на форме.

• Окно 2 разбито на три закладки: «Реквизиты», «Команды» и «Параметры».

o«Реквизиты» - содержит реквизиты формы (что это, мы узнаем позже);

o«Команды» - состав команд, которые потенциально можно применить на форме (локальные и глобальные команды).

o«Параметры» - содержит параметры формы (что это, мы узнаем позже)

• Окно 3 разбито на две закладки - «Форма» и «Модуль»;

o«Форма» - внешний вид формы, как его увидит пользователь;

o«Модуль» - модуль формы для описания событий на встроенном языке.

Определим основные термины:

• Реквизиты формы – это данные, с которыми осуществляется основная работа формы. Более подробно работать с реквизитами мы будем в следующей части, а пока отметим, что есть основной реквизит. На рис. 5.2.1 в окне 2 это реквизит «Объект» и выделен жирным. При создании типизированных форм (форма документа, элемента справочника, списка и т.п.) основной реквизит создается автоматически.

• Команды формы – с помощью них пользователь осуществляет действия на форме. В окне 2 в закладке «Команды» перечислены все возможные команды, которые пользователь может 277стр.<<

использовать в форме. В окне 1 в закладке «Командный интерфейс» перечислены все команды, размещенные на форме.

• Элементы формы – реквизиты, которые размещены на форме.

• Параметры формы – это данные, с помощью которых осуществляется открытие формы (об этом подробно во второй части шестой главы).

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

Посмотрим, что собой представляет командный интерфейс формы (см. рис. 5.2.2). Он содержит два узла, это «Панель навигации» и «Командная панель».

Рис. 5.2.2

Посмотрим, что из себя представляют эти объекты на форме в пользовательском виде (см. рис. 5.2.3).

Для того, чтобы появилась панель навигации на форме, необходимо установить флаг «Видимость» для ветки «Цены на топливо» узла «Панель навигации» (см. рис. 5.2.2).

Рис. 5.2.3. Панель навигации и командная панель на форме (1 – панель навигации, 2 - командная панель)

В закладке «Командный интерфейс» формы помимо колонки, где расположены узлы панель навигации и командная панель, есть еще три колонки - «Видимость», «Автовидимость» и «Автоположение». Разберем, для чего они нужны.

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

Следующая колонка – «Автовидимость». Данная колонка доступна только для команд, добавляемых автоматически (о них ниже). При установке флажка в эту колонку автоматически снимается или устанавливается флаг в колонке «Видимость». Например, для команд открытия форм списков с отбором по регистратору всех регистров (сведений, накопления, бухгалтерии и расчетов) по умолчанию видимость отключена, поэтому когда Вы поставите флаг «Автовидимость» рядом с такой командой, то флаг «Видимость» этой команды снимется (как сняты флажки на рис. 5.2.4). Если разработчику необходимо, чтобы пользователь видел эти формы, то необходимо вручную поставить для них всех видимость, как это сделано на рис. 5.2.2.

Рис. 5.2.4

Устанавливает ли признак «Автовидимость» флаг «Видимость» в значение Истина, или нет - определяется разработчиками платформы. В этой книге нет смысла перечислять все возможные варианты зависимостей. Просто при создании формы проверяйте установку флажка «Видимость», и если по умолчанию он снят, а Вам нужно чтобы у пользователя был доступ к этой команде, то просто установите этот флажок.

И последняя колонка «Автоположение» - определяет расположение команды по умолчанию. При снятии флажка с этой колонки команды можно перемещать внутри группы (сразу становятся доступны стрелки на командной панели вверху окна).

Разберемся с панелью навигации и командной панелью. Для этого самостоятельно создайте форму документа для документа Прибытие в гараж (если не сделали это ранее).

Рис. 5.2.5 279стр.<<

Панель навигации служит для размещения навигационных команд (команды, необходимые для навигации по конфигурации), это какие-либо глобальные команды (независимые или параметризируемые). А командная панель предназначена для размещения команд формы и стандартных команд формы (закрытие, запись и т.д.).

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

В панели навигации формы документа Прибытие в гараж автоматически разместилась команда на открытие формы списка регистра накопления Пробег автомобиля с выключенной видимостью (см. рис. 5.2.6).

Рис. 5.2.6

Установим флаг Видимость (флаг Автовидимость автоматически снимется), сохраним конфигурацию, обновим базу данных и посмотрим на панель навигации формы документа Прибытие в гараж:

Рис. 5.2.7

Как Вы видите, в панели навигации формы документа Прибытие в гараж появилась ссылка, по которой можно увидеть движения этого документа по регистру накопления Пробег автомобиля. 280стр.<<

Рис. 5.2.8

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

Рис. 5.2.9

В предыдущей главе мы создали возможность ввода документа Прибытие в гараж на основании документа Выбытие из гаража (см. стр. 182). Поэтому в командную панель формы автоматически должна добавиться глобальная команда создания на основании (см. рис. 5.2.10).

Рис. 5.2.10

Обратите внимание: флаг «Видимость» для команды создания на основании устанавливается автоматически. 281стр.<<

Подробно о принципах формирования панели навигации и командной панели см. 2-ю часть книги «Основы разработки в 1С: Такси».

.

.

Как было уже сказано выше, в панель навигации добавляются глобальные команды. А в командную панель добавляются как глобальные, так и локальные команды. Причем Вы уже должны были обратить внимание, что некоторые команды добавляются автоматически (правда, у многих по умолчанию выключена видимость). Автоматически **всегда добавляются глобальные параметризируемые команды**, у которых в качестве параметра выступает ссылка на объект формы (реквизит «Объект»). В практике наиболее часто автоматически глобальные команды добавляются при создании форм элементов справочников и форм документов.

Например, создадим форму элемента справочника МаркиАвтомобилей. Для этого выделим узел «Формы» ветки «МаркиАвтомобилей», вызовем контекстное меню (см. рис. 5.2.11) и кликнем на единственный пункт «Добавить».

Рис. 5.2.11

В открывшемся конструкторе оставим переключатель на «Форма элементов справочника», а флаг «Назначить форму основной» оставим включенным.

Больше нам ничего от этого конструктора не нужно. Нажмем кнопку «Готово».

Во вновь созданной форме сразу перейдем на закладку «Командный интерфейс» и увидим, что в панели навигации, в группе «Перейти» уже есть команда, для которой, кстати, видимость по умолчанию включена (см. рис. 5.2.12). Разберемся, почему эта команда попала в панель навигации.

Рис. 5.2.12 282стр.<<

В панель навигации автоматически добавилась параметризируемая команда на открытие формы списка справочника МоделиАвтомобилей с отбором по владельцу (если Вы помните, то справочник МоделиАвтомобилей подчинен справочнику МаркиАвтомобилей).

Команда на открытие формы списка справочника с отбором по владельцу является стандартной глобальной параметризированной командой, параметром этой команды является ссылка на элемент справочника. В нашем случае параметром команды на открытие формы списка справочника МоделиАвтомобилей является выражение «Объект.Ссылка». Реквизитом «Объект» формы элемента является объект элемента справочника МаркиАвтомобилей (см. рис. 5.2.13).

Рис. 5.2.13

Объекты и ссылки на объекты будем изучать в следующей главе.

Почему же добавилась команда на открытие формы списка с отбором по регистратору регистра накопления ПробегАвтомобиля на форму элемента документа ПрибытиеВГараж? Потому что документ ПрибытиеВГараж является регистратором вышеупомянутого регистра и поэтому существует стандартная параметризируемая глобальная команда на открытие формы списка регистра накопления с отбором по регистратору, которая и добавилась в командный интерфейс формы документа (с выключенной по умолчанию видимостью). Создайте самостоятельно формы документов ЗаправкаТоплива и ОтчетОРасходеТоплива, и в командном интерфейсе формы Вы обнаружите глобальную параметризируемую команду на открытие формы списка регистра накопления ТопливоВАвтомобилях с отбором по регистратору (см. рис. 5.2.14). Регистратор - это ссылка на документ, форма которого будет открыта.

Рис. 5.2.14 283стр.<<

Помимо возможности автоматического добавления глобальных команд, в панель навигации можно добавлять команды вручную, перенося их мышкой из вкладки «Глобальные команды» (см. рис. 5.2.15).

Рис. 5.2.15

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

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

.

.

Помимо глобальных команд, которые можно размещать в панели навигации (команды навигации) и в командной панели (команды действия), на форме можно размещать локальные команды. Локальные команды формы **необходимы для выполнения различных действий на форме**. Все локальнее команды расположены на закладке «Команды» в подзакладках Команды формы и Стандартные команды.

Рис. 5.2.16 284стр.<<

В закладке Стандартные команды (см. рис. 5.2.17) перечислены команды формы, которые характеризуют стандартные события с формой или объектом формы. Например, это может быть команда закрытия формы, получения справки, проведения документа и т.п.

Рис. 5.2.17

В закладке Команды формы перечислены команды, созданные разработчиком самостоятельно. Разработчик может создать собственную локальную команду формы. Для этого необходимо на закладке Команды формы нажать на кнопку «Добавить» (+), после этого вновь созданная команда отобразится в списке и справа появится палитра свойств новой команды (см. рис. 5.2.18).

Рис. 5.2.18

В этой палитре свойств пользователь может изменить имя команды (имена должны быть уникальны в пределах формы), установить картинку, заголовок, но самое главное - это привязать какое-то действие к команде.

Назовем нашу команду «ВывестиСообщение».

Рис. 5.2.19 285стр.<<

В свойстве Действие указывается процедура, которая должна сработать, когда пользователь выполнит команду. Можно выбрать имеющуюся процедуру, а можно создать новую, нажав на кнопку «Лупа» свойства «Действие» (см. рис. 5.2.20).

Рис. 5.2.20

После нажатия на кнопку «Лупа» будет предложено три варианта создания обработчиков команды: на клиенте, на клиенте и на сервере, на клиенте и на сервере без контекста. В четвертой части этой главы мы узнаем, в чем особенность каждого вида обработчика. Пока оставим переключатель в значение «Создать на клиенте» и нажмем кнопку «ОК», после этого в модуле формы будет создана процедура (см. рис. 5.2.21), а в свойстве Действие нашей команды появится название этой процедуры (см. рис. 5.2.22).

Рис. 5.2.21

Рис. 5.2.22

Причем название процедуры будет совпадать с названием команды, поэтому не используйте в качестве названия команды какие-либо ключевые слова. 286стр.<<

В новой процедуре самостоятельно напишите код, который будет выводить какое-либо сообщение. Теперь осталось разместить нашу команду на форме. Команду формы можно разместить как в командной панели, так и в элементах формы. Достаточно просто перетащить её в нужное место мышкой (см. рис. 5.2.23, 5.2.24). Естественно Вы не сможете разместить локальную команду в панели навигации.

Рис. 5.2.23

Рис. 5.2.24

После размещения кнопка, соответствующая команде, появится или на командной панели (см. рис. 5.2.25), или среди элементов формы (см. рис. 5.2.26).

Рис. 5.2.25 287стр.<<

Рис. 5.2.26

При нажатии на эту кнопку выполнится код, который описан в процедуре, указанной в свойстве Действие связанной с этой кнопкой команды.

Рис. 5.2.27 288стр.<<

.

.

Приступим к изучению реквизитов форм. Что такое реквизиты формы? Это **данные, которые привязаны именно к форме**: они создаются, хранятся, отображаются (по возможности) и редактируются на форме. Вне контекста формы эти данные не существуют. Сам по себе реквизит не может отображаться на форме. Для этого служат элементы формы, которые связаны с реквизитами форм (о них позже).

Очень часто разработчикам бывает необходимо разместить на форме какой-нибудь элемент. Это может быть какое-то стороннее поле ввода, или какая-то вспомогательная таблица значений. Эти элементы не должны храниться в базе данных и играют второстепенную вспомогательную роль (например, с их помощью выполняются какие-либо вычисления).

Поэтому в управляемом приложении (как и в обычном, кстати) есть возможность создать реквизит формы, который, по сути, будет локальной переменной формы. Реквизит формы можно разместить на форме, тогда добавится новый элемент формы, который будет привязан к этому реквизиту, а можно не размещать. Так или иначе, к реквизиту формы можно обращаться в любой процедуре или функции, написанной в модуле формы.

Это краткая теория. Теперь приступим к практической части.

В предыдущей части мы уже создали форму документа УстановкаЦенНаТопливо. Откройте заново эту форму и перейдите на закладку «Реквизиты» (см. рис. 5.3.1).

Рис. 5.3.1

С ней мы и будем работать. Сейчас у нас на форме только один реквизит, который называется «Объект», причем, как Вы могли заметить из рис. 5.3.1, он имеет иерархическую структуру.

Обратите внимание: этот реквизит выделен жирным шрифтом, и если Вы зайдете в палитру свойств этого реквизита, то свойство «Основной реквизит» будет установлено. Т.е. реквизит «Объект» нашей формы является основным реквизитом формы. У формы может быть только один основной реквизит, и с его помощью определяется функциональность формы. 289стр.<<

Создадим несколько разных реквизитов для основной формы документа УстановкаЦенНаТопливо. Для того чтобы создать новый реквизит, необходимо нажать на кнопку «Добавить реквизит» закладки реквизитов (см. рис. 5.3.2).

Рис. 5.3.2

После того, как Вы нажмете на эту кнопку, автоматически будет создан новый реквизит (по умолчанию тип нового реквизита - строка) и в правой части рабочей области конфигуратора откроется палитра свойств нового реквизита (см. рис. 5.3.3).

Рис. 5.3.3

Разберем основные свойства реквизита формы. И первое свойство, которое бросается в глаза, - это тип. Разработчик может назначить реквизиту практически любой из предоставленных платформой типов: примитивный, ссылочный, объект, таблицу значений, дерево значений и т.д. Причем тип также может быть составным. После нажатия на кнопку «…» рядом с типом откроется окно редактирования типов данных (см. рис. 5.3.4), посредством которого разработчик может назначить тип реквизиту.

Очень осторожно стоит использовать типы, содержащие прикладные объекты (ДокументОбъект, СправочникОбъект и т.п.). Начинающим программистам я рекомендую воздержаться от их использования (кроме случаев, когда данный реквизит является основным). 290стр.<<

Рис. 5.3.4

Замечу, что при присвоении реквизиту формы таких типов, как ссылки, объекты и т.п., реквизит в окне отобразится в виде дерева. Где корнем будет название реквизита, а ветками этого дерева – реквизиты объекта выбранного типа.

Например, на рисунке 5.3.5 мы назначили новому реквизиту тип «ДокументСсылка.УстановкаЦенНаТопливо». И в списке реквизитов можно увидеть, что «Реквизит1» приобрел древовидную структуру, где в ветках дерева можно наблюдать реквизиты и табличную часть документа Установка цен на топливо.

Рис. 5.3.5

Причем на форме можно будет разместить не только сам реквизит с ссылочным или объектным типом, но также и любой реквизит, который входит в состав объекта, образующего данный тип.

Ссылочные типы мы будем изучать в следующей части, а пока научимся работать с реквизитами примитивных типов. Поменяйте у реквизита Реквизит1 тип на «Число», для этого зайдите в свойство реквизита Тип, нажав на кнопку «…», и установите новый тип. 291стр.<<

Рис. 5.3.6

Вернемся к свойствам реквизитов (см. рис. 5.3.7). Следующим после типа идет свойство «Сохраняемые данные». Если это свойство установлено, то при попытке редактирования элемента, связанного с этим реквизитом, будет установлен признак модифицированности формы (символ * рядом с названием).

Рис. 5.3.7

Ещё одно интересное свойство – это «Проверка заполнения» (см. рис. 5.3.8).

292стр.<<

Рис. 5.3.8

Это свойство устанавливается для реквизитов с примитивными и ссылочными типами, а также для реквизитов с типами «Таблица значений» и «Список значений» (эти типы будем проходить в 7-й и 8-й главах).

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

.

.

Просмотр как окно в магазине - позволяет посмотреть на товар, а "Редактирование" как инструмент для изменения - позволяет настроить товар по своему вкусу.

***

Свойства «Просмотр» и «Редактирование» **позволяют настроить видимость реквизита** и возможность его редактирования в зависимости от ролей. После нажатия на гиперссылку «Открыть» реквизита «Просмотр» («Редактирование») появится окно настройки доступа (см. рис. 5.3.9). Если для роли установлен флаг, то пользователь, имеющий такую роль, будет видеть этот реквизит (сможет отредактировать), если флаг снят – то пользователь не будет видеть этот реквизит (не сможет редактировать), а если флаг – серый, то видимость этого реквизита (возможность редактировать) будет определяться флагом в шапке формы.

Рис. 5.3.9

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

Вернемся к списку реквизитов на форме (см. рис. 5.3.10): 293стр.<<

Рис. 5.3.10

Помимо колонок «Реквизит» и «Тип», у данной таблицы есть еще две колонки - «Расположение на форме» и «Использовать всегда». Если есть элемент, который привязан к реквизиту формы, то в колонке «Расположение на форме» появляется серый квадратик. С этим все просто. С полем «Использовать всегда» на данном этапе обучения не будем разбираться, чтобы не загружать Вас излишней информацией.

Интерактивное управление формой осуществляется посредством элементов формы. Элементы расположены на форме в иерархическом порядке. Этот порядок определяет внешний вид формы и состав элементов управления формы. В конфигураторе работа с элементами формы осуществляется в редакторе формы на закладке «Элементы» (см. рис. 5.3.11), а сама же форма, её графический вид - на закладке «Форма» (см. рис. 5.3.11).

294стр.<<

Рис. 5.3.11. Элементы формы (1) и вид формы (2)

Для тех, кто работал с обычными формами: нельзя работать с элементами формы (перемещать, удалять, растягивать и т.п.) непосредственно в графическом отображении формы. Вся работа с элементами ведется в закладке «Элементы».

Всего существует **несколько видов элементов:

• Форма;

• Поле формы;

• Группа формы;

• Декорация формы;

• Таблица формы;

• Кнопка формы;

• Командные панели.**

Позже мы разберем некоторые из них подробнее, пока отмечу, что элемент «Форма» существует только в единственном экземпляре. И располагается в самом верху иерархии. А элемент «Группа формы» может содержать в себе другие элементы формы.

Управление элементом возможно как с помощью мышки, так и с помощью командной панели, которая расположена в верхней части закладки «Элементы». Разберем некоторые кнопки командной панели (см. рис. 5.3.12).

Рис. 5.3.12 295стр.<<

Кнопка Добавить – первая кнопка на командной панели (см. рис. 5.3.12). При нажатии на неё открывается окно с выбором типа элемента (см. рис. 5.3.13).

Рис. 5.3.13

После выбора нужного типа элемента и нажатия кнопки «ОК» этот элемент будет создан и помещен либо непосредственно на форму, либо в какую-нибудь группу, расположенную на форме. В зависимости от того, что у Вас на данный момент было активным.

При нажатии на кнопку «Изменить» (вторая на рисунке 5.3.12) откроется палитра свойств элемента.

С кнопками «Удалить», «Переместить вверх» и «Вниз» все понятно из названия, и, думаю, Вы в этом разберетесь самостоятельно.

При нажатии на кнопку «Проверить» (см. рис. 5.3.14) на экране показывается представление формы, какой её увидит пользователь. 296стр.<<

Рис. 5.3.14

Разберем основные элементы формы, с которыми Вам придется столкнуться в первое время.

Самый главный элемент, без которого не обходится ни одна форма, это элемент «Форма». Данный элемент всегда располагается в верхней части дерева элементов и является родителем для всех элементов формы (см. рис. 5.3.15).

Рис. 5.3.15 297стр.<<

Для того, чтобы попасть в палитру свойств формы, достаточно просто дважды кликнуть по элементу «Форма» мышкой, или, выделив форму, вызвать контекстное меню, где выбрать пункт «Свойства».

Рис. 5.3.16

Свойств у формы много, и я в рамках этой книги не буду все разбирать. Если у кого возникнет желание более глубоко изучить свойства формы, то он найдет всю нужную информацию в справке к программе 1С. С некоторыми свойствами Вы можете познакомиться в 1-й главе 3-й части моей книги «Основы разработки в 1С: Такси». В этой книге изучим только одно интересное свойство: РежимОткрытияОкна.

Режим открытия окна – очень важное свойство формы. **Определяет, каким образом будет открываться наша форма**. Может принимать **три значения**: независимый, блокировать окно владельца, блокировать весь интерфейс.

В этой книге рассмотрим режимы открытия окна только при работе с интерфейсом Такси.

При использовании Независимого режима открытия окна, новая форма откроется в рабочей области интерфейса. Она будет как бы «рядом» с тем окном, откуда было инициировано ей открытие.

Например, на рис. 5.3.17 мы открыли форму документа Установка цен на топливо из формы списка документов. Эта форма стала сама по себе (независимая) и мы как с помощью стрелок навигации, так и с помощью панели навигации можем перейти с этой формы на ту форму, откуда она была открыта. 298стр.<<

Рис. 5.3.17

Если используется режим Блокировать окно владельца (см. рис. 5.3.18), то форма открывается «поверх» окна, где было инициировано её открытие. Блокирует это окно, но в то же время пользователь сможет спокойно осуществлять навигацию по всему интерфейсу.

Рис. 5.3.18

Например, на рис. 5.3.19 мы открыли форму документа УстановкаЦенНаТопливо из списка документов с режимом Блокировать окно владельца. У нас есть возможность перемещаться по интерфейсу, открыть еще одно окно, но чтобы вернутся в список документов, необходимо закрыть окно документа. 299стр.<<

Рис. 5.3.19

Данный режим желательно применять, когда требуется открыть форму, в которую нужно ввести небольшое количество информации

По умолчанию этот режим устанавливается у следующих видов форм:

• Формы элементов и групп справочников

• Формы элементов и групп планов видов характеристик

• Форма счета

• Форма задачи и т.д.

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

.

.

Этот элемент формы **необходим для реализации всевозможных вариантов объединения остальных элементов формы**. В управляемой форме мы не можем самостоятельно размещать элементы на форме, но иногда для удобства работы пользователей возникает необходимость расположить элементы относительно друг друга в различных вариациях. Например, у нас в документе УстановкаЦенНаТопливо поля «Дата» и «Номер» расположены друг под другом, а более удобно, например, чтобы они располагались рядом по горизонтали.

Всего можно создать 4 варианта группы: **«Обычная», «Обычная без отображения», «Страницы» и «Командная панель»** (см. рис. 5.3.20). Также можно сгруппировать колонки в 300стр.<<

таблице формы (эту группу мы изучим, когда будем проходить таблицы на форме, см. глава 8, часть 1, стр. 509).

Рис. 5.3.20

Обычная группа (обычная группа без отображения)

Добавим на нашу форму документа УстановкаЦенНаТопливо обычную группу.

Рис. 5.3.21

По умолчанию группа добавится вниз элементов формы, перетащите её вверх мышкой или при помощи кнопки «Переместить вверх». В закладке Элементы группы отображаются в виде пиктограммы «Папка» (см. рис. 5.3.22).

Рис. 5.3.22

Пока мы никак не увидим нашу группу на форме, для этого необходимо перетащить нужные элементы в группу. Делается это с помощью мышки: просто выделяется нужный элемент 301стр.<<

и «тащится» в группу. Я перенесу в группу элементы «Номер» и «Дата», и на рис. 5.3.23 можно увидеть, как это отобразится на нашей форме.

Рис. 5.3.23

Элементы в «Группа1» расположились согласно свойствам группы по умолчанию. Сейчас мы перейдем в палитру свойств группы и узнаем, какие свойства за что отвечают. Для того, чтобы перейти в палитру свойств группы, необходимо или дважды кликнуть мышкой по группе, или в контекстном меню группы выбрать пункт «Свойства». В открывшейся палитре (см. рис. 5.3.24) нас в основном интересуют свойства из закладки «Основные».

Рис. 5.3.24

И первым делом обратите внимание на свойство Вид – Обычная группа. Всего существуют три вида группы. В этом подразделе мы будем работать с Обычной группой. При выборе групп можно выбрать «Обычную группу» или «Обычную группу без отображения» (см. рис. 5.3.24), но в обоих случаях будет выбрана одна и та же группа с видом Обычная группа. Только во втором случае будет снято свойство ОтображатьЗаголовок (в категории Использование). Больше никаких различий между двумя этими видами в форме выбора нет. По сути, это одна и та же группа, разделение на «Обычную группу» или «Обычную группу без отображения» сделано больше для удобства. 302стр.<<

Перейдем к следующему свойству, это «Группировка». Именно от значения в этом свойстве будет зависеть, как будут располагаться друг относительно друга элементы в группе. По умолчанию оно всегда установлено: «Горизонтальная если возможно». Если мы установим свойство «Вертикальная», то расположение элементов изменится (см. рис. 5.3.25).

Рис. 5.3.25

Зададим заголовок группы, назовем её «Номер и дата» (см. рис. 5.3.26).

Рис. 5.3.26

Обратите внимание: если свойство Отображать заголовок снято, то заголовок не будет отображаться. Причем в любом случае, заполнено свойство «Заголовок» или нет.

Рис. 5.3.27

Объем этой книги не позволяет изучить все свойства групп, да и на данном этапе обучения это не нужно. Пока научитесь работать со свойствами «Вид» (о других значениях позже), «Группировка», «Заголовок» и «Отображать заголовок».

303стр.<<

.

.

Рассмотрим следующий очень интересный вид группы - это страницы. С помощью этой группы **можно создавать различного рода закладки** и размещать по ним элементы. Например, нашу форму документа УстановкаЦенНаТопливо можно реализовать в таком виде:

Рис. 5.3.28

Рис. 5.3.29

Реализуем интерфейс формы документа УстановкаЦенНаТопливо с закладками как на рис. 5.3.28 и 5.3.29. Поставим курсор на узел «Форма», нажмем на кнопку «Добавить» командной панели закладки «Элементы» и выберем элемент с названием «Группа - Страницы» (см. рис. 5.3.30)

Рис. 5.3.30

После этого в дереве «Форма» закладки Элементы добавится строка с уже знакомой Вам пиктограммой «папка». Только свойство Вид этой группы будет Страницы (см. рис. 5.3.31).

Рис. 5.3.31 304стр.<<

Сейчас мы разместили общую группу с видом Страницы, но нам её еще необходимо разбить на страницы. У нас на форме должно быть две страницы, одна для реквизитов шапки, а вторая для табличной части Цены. Для того чтобы добавить новую страницу к группе, необходимо установить курсор на нужную группу (с видом Страницы, не забываем) и нажать на кнопку «Добавить» закладки элементы. В появившемся окне выбора элементов добавится элемент «Группа - страница» (см. рис. 5.3.32).

Рис. 5.3.32

Подобные действия нужно осуществить столько раз, сколько страниц в группе Вы хотите сделать (в нашем случае две). После этого элемент Группа2 в дереве формы приобретет иерархический вид (см. рис. 5.3.33, самостоятельно переместите элемент Группа2 в верх формы).

Рис. 5.3.33

Обратите внимание, что в группах с видом «Страница» тоже можно устанавливать различные группировки с помощью свойства «Группировка» (см. рис. 5.3.34).

Рис. 5.3.34 305стр.<<

Нам осталось с помощью мышки «перетащить» нужные элементы по нужным страницам, и наша форма примет вид почти как на рис. 5.3.28 и 5.3.29

Рис. 5.3.35

Вы заметили, что на рис. 5.3.35 наша группа без страниц. Это потому, что мы не задали заголовки элементам Группа3 и Группа4. Дадим имя заголовку элемента Группа3 – «Шапка» (см. рис. 5.3.36), а Группа4 – «Таблица». После этого наша таблица примет более красивый вид (см. рис. 5.3.37).

Рис. 5.3.36

Рис. 5.3.37 306стр.<<

.

.

Группа с видом Командная панель предназначена **для размещений различных кнопок и групп**. Причем для групп с таким видом можно указывать Источник, в этом случае группа будет автоматически заполнена командами источника по умолчанию. Изменим представление формы документа УстановкаЦенНаТопливо: «перетащим» командную панель формы в закладку «Шапка».

Начнем. Первым делом нам необходимо отключить командную панель формы. Делается это посредством установки свойства формы ПоложениеКоманднойПанели в значение Нет (см. рис. 5.3.38).

Рис. 5.3.38

Добавим новую группу с видом Командная панель в страницу Шапка. Для этого необходимо установить курсор на элемент Группа3 (поскольку именно он является закладкой Шапка) и нажать на кнопку «Добавить» (см. рис. 5.3.39).

Рис. 5.3.39

После добавления новой группы, переместите её вверх над элементом Группа1.

В открывшейся палитре свойств добавленной группы нам нужно указать источник команд. В нашем случае три источника, это команды формы, глобальные команды командной панели формы и команды таблицы «Цены топлива» (см. рис. 5.3.40). Мы выберем источник – «Форма». И после этих действий наша группа сразу же заполнится стандартными командами формы (см. рис. 5.3.41). 307стр.<<

Рис. 5.3.40

Рис. 5.3.41

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

Для дальнейшей работы самостоятельно приведите форму в первоначальный вид.

.

.

Элемент "Поле ввода" это как белая доска, на которой можно писать и стирать текст. Пользователь может писать в этом "поле" и исправлять свои ответы.

***

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

Посредством элемента формы Поле ввода пользователь имеет **возможность просматривать и редактировать реквизит формы**. Создать его на форме можно двумя способами. Первый - с помощью кнопки «Добавить» командной панели закладки элементы, после нажатия на которую, откроется форма выбора типа элемента, где и выбираем нужный нам элемент с типом «Поле» (см. рис. 5.3.42).

308стр.<<

Рис. 5.3.42

Второй способ заключается в перетаскивании нужного реквизита из закладки «Реквизиты» на форму или в группу формы (см. рис. 5.3.43).

Рис. 5.3.43

На форму можно перетаскивать не только реквизиты формы, но и реквизиты реквизитов. Особенно это применимо в том случае, когда основной реквизит формы объект справочника или документа.

Рис. 5.3.44

При простом добавлении поля ввода (первый способ) на отображении формы никакое поле не появится. Так произойдет потому, что свойство ПутьКДанным элемента формы Поле не заполнено (см. рис. 5.3.45). Если же мы будем перетаскивать реквизит формы, то это свойство заполнится автоматически (см. рис. 5.3.46), и как следствие он сразу отобразится на экране. 309стр.<<

Рис. 5.3.45

Рис. 5.3.46

Разработчик имеет возможность самостоятельно отредактировать свойство ПутьКДанным поля: можно выбрать или реквизит формы или, если у реквизита формы ссылочный (объектный) тип, реквизит реквизита формы (см. рис. 5.3.47).

Рис. 5.3.47

Элементов Поле может быть множество видов. Мы рассмотрим самые нужные для дальнейшего изучения. 310стр.<<

.

.

И самый нужный вид элемента Поле это – Поле ввода (см. рис. 5.3.48). С помощью поля с этим видом мы можем вводить практически любые значения: **примитивные (строка, число, дата, булево) и ссылочные (ссылка на справочники, документы и т.д.)**.

Рис. 5.3.48

Внешний вид поля на форме будет зависеть от того, какой тип имеет реквизит, указанный в свойстве поля ПутьКДанным. Для реквизита с типом строка внешний вид поля показан на рис. 5.3.49. Для типов число, булево и дата – на рис. 5.3.50, 5.3.51, 5.3.52. А для ссылочного типа («СправочникСсылка.ТипыТоплива») – на рис. 5.3.53.

Рис. 5.3.49

Рис. 5.3.50

Рис. 5.3.51 311стр.<<

Рис. 5.3.52

Рис. 5.3.53

Если тип реквизита Строка, то в некоторых случаях у элемента формы Поле есть смысл устанавливать свойство МногострочныйРежим в значение Да (см. рис. 5.3.54). Например, это нужно сделать тогда, когда предполагается, что пользователь будет вводить информацию, которая может не войти по длине поля ввода.

Рис. 5.3.54

Еще одна интересная возможность Поля с типом Поле ввода - это возможность выбирать какие-либо значения из заранее созданного списка. Для реализации такой возможности нам понадобятся два свойства, это – РежимВыбораИзСписка, его нужно включить, и свойство СписокВыбора. После нажатия на кнопку «…» свойства СписокВыбора откроется окно, в которое можно внести все варианты выбора (см. рис. 5.3.55). 312стр.<<

Рис. 5.3.55

Причем не важно, какого типа будет реквизит, просто разными значениями будет заполняться поле Значение формы списка выбора.

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

После таких настроек у поля ввода на форме появится кнопка списка, при нажатии на которую выпадет список выбора (см. рис. 5.3.56).

Рис. 5.3.56

.

.

Этот вид элемента Поле можно применять тогда, когда нужно просто для информации **вывести какое-либо значение без возможности редактирования**. Например, добавим на форму документа УстановкаЦенНаТопливо поле, в котором будем показывать текущий тип топлива (на который установлен курсор) таблицы формы «Цены».

Сначала просто добавим элемент Поле при помощи кнопки «Добавить» командной панели окна Элементы, а потом в свойстве ПутьКДанным укажем путь полю ТипТоплива текущих данных элемента формы ЦеныТоплива (см. рис. 5.3.57).

313стр.<<

Рис. 5.3.57

Реквизит «ЦеныТоплива» с текущими данными в окне выбора реквизитов будет только тогда, когда на форме размещена таблица «ЦеныТоплива».

Установим свойства Заголовок и Вид (см. рис. 5.3.58).

Рис. 5.3.58

Вы уже заметили, что после установки значения Поле надписи в свойство Вид отображение элемента Поле на форме поменялось: непосредственно самого поля ввода нет. Посмотрим, как будет работать наше поле надписи (см. рис. 5.3.59).

Рис. 5.3.59 314стр.<<

.

**Для реквизитов с типом Булево** можно задать два вида поля – Поле ввода и Поле флажка. Как выглядит поле ввода для реквизита с типом Булево можно посмотреть на рис. 5.3.60.

Рис. 5.3.60

Такой вариант интерфейса применим, но не всегда удобен, **гораздо практичнее использовать вид поля – Поле флажка** (см. рис. 5.3.61).

Рис. 5.3.61

В этом случае поле приобретает более компактный вид.

Но самое интересное, можно установить два вида флажка, это вид – Флажок, который Вы видите на рис. 5.3.61 и вид «Тумблер» (см. рис. 5.3.62).

Рис. 5.3.62

Такой вид флажка более удобен для восприятия пользователя. Надписи Истина и Ложь можно заменить более понятными с помощью свойства поля флажка ФорматРедактирования. После нажатия на кнопку «…» этого свойства откроется конструктор редактирования форматной строки, где на закладке «Булево» можно задать представление значений Истина и Ложь (см. рис. 5.3.63). 315стр.<<

Рис. 5.3.63

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

Рис. 5.3.64

.

.

С помощью этого поля можно **устанавливать на форме различные переключатели**. При этом виде поля нужно работать с уже знакомым нам свойством СписокВыбора, в котором необходимо указывать все возможные переключатели.

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

Рис. 5.3.65

Следующим шагом необходимо установить значения переключателя, делаем это с помощью уже знакомого свойства СписокВыбора (см. рис. 5.3.66), где в левой части таблицы необходимо указать значение, которое примет наш реквизит при установке того или иного переключателя, а в правой части отображение этого значения на форме. 316стр.<<

Рис. 5.3.66

Чтобы узнать программно, какое значение выбрано, достаточно прочитать реквизит формы. Позже (см. стр. 387) мы узнаем, как это делать.

С помощью свойства КоличествоКолонок можно задать различные расположение переключателя на форме (см. рис. 5.3.67 и 5.3.68). Если свойство КоличествоКолонок равно 0, то все переключатели идут в один ряд в зависимости от места на форме.

Рис. 5.3.67

Рис. 5.3.68

И точно так же, как и в случае с флажком, у переключателя есть свойство ВидПереключетеля, которое может принимать три значения – Авто, Переключатель и Тумблер.

Отображение переключателя с видом Тумблер на форме в конфигураторе (см. рис. 5.3.69) и в «1С:Предприятии» такое же, как и для флажка.

317стр.<<

Рис. 5.3.69

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

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

Кнопку на форму можно добавить двумя способами. Первый: используя кнопку «**Добавить**» командной панели закладки «Элементы» (в открывшемся окне выбрать тип элемента Кнопка, см. рис. 5.3.70).

Рис. 5.3.70

Второй способ: **перетащить команду** на форму (см. рис. 5.3.71).

Рис. 5.3.71 318стр.<<

Если мы добавим кнопку на форму первым способом, то она не отобразится на форме, потому что свойство ИмяКоманды у нашей новой кнопки пустое (см. рис. 5.3.72). Необходимо выбрать команду в этом поле, чтобы кнопка была видна на форме. После нажатия кнопки «…» свойства ИмяКоманды откроется окно выбора команд, посредством которого можно выбрать любую команду: от локальных команд формы до глобальных стандартных команд (см. рис. 5.3.73).

Рис. 5.3.72

Рис. 5.3.73

Кнопка будет создана в любом случае, когда мы свяжем свойство ИмяКоманды с нужной командой. Причем заметьте, кнопка будет создана даже в том случае, если локальная команда формы не связана ни с каким обработчиком. Например, я создал локальную команду формы Команда1, у которой свойство «Действие» пустое (см. рис. 5.3.74). 319стр.<<

Рис. 5.3.74

Привяжем вновь созданную кнопку к локальной команде формы Команда1. Из рис. 5.3.75 Вы видите, что кнопка на форме отобразилась. Она будет и в пользовательском режиме. Просто при нажатии на неё не произойдет никаких действий.

Рис. 5.3.75

Разберем основные и самые интересные свойства элемента Кнопка. И самое первое свойство это Вид. У кнопки есть два вида, это «Обычная кнопка» (см. рис. 5.3.75) и «Гиперссылка» (см. рис. 5.3.76).

Рис. 5.3.76

Обычно на кнопке какой-нибудь текст. Этот текст берется или из имени команды, которая привязана к кнопке, или из свойства Заголовок команды (если оно заполнено), или из свойства Заголовок кнопки (если оно заполнено). 320стр.<<

В свойстве Заголовок локальной команды формы Команда1 напишем текст «Печать», надпись на кнопке поменяется (в свойство кнопки Вид установим обратно значение Обычная кнопка).

Рис. 5.3.77

Если же мы хотим, чтобы рядом с текстом была пиктограмма, то необходимо в свойство Отображение установить значение Картинка и текст, а в свойство Картинка выбрать нужную картинку с помощью окна выбора картинок (см. рис. 5.3.78).

Рис. 5.3.78

И нам осталось сделать так, чтобы наша команда работала. Для этого в палитре свойств команды нажмем на пиктограмму «Лупа» свойства Действие и в открывшемся окне выбора вариантов оставим переключатель на варианте «Создать на клиенте» (см. рис. 5.3.79). 321стр.<<

Рис. 5.3.79

В созданной автоматически процедуре на клиенте напишем код, который просто выведет сообщение.

```csharp

&НаКлиенте

Процедура Команда1(Команда)

Сообщить("Эмуляция печати");

КонецПроцедуры

```

Листинг 5.3.1

Сохраним конфигурацию, перезапустим «1С:Предприятие» и посмотрим, как отрабатывает наша кнопка (см. рис. 5.3.80).

Рис. 5.3.80 322стр.<<

.

.

Этот элемент формы применяется при **необходимости различного оформления**. Например, нужно разместить какой-то не связанный с данными текст или какую-нибудь картинку. Поместить этот элемент на форму можно при помощи кнопки «Добавить» закладки Элементы, при нажатии на которую выйдет форма выбора элементов. В этой форме нужно выбрать или элемент «Декорация - надпись» или «Декорация - картинка» (см. рис. 5.3.81).

Рис. 5.3.81

Элемент Декорация имеет два вида, это Надпись и Картинка. Когда выбираете тип «Декорация - надпись» или «Декорация - картинка», то свойство Вид уже заполнено, но его можно при необходимости поменять (см. рис. 5.3.82)

Рис. 5.3.82

Если выбран вид «Надпись», то в свойстве «Заголовок» можно написать любое сообщение. Причем у свойства есть кнопка «Лупа», нажав на которую, откроется окно ввода строки, где можно ввести как обычную строку (см. рис. 5.3.83), так и форматированную (см. рис. 5.3.84 и 5.3.85). 323стр.<<

Рис. 5.3.83

Рис. 5.3.84

Рис. 5.3.85

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

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

В 4-й главе мы добавили общую картинку в конфигурацию (см. стр. 239) эту картинку мы и будем использовать в текущем примере. 324стр.<<

Добавим элемент «Декорация - картинка» на форму, для того, чтобы картинка отобразилась на форме, нужно заполнить свойство Картинка (см. рис. 5.3.86).

Рис. 5.3.86

После нажатия на кнопку «…» откроется форма выбора картинки (см. рис. 5.3.87), в которой пользователь может или выбрать картинку из конфигурации, или стандартную картинку, или загрузить свою собственную картину.

*Не стоит с помощью элемента «Декорация» размещать картинки, которые будут храниться в базе. Для этого необходимо использовать поле ввода с видом «Поле» картинки. Как работать с картинками, хранящимися в базе, рассказывается в третей части книги «Основы разработки в 1С: Такси».*

Рис. 5.3.87

Теперь Вам просто нужно выбрать или общую картинку из конфигурации (закладки «Из библиотеки» - «Из конфигурации»), или стандартную картинку, или загрузить картинку из файловой системы. Выберем картинку из конфигурации (см. рис. 5.3.88). 325стр.<<

Рис. 5.3.88

Самостоятельно при помощи группы (или групп) разместите декорации следующим образом (см. рис. 5.3.89).

Рис. 5.3.89

На этом мы закончим изучать элементы формы. В дальнейшем при углублении материала мы изучим еще один нужный элемент – «Таблица».

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

Принцип работы «1С:Предприятия 8.3» под управляемым приложением имеет клиент-серверный характер. Не будем углубляться в дебри, отмечу только, что это значит, что **какой-то код выполняется в контексте сервера, а какой-то код в контексте клиента**. Причем, при разработке управляемого приложения, разделение контекста выполнения программного кода на клиентский и серверный стало очень критичным. Узнаем, что означает клиентский контекст выполнения кода, а что - серверный.

Для этого рассмотрим классическую трехзвенную архитектуру «1С:Предприятия». У Вас есть клиентские компьютеры, где работают все пользователи, есть кластер серверов «1С:Предприятия», где выполняются все вычисления, и есть SQL-база (СУБД), где хранятся все данные (см. рис. 5.4.1). 326стр.<<

Рис. 5.4.1. Клиент-серверная архитектура работы «1С:Предприятия»

На клиентской машине может быть установлено какое-то приложение 1С, которое запускается под толстым или тонким клиентом, а может быть и ничего не установлено, вся работа будет осуществляться посредством веб-клиента из Интернет-браузера. Толстый или тонкий клиент, а также работу под веб-клиентом называют клиентским приложением. Таким образом, на клиентской машине осуществляется взаимодействие пользователя программы с самой программой 1С. Это взаимодействие осуществляется при помощи механизмов платформы 1С, а также при помощи кода, который написан разработчиками прикладного решения. Выполняясь, этот код задействует ресурсы клиентского компьютера. В этом случае говорят, что он выполняется «на клиенте». А контекст выполнения этого кода называют клиентским. Причем есть клиентский контекст под тонким клиентом, а есть под толстым клиентом. Не все методы, которые могут работать под толстым клиентом, будут работать под тонким или веб-клиентом.

Кластер серверов 1С не является чем-то единым целым, а представляет собой несколько запущенных процессов, каждый из которых является сервером 1С. Сервер 1С осуществляет взаимосвязь клиентского приложения с системой управления базы данных (СУБД). Также север 1С может исполнять определенный код, тогда говорят, что код выполняется «на сервере», а контекст выполнения этого кода – серверный. В случае выполнения кода на сервере все вычисления будут происходить на той машине, где в этот момент запущен соответствующий экземпляр сервера 1С. Как правило, это мощный и производительный компьютер. 327стр.<<

Рис. 5.4.2. Клиентский и серверный контекст выполнения кода

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

Форма же в обычном приложении выполнялась полностью на стороне клиентского компьютера. Причем с формы можно было что угодно делать с базой данных: создавать новые объекты, редактировать их и т.п.

В управляемом приложении все кардинально поменялось. Теперь на стороне клиентского компьютера форма должна только прорисовываться и всё. Связано это с возникновением тонкого и веб-клиента, которые осуществляют взаимодействие с серверной частью посредством сети Internet. Этот канал связи накладывает существенные ограничения на широту передаваемых данных. И если раньше мы могли на форме делать практически всё: обращаться к базе данных, создавать документы, справочники и т.п., то теперь это стало слишком дорогим удовольствием. Поэтому для нормального функционирования тонкого клиента и веб-клиента был существенно переделан механизм работы форм. Форма только прорисовывается на клиенте и всё, а все обработки данных, вычисления и т.п. должны выполняться на сервере.

При разработке управляемых приложений разработчик сам **должен определять, Директиву компиляции - какой код будет работать на сервере, а какой на клиенте**.

Например, нам нужно на какой-то форме узнать остаток товара на какую-то дату. Для этого мы разместим на форме два реквизита, в одном будет храниться ссылка на справочник товаров, а в другом - дата, на которую нужно получить остаток, а также команду «Получить остаток». Следующим шагом нужно определить, что будет выполняться на сервере, а что на клиенте. Понятно, что обработка нажатия на кнопку (обработчик команды «Получить остаток») должна 328стр.<<

выполняться на клиентской машине. А функция подсчета остатков – на серверной, поскольку идет обращение к базе данных. Но это еще не всё. Нам нужно вызвать из процедуры, которая выполняется на клиенте (обработка нажатия на кнопку), функцию, которая выполняется на сервере (подсчет остатков).

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

И заметьте, вызов сервера будет происходить каждый раз, когда идет вызов процедуры или функции, которая выполняется на сервере. Причем этот вызов в иных случаях может происходить быстро и быть практически незаметным (при работе по локальной сети), а может быть очень медленным (при работе по сети Internet). Поэтому разработчику при конструировании прикладной системы необходимо очень внимательно относиться к вызову процедур на сервере, чтобы не создавать «тормознутые приложения».

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

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

Еще одной головной болью хорошего разработчика будет определить, какой серверный метод будет вызываться обычным образом (с передачей реквизитов формы на сервер), а какой метод будет вызываться без контекста. Потому что если мы каждый раз будем отправлять на сервер большие объемы информации с формы, а потом получать их обратно, это существенно скажется на производительности приложения. Но тут стоит знать, что не все данные с формы при обычном вызове передаются на сервер, а только те, которые были изменены.

Но это еще не все, вспомним наш вызов процедуры подсчета остатков, где мы передаем на сервер какие-то объекты. В нашем случае это ссылка на какой-то элемент справочника «Номенклатура» и дата. Иногда при передаче каких-либо значений на сервер могут возникнуть определенные проблемы: не все объекты можно передать с клиента на сервер и наоборот, не всё можно передать с сервера на клиент. Например, с сервера на клиент нельзя передать объект справочника или документ, и наоборот, с клиента на сервер нельзя передать какой-нибудь элемент формы. Для того, чтобы **объект можно было передавать на сервер, он должен сериализоваться**. Сериализация, простыми словами, это **возможность представления объекта в каком-то виде, например в виде текстовой строки, или в виде XML**. Для начинающего программиста поначалу сложно будет понять, какой объект подлежит сериализации, а какой нет. Но вся **информация об этом содержится в синтаксис-помощнике**. Например, объект Массив (будем проходить в 7-й главе) подлежит сериализации. 329стр.<<

Рис. 5.4.3

И естественно, нужно помнить и знать, что при разработке управляемого приложения очень существенно ограничиваются наши действия в контексте серверного и клиентского кода. С клиентского контекста мы не можем получить прямой доступ к объектам базы 1С, у нас нет возможности ими манипулировать (добавлять, изменять, удалять и т.п.), а также не можем обращаться к свойствам этих объектов.

Например, на клиенте у нас не получится прочитать у ссылки на справочник «Номенклатура», которая хранится в реквизите формы, реквизиты и свойства этой ссылки. При попытке выполнения в клиентском контексте кода вот такого вида: НаименованиеНоменклатуры = Номенклатура.Наименование;, произойдет ошибка. В то же время в серверном контексте нет смысла в выполнении кода, который обрабатывает различные события на форме (нажатие на кнопку и т.п.).

Также стоит учитывать вид клиентского контекста. Какие-то объекты доступны в тонком, толстом и веб-клиенте (как тот же «Массив»). А какие-то только в толстом клиенте, например ТаблицаЗначений (изучим в 8-й главе). Определить, что выполняется в каком виде клиента можно в справочной информации.

Рис. 5.4.4

Т.е. та же ТаблицаЗначений вполне работает в клиентском контексте, но только в режиме толстого клиента.

Что же из себя представляет форма в клиент-серверном понимании? Форма - это программный объект, который создается на сервере согласно настройкам, сделанным в конфигураторе (если формы нет в конфигураторе, то она генерируется автоматически платформой), а потом выводится в клиентском приложении. Таким образом, форма 330стр.<<

одновременно существует и на сервере, и на клиенте! А как следствие у формы есть и серверный, и клиентский контекст выполнения кода.

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

При разработке формы в управляемом приложении программисту нужно явно указывать, какой код выполняется в клиентском контексте. А какой - в серверном. Осуществляется это при помощи директив компиляции, которые предопределенны в платформе 1С 8. Директиву компиляции следует указывать перед каждой функцией или процедурой (а также переменными) в модуле формы, в общем модуле или в модуле команды. Все директивы компиляции начинаются с символа амперсанд - &. И от них зависит, в каком контексте будет выполняться код в процедуре или функции. **Всего их пять**:

• &НаКлиенте

• &НаСервере

• &НаСервереБезКонтекста

• &НаКлиентеНаСервереБезКонтекста

• &НаКлиентеНаСервере

В этой книге мы изучим только первые три директивы.

.

.

Директива &НаКлиенте - единственная директива, из-под которой **доступен клиентский контекст формы.**

***

**&НаКлиенте** – когда процедура или функция предварена этой директивой, то данный метод будет выполняться в клиентском контексте. Это значит, что он будет выполняться на той машине, где в данный момент функционирует клиентское приложение. Из такой процедуры или функции будут доступны все данные формы, а также из неё можно вызывать любую процедуру или функцию текущего модуля. Под этой директивой будет доступен весь клиентский контекст формы, т.е. мы можем вызывать любые функции под директивой &НаКлиенте.

Все обработчики команд всегда выполняются на клиенте. Для того, чтобы проверить это, разместите на любой форме (я для этой цели создал новую обработку) произвольную команду (я её назвал «Нажатие кнопки») и нажмите на кнопку «Лупа» свойства «Действие» этой команды (см. рис. 5.4.5).

Рис. 5.4.5 331стр.<<

После нажатия на кнопку «Лупа» свойства «Действие» команды, платформа предложит Вам выбрать, где создать обработчик события (см. рис. 5.4.6). Заметьте, во всех трех вариантах создания процедуры обработчика присутствует процедура, которая будет выполняться на клиенте. Просто в случаях выбора «Создать процедуру на клиенте и на сервере» и «Создать процедуру на клиенте и на сервере без контекста» будет создана процедура на клиенте, которая будет вызывать процедуру или на сервере, или на сервере без контекста. Ниже мы разберем этот момент.

Рис. 5.4.6

Мы выберем пункт «Создать на клиенте», и после нажатия кнопки «ОК» в модуле формы автоматически появится код, как на листинге 5.4.1.

&НаКлиенте Процедура НажатиеКнопки(Команда) // Вставить содержимое обработчика. КонецПроцедуры

Листинг 5.4.1

Имейте в виду, все обработчики элементов формы должны всегда выполняться под этой директивой (см. листинг 5.4.1). Другими словами обработка событий всех элементов формы имеет клиентский контекст.

Любая процедура или функция, которая написана под директивой &НаКлиенте, может использовать все методы этой формы под директивами &НаКлиенте, &НаСервере, &НаСервереБезКонтекста и &НаКлиентеНаСервереБезКонтекста. Поэтому, код, показанный на листинге 5.4.2, будет успешно выполняться и не вызовет ошибки.

```csharp

&НаКлиенте

Процедура НажатиеКнопки(Команда)

ПроцедураВыполняемаяНаКлиенте();

КонецПроцедуры

&НаКлиенте

Процедура ПроцедураВыполняемаяНаКлиенте()

//....

КонецПроцедуры

```

Листинг 5.4.2 332стр.<<

Директива &НаКлиенте - единственная директива, из-под которой **доступен клиентский контекст формы.**

.

.

при вызове метода под директивой &НаСервере **доступны все данные формы, доступен серверный контекст формы, а также можно вызывать внеконтекстные серверные процедуры и функции (с директивой &НаСервереБезКонтекста)**. В то же время нужно иметь в виду, что при вызове серверного метода происходит передача всех данных формы на сервер, а потом обратно, что может сказаться на производительности приложения, особенно запускаемого под тонким клиентом.

***

**&НаСервере** - код процедуры или функции под этой директивой будет выполняться в серверном контексте, т.е. на машине, где запущен сервер 1С. Все данные формы будут передаваться на сервер, а потом обратно на форму, после завершения выполнения метода. Из процедуры под этой директивой будет доступен весь серверный контекст формы, т.е. все процедуры или функции, которые выполняются на сервере, можно вызвать из метода предваренного этой директивой. Но в то же время клиентский контекст формы будет недоступен.

Проверим работу данной директивы, для этого удалите все обработчики команды «Нажатие кнопки», очистите свойство «Действие», заново на него нажмите и выберите пункт «Создать на клиенте и процедуру на сервере» (см. рис. 5.4.7).

Рис. 5.4.7

После этих действий автоматически будут созданы две процедуры. Одна на сервере, а другая на клиенте (см. листинг 5.4.3).

```csharp

&НаСервере

Процедура НажатиеКнопкиНаСервере()

// Вставить содержимое обработчика.

КонецПроцедуры

&НаКлиенте

Процедура

НажатиеКнопки(Команда)

НажатиеКнопкиНаСервере();

КонецПроцедуры

```

Листинг 5.4.3

В этом листинге процедура клиентского контекста НажатиеКнопки вызывает процедуру серверного контекста НажатиеКнопкиНаСервере. В методе, который выполняется под директивой &НаСервере, нам доступны все данные формы: реквизиты, параметры и т.д. Но нам уже не доступен клиентский контекст формы. Если мы напишем еще одну процедуру на клиенте (см. листинг 5.4.4) и попытаемся её вызвать из новой серверной процедуры НажатиеКнопкиНаСервере, то при проверке синтаксиса будет сгенерирована ошибка (см. рис. 5.4.8). 333стр.<<

```csharp

&НаСервере

Процедура НажатиеКнопкиНаСервере()

ВыполнениеНаКлиенте()

КонецПроцедуры

&НаКлиенте

Процедура НажатиеКнопки(Команда)

НажатиеКнопкиНаСервере();

КонецПроцедуры

&НаКлиенте

Процедура ВыполнениеНаКлиенте()

КонецПроцедуры

```

Листинг 5.4.4