Проект

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

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

Важно!

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

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

Основные понятия

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

  • Расписание выгрузки — это расписание, согласно которого, будут происходить регламентные выгрузки тех данных, которые накопились в очередь выгрузки. О том, как настроить расписание, читайте здесь: Настройка расписания.

  • Очередь выгрузки — это информация о своего рода пакетах, готовых к выгрузке. Здесь содержится информация о том, какие сегменты данных надо выгрузить. Если это очередь выгрузки, сформированная сразу после настройки, то это первоначальная очередь выгрузки. Первоначальная очередь выгрузки содержит в себе все сегменты данных (чтобы выгрузить первоначально все наборы данных проекта целиком и создать из них таблицы базы данных). В последствии, когда проект начнет работать по расписанию - в очередь буду попадать лишь те сегменты данных, в которых возникли изменения.
    Подробнее об очереди выгрузки см. в статье: Все, что нужно знать об очереди выгрузки.

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

  • Набор данных — это либо результат запроса к 1С, либо выбранный интерактивно объект базы 1С, или любой другой допустимый набор данных (Excel, CSV, Обработчик).

  • Обработчик события проекта — это программный код (предопределенный, или созданный вами самостоятельно), который выполняется на определенных этапах (в момент определенного события) проекта.

Этапы выполнения проекта

графически этапы выполнения проекта можно представить так:

Подробнее об обработчиках, как и когда их применять см. в статье: Обработчики
Все этапы выполнения выгрузки данных записываются (логируются) в журнале «История выполнения проекта». Здесь будет записана информация о том, какие сегменты/партиции были выгружены, сколько записей в них содержалось, были ли ошибки при выгрузке.

Интерфейс окна проекта

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

Данное окно содержит следующий функционал:

Элемент интерфейса

Описание

Кнопка «Записать и закрыть»

позволяет записать и закрыть созданный или отредактированный проект.

Кнопка «Записать»

позволяет записать созданный или отредактированный проект.

Кнопка «Сформировать очередь»

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

Кнопка «Выполнить проект»

позволяет выполнить проект.

Кнопка «История»

позволяет открыть окно «История выполнения проекта».

Кнопка «Очередь»

позволяет открыть окно «Очередь выгрузки».

Поле «Наименование»

позволяет указать наименование проекта.

Поле «Группа»

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

Поле «Код»

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

Поле «Подключение»

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

Кнопка «Проверить»

позволяет проверить работу выбранного подключения.

Вкладка «Таблицы»

Кнопка «Добавить»

позволяет добавить новую строку в проект.

Кнопка «Изменить»

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

Кнопка

(Дублировать)

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

Кнопка

(Вырезать)

позволяет вырезать выбранную строку проекта.

Кнопка

(Скопировать в буфер)

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

Кнопка

(Вставить из буфера)

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

Кнопки

(Переместить текущий элемент вверх/переместить текущий элемент вниз)

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

Кнопка

(Настройка строки проекта)

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

Кнопка «Сформировать очередь»

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

Кнопка «Выполнить строку»

позволяет выполнить выбранную строку проекта.

Кнопка «Еще»

содержит весь функционал панели управления вкладки «Таблицы». А также пункт «Удалить» и «Выполнить строку (не в фоне)».

Вкладка «Обработчики»

подержит функционал для настройки обработчиков событий проекта.

Вкладка «Дополнительно»

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

Поле «Расписание выгрузки»

позволяет настроить расписание выгрузки проекта.

Поле «Комментарий»

позволяет оставить комментарий к проекту.