Добавление внешнего отчета в базу. Добавление внешнего отчета в базу Внешние отчеты 1с 8.3 сделать

Говорят, что под названием 1С изначально подразумевалась фраза «одна секунда», т.е. программы должны выдавать отчеты быстро, «в одну секунду». Скорость работы отчетов очень важна, но еще важнее, чтобы отчеты выдавали правильную информацию — разберемся с этим на примере создания простого отчета в 1С 8.3 на базе конфигурации Управление торговлей 10.3. Для создания корректных отчетов желательно (даже настоятельно рекомендуемо) уметь конфигурировать 1С и немного уметь программировать на внутреннем языке и языке запросов 1С, хотя, с другой стороны, создание отчетов — прекрасная возможность начать осваивать эти навыки.

Данное описание является учебным для понимания основных принципов создания отчетов 1С

Как создать отчет в 1С 8.3

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

В самом конфигураторе заходите в меню Файл и выбираете пункт Новый:


В появившемся меню выбираете пункт Внешний отчет и нажимаете кнопку ОК:


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


Как сделать отчет с помощью макета

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

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


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


После чего откроется окно макета, напоминающее лист Excel:


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

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

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


После этого идем в меню Таблица главного меню, заходим в подменю Имена и кликаем на пункт Назначить имя:


Программа предложит указать Имя области, имя также не должно содержать пробелов и спецсимволов, после этого нажимаем ОК, должно получиться так:


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

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


В открывшемся окне в разделе Начертание устанавливаем галочку Жирный и нажимаем кнопку ОК:


В макете должно получиться вот так:


Таким же образом создаем область строки номенклатуры, только не выделяем жирным:


В области строки нужно указать, что Наименование — это параметр, т.е. что туда будет подставляться реальное наименование номенклатуры при выводе отчета. Для этого открываем свойства ячейки с наименованием и в свойствах в поле Заполнение выбираем значение Параметр, на этом настройка макета завершена:


Возвращаемся в главное окно отчета и в нижнем списке кликаем правой кнопкой на пункт Формы и нажимаем Добавить:


В открывшемся конструкторе формы отчета нажимаем кнопку Готово, откроется форма отчета, кликаем два раза на кнопку Сформировать:


В результате откроется окно свойств кнопки в правой части экрана, в поле Действие нажимаем на лупу:


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


Сначала вставим вместо выделенного текста следующий текст программного кода:

//создаем табличный документ, который будет наполняться частями отчета и выводиться на экран
ТабДокумент = Новый ТабличныйДокумент;
//далее, получаем макет, который создавали при создании отчета
Макет = ПолучитьМакет("Макет");
//теперь нужно вывести шапку отчета, дял этого получаем область шапки из макета и выводим ее в табличный документ
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ТабДокумент.Вывести(ОбластьШапка);
//с помощью запроса получаем выборку наименований номенклатуры, которые надо вывести в отчете
Запрос = Новый Запрос;
Запрос.Текст = "
|ВЫБРАТЬ
| Наименование
|ИЗ
| Справочник.Номенклатура
|";
//получить из макета область строки номенклатуры — будем обращаться к ней в цикле для вывода каждого наименования
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
//обрабатываем в цикле каждое наименование из полученной выборки
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
//для вывода очередной строки нужно указать очередное наименование в параметре области (сам параметр мы настраивали при создании макета)
ОбластьСтрока.Параметры.Наименование = Выборка.Наименование;
//параметр заполнили, теперь можно вывести строку
ТабДокумент.Вывести(ОбластьСтрока);
КонецЦикла;
//табличный документ сформирован, теперь выводим его на экран
ТабДокумент.Показать("Перечень номенклатуры«);

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


Резюмируем, какие строки программного кода необходимы для формирования отчета:

  1. Необходимо создать табличный документ, который будет наполняться частями отчета и выводится на экран, делается это строкой «ТабДокумент = Новый ТабличныйДокумент;»
  2. Нужно получить макет отчета, из него будем получать структуру отчета по частям (области), делается это строкой "Макет = ПолучитьМакет("Макет")"
  3. Для вывода каждой из областей нужно получить ее из макета и вывести в табличный документ, делается это строками "ОбластьШапка = Макет.ПолучитьОбласть("Шапка")" и «ТабДокумент.Вывести(ОбластьШапка)»
  4. Если требуется заполнить параметры, который становятся известны только при выполнении программы, то перед выводом области нужно заполнить такие параметры, делается это строкой «ОбластьСтрока.Параметры.Наименование = Выборка.Наименование»
  5. И лишь, когда табличный документ заполнен всеми нужными частями отчета, он выводится на экран, делается это строкой "ТабДокумент.Показать("Перечень номенклатуры")"

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


Находим и открываем сохраненный файл отчета. В открывшейся форме нажимаем кнопку Сформировать:


и получаем перечень номенклатуры:


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

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

Отчеты и обработки

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

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

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

Физически рассматриваемые в статье объекты от внешней обработки различаются расширением файла:

  1. Внешняя обработка – epf;
  2. Внешний отчет – erf.

Внешние и встроенные отчеты

Если внимательно посмотреть на дерево любой конфигурации в 1С, можно заметить, что там также есть ветка отчетов (Рис. 1)

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

Рис. 2

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

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

Создание внешнего отчета

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

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

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

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

Но, независимо от выбранного механизма, начинать надо из меню «Файл», подменю «Новый». Перед разработчиком открывается меню выбора создаваемого объекта (Рис. 3).

Рис. 3

Рис. 4

Здесь мы видим:

  • Имя, которое максимально точно резюмирует назначение объекта;
  • Синоним и комментарий – предназначены для полного описания;
  • Основная схема компоновки – здесь можно задать схему, которая будет использоваться для вывода отчета на печать;
  • Кнопка «Открыть схему…» открывает конструктор результата обработки;
  • Окно описания форм, реквизитов и макетов.

По кнопке «Действия» можно открыть модуль создаваемого объекта.

Схема компоновки

Использование СКД для создания отчета значительно упрощает работу разработчика:

  1. Не надо продумывать и создавать форму объекта;
  2. Отборы, группировки, колонки выводимой формы можно динамически менять в пользовательском режиме;
  3. Есть возможность создания и хранения нескольких вариантов формирования итоговой таблицы.

Именно поэтому в современных решениях схема компоновки данных пользуется все большей популярностью. Если нажать соответствующую кнопку, перед разработчиком открывается конструктор СКД. (Рис. 5)

Рис.
5

Хранится схема в макетах объекта.

Кроме внутренних и встроенных отчетов, существует еще одна возможность хранения и обращения к этим объектам – справочник «Дополнительные обработки».

Регистрация внешних объектов в базе данных

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

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

Для этого в модуле обработчика должна быть определена экспортная функция СведенияОВнешнейОбработке. (Рис. 6)

Рис. 6

На Рис.6 приведен приблизительный набор команд, который позволит зарегистрировать файл в справочнике.

Кроме функцию со сведениями здесь представлены: еще одна процедура (ДобавитьКоманду) и функция (ПолучитьТаблицуКоманд). Их содержание показано на Рис. 7

Рис. 7

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

Пример получившегося отчета можно скачать по .

Используя меню Файл->Новый, добавим новый внешний отчет, дадим ему имя и сохраним на диск. Создадим схему компоновки используя кнопку Открыть схему компоновки данных.

Написание запроса 1С для СКД

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

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

|ВЫБРАТЬ | РеализацияТоваровУслугТовары.Ссылка, | РеализацияТоваровУслугТовары.Ссылка.Организация, | РеализацияТоваровУслугТовары.Ссылка.Контрагент, | РеализацияТоваровУслугТовары.Номенклатура, | РеализацияТоваровУслугТовары.Сумма, | РеализацияТоваровУслугТовары.СтавкаНДС, | РеализацияТоваровУслугТовары.СуммаНДС, | РеализацияТоваровУслугТовары.Цена |ИЗ | Документ.РеализацияТоваровУслуг.Товары | КАК РеализацияТоваровУслугТовары |ГДЕ | РеализацияТоваровУслугТовары.Ссылка.Дата | МЕЖДУ &НачалоПериода И &КонецПериода | И РеализацияТоваровУслугТовары.Ссылка.Организация | = &Организация

Настройка полей набора данных

После написания запроса, СКД автоматически заполнит таблицу с настройками полей.

Вкратце расскажу про некоторые настройки:


Настройка ресурсов

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

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

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

  1. Столбцы Имя, Заголовок и Тип заполняются автоматически и менять их значения не следует без необходимости;
  2. Доступен список значений. Если хотите передать в параметр список, нужно установить этот флаг, иначе туда попадет только первый элемент списка.
  3. Значение. Здесь можно указать значение по умолчанию для параметра. В нашем примере выберем для параметра Организации значение Элементы(пустая ссылка на справочник Организации).
  4. Включать в доступные поля. Если снять этот флаг, параметра не будет видно в настройках: в выбранных полях, отборе.
  5. Ограничение доступности. Флаг отвечает за возможность установки значения параметра в настройке СКД.

Настройка структуры отчета

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

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

Добавим отборы по Контрагенту и Номенклатуре для удобства использования отчета. Флаги использования отбора снимем, пользователь поставит их, когда потребуется.

На этом настройка отчета закончена, теперь можно запускать его в режиме предприятия.

Формирование отчета

Для отчета на СКД в 1С не обязательно создавать форму, система компоновки сама сгенерирует ее. Открываем отчет в режиме 1С Предприятие 8.

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

Смотрите также видео по созданию отчетов на СКД:

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

Вот главная страница отчета:

Вызывается данная страничка из конфигуратора в меню Файл – Новый – Внешний отчет.

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

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

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

На закладке Ресурсы выбираем сами ресурсы и настраиваем вывод итогов для них:

Закладка Параметры содержит все, от чего меняется содержимое отчета (например, период, за который будут выбираться данные). Заполняется автоматически на основании параметров запроса (см. первую страничку). Галочками можно регулировать видимость, доступность этих параметров, задавать первоначальное значение и т.д:

Получите 267 видеоуроков по 1С бесплатно:

И, наконец, Настройки. Тут рисуется внешний вид отчета – колонки, строки, их положение относительно друг друга, группировки и т.д. Кнопочка «Открыть конструктор настроек» поможет выстроить строчки и колонки в нужном порядке. Кнопочка «Пользовательские настройки элемента» позволит вывести параметры в шапку отчета:

Обратите внимание на колонку Период.ЧастиДат.НазваниеМесяца. Как же вывести название месяца в заголовок колонки? Вот тут и выводится.

Кстати, именно такая настройка позволяет выводить данные сразу за несколько периодов в соседних колонках отчета:

Еще одна важная закладка – Выбранные поля. Если она будет пустой, отчет не сформируется. Обычно заполняется автоматом по кнопке «Открыть конструктор настроек»:

Собственно, вот все, что нужно из минимально необходимого. В результате будем иметь отчет следующего вида:

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

Отчеты и обработки: различия

При этом от других подобных объектов – обработок, их отличает:

  1. Возможность использования СКД (системы компановки данных);
  2. С помощью обработки можно вводить информацию, отчет служит для вывода и организации данных;
  3. Разница в формате файлов: расширение epf говорит о том, что мы имеем дело с обработкой, erf характерно для внешних отчетов.

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

Способы добавления отчета в базу

С помощью специального справочника

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

  1. Для Полного и Административного интерфейсов, перейдя по адресу: Операции->Справочники->Внешние обработки;
  2. Все остальные через: Сервис->Дополнительные отчеты и обработки.
  3. Дальше надо выбрать вид формы, которую необходимо получить.

Итак, как добавить компановку в справочник через форму, вид которой представлен на рис.1

Рис.1 Форма регистрации отчета или обработки

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

  1. Печатная форма, вызываемая по кнопке Печать или другой кнопке в тех объектах, которые указаны в табличной части «Принадлежность печатной формы»;
  2. Заполнение табличных частей, для табличных частей документов и справочников, представленных в Табличной части «Принадлежность обработки по заполнению табличных частей»;
  3. Обработка;
  4. Отчет.

Рис. 2 Поле выбора вида отчета

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

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

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

Добавление в конфигурацию

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

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

Если конфигурация закрыта для редактирования, необходимо зайти в пункт меню Конфигурация->Поддержка->Настройка поддержки. Откроется окно, как на Рис.4

Рис. 4 Окно редактирования поддержки

  1. Нажать кнопку «Включить возможность изменения»;
  2. Положительно ответить на вопрос системы.

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

Теперь кликнув правой кнопкой мышки по строке «Отчеты» дерева конфигурации можно добавить внешний компановщик данных в конфигурацию Рис.5.

Рис. 5 Подменю добавления отчета в конфигурацию

Особенности размещения обработки на управляемых формах

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

Перед тем, как в 1С добавить отчет в управляемую форму, необходимо убедиться, что он создан с использованием СКД, в противном случае форма будет отражаться некорректно.

Открыв программу в режиме Администрирования, необходимо в Панели навигации найти пункт «Печатные формы, отчеты и обработки»

Рис. 6 Панель навигации 1С 8.3

Установив в открывшемся окне флажок «Дополнительные отчеты и обработки», вы получите возможность добавлять в базу ваши разработки для управляемой формы.

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

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

  1. Объект, к которому будет подключаться обработчик;
  2. Имя, с которым он будет зарегистрирован в базе;
  3. Наименование команды.

После этого можно приступать к размещению отчета в интерфейсе. Для этого надо щелкнуть по команде «Размещение».

Рис. 7 Размещение

При этом активность элемента регулируется выбором соответствующего значения в поле «Публикация».

Добавление без размещения

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

Регламентированные отчеты

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

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

Открыть их можно из меню Отчеты->Регламентированные отчеты. После выбора варианта отчета, программа проведет его заполнение данными из базы. Если данных будет не хватать, программа предложит довнести недостающие данные вручную.

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