Программирование 1С 8.х для начинающих
Конфигурация
ИмяПараметровПечати, КлючПараметровПечати
Если Вы сталкивались с данным свойством Табличного документа, то думаю заметили, что не совсем очевидно как оно устанавливается и где хранится. В этой статье я расскажу об этом.
В этой статье я буду использовать свойство ИмяПараметровПечати как более привычное, но все что здесь написано справедливо и для КлючПараметровПечати.
Как происходит сохранение параметров печати?
Рассмотрим простой отрывок кода (листинг):
В нём мы создали табличный документ и установили свойство «ПолеСверху» равное 5. Далее мы указали для свойства «ИмяПараметровПечати» значение «ПАРАМЕТРЫ_ПЕЧАТИ_Реализация_Печать», эта текстовая строка является ключом в хранилище настроек(об этом позже). Выполняя этот код программа посмотрит существует ли для этого табличного документа и этого пользователя настройка печати, если нет то запишет, а если есть, то параметры будут взяты уже из сохраненной.
Как изменить параметры печати?
Параметры печати можно изменить только в пользовательском режиме открыв окно «Параметры страницы»
Здесь Вы видите параметры которые сохраняются для печати здесь же их можно изменить, после изменения нужно нажать «ОК».
Программно изменить уже существующую настройку нельзя, т.к. она хранится в виде объекта с которым 1С не умеет работать «НеизвестныйОбъект». Чтобы установить свои параметры нужно удалить существующую настройку и тогда при печати запишутся те параметры которые Вы указали выше установки свойства «ИмяПараметровПечати». В моем примере сохранится только отступ сверху 5 мм. При этом остальные параметры могут оказаться не пустыми, а заполненными по умолчанию.
Как удалить параметры печати?
Настройка сохраняется в системном Хранилище настроек и чтобы её удалить нужно, вызвать метод «Удалить» указав «Ключ объекта» и «Имя пользователя». Если пользователя не указать, то эта настройка удалиться для всех пользователей. При указании Ключа объекта есть особенность это не просто строка которую Вы указали при создании табличного документа, а дополненная в начале следующим:
В моем случае чтобы удалить настройку нужно написать следующее:
Печать документов в 1С 8.3
Функция печать документов в программах «1С Предприятие» имеет свои особенности настроек, при выводе на печать готового файла.
Настройка печатного документа
В разделе «Подписи» указываются данные руководителя, кассира и главного бухгалтера. При изменении ответственных лиц в организации всю информацию действий можно проследить перейдя в раздел «История». Например, при необходимости вывода одного документа на печать под разными датами и за подписями разных ответственных лиц.
Для автоматического заполнения данных ответственных лиц за подготовку отчетов, следует ввести все необходимые параметры в разделе «Ответственные лица за подготовку отчетов».
На рисунке №4 представлен пример автоматического заполнения документа.
Необходимо знать, при формировании печатной формы существуют специальные закладки для внесения данных. На рисунке №5 представлен пример: при открытии вкладки «Инвентаризационная комиссия» требуется внести информацию о членах комиссии.
В печатной форме, при не заполнении данных, поля остаются пустыми.
Печать табличного документа 1С. Параметры печати
Для избежания ситуации, при которой на печати таблица делит документ на несколько листов, следует воспользоваться кнопкой «Предварительный просмотр документа». При ее нажатии, появляется окно с итоговым расположением таблицы на бумаге. Пример на рисунке №6. Внизу окна указывается количество страниц документа.
Если документ выходит за рамки листа, разбивает колонки таблицы и занимает несколько страниц, то следует воспользоваться разделом «Параметры страницы». Перейдя в данный раздел, появляется возможность настроить необходимые параметры, для правильного расположения таблиц и остальных частей документа на бумаге.
В разделы «Предварительный просмотр» и «Параметры страницы» можно перейти через главное меню «Файл», находясь в печатной форме документа. Пример рисунок №10.
На рисунке №12 представлен вариант, при котором на печать выводятся страницы с 3 по 5, и дополнительно 10.
Ошибки печати
При отправке документа на печать, программа может выдавать ошибку или не печатать вовсе. Какие возможны причины неисправности?
Изменение принтера пользователя после переустановки. Система автоматически выбирает для печати принтер, на который ранее уже производилась печать. Для исправления этой ошибки можно попробовать выбрать другой принтер перед печатью документа, но такой вариант не всегда эффективен. В случае, когда первый вариант не подходит, следует сбросить настройки, выбрав в «Меню» следующий путь: «Администрирование», «Настройки пользователей и прав», «Настройки пользователей», «Прочие настройки», «Настройки печати табличных документов», «Очистить». (пример рисунки №13,№14 и №15)
Выполнив все вышеперечисленные действия, необходимо выбрать требуемый принтер в «Параметры страницы».
Еще один вариант ошибки — сохранение документа в формате PDF, а не вывод на печать, при работе в браузере. Такая ошибка может возникнуть при отсутствии подключения принтера. Для исправления проблемы, требуется изменить настройки в браузере перейдя в раздел «Печать» или «Предварительный просмотр», далее в «Изменить» и указать нужный принтер. Пример на рисунке №16.
Иногда ошибки в работе приложения «1С Предприятие» с принтерами могут возникать из-за сбоя в коде самой программы, в данном случае исправлением занимаются сами разработчики. Чаще всего ошибки при печати в приложении возникают при неправильном заполнении настроек.
1С 8.x : Табличный документ: Колонтитулы и параметры страницы
Большинство обучающих материалов по программированию в системе 1С при описании формирования печатных форм на основе объекта «Табличный документ» ограничиваются выводом готовой формы на экран. Для пользователей же куда более важным является то, как документ будет выглядеть в распечатанном виде. Здесь, кроме хорошо сверстанного макета, играют роль и установки параметров печати.Почти все параметры, доступные в диалогах настройки печати (настройки принтера, свойства страницы), можно указать непосредственно при формировании табличного документа.Рассмотрим свойства и методы табличного документа, относящиеся к настройкам печати (в приведенных примерах «ТабДок» это объект типа «Табличный документ»).
Свойство «ИмяПринтера» позволяет задать для печати принтер, отличный от установленного по умолчанию. Имя должно совпадать с именем принтера, заданным в системе:
ТабДок.ИмяПринтера=»HP LaserJet 3050 Series PCL 6″;
При печати пакета документов можно сэкономить время, установив признак разбора по копиям:
Число копий можно указать так:
Разумеется, можно задать поля:
ТабДок.ПолеСлева=20;//Поле слева 20мм, остальные поля 10мм (по умолчанию)
Еще несколько свойств страницы:
ТабДок.ОриентацияСтраницы=ОриентацияСтраницы.Ландшафт; ТабДок.ЭкземпляровНаСтранице=2; //на листе будет размещено 2 страницы ТабДок.Автомасштаб=истина; //аналогично настройкам масштаба «по ширине страницы»
При необходимости можно указать конкретное значение масштабирования в процентах (свойство «МасштабПечати»).
Свойство «РазмерСтраницы» позволяет задать стандартные форматы страницы – “A3”, “A4”, “A5” (полный список вариантов доступен в справке 1С).
ТабДок.РазмерСтраницы=»A3″;// буква А должна быть английской
Для нестандартного размера бумаги (Custom) можно указать значения высоты и ширины страницы (в мм):
ТабДок.РазмерСтраницы=»Custom»;//нестандартный размер ТабДок.ВысотаСтраницы=350; ТабДок.ШиринаСтраницы=350;
Также в табличном документе доступно управление выводом колонтитулов и их содержимым. Для этого служат свойства «ВерхнийКолонтитул» и «НижнийКолонтитул». Например:
ТабДок.ВерхнийКолонтитул.Выводить=истина; //будет напечатан верхний колонтитул ТабДок.РазмерКолонтитулаСверху=7; //размер колонтитула 7мм (по умолчанию 10мм) ТабДок.ВерхнийКолонтитул.ВертикальноеПоложение=ВертикальноеПоложение.Верх; ТабДок.ВерхнийКолонтитул.НачальнаяСтраница=2;//колонтитул выводится со второй страницы ШрифтКолонтитула=Новый Шрифт(«Courier New», 8,,Истина); ТабДок.ВерхнийКолонтитул.Шрифт=ШрифтКолонтитула; //наклонный шрифт ТабДок.ВерхнийКолонтитул.ТекстВЦентре=»Верхний колонтитул»; ТабДок.ВерхнийКолонтитул.ТекстСправа=»Стр.[&НомерСтраницы] из [&СтраницВсего]»; //нумерация страниц ТабДок.ВерхнийКолонтитул.ТекстСлева=»[&Дата]»;//текущая дата
Сформированный документ отправляется на печать с помощью метода «Напечатать()». Возможно два варианта вызова.
1) Непосредственно на принтер:ТабДок.Напечатать(РежимИспользованияДиалогаПечати.НеИспользовать); ТабДок.Напечатать(истина);
2) Перед печатью будет выведен диалог печати:ТабДок.Напечатать(РежимИспользованияДиалогаПечати.Использовать); ТабДок.Напечатать(ложь);
Кроме того можно управлять и разбиением документа на страницы. Оценить количество страниц в документе по настройкам текущего принтера можно так:
С помощью методов «ПроверитьВывод()» и «ПроверитьПрисоединение()» можно определить, умещается ли табличный документ или массив областей табличного документа на странице в высоту и в ширину при текущих настройках принтера.Надо иметь ввиду, что работа последних трех методов зависит от установленного принтера. Если методу не удается его найти, вызывается исключение.
Принудительно вставить разрывы страниц позволяют методы «ВывестиВертикальныйРазделительСтраниц()» и «ВывестиГоризонтальныйРазделительСтраниц()».Таким образом, можно управлять постраничным выводом на печать и контролировать заполнение страницы:
Если Не ТабДок.ПроверитьВывод(МассивВыводимыхОбластей) Тогда ТабДок.ВывестиГоризонтальныйРазделительСтраниц();КонецЕсли;
Настройка табличного документа для вывода на печать в 1С
основном все информационные материалы по программированию в 1С при описании создания печатных форм на основе «Табличный документ» ограничиваются простым выводом готовой формы документа на экран. Но этого не всегда достаточно, и на много важнее то, как этот документ будет выглядеть в распечатанной форме на листе бумаги.
Далее будем рассматривать свойства и методы табличного документа, которые непосредственно относятся к настройкам печати. Тут помимо хорошо составленного макета, немаловажную роль играют и сами настройки печати, которые мы меняем в диалоговых окнах. К ним относятся настройки принтера и свойства страницы. Почти все из них можно определить заранее при формировании табличного документа.
Ниже рассмотрим более подробно свойства и методы табличного документа, которые имеют отношение к настройкам печати (В приведенном примере «ТабличныйДок» это объект типа «Табличный документ»)
Для того что бы задать принтер для печати, отличный от того, что по умолчанию установлен в системе, используется такое свойство как «ИмяПринтера», причем имя должно полностью совпадать с принтером который установлен в системе:
Можно сэкономить немало времени при печати пакета документов, прописав признак разбора по копиям:
Число копий указывается так:
Также возможно задать поля:
Вот еще несколько свойств страницы, которые нам доступны:
Если необходимо, то используя описание «МасштабПечати» можно указать конкретное значение для масштабирования, измеряемое в процентах.
Задать стандартные форматы страницы «А3», «А4», «А5» можно при помощи свойства «РазмерСтраницы». Есть и другие доступные стандартные форматы, полный их список можно найти в справке 1С.
Помимо этого имеется возможность задать и нестандартные размеры бумаги (Custom). Для этого задаются значения высоты и ширины страницы в миллиметрах:
В дополнение к вышеуказанным свойствам, в табличном документе присутствует возможность управлять выводом на печать колонтитулов и указывать их содержимое. Для этого используются свойства «ВерхнийКолонтитул» и «НижнийКолонтитул»:
Отправить на печать уже сформированный документ можно использовав метод «Напечатать()». При этом есть два варианта вызова этого метода.
1. Непосредственно на принтер
Используя такие методы, как «ПроверитьВывод()» и «ПроверитьПрисоединение()» можно заранее определить, умещается ли документ или массив документов на странице по ширине и высоте относительно текущих настроек принтера.
Стоит обратить внимание, что последние три метода ориентируются на настройки текущего установленного принтера, и если методу не удается его найти, вызывается исключение.
Это позволяет управлять постраничным выводом и контролировать заполнение страницы:
Основы формирования табличного документа на основе макета
Обычно табличный документ формируется на основе макета как из строительных блоков. Макет представляет собой шаблон для формирования печатной формы. Построение макета производится в конфигураторе в специальном табличном редакторе. Разработчик может создавать области, изменять высоту строк и ширину колонок, задавать форматирование ячеек и всего табличного документа, включать в макет рисунки, диаграммы и сводные таблицы.
Области макета предназначены для однократного или многократного вывода, например, ниже представлен макет для печати расходной накладной:
Некоторые ячейки содержат только текст, который должен быть выведен. Другие ячейки содержат имена параметров (в угловых скобках). Значения этих параметров должны указываться в программном модуле. В отличие от версии 7.7, в ячейку нельзя вписать выражение. В версии 8.0 весь программный код сосредоточен в программных модулях и при выводе секций нет связи с текущим контекстом программного модуля. Назначение параметров табличного документа должно производиться явно из программного модуля через коллекцию «Параметры» объекта «ТабличныйДокумент».
Область может состоять из нескольких расположенных подряд строк или колонок, либо быть прямоугольной областью таблицы. К области можно обратиться по имени или по координатам. Можно также обращаться к пересечению областей, используя вертикальную черту (как в версии 7.7).
Общая схема
Общая схема формирования печатной формы на основе макета:
Пример вывода табличного документа
Ниже приведен пример формирования печатной формы расходной накладной из модуля документа:
Процедура Печать(ТабДок) Экспорт
//создание нового табличного документа
ТабДок = Новый ТабличныйДокумент ;
//получение макета для печати расходной накладной
Макет = Документы.РасходнаяНакладная. ПолучитьМакет («Основной»);
//получим область «Заголовок» как новый табличный документ (!)
Область = Макет. ПолучитьОбласть («Заголовок»);
//выведем заполненную область «Заголовок» в табличный документ
ТабДок. Вывести (Область);
//выведем область «Шапка» в табличный документ
ТабДок.Вывести(Макет.ПолучитьОбласть(«Шапка»));
//получение области «Строка»
//обратите внимание, что это можно сделать до цикла по строкам
Область = Макет.ПолучитьОбласть(«Строка»);
//вывод строк документа в печатную форму
Для Каждого СтрСостава Из Состав Цикл
//заполнение параметров области из строки табличной части
Область.Параметры. Заполнить (СтрСостава);
//вывод сформированной области в табличный документ
ТабДок.Вывести(Область);
//вывод области «Подвал»
Область = Макет.ПолучитьОбласть(«Подвал»);
Область.Параметры.ИтогоКоличество = Состав.Итог(«Количество»);
Область.Параметры.ИтогоСумма = Состав.Итог(«Сумма»);
ТабДок.Вывести(Область);
//установим параметры отображения табличного документа
ТабДок.ТолькоПросмотр = Истина;
ТабДок.ОтображатьЗаголовки = Истина;
ТабДок.ОтображатьСетку = Ложь;
//покажем табличный документ на экране
ТабДок. Показать ();
Основные методы
Основные методы формирования итогового табличного документа следующие: