НастроитьОтчетВМодулеМенеджера (БСП)
Настроить отчет модуле менеджера. Вызывает модуль менеджера отчета для заполнения его настроек.
// Вызывает модуль менеджера отчета для заполнения его настроек. // Для вызова из процедуры ВариантыОтчетовПереопределяемый.НастроитьВариантыОтчетов. // // Параметры: // Настройки - Коллекция - передается "как есть" из процедуры НастроитьВариантыОтчетов. // ОтчетМетаданные - ОбъектМетаданных - метаданные отчета, в модуле менеджера которого расположена // экспортная процедура НастроитьВариантыОтчета(Настройки, НастройкиОтчета). // Процедура НастроитьОтчетВМодулеМенеджера(Настройки, ОтчетМетаданные) Экспорт НастройкиОтчета = ОписаниеОтчета(Настройки, ОтчетМетаданные); Попытка Отчеты[ОтчетМетаданные.Имя].НастроитьВариантыОтчета(Настройки, НастройкиОтчета); Исключение ТекстОшибки = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку( НСтр("ru = 'Недопустимое значение параметра КлючВарианта в процедуре ВариантыОтчетов.НастроитьОтчетВМодулеМенеджера. |Не удалось настроить варианты отчета из модуля менеджера по причине: |%1'"), ПодробноеПредставлениеОшибки(ИнформацияОбОшибке())); ЗаписатьВЖурнал(УровеньЖурналаРегистрации.Ошибка, ТекстОшибки, ОтчетМетаданные); КонецПопытки; КонецПроцедуры /////////////////////////////////////////////////////////////////////////////////////////////////////// // Copyright (c) 2019, ООО 1С-Софт // Все права защищены. Эта программа и сопроводительные материалы предоставляются // в соответствии с условиями лицензии Attribution 4.0 International (CC BY 4.0) // Текст лицензии доступен по ссылке: // https://creativecommons.org/licenses/by/4.0/legalcode ///////////////////////////////////////////////////////////////////////////////////////////////////////
// Вызывает модуль менеджера отчета для заполнения его настроек. // Для вызова из процедуры ВариантыОтчетовПереопределяемый.НастроитьВариантыОтчетов. // // Параметры: // Настройки - Коллекция - передается "как есть" из процедуры НастроитьВариантыОтчетов. // ОтчетМетаданные - ОбъектМетаданных - метаданные отчета, в модуле менеджера которого расположена // экспортная процедура НастроитьВариантыОтчета(Настройки, НастройкиОтчета). // Процедура НастроитьОтчетВМодулеМенеджера(Настройки, ОтчетМетаданные) Экспорт НастройкиОтчета = ОписаниеОтчета(Настройки, ОтчетМетаданные); Попытка Отчеты[ОтчетМетаданные.Имя].НастроитьВариантыОтчета(Настройки, НастройкиОтчета); Исключение ТекстОшибки = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку( НСтр("ru = 'Недопустимое значение параметра КлючВарианта в процедуре ВариантыОтчетов.НастроитьОтчетВМодулеМенеджера. |Не удалось настроить варианты отчета из модуля менеджера по причине: |%1'"), ПодробноеПредставлениеОшибки(ИнформацияОбОшибке())); ЗаписатьВЖурнал(УровеньЖурналаРегистрации.Ошибка, ТекстОшибки, ОтчетМетаданные); КонецПопытки; КонецПроцедуры /////////////////////////////////////////////////////////////////////////////////////////////////////// // Copyright (c) 2019, ООО 1С-Софт // Все права защищены. Эта программа и сопроводительные материалы предоставляются // в соответствии с условиями лицензии Attribution 4.0 International (CC BY 4.0) // Текст лицензии доступен по ссылке: // https://creativecommons.org/licenses/by/4.0/legalcode ///////////////////////////////////////////////////////////////////////////////////////////////////////Подключение внешних отчетов, обработок, печатных форм в 1С
Рассмотрим подключение внешних отчетов, обработок и печатных форм на примере конфигурации ЗУП 3.1.1.91.
Для подключения внешнего файла переходим в раздел Администрирование – Печатные формы, отчеты и обработки – Дополнительные отчеты и обработки (рис. 1, рис. 2):
Рис. 1. Администрирование — Печатные формы, отчеты и обработки
Рис. 2. Дополнительные отчеты и обработки
Нажимаем Создать (рис. 3):
Рис. 3. Добавление файла
Появляется сообщение Предупреждение безопасности, если файл точно нужный и безопасный, нажимаем Продолжить (рис. 4):
Рис. 4. Предупреждение безопасности
Появляется окно для выбора файла, выбираем нужный файл, в примере это будет внешний отчет пр_ОтчетПоКадровымПеремещениям, нажимаем Открыть (рис. 5):
Рис. 5. Выбор файла
После выбора файла заполняются поля формы дополнительного отчета (рис. 6):
Рис. 6. Поля формы внешнего дополнительного отчета
Т.к. Размещение , нужно определить, в каких разделах будет видна команда вызова отчета. Нажимаем ссылку (рис. 6) и указываем раздел Кадры, нажимаем ОК (рис. 7):
Рис. 7. Выбор раздела
Указываем пользователей, которым будет доступен отчет: переходим в табличную часть формы в поле Быстрый доступ (рис. 8):
Рис. 8. Настройка быстрого доступа
Выбираем пользователя, нажимаем >, выбранный пользователь окажется в разделе Пользователи, для которых видна команда и нажимаем ОК (рис. 9):
Рис. 9. Выбор пользователя
Теперь можно записать и закрыть форму внешнего отчета (рис. 10):
Рис. 10. Сохранение внешнего отчета
Переходим в раздел Кадры – Сервис – Дополнительные отчеты, в котором должна появиться команда вызова внешнего отчета (рис. 11):
Рис. 11. Кадры – Сервис – Дополнительные отчеты
Открывается форма Дополнительные отчеты, выбираем нужный отчет (название отчета задается при регистрации внешнего отчета, рис. 6 в табличной части формы колонка Наименование) и нажимаем Выполнить (рис. 12):
Рис. 12. Запуск отчета
Если в разделе Кадры отсутствует команда Сервис – Дополнительные отчеты, нужно ее вывести. Нажимаем значок Настройки (рис. 13):
Рис. 13. Настройка команд раздела
Выбираем пункт Настройка действий (рис. 14):
Рис. 14. Настройка действий
В открывшемся окне Настройка панели действий в разделе Доступные команды выбираем Сервис – Дополнительные отчеты, нажимаем Добавить (после этого команда появится в разделе Выбранные команды), нажимаем ОК (рис. 15):
Рис. 15. Добавление команды Дополнительные отчеты
После этого в разделе Кадры появится пункт Сервис – Дополнительные отчеты (рис. 16):
Рис. 16. Кадры – Сервис – Дополнительные отчеты
Добавление внешней обработки аналогично добавлению внешнего отчета, только искать нужную внешнюю обработку нужно в разделе Сервис – Дополнительные обработки (внешние отчеты можно найти в разделе Сервис – Дополнительные отчеты, рис. 11).
Добавление внешней печатной формы аналогично добавлению внешнего отчета. В поле Размещение (рис. 10) будет указан объект, к которому относится печатная форма. Нужно открыть этот объект и у него при нажатии на кнопку Печать появится пункт с наименованием добавленной внешней печатной формы (наименование задается при регистрации внешней печатной формы, рис. 6 в табличной части формы колонка Наименование).
Если при регистрации файла происходит ошибка:
Для того, чтобы при регистрации внешнего отчета/обработки верно заполнились все поля формы внешнего отчета/обработки и регистрация прошла успешно, нужно в модуле объекта прописать определенные процедуры. Пример модуля объекта для файла внешнего отчета:
Функция СведенияОВнешнейОбработке() Экспорт ПараметрыРегистрации = Новый Структура; МассивНазначений = Новый Массив; МассивНазначений.Добавить(""); ПараметрыРегистрации.Вставить("Вид", "ДополнительныйОтчет"); ПараметрыРегистрации.Вставить("Назначение", МассивНазначений); ПараметрыРегистрации.Вставить("Наименование", "Отчет по кадровым перемещениям"); ПараметрыРегистрации.Вставить("Версия", "1.0"); ПараметрыРегистрации.Вставить("БезопасныйРежим", Истина); ПараметрыРегистрации.Вставить("Информация", "Дополнительный отчет"); ТаблицаКоманд = ПолучитьТаблицуКоманд(); ДобавитьКоманду(ТаблицаКоманд, "Отчет по кадровым перемещениям", "_ОтчетПоКадровымПеремещениям", "ОткрытиеФормы", Истина); ПараметрыРегистрации.Вставить("Команды", ТаблицаКоманд); Возврат ПараметрыРегистрации; КонецФункции Функция ПолучитьТаблицуКоманд() Команды = Новый ТаблицаЗначений; Команды.Колонки.Добавить("Представление", Новый ОписаниеТипов("Строка")); Команды.Колонки.Добавить("Идентификатор", Новый ОписаниеТипов("Строка")); Команды.Колонки.Добавить("Использование", Новый ОписаниеТипов("Строка")); Команды.Колонки.Добавить("ПоказыватьОповещение", Новый ОписаниеТипов("Булево")); Команды.Колонки.Добавить("Модификатор", Новый ОписаниеТипов("Строка")); Возврат Команды; КонецФункции Процедура ДобавитьКоманду(ТаблицаКоманд, Представление, Идентификатор, Использование, ПоказыватьОповещение = Ложь, Модификатор = "") НоваяКоманда = ТаблицаКоманд.Добавить(); НоваяКоманда.Представление = Представление; НоваяКоманда.Идентификатор = Идентификатор; НоваяКоманда.Использование = Использование; НоваяКоманда.ПоказыватьОповещение = ПоказыватьОповещение; НоваяКоманда.Модификатор = Модификатор; КонецПроцедуры
1с как открыть модуль менеджера внешнего отчета
Понятно что вопрос глупый — не может его там быть по определению. Но! Есть отчет, в нем модуль менеджера. Я его выгружаю во внешний отчет.
там нет модуля менеджера! Т.е. часть кода пропало.
Что мне его руками переносить? Тогда в чем смысл этой выгрузки во внешний отчет? если руками допереносить?
А в чем сложность скопипестить?
*скопипастить:-)
(0) модуль менеджера в файл отчетов и обработок не выгружается. Это ты у 1С спроси, почему так — модуль менеджера в конфигурации есть, а во внешнем файле нет.
это сейчас ты спрашиваешь у нас, какой смысл в том, что ты делаешь?
нах они его вообще ввели, методы надо было располагать в модуле объекта с пометкой static
(5)+10000000000
(4) например, в БП 3.0, вся печать в отчетах реализована в менеджере модуля отчета. Соответственно, если переделывать что-то во внешний отчет на основе типового, то не получится
(5)типа подобие нормально ориентированного.
(7)вот и я о том же! Либо выгружается все, либо не выгружается.
А то смотришь — блин — коды переносить!
(7) если на основе типового, достаточно перед вызовом добавить отчеты.отчет.
(0) А КУДА ты его переносить собрался, если не секрет?
(6) не получится — все равно, надо будет поднимать конкретный объект, а через модуль менеджера вызывается именно static метод
(12)ну что не ясно. Есть типовой отчет. надо переделать. Не хочу конфу корячить — выгружаю во внешний
может это реализовано для того, чтобы не обновлялись внешние отчеты, реализованные на типовых?
(11) не. я же хочу, например, чтобы отчет делал почти то же, что и типовой, но с моими наворотами, и без изменения конфигурации, т.е. вызывается из внешнего файла (или сохраненного в доп. отчетах и обработках)
(3) Ну логично же, ведь внешний отчет не является объектом конфигурации, соответственно у него нет менеджера, нет менеджера, значит нет модуля.
(17)это логично. Но почему при выгрузке не переносить модуль менеджера в модуль объекта
(17) Да, но тогда не стоило затевать модуль менеджера у встроенных отчетов.
Качественная подстава от 1С 🙂
(18) возможно дублирование имени процедуры/функции
при создании внешнего отчета не нужно копировать подпрограммы из модуля менеджера в модуль объекта, достаточно прописать путь к функции/процедуре, если необходимо ее изменить, копируй в модуль объекта
Если процедуры и функции модуля менеджера отчета вызываются как «Отчет.ВедомостьПоПартиям.ОпределитьВыводДокумента()», то простите как вы хотите этот метод вызвать из внешнего отчета?
(22) Отчет.ВедомостьПоПартиям.ОпределитьВыводДокумента()
*Отчеты.ВедомостьПоПартиям.ОпределитьВыводДокумента()
(22) если (14), то почему бы не обратиться к типовому отчету.
(25) Я про это и говорю
(23) (24) Не ясен ход твоих мыслей. По сути ты обращаешься к отчету конфигурации, значит во внешнем отчете модуль менеджера не нужен
(25), (27) — к какому ВедомостьПоПартиям? нужно же МояВедомостьПоПартиям.ОпределитьВыводДокумента()
(29) статические методы ничего не знают об объекте, работают с параметрами
т.е. отчеты.ведомость(мояВедомость)
(31) это как понимать?
(32) это скорее качательно документов, справочников, а не отчетов, но суть та же)
*касательно
(29) (31) А где он увидит твою ведомость, если она лежит в файле неизвестно где (для 1С) на диске.
(34) хм, в чем суть ? (31) не знает такого параметра (мы же договорились, что конфигурация не меняется)
Именно потому, что объект конфигурации имеет алиас (по вашемски это имя класса), имеется доступ по вашенски к статическим методам, а по 1С — к процедурам и функциям модуля менеджера. Когда ты генеришь внешний отчет, ты его генеришь путем ВнешннийОтчет.Создать() и после этого используешь уже процедуры и функции объекта, менеджер тут не к чему.
В основном менеджер используется для вызова каких либо обрабочиков вне контекста этого отчета. Так же удобен в серверных процедурах управляемых форм.
(38) ничего не мешало добавить метод/свойство доступа к менеджеру или статическим методам
(38) так это понятно. Только нафига для отчетов и обработок менеджер ? Физически в базе нет объекта МойОтчет, в отличие от документа (найдешь ссылку ?), т.е. в принципе, «менеджер тут не к чему».
Код Икс Пи ☆ Центр автоматизации, сопровождения и поддержки
В платформе 1С 8.3 существует достаточно большое количество видов модулей, каждый из которых имеет свое предназначение и особенности.
Любая строка кода находится в каком-либо модуле. Различают модули общего предназначения и модули объекта. Некоторые модули могут быть скомпилированы как на Клиенте, так и на Сервере, а некоторые только на Сервере.
Модуль может состоять из 3х разделов, но 1й и 3й необязателен, а в некоторых видах модулей не разрешен. Рассмотрим эти три раздела модуля:
-
В разделе объявления переменных описываются переменные данного модуля, которые впоследствии могут быть использованы в любой процедуре этого модуля.
Внутри каждой процедуры можно обращаться к переменной модуля. Кроме того, внутри самой процедуры может быть еще одно объявление переменной с таким же именем. Это будет локальная переменная данной процедуры. Несмотря на одинаковое название, это две разные переменные: одна используется внутри конкретной процедуры, а другая вне ее. При объявлении переменной с таким же именем внутри процедуры, локальная переменная имеет наивысший приоритет и перекрывает переменную объявленную для всего модуля.
В некоторых модулях для переменных может указываться место компиляции (доступность) НаСервере или НаКлиенте. Например:
За разделом описания переменных следует раздел процедур и функций, где указываются локальные методы данного модуля. В некоторых модулях следует указывать, где будет скомпилирована процедура или функция (на клиенте или сервере).
Модуль приложения
Как открыть — нажать правой кнопкой мыши на корень конфигурации — модуль управляемого приложения. Модуль Управляемого приложения также можно открыть из палитры свойств корневого элемента конфигурации.
Данный модуль предназначен для того, чтобы обработать события запуска приложения и завершения его работы. Например, при запуске приложения можно делать проверки, обновление каких-то данных в таблицах базы данных или открывать на экране новостной блок. При завершении приложения можно удостовериться у пользователя о его намерениях закончить работу.
Также в модуле приложения существуют специальные обработчики, которые позволяют перехватить внешние события от оборудования.Это могут быть события от ридера магнитных карт, фискального регистратора. И эти события можно каким-то образом тоже обработать.
Следует обратить внимание, что в модуле приложения отслеживается именно интерактивный запуск системы.
Модуль приложения не будет работать, если запуск программы 1С осуществляется, например, в режиме com-соединения. В этом случае окно программы не создается.
Следует отметить, что в Платформе 8.3 существует два разных модуля приложения: модуль Управляемого приложения и модуль Обычного приложения. События модуля управляемого приложения отрабатываются при запуске Тонкого и Толстого клиента Управляемого приложения и Веб-клиента.
Модуль Обычного приложения работает при запуске Толстого клиента в режиме Обычного приложения, в котором присутствует обычный командный интерфейс в виде Главного меню.
Если приложение работает и в режиме Управляемого, и в режиме Обычного приложения, то необходимо описывать процедуры-обработчики как для модуля Управляемого приложения, так и для модуля Обычного приложения.
Чтобы открыть модуль Обычного приложения, следует обратиться к настройкам конфигурации (команда Параметры в меню Сервис).
Откроется форма Параметры. На закладке Общие должен быть указан режим редактирования конфигурации Управляемое приложение и Обычное приложение.
В этом случае модуль Обычного приложения также можно будет открыть из свойств корневого узла.
Список событий, которые можно обрабатывать, для Управляемого и Обычного приложения одинаков.
В данном модуле можно размещать раздел объявления переменных, раздел описания произвольных процедур и функций и раздел основной программы. Но кроме произвольных процедур и функций в модуле могут быть расположены специальные обработчики событий.
Список доступных обработчиков можно посмотреть, если при открытом модуле вызвать список процедур и функций текущего модуля.
В раскрывшемся окне Процедуры и функции отображаются все процедуры и функции данного модуля, а также события, для которых обработчики еще не созданы.
Есть два события, связанные с началом работы системы (“перед” и “при”). Два события, связанные с завершением работы системы (“перед” и “при”). А также обработка внешнего события (например, события торгового оборудования).
Когда выполняется обработчик события “перед”, считается, что действие еще не совершено. Когда выполняется обработчик события “при” – действие уже совершено.
Событие ПередНачаломРаботыСистемы возникает в тот момент, когда производится запуск Предприятия 8.3, но само приложение еще не появилось на экране. У данного события есть такой параметр, как Отказ.
Если этот параметр примет значение Истина, то приложение не запустится. Событие ПриНачалеРаботыСистемы предполагает, что действие уже совершено, окно уже создано, и в этом случае мы можем, например, отобразить какую-то специальную форму. От запуска отказаться уже нельзя.
Аналогично перед завершением работы системы приложение еще открыто и можно отказаться от его завершения. При завершении работы системы окно приложения уже закрылось. Возможно выполнить лишь дополнительные действия, например, по удалению каких-то файлов или отправке электронного письма.
В модуле Управляемого приложения не указываются директивы компиляции процедур и функций, так как модуль целиком компилируется на стороне Клиента. Это означает, что в процедурах и функциях модуля мы не сможем непосредственно обратиться, например, к справочникам.
Если из модуля Управляемого приложения необходимо сделать Серверный вызов, то для этого нужно будет создавать специальные Общие модули с выставленным флагом Вызов Сервера.
В модуле Обычного приложения подобных ограничений нет, так как данный модуль будет компилироваться при загрузке Толстого клиента. В Толстом клиенте доступны практически все типы данных.
Процедуры, функции и переменные модуля приложения могут быть описаны как экспортные.
Поскольку модуль скомпилирован целиком на Клиенте, это означает, что в клиентских процедурах мы можем обращаться к данному методу и данному свойству.
Например, из модуля формы какого-либо объекта можно вызвать процедуру или функцию модуля приложения. Однако для описания общих алгоритмов рекомендуется использовать Общие модули. Основное предназначение модуля приложения – обработать точку старта и точку завершения.
Модуль внешнего соединения
Как открыть — нажать правой кнопкой мыши на корень конфигурации — модуль внешнего соединения. Модуль Внешнего соединения также можно открыть из палитры свойств корневого элемента конфигурации.
По аналогии с модулем приложения данный модуль предназначен для того, чтобы обработать событие открытия программы и событие завершения работы.
В отличии от модуля приложения, который инициируется в момент интерактивного запуска приложения, модуль внешнего соединения работает в режиме com-соединения, т.е. когда создается объект 1С:Предприятие 8 и осуществляется подключение к определенной базе.
В этом модуле есть события: ПриНачалеРаботыСистемы и ПриЗавершенииРаботыСистемы.
Сам процесс внешнего соединения – это процесс программной работы с информационной базой, а не интерактивный. Соответственно, в этот момент нельзя использовать диалоговых форм, выводить предупреждающие сообщения, так как нет пользовательского интерфейса.
В Модуле внешнего соединения возможно описывать экспортные переменные и экспортные методы, которые будут доступны на той стороне, где происходит внешний вызов 1С:Предприятие 8.3.
Поскольку во внешнем соединении нет пользовательского интерфейса, Модуль внешнего соединения компилируется целиком на Сервере.
Модуль сеанса
Как открыть — нажать правой кнопкой мыши на корень конфигурации — модуль сеанса. Модуль Сеанса также можно открыть из палитры свойств корневого элемента конфигурации.
Данный модуль нужен для того, чтобы инициализировать параметры сеанса. Параметры сеанса – это быстрые глобальные переменные, значения которых доступны в любом месте конфигурации.
В Модуле сеанса предусмотрено событие УстановкаПараметровСеанса.
При старте приложения данная процедура вызывается самой первой. Параметры сеанса нужны при любой работе приложения: как при интерактивном запуске, так и при запуске в режиме внешнего соединения.
В Модуле сеанса описываются различные действия по инициализации параметров сеанса в зависимости от разных условий.
В данном модуле, как правило, описываются несколько процедур, которые вызываются из процедуры УстановкаПараметровСеанса. Поэтому все эти процедуры выделены в отдельный модуль.
Модуль сеанса всегда исполняется в привилегированном режиме. Это означает, что не будет выполняться проверка прав доступа при обращении к базе данных. Модуль сеанса компилируется на Сервере, т.е. возможно обращение к любым серверным методам (в том числе и чтение значений из базы).
В Модуле сеанса возможно определять только процедуры и функции, т.е. нет раздела описания переменных и нет раздела основной программы. В Модуле сеанса нельзя описывать экспортные методы.
Если при запуске системы необходимо выполнить некоторые действия на Сервере, например, создать элемент какого-либо справочника, то, как вариант, возможно использовать Модуль сеанса, т.к. он компилируется на Сервере и всегда достоверно выполняется при старте системы. Однако при этом необходимо учитывать следующие моменты:
- процедура УстановкаПараметровСеанса выполняется не только при старте системы, а также при обращении к неинициализированным параметрам сеанса. Т.е. обработчик УстановкаПараметровСеанса может вызываться неоднократно в процессе работы приложения;
- если количество элементов в массиве параметров сеанса равно нулю (у массива требуемых параметров тип данных Неопределено), то это момент запуска приложения;
- поскольку Модуль сеанса работает в привелигированном режиме и проверки прав доступа не будет, следует очень аккуратно работать с объектами базы данных, так как пользователь может получить доступ к тем данным, которые ему не должны быть предоставлены;
- при запуске системы достоверно еще не известно: будет ли запущено приложение. При этом в обработчике события УстановкаПараметровСеанса могут быть произведены лишние действия.
Общие модули
Как открыть или создать общий модуль: развернуть дерево конфигурации — общие — общие модули — открыть нужный модуль (или добавить свой).
Данные модули представляют собой описание некоторых общих алгоритмов, т.е. процедур и функций, которые могут вызываться из различных мест.
Можно добавить любое количество общих модулей. Чтобы методы Общих модулей были доступны в других местах конфигурации, необходимо их определять с ключевым словом Экспорт. Клиентские процедуры общих модулей будут доступны на Клиенте, а серверные – на Сервере.
В Общих модулях доступен только раздел описания процедур и функций. Т.е. в Общем модуле нельзя описывать переменные и нельзя описывать раздел основной программы.
Если необходима глобальная переменная, то можно использовать либо параметры сеанса, либо экспортные переменные модуля приложения.
Для Общих модулей можно задавать некоторые параметры, которые будут влиять на поведение данного модуля. Если для Общего модуля выставлено свойство Глобальный, то объявленные в данном модуле экспортные методы будут доступны из вне напрямую, без каких-либо дополнительных указаний.
Т.е. данный Общий модуль будет участвовать в формировании глобального контекста конфигурации.
Свойство Глобальный для общих модулей может быть полезным. Однако не стоит его использовать повсеместно для всех общих модулей.
Те Общие модули, которые отмечены признаком Глобальный, будут компилироваться при старте системы. Чем больше таких модулей, тем медленнее программа будет стартовать.
Если флаг Глобальный для Общего модуля не указан, то компиляция данного модуля будет выполняться в момент первого обращения к нему (т.е. уже после старта системы).
Кроме того, использование глобальных общих модулей влияет на понимание кода. Вызов методов не глобального общего модуля осуществляется через имя Общего модуля и имя метода, например:
МодульРасчетаСебестоимости.РаспределитьКосвенныеЗатраты();
При этом имена Общих модулей должны отражать содержание описываемых в них процедур. Указание имени Общего модуля при вызове процедуры способствует лучшему пониманию кода.
Для Общего модуля в Палитре свойств можно установить свойство Привилегированный.
В привилегированном модуле не контролируются права доступа. Это необходимо в том случае, если в Общем модуле требуется выполнять массовую обработку данных, получение данных из базы.
Контроль прав доступа увеличивает время обращения к базе данных, а массовые алгоритмы, зачастую, должны работать как можно быстрее.
Например, ресурсоемкой операцией является расчет заработной платы. Необходимо, чтобы она выполнялась как можно быстрее. Для этого алгоритмы, которые рассчитывают заработную плату, помещают в привилегированные Общие модули.
При этом все процедуры, которые обеспечивают заполнение документов по начислению заработной платы, находятся вне этих Общих модулей. Именно в этих процедурах и выполняется контроль прав доступа.
Таким образом можно достичь значительного повышения быстродействия. Особенно это касается случая применения механизма построчного разграничения доступа к записям таблицы.
Если Общий модуль является привилегированным, то процедуры этого модуля могут быть скомпилированы только на Сервере.
Бывают ситуации, когда пользователю какой-то объект должен быть недоступен, например, определенный справочник. Но при проведении какого-то одного документа обращение к данному справочнику необходимо.
Т.е. возникает потребность временно расширить права пользователя, а потом вернуть их в исходное состояние. Этот эффект может быть получен при использовании привилегированных Общих модулей.
Для этого в привилегированном Общем модуле следует оформить процедуру, которая обращается к нужным данным.
Данная процедура будет вызываться из соответствующего документа. Т.е. пользователю на момент вызова этой процедуры фактически предоставляются расширенные права.
Для Общих модулей существует возможность указывать место компиляции. С помощью флагов устанавливается: будет ли доступен Общий модуль на Клиенте (управляемое приложение), на Сервере, в режиме работы Внешнего соединения.
Кроме того, если перевести режим редактирования конфигурации в Управляемое приложение и обычное приложение, то будет возможен еще один контекст компиляции – Клиент (обычное приложение).
Таким образом, выделяется четыре варианта функционирования программы. В зависимости от запущенного приложения, в зависимости от работы на Клиенте или на Сервере будут доступны или недоступны определенные Общие модули.
Кроме возможности указывать флаги компиляции имеется возможность указывать директивы компиляции для процедур и функций, располагающихся в Общем модуле.
Если для метода указана директива компиляции, то не смотря на то, что Общий модуль доступен во всех указанных контекстах, доступность конкретного метода будет ограничена директивой компиляции.
При этом процедура не может быть доступна в контексте, который не доступен в целом для всего модуля.
Если директиву компиляции для процедуры (функции) не указывать, то она будет скомпилирована во всех контекстах, определенных для модуля.
Т.е. по сути будет сделано несколько копий процедуры. Выбор конкретного скомпилированного экземпляра зависит от места вызова процедуры (по правилу ближайшего вызова). При этом следует учитывать, что код такой процедуры должен быть написан с учетом его доступности во всех определенных для модуля контекстах.
Общие модули, одновременно доступные в нескольких различных контекстах, в основном предназначены для того, чтобы создавать процедуры, доступные в нескольких контекстах.
При создании Общего модуля, правилом хорошего тона считается не указывать директивы компиляции. Т.е. доступность процедур и функций должна определяться свойствами самого модуля.
При таком подходе в отдельных Общих модулях будут располагаться клиентские процедуры, и в отдельных Общих модулях – процедуры серверные.
В названиях общих модулей рекомендуется это указывать. Например: РегламентныеПроцедурыСервер, РегламентныеПроцедурыКлиент.
Модули, у которых установлено несколько флагов компиляции, на практике используются крайне редко. Это некоторые общие действия, доступные как на Клиенте, так и на Сервере. Обычно, это какие-то простейшие вычисления.
Важно! С Клиента возможно обращаться к экспортным серверным методам Общего модуля, но только в том случае, если данный Общий модуль скомпилирован только на Сервере. При этом для обеспечения доступа с Клиента предназначен специальный флажок Вызов Сервера.
Для неглобальных Общих модулей существует возможность кэширования тех значений, которые возвращаются функциями. Т.е. система может после первого вызова функции запомнить результат ее выполнения. Если данная функция будет вызвана еще раз с теми же параметрами, система выдаст значение уже из кэша.
Цель данного механизма – ускорить повторные вызовы. Для настройки подобного поведения необходимо в Палитре свойств модуля выставить соответствующее значение для свойства Повторное использование возвращаемых значений.
По умолчанию для данного свойства определено значение Не использовать. Другие возможные значения: кэшировать На время вызова, либо На время сеанса.
Данное свойство имеет смысл использовать только для тех функций, результат которых зависит исключительно от входных параметров. Данный механизм доступен только для не глобальных Общих модулей.
Если выбрано значение соответствующего параметра На время вызова, то кэш будет действовать до тех пор, пока работает та процедура, откуда был сделан вызов метода Общего модуля. Если выбрано значение На время сеанса, то условно считается, что кэш будет действовать, пока пользователь работает.
Тем не менее, существуют определенные временные ограничения. Очистка кэша происходит автоматически через 20 минут после попадания значения в кэш.
Модуль формы
Как открыть модуль формы — в дереве конфигурации развернуть справочник или документ — перейти «формы» — двойным кликом открыть форму на экране — в открытом окне перейти на вкладку «модуль».
Данный модуль предназначен для того, чтобы обработать действия пользователя. Например, описать алгоритм реакции программы при нажатии кнопки. Или, например, в момент ввода в поле значения сразу же выполнить проверку на корректность.
Кроме событий, связанных с элементами управления формы (кнопки, поля ввода) существуют события, связанные непосредственно с самой формой.
Например, можно обработать событие открытия формы и провести некую начальную инициализацию. Также можно обработать событие закрытия формы и проверить, а все ли правильно ввел пользователь.
Существуют формы управляемые и формы обычные. Модули данных форм различаются прежде всего тем, что модуль управляемой формы четко разделяется на контекст. Каждая процедура (функция) должна иметь директиву компиляции. В обычной форме весь код используется на Клиенте.
В модуле управляемой формы можно объявлять процедуры и функции, можно объявлять переменные и описывать раздел основной программы.
Программный код основной программы будет выполняться в момент инициализации формы, т.е. когда пользователь начинает ее открывать. На рисунке представлен список стандартных событий для управляемой формы.
Список событий управляемой формы виден также в списке свойств непосредственно для самой формы. Данный список вызывается в редакторе управляемых форм.
В управляемой форме можно обработать событие записи элемента. Данное событие присутствует только для форм объектов (справочников, документов и некоторых других). Если форма не привязана к конкретному объекту, то событие записи отсутствует.
Для модуля обычной формы перечень стандартных событий несколько меньше, т.к. в управляемой форме многие события сделаны парными (одно выполняется на Клиенте, а другое на Сервере). В обычной форме весь код исполняется на Клиенте.
Модуль объекта
Как открыть модуль объекта: через контекстное меню — в дереве конфигурации найти нужный справочник\документ — нажать правой кнопкой мыши — открыть модуль объекта; либо через Палитру свойств, либо через окно редактирования.
Данные модули характерны для справочников, документов, планов видов расчетов, планов счетов и многих других объектов. Модуль объекта предназначен для обработки стандартных событий. Например, событие на ввод элемента справочника, событие на запись элемента, удаление, проведение документа и т.д.
В принципе, событие записи существует и в Модуле формы. Но событие записи в Модуле формы возникает в процессе интерактивной записи, при работе с конкретной формой.
Событие записи в Модуле объекта будет выполняться при любой записи как из любой формы данного объекта, так и если объект записывается программно. Поэтому в событии записи Модуля объекта как правило размещаются все проверки на корректность записываемых данных.
Ниже на рисунке представлен перечень доступных событий модуля справочника.
В Модуле объекта можно размещать раздел описания переменных, описывать произвольные функции, которые могут быть и не связаны с событием, а также раздел основной программы.
В разделе основной программы можно, например, выполнять инициализацию локальных переменных данного модуля. Этот программный код будет выполняться при обращении к данному Модулю объекта.
Следует отметить, что все процедуры Модуля объекта скомпилированы на Сервере. Соответственно директивы компиляции у процедур и функций Модуля объекта указывать не требуется. У некоторых объектов конфигурации не существует Модулей объектов.
Это связано с особенностями самих объектов. К таким объектам относятся Константы и Регистры. Для Констант не существует модуля объекта, но существует очень похожий модуль, который называется Модулем менеджера значения.
В Модуле менеджера значения можно выполнить обработку событий записи Константы и обработку проверки заполнения.
Весь контекст модуля исполняется на Сервере.
Для регистров существует Модуль набора записей.
В данном модуле также имеется возможность обрабатывать события записи и выполнять проверку заполнения.
В Модулях объектов, Модулях менеджера значения (для констант) и Модулях набора записей (для регистров) можно описывать методы, которые можно делать экспортными, и эти методы будут доступны из вне.
Т.е. помимо использования фиксированных методов класса объектов можно создавать для объекта дополнительные методы в Модуле объекта. В данном модуле следует описать соответствующую процедуру с ключевым словом Экспорт.
Тогда будет возможно обращаться к этой процедуре из вне. Причем данный метод будет отображаться в контекстной подсказке. Новые методы в контекстной подсказке выделяются синим шрифтом (синий значок p( ) для процедур и f( ) для функций).
Аналогичным образом можно создавать новое свойство, объявив переменную с ключевым словом Экспорт. К этому свойству также можно будет обращаться из вне.
Таким образом возможно расширять функциональность объектов (доопределять новые методы и новые свойства). При этом свойства являются динамическими и не сохраняются в базе данных.
Если необходимо использовать для объекта свойство, которое будет храниться в базе данных, следует создавать реквизит объекта.
Модуль менеджера
Как открыть модуль менеджера: через контекстное меню — в дереве конфигурации найти нужный справочник\документ — нажать правой кнопкой мыши — открыть модуль менеджера; либо через Палитру свойств, либо через окно редактирования.
Данный модуль существует для многих объектов (справочники, документы, регистры и др.).
В Модуле менеджера можно переопределить некоторые стандартные события.Например, в ОбработкеПолученияДанныхВыбора, когда выбирается элемент из справочника, можно сделать какую-то дополнительную фильтрацию или проверку.
Кроме этого в Модуле менеджера можно создать дополнительные методы и указать, что они являются экспортными. В этом случае возможно обращение к данным методам из вне.
Для того, чтобы выполнить данное обращение, необходимо получить тип данных СправочникМенеджер.
Отличие экспортных методов Модуля менеджера и Модуля объекта состоит в том, что для обращения к методу Модуля объекта вначале нужно получить сам объект (т.е каким-то образом получить ссылку и далее эту ссылку преобразовать в объект).
После этого будут доступны экспортные переменные и методы Модуля объекта. Для Модуля менеджера обращение более простое, например:
Справочники.Контрагенты.ИмяМетода
Это два разных обращения. Преобразование из ссылки в объект (метод ПолучитьОбъект) – это достаточно серьезное действие для системы, так как при получении объекта читаются абсолютно все данные этого объекта, что может быть достаточно длительным.
Второе отличие в том, что МодульОбъекта вызывается в контексте конкретного элемента. Соответственно можно считать, что он применим для данного элемента (в большинстве случаев закладывается именно такая логика).
Что касается Модуля менеджера, то в нем описывается какое-то общее действие для группы или для всех элементов справочника или какого-то документа. Например, если необходимо напечатать элемент справочника, можно использовать Модуль объекта.
Но в Модуле менеджера возможно сделать более универсальный механизм, который будет печатать, в том числе, и группу элементов.
Кроме того, обращение к Модулю объекта – это все-таки более длительное действие. Поэтому решать данную задачу в модуле менеджера более предпочтительно.
Модуль команды
Как открыть модуль команды — найти команду в дереве (узел общие команды или команды конкретного объекта метаданных) — правой кнопкой мыши — открыть модуль команды.
Модуль команды предназначен для того, чтобы описать в нем на встроенном языке те действия, которые должна выполнить система при вызове этой команды. При добавлении новой команды в дерево конфигурации платформа автоматически открывает модуль этой команды для редактирования.
You have no rights to post comments