Первая программа на 1С

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику Архитектору

Первая программа на 1С

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

Конфигурация 1С:Предприятие — это набор объектов, описывающих структуру данных, интерфейсы пользователя, бизнес-правила и алгоритмы обработки информации для конкретной задачи (например, бухгалтерский учет, торговля, склад). Конфигурация состоит из метаданных (описание объектов) и пользовательских данных (заполненные таблицы, документы). Конфигурация работает только внутри запущенной платформы 1С.

Взаимодействие между платформой и конфигурацией происходит следующим образом. Пользователь запускает программу через ярлык или меню. Запускается процесс исполняемого файла платформы (rphost.exe или 1cv8.exe). Платформа считывает файл конфигурации, загружает в память описание всех объектов (справочники, документы, отчеты), компилирует код модулей и начинает выполнение скриптов по требованию пользователя или по расписанию.

Язык программирования 1С представляет собой высокоуровневый объектно-ориентированный язык со специфическим синтаксисом. Синтаксис языка близок к естественному русскому языку, что облегчает чтение кода. Команды языка имеют вид словосочетаний, например, «Создать», «Записать», «Провести». Язык поддерживает встроенные типы данных, такие как Число, Строка, Дата, Булево, Справочник, Документ.

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

Первая программа в среде 1С всегда создается в режиме «Конфигуратор». Программа представляет собой объект метаданных, который содержит код процедуры или функции. Этот код выполняется при определенных событиях (например, при нажатии кнопки, при открытии формы, при сохранении документа).

---

Установка платформы 1С:Предприятие

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

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

Запуск установщика осуществляется двойным щелчком мыши по файлу. Интерфейс установщика предлагает выбрать тип установки. Существует вариант «Обычная установка» и вариант «Выборочная установка». Обычная установка устанавливает платформу со всеми стандартными компонентами, включая клиентские и серверные компоненты, средства разработки и демо-данные. Выборочная установка позволяет включить или исключить отдельные компоненты, что полезно для экономии места на диске.

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

После выбора компонентов система предлагает указать путь установки. По умолчанию используется папка C:\Program Files\1c\v8.3. Изменение этого пути допустимо, но не рекомендуется, так как многие настройки и ссылки в системе привязаны к этому расположению. После указания пути следует нажать кнопку «Установить».

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

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

Для работы с базами данных требуется наличие сервера баз данных. Платформа 1С поддерживает работу с собственным файловым сервером (когда база данных хранится в одном файле на диске) и с внешними СУБД (Microsoft SQL Server, PostgreSQL, Oracle DB). Для обучения достаточно использовать файловый режим работы, когда вся база данных хранится в одном файле с расширением .dtb или .dbf.

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

---

Создание новой конфигурации и структура проекта

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

Создание новой конфигурации начинается с выбора типа информационной базы. Доступны варианты «Файловая информационная база» и «Серверная информационная база». Для первой программы выбирается вариант «Файловая информационная база». Этот тип проще в настройке и не требует установки внешнего сервера баз данных.

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

После указания имени и пути система предлагает выбрать шаблон конфигурации. Шаблон определяет начальную структуру базы данных. Существуют шаблоны «Пустая конфигурация», «Типовая конфигурация 1С», «Шаблон с примерами». Для обучения лучше всего выбрать шаблон «Пустая конфигурация». Этот шаблон создает пустую структуру, куда можно добавлять объекты вручную, что позволяет понять принцип построения системы.

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

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

Для первой программы достаточно создать один объект типа «Документ». Документ в 1С представляет собой факт хозяйственной операции (например, «Поступление товаров», «Выдача наличных»). Каждый документ имеет свой модуль, где описывается логика его обработки.

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

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

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

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

---

Написание кода первой программы

Первая программа в 1С должна демонстрировать базовые возможности языка: вывод сообщения пользователю и запись данных в базу. Логика программы будет следующей: при нажатии специальной кнопки на форме документа выполняется процедура, которая выводит сообщение «Привет, мир!» и сохраняет документ в базе данных.

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

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

Добавление кнопки осуществляется перетаскиванием элемента из списка в макет формы. Нужно найти элемент «Кнопка» и перетащить его на форму. Кнопка появится в области дизайна. Теперь нужно настроить её свойства. В панели свойств справа найти поле «Имя» и задать значение, например, КнопкаВывода. Затем найти поле «Описание» и ввести текст, который будет отображаться на кнопке, например, «Показать приветствие».

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

В редакторе кода появляется заглушка процедуры. Текст кода пишется на языке 1С. Для вывода сообщения используется встроенная функция Сообщить(). Эта функция принимает строковый аргумент и показывает всплывающее окно с текстом.

Пример кода для процедуры нажатия кнопки:

Процедура КнопкаВыводаНажатие(Кнопка)
    
    Сообщить("Привет! Вы создали первую программу на 1С.");
    
КонецПроцедуры

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

Чтобы программа стала более полезной, добавим возможность записи данных. Создадим новый реквизит в документе. Реквизит — это переменная, хранящая данные внутри объекта. В окне свойств документа перейдем на вкладку «Реквизиты». Добавим новый реквизит с именем ТекстПриветствия и типом «Строка».

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

Измененный код процедуры:

Процедура КнопкаВыводаНажатие(Кнопка)
    
    Текст = ВводСтроки("Введите ваше приветствие", , "Текст");
    
    Если Не ПустаяСтрока(Текст) Тогда
        
        СохранитьДокумент();
        
        Сообщить("Ваше сообщение: " + Текст);
        
    КонецЕсли;
    
КонецПроцедуры

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

Для полной реализации нужно добавить метод Записать() в процедуру. Этот метод сохраняет текущее состояние документа в базе данных. Код становится таким:

Процедура КнопкаВыводаНажатие(Кнопка)
    
    Текст = ВводСтроки("Введите ваше приветствие", , "Текст");
    
    Если Не ПустаяСтрока(Текст) Тогда
        
        Реквизит.ТекстПриветствия = Текст;
        
        Записать();
        
        Сообщить("Документ сохранен. Сообщение: " + Текст);
        
    КонецЕсли;
    
КонецПроцедуры

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

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

---

Запуск и тестирование программы

После написания кода необходимо сохранить изменения в конфигурации. В режиме «Конфигуратор» нажатие клавиш Ctrl+S или выбор пункта меню «Файл» -> «Сохранить» записывает изменения в файл базы данных. Система проверяет синтаксис кода. Если найдены ошибки, редактор подсветит их красным цветом и покажет описание проблемы в нижней панели.

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

В окне запуска выберите созданную базу данных «МояПерваяПрограмма» и нажмите кнопку «Запустить». Откроется интерфейс программы в режиме эксплуатации. Поскольку мы создали документ «ТестовыйДокумент», он должен появиться в списке документов или на главной форме.

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

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

Проверьте, что документ действительно сохранился. Вернитесь к списку документов. Найдите созданный документ. Откройте его двойным щелчком. В реквизите ТекстПриветствия должно отображаться введенное вами сообщение. Если сообщение отображается корректно, значит, операция записи прошла успешно.

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

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

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

---

Архитектура выполнения кода и обработка событий

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

Событие — это сигнал о том, что произошло какое-то действие. Примеры событий: нажатие кнопки, открытие формы, сохранение документа, получение данных из сети. Когда событие возникает, система ищет обработчик этого события в соответствующем модуле.

Каждый объект метаданных имеет свои модули. Модуль «Объект» содержит код, реагирующий на события самого объекта. Модуль «Формы» содержит код, реагирующий на события интерфейса. Модуль «Общий» содержит код, доступный всем объектам.

Когда пользователь нажимает кнопку, генерируется событие «Нажатие». Система просматривает список обработчиков событий для этой кнопки. Если найден обработчик ПриНажатии, он выполняется. Код внутри обработчика выполняется последовательно сверху вниз.

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

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

Пример использования обработки исключений:

Процедура БезопаснаяЗапись()
    
    Попытка
        
        Записать();
        
        Сообщить("Успешно");
        
    Исключение
        
        Сообщить("Ошибка при записи: " + ОписаниеОшибки());
        
    КонецПопытки;
    
КонецПроцедуры

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

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

Для работы с сетью используются методы HTTPЗапрос, HTTPSЗапрос. Эти методы позволяют отправлять данные на сервер и получать ответы. Результаты запроса возвращаются в виде объектов, которые содержат статус ответа и тело сообщения.

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

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

---