Программирование в 1С для всех
В этой статье вы узнаете, по какому принципу осуществляется работа со страницами в табличном документе 1С 8.3. Будет показано, как определить помещается ли область (или области) в страницу, а также как принудительно осуществить разделение страниц.
Для демонстрации принципов работы страниц в табличном документе реализуем простой учебный пример: в табличном документе выведем строки со случайными числами и их текстовое представление, количество строк с числами, которые нужно вывести будем вводить в поле на управляемой форме обработки.
Создадим макет табличного документа с горизонтальными областями.
Создадим обработчик команды формы, в котором будем вызывать функцию, где создается и заполняется строками со случайными числами и их текстовым представлением табличный документ.
Этот код комментировать не будем, если у вас он вызывает затруднения, то ознакомьтесь с моими предыдущими статьями и видео-уроками.
Сейчас, когда мы выполним команду и выведем, например, 80 строк, то у нас все будет показано на одной странице, а при попытке распечатать (или выполнить предварительный просмотр) платформа самостоятельно разобьет табличный документ на страницы.
Согласитесь, что такой вариант формирования печатной формы не лицеприятно выглядит.
Для более приятного формирования печатной формы, сделаем так, чтобы каждый раз в конце страницы выводился подвал таблицы, а в начале новой страницы (кроме первой) выводилась шапка таблицы. Для этого доработаем код в методе СформироватьТабличныйДокумент.
Используя метод табличного документа ПроверитьВывод можно проверить, войдет ли вывод области или нескольких областей на страницу табличного документа. Этот метод возвращает Истина, если область вмещается на страницу, и ложь – если нет. Параметром этого метода может быть как область, так и массив областей.
В функции мы создали массив, который состоит из области строки и из области подавала таблицы.
В каждой итерации цикла, в котором осуществляется вывод строк табличного документа, при помощи метода ПроверитьВывод выполняется проверка: вмещается ли область строки и область подвала таблицы в страницу табличного документа.
Если области не вмещаются на страницу табличного документа, то выводится подвал таблицы, потом выводится горизонтальный разделитель таблицы, который, по сути, создает новую страницу таблицы, и осуществляется вывод шапки таблицы уже на новой странице.
В результате, вывод табличного документа осуществится в более удобном виде.
Другие статьи про табличные документы в 1С:
Более подробно и основательно разработка в 1С дается в моей книге: «Программировать в 1С за 11 шагов»
Изучайте программирование в 1С в месте с моей книги «Программировать в 1С за 11 шагов»
О том как разрабатывать под управляемым приложением 1С, читайте в книге Книга «Основы разработки в 1С: Такси»
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
Промо-код на скидку в 15% — 48PVXHeYu
Эти книги, плюс книга по программированию оперативного учета имеются в едином комплекте: комплект книг по разработке в 1С.
Только для читателей моего блога,
промо-код на скидку в 300 рублей на весь комплект: blog
Если Вам понравился этот урок, был полезен или помог решить какую-нибудь проблему, то Вы можете поддержать мой проект, перечислив любую сумму.
можно оплатить вручную:
Яндекс.Деньги — 410012882996301
Web Money — R955262494655
Программирование в 1С для всех
В массе своей, в прикладных задачах нужно вывести на печать какие-либо данные оформленные нужным образом (например, счет, торговую накладную, акт сверки и т.п.). Для вывода на печать в 1С 8.3. можно использовать табличные документы. В предыдущей статье я показал, как создать макет табличного документа и как правильно его оформить. Нам осталось научиться заполнять его данными и выводить на просмотр для последующей печати. Материал по выводу табличного документа на печать, я решил разбить на две части. В первой части мы разберем простой пример (я бы назвал его учебным), а во втором случае реализуем пример приближенный к реальному. Эта статья — первая часть, в ней мы реализуем простой пример: будем выводить табличный документ на печать, используя команду управляемой формы. Этот вариант имеет следующий недостаток: нельзя вывести печатную форму из списка документов, можно это сделать, только открыв форму документа. Для того, чтобы можно было вывести печатную форму из списка документов, необходимо создать команду документа. Этот вариант мы рассмотрим в следующей статье.
И так, сам макет документа мы уже создали, как это сделано, вы можете узнать в соответствующей статье.
Сейчас мы получим ранее созданный макет, заполним табличный документ 1С по этому макету, и нам останется вывести табличный документе 1С на просмотр для последующей печати.
Мы сделаем упрощенный (учебный) вариант: формирование всего нашего табличного документа будет осуществляться на модуле управляемой формы. Для этого мы на форме документа создадим команду «ПечатьДокумента», которую разместим в командной панели формы.
Для команды ПечатьДокумента создадим два обработчика в клиентском и серверном контексте.
Серверный обработчик переименуем в функцию, в нем мы создадим программно табличный документ 1С, который она и будет возвращать.
Теперь нужно получить макет, созданный в предыдущей статье, для этого мы будем использовать метод менеджера документа ПолучитьМакет.
Имейте в виду, что метод ПолучитьМакет напрямую доступен только или в модуле документа, или в модуле менеджера документа. Еще этот метод можно применить, используя менеджер конкретного объекта, как я сделал выше. Непосредственно на форме его использовать нельзя!
Алгоритм заполнения табличного документа будет следующим: мы будем получать нужную область макета, если необходимо заполнять эту область какими-нибудь данными, а потом выводить полученную область в табличный документ.
Напомню, что макет у нас имеет четыре области: Шапка, ШапкаТаблицы, СтрокаТаблицы, Подвал. Области Шапка, ШапкаТаблицы и Подвал будут выведены в табличный документ всего один раз, а область СтрокаТаблицы будет выведена столько раз, сколько строк в табличной части обрабатываемого документа.
Весь код ниже я выполняю между кодом получения макета и возвратом табличного документа.
Получим самую первую область макета, при помощи метода ПолучитьОбласть, где в качестве параметра следует указать название получаемой области.
В этой области мы используем шаблон, в котором имеются два параметра: НомерДок и ДатаДок передадим номер документа и дату документа в соответствующие параметры области, используя свойство Параметры нужной нам области. Данное свойство содержит коллекцию параметров табличного документа, и мы можем обращаться к нужному параметру через оператор «.».
Мы закончили с областью Шапка, и нам нужно вывести её в табличный документ, делается это при помощи метода Вывести табличного документа, где в качестве параметра указывается выводимая область.
Точно также получим область, которая соответствует шапке таблицы, заполнять его не нужно, а мы просто выведем его сразу же в табличный документ.
Следующим шагом выведем область СтрокаТаблицы, причем эта область должна быть выведена столько раз, сколько строк в табличной части документа. Поэтому мы сначала получим эту область, а потом циклом будем обходить табличную часть, заполнять параметры области и выводить область в табличный документ.
В коде выше, мы обошли табличную часть документа, обратившись к ней через основной реквизит Объект управляемой формы (основной формы документа).
Обратите внимание, я использовал метод Заполнить, потому что названия параметров макета совпадают с названиями реквизитов табличной части документа.
Нам осталось получить область Подвал и вывести её в табличный документ.
На этом мы закончим работать с функцией на сервере, весь ее код будет выглядеть следующим образом.
Нам осталось доделать клиентскую процедуру ПечатьДокумента: мы будем выводить на просмотр полученный табличный документ при помощи метода табличного документа Показать().
В качестве первого параметра метода Показать, я указал название, которое выйдет на форме табличного документа.
Проверим, как работает наш код.
Напомню, что я рассмотрел самый простой (учебный) пример вывода печатной формы, следующие примеры будут более приближенные к реальным.
Более подробно и основательно разработка в 1С дается в моей книге: «Программировать в 1С за 11 шагов»
Изучайте программирование в 1С в месте с моей книги «Программировать в 1С за 11 шагов»
О том как разрабатывать под управляемым приложением 1С, читайте в книге Книга «Основы разработки в 1С: Такси»
Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.
Промо-код на скидку в 15% — 48PVXHeYu
Как в печатной форме выводить номер страницы
Как в печатной форме выводить номер страницы
Очень часто требуется вывести в табличном документе номер текущего листа, страницы, другой информации. Эту задачу можно решить двумя способами
Если требуется вывести это в самом начале или конце, то самый простой способ использовать колонтитулы.
Колонтитулы
Это автоматически отображаемый в документе текст.
Можно управлять его шрифтом или вертикальным/горизонтальным положением текста в «ячейках» (6 зон)
Для текста существует список доступных «макропеременных»:
Код для вывода колонтитула
Если необходимо вывести счетчик листов внизу/справа, код будет таким:
Важно располагать данный код после установки имени настроек печати.
Аналогично делается для верхнего колонтитула и других частей.
Области макета
Когда же требуется вывести в середине табличного документа, например в шапке таблицы, или более сложное отображение, тогда следует использовать области.
Считать листы в таком варианте придется самостоятельно.
Для вывода нам потребуется использовать функцию
Массив из проверяемых таблиц или табличный документ.
В данном случае есть риск, что не получится вывести сам колонтитул: он должен быть не большим, чтобы снизить эту вероятность, либо потребуется усложнить алгоритм, перед выводом секции проверять получится ли вывести сам колонтитул.
Восторженное отношение жены к работе мужа — лучшая реклама его деятельности.
Макеты печатных форм в 1С 8.3
Для того, чтобы распечатать сформированный документ в 1С, его необходимо преобразовать в печатную форму при помощи макета печатной формы. Такой шаблон формы для печати создается при помощи специального конструктора, который внешне схож с таблицей Excel.
Используя программу 1С в режиме управляемых форм, можно редактировать макет печатной формы и вносить изменения в печатную форму документа самостоятельно. Не изменения конфигурации программы пользователь имеет возможность менять внешний вид (линии таблиц, шрифт и т.д), вставить свой логотип и другое.
Подробнее разберем, что такое печатный макет в 1С, рассмотрим возможности изменения, просмотра и настроек, используем в качестве примера программу 1С:Бухгалтерия версии 3.0.
Как изменить макет печатной формы в 1С 8.3
В качестве примера создадим документ типа «Реализация (акт, накладная)» находящийся в меню «Продажи» и выстоим печатную форму для данной накладной.
Нам понадобилось внести изменения в печатную форму, а также в документ добавить логотип организации.
Организация вправе кроме обязательных реквизитов вносить изменения, при этом сохраняя утверждённый формат документа. Наличие логотипа не является обязательны реквизитом, однако организация может его добавить. Нажав кнопку «Печать», вы переходите в печатную форму, далее нажимает кнопку «Еще», там высвечиваются следующие пункты: «Перейти к макетам форм» и «Изменить макет».
Следующей командой выбираем «Перейти к макетам форм», там представлен весь перечень предлагаемых печатных форм, имеющихся в программе. Используя при помощи отбора пункт «стандартные макеты» (не имеют изменений) просмотр можно сделать более удобным.
Для того, чтобы документ можно было просмотреть и отредактировать необходимо нажать команду «Изменить макет». Далее на экране появится макет печатной формы, выбранный для редактирования. Видно, что большая часть полей формы имеет определенные команды, при использовании которых и происходит заполнение формы. Изменять имена областей и параметров нельзя, так как это может способствовать нарушению работы печатной формы.
Для изменения шрифта, определения линий границ таблицы, выравнивания текста и других изменений касаемо изменений внешнего вида используется панель инструментов, на работоспособность это не влияет. Работа с макетом печатной формы похожа на работу с таблицей Excel.
В случае если в печатной форме мешают линии их можно удалить, использовав кнопку «Границы» далее «Нет границы». Когда линии не мешают, они остаются без изменения, а рисунок расположится сверху.
Если требуется вставить картинку, для этого необходимо нажать кнопку «Еще» и выбрать команду «Картинки», которая находится в меню «Рисунок».
Далее в открывшимся окне необходимо нажать «Выбрать из файла» и выбираем нужный логотип.
Нужный рисунок разместился в форме. При помощи маркеров по краям рисунка, возможно увеличить или уменьшить его размер. В случае если что-то не получилось, действие можно изменить, для этого достаточно использовать комбинации Ctrl+Y – вернуть действие, Ctrl+Z – отменить действие.
Вставляется логотип в рамке. Далее правой кнопкой нажимаем на вставленный логотип и выбираем меню «Свойства».
В появившимся окне можно задать параметры объекта. Нам необходимо удалить рамку, для этого мы нажимаем «Стиль линии» далее «Без линии».
Размещение рисунка между двумя горизонтальными линиями красного цвета, является обязательным, не стоит об этом забывать. В противном случае его попросту не будет видно в форме. Что бы рисунок поместился, строки формы мы раздвинули. Далее нажимаем «Записать и закрыть» и оцениваем получившийся результат.
Проверили, логотип на месте.
Так у пользователя есть возможность вносить изменения в макеты печатных форм, не меняя при это конфигурацию.
После этого, если зайти в раздел «Перейти к макетам печатных форм», нажать кнопку «Еще», то можно увидеть, что возле измененного макета появился зелёный карандаш, что говорит о том, что макет является изменённым. В случае если пользователю понадобится восстановить исходный макет, то достаточно нажать кнопку «Использовать стандартный макет».
Цвет карандаша при этом изменится на черно-белый, а при печати форма документа будет стандартной.
В том случае, если изменения нужно удалить навсегда, то следует нажать на красный крестик. Появившийся ранее карандаш исчезнет, а все изменения макета будут удалены.
В макет печатной формы рисунок вставляется автоматически.
Шаблон и параметры макета
Таким образом пользователь самостоятельно способен добавить в макет какие-то значения для документа, при помощи параметров. Для того, чтобы удобнее было сориентироваться в параметрах, лучше просмотреть другие макеты документов. Например, для того чтобы в ячейку выводилась цена, артикул или товар, нужно просто указать необходимый параметр в ячейке.
Для просмотра настроек этой ячейки, необходимо нажать на нее правой кнопкой мыши и выбрать «Свойства».
На экране появилось окно, в котором видно, что значение ячейки — это параметр. Но задать можно не только параметры и текст, также в макете для ячейки возможно задать шаблон, в свойствах должно быть указано, что это именно шаблон. При использовании шаблона можно скомбинировать параметры и текстовые значения. Для это нужно в значении ячейки товара отметить, что это шаблон, а при выборе значения шаблона в поле «Текст» при указании параметра использовать квадратные скобки.
После сохранения макета, рядом появляется карандаш, который говорит о том, что макет изменялся.
Теперь проверяем сохраненный макет, открываем и видим, что в ячейке есть написанный текст.
Текст с форматированием в макете печатной формы добавляется таким же образом. Используя шаблон нельзя в одной ячейке применить сразу несколько вариантов форматирования, это значит, что оформление будет для всей ячейки.
Рассмотрев примеры видно, что при необходимости изменить макеты возможно. В случаях, требующих создания внешней или новой печатной формы, используется уже режим «Конфигуратор», в пользовательском же режиме доступны только не большие изменения.