1с бсп расширение файла
1С:Предприятие 8
Стандартная библиотека
Библиотека стандартных подсистем, редакция 3.0
Версия 3.0.3
Версия 3.0.3 является развитием редакции инструментария «1С:Библиотека стандартных подсистем», который предназначен для разработки конфигураций на платформе «1С:Предприятие» версии 8.3.12 и выше. При этом свойство конфигурации «Режим совместимости» должно быть установлено в «Не использовать» при разработке на версии 8.3.12 или в «Версия 8.3.12» при разработке на более старших версиях.
«1С:Библиотека стандартных подсистем» (БСП) предоставляет набор универсальных функциональных подсистем, готовые разделы для пользовательской документации и технологию для разработки прикладных решений на платформе «1С:Предприятие». С применением БСП становится возможной быстрая разработка новых конфигураций с уже готовой базовой функциональностью, а также включение готовых функциональных блоков в существующие конфигурации. Использование БСП при разработке прикладных решений на платформе 1С:Предприятие позволит также достичь большей стандартизации конфигураций, что уменьшит время на изучение и внедрение прикладных решений за счет их унификации по набору используемых стандартных подсистем.
Администрирование пользователей и прав доступа;
Средства администрирования и обслуживания (установка обновлений, резервное копирование, дополнительные отчеты и обработки, оценка производительности и др.);
Сервисные подсистемы (история изменений объектов, заметки и напоминания, печать, полнотекстовый поиск, присоединенные файлы, электронная подпись и др.);
Технологические механизмы и программные интерфейсы (процедуры и функции общего назначения, обновление версии ИБ, работа в модели сервиса и др.);
Нормативно-справочная информация и классификаторы (адресный классификатор, банки, валюты и др.);
Прикладные подсистемы и рабочие места пользователей (анкетирование, бизнес-процессы и задачи, взаимодействия, варианты отчетов и др.).
Кроме того, для администраторов и специалистов по внедрению прикладных решений в составе БСП поставляются внешние обработки, которые можно использовать автономно без БСП для решения ряда административных и «ремонтных» задач: консоль запросов, групповое изменение объектов, регистрация изменений на узлах планов обмена, скрытие конфиденциальной информации и др.
Порядок перехода с предыдущей версии
Весь исходный код библиотеки распространяется по лицензии Attribution 4.0 International (CC BY 4.0) . Текст лицензии доступен по ссылке: https://creativecommons.org/licenses/by/4.0/legalcode. Эта лицензия позволяет вам использовать, распространять, перерабатывать, исправлять и развивать библиотеку в любых, в том числе, в коммерческих целях, при обязательном условии указания авторства библиотеки в вашем программном продукте. См. также: Ответы на типовые вопросы по лицензированию "1С:Предприятия 8".
Для обновления версий БСП в прикладных решениях рекомендуется использовать специализированные инструменты, входящие в дистрибутив библиотеки:
ExtFiles\ПервоеВнедрениеБСП.epf – внешняя обработка для упрощения процесса первого внедрения библиотеки в прикладную конфигурацию. Позволяет выбрать подсистемы для внедрения с учетом их зависимостей друг от друга и сохранить настройки для сравнения-объединения с помощью конфигуратора. Также с ее помощью можно выполнить удаление избыточных фрагментов кода подсистем, которые не используются в конфигурации.
ExtFiles\Инструменты разработчика\ПереходНаВерсию.epf – внешние обработки по автоматизации ряда массовых операций при переводе конфигурации с ранних версий библиотеки, которые указаны в разделе Переход с предыдущих версий файла UpdateSSL.htm . Предусмотрены обработки для перехода на версии 3.0.1 и 3.0.3. Обработки запускаются в информационной базе после обновления метаданных библиотеки в прикладной конфигурации. При работе с хранилищем конфигурации обработку рекомендуется запускать на копии информационной базы и затем загружать обратно измененные метаданные конфигурации с помощью сравнения-объединения.
ExtFiles\ПроверкаВнедренияБСП.erf – внешний отчет, предназначенный для запуска в информационной базе после внедрения или обновления метаданных библиотеки в прикладной конфигурации. Выявляет распространенные проблемы внедрения библиотеки в конфигурации, в частности, проверяет корректность заполнения состава определяемых типов, наличие необходимых вставок кода в модулях.
ExtFiles\ОбновлениеНаИсправительнуюВерсиюБСП.epf – внешняя обработка для обновления конфигурации на новые исправительные релизы библиотеки. Она позволяет существенно сэкономить время при регулярных (например, еженедельных) обновлениях. Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 2.4.1. 1 , 2.4.1. 2 , 2.4.1. 10 и т.п. Ее необходимо запускать в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки. Нажать на кнопку Обновить на исправительную версию , указав файл 1Cv8.cf новой версии библиотеки из комплекта поставки. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки. После обновления необходимо дополнительно выполнить инструкции из раздела Переход с тестовых версий или Переход с предыдущих версий документа UpdateSSL.htm , если они указаны. Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать настройки, которые затем можно загрузить в конфигураторе для ручного сравнения-объединения. Однако при обновлении на новые функциональные релизы (изменение третьей цифры) расстановку флажков в окне сравнения-объединения необходимо выполнять, как и ранее, в конфигураторе, следуя инструкциям в главе 2 документации.
Документация
См. также на портале
Перед началом установки конфигурации ознакомьтесь с важной информацией в файле Readme.txt
Полный дистрибутив конфигурации
Все данные для установки находятся на диске в каталоге \1Cits\EXE\SSL\3.0.3.121\ ( просмотреть каталог )
Библиотека стандартных подсистем (далее - БСП) является частью любой типовой конфигурации, поэтому умение применять готовые процедуры и функции повышает качество разработки и избавляет от написания лишнего кода. К сожалению, не у всех есть время и упорство овладеть всей документацией, поэтому я собрал воедино наиболее популярный функционал.
Официальная документация неплохо структурирована и подробно описывает каждый метод. Единственная трудность, с которой я столкнулся, было незнание, какие методы наиболее популярны в основных типовых решениях. Что необходимо знать в первую очередь, а какой функционал оставить на потом. Цель статьи - собрать и упорядочить методы по популярности (суммарным количеством вызовов). Что было сделано:
1. Из официальной документации получены все вызовы (за исключением раздела "Предопределенные").
2. Далее, производился поиск и подсчет каждого метода в 5-х типовых конфигурациях: УТ 11.4, РТ 2.3, БП 3.0, ЗУП 3.1 и ERP 2.4.
3. В заключение, собранная статистика вызовов была преобразована в разделы, близкие по структуре с документацией, и упорядочена в порядке убывания по количеству вызовов. Тем самым мы сразу можем увидеть методы, которые используются наиболее часто. Для удобства ряд методов в рамках раздела сгруппирован логически. Порядок разделов выполнен в ручном режиме. Цифра перед именем метода это и есть количество вызовов данного метода.
Часть 1. Базовая функциональность.
Пользовательская документация
Настройка и использование
2259. ТекущийПользователь. Возвращает текущего пользователя.
1926. ЭтоПолноправныйПользователь. Проверяет, является ли текущий или указанный пользователь полноправным.
981. АвторизованныйПользователь. Возвращает текущего пользователя или текущего внешнего пользователя, в зависимости от того, кто выполнил вход в сеанс.
620. РолиДоступны. Возвращает доступность хотя бы одной из указанных ролей или полноправность пользователя (текущего или указанного).
140. СсылкаНеуказанногоПользователя. Возвращает ссылку неуказанного пользователя.
100. СвойстваПользователяИБ. Возвращает свойства пользователя информационной базы в виде структуры.
21. НайтиПоИмени. Возвращает пользователя из справочника Пользователи, с которым сопоставлен пользователь ИБ с указанным именем.
67. НовоеОписаниеПользователяИБ. Возвращает пустую структуру описания пользователя ИБ. Назначение свойств структуры соответствует свойствам объекта ПользовательИнформационнойБазы.
10. УдалитьПользователяИБ. Удаляет указанного пользователя информационной базы.
7. СоздатьАдминистратора. Используется при обновлении и начальном заполнении информационной базы. Создает первого администратора и сопоставляет его с новым или существующим пользователем в справочнике Пользователи
5. СоздатьПароль. Создает новый пароль, соответствующий заданным правилам проверки сложности. Для облегчения запоминания, пароль формируется из слогов (согласная-гласная).
5. СохраняемоеЗначениеСтрокиПароля. Возвращает сохраняемое значение пароля для указанного пароля.
30. СкопироватьСвойстваПользователяИБ. Копирует значения свойств пользователя ИБ с преобразованием в/из строковых идентификаторов для основного интерфейса, языка, режима запуска и ролей.
77. НайтиНеоднозначныхПользователейИБ. Выполняет поиск идентификаторов пользователей ИБ, используемых более одного раза, и либо вызывает исключение, либо возвращает найденных пользователей ИБ для дальнейшей обработки.
15. СформироватьДанныеВыбораПользователя. Возвращает список пользователей, групп пользователей, внешних пользователей и групп внешних пользователей. Для использования в обработчиках событий ОкончаниеВводаТекста и АвтоПодбор.
5. ПользовательИБЗанят. Проверяет, сопоставлен ли пользователь ИБ с элементом справочника Пользователи или с элементом справочника ВнешниеПользователи.
Пользовательская документация
Настройка и использование
1435. ВывестиТабличныйДокументВКоллекцию. Добавляет табличный документ в коллекцию печатных форм. Процедура предназначена для использования только внутри процедуры Печать.
1307. НужноПечататьМакет. Проверить, нужно ли печатать макет. Функция предназначена для использования только внутри процедуры Печать.
1121. МакетПечатнойФормы. Возвращает макет печатной формы по полному пути к макету.
868. ЗадатьОбластьПечатиДокумента. Задает область печати объекта в табличном документе.
627. ВыполнитьКомандуПечати. Формирует и выводит на экран печатные формы.
142. ДобавитьОписаниеОбласти. Добавляет к параметру НаборОбластей новую запись об области.
Пользовательская документация
Настройка и использование
1948. ОписаниеВарианта. Находит настройки варианта отчета. Используется для настройки размещения. Для использования в ВариантыОтчетовПереопределяемый.НастроитьВариантыОтчетов.
618. ОписаниеОтчета. Возвращает настройки указанного отчета. Используется для настройки размещения и общих параметров отчета в ВариантыОтчетовПереопределяемый.НастроитьВариантыОтчетов.
306. НастроитьОтчетВМодулеМенеджера. Вызывает модуль менеджера отчета для заполнения его настроек. Для вызова из процедуры ВариантыОтчетовПереопределяемый.НастроитьВариантыОтчетов.
142. ПодключитьСхему. Устанавливает отчету переданную схему и на основании нее, инициализирует компоновщик настроек.
Пользовательская документация
Настройка и использование
256. ЭтоКонтактнаяИнформацияВXML. Возвращает признак того, является ли строка данных контактной информации XML данными.
138. ЭтоКонтактнаяИнформацияВJSON. Возвращает признак того, является ли строка данных контактной информации JSON данными.
247. СведенияОбАдресе. Возвращает сведения об адресе в виде отдельных частей адреса и различных кодов (код региона, ОКТМО и др.).
234. ПредставлениеКонтактнойИнформации. Возвращает представление контактной информации (адреса, телефона, электронной почты и т.п.).
209. КонтактнаяИнформацияОбъекта. Возвращает таблицу, содержащую контактную информацию объекта.
188. КонтактнаяИнформацияВJSON. Преобразует входящие форматы контактной информации во внутренний формат JSON.
140. КонтактнаяИнформацияПоПредставлению. Преобразует представление контактной информации во внутренний формат JSON. Для адресов, введенных в свободной форме, корректное преобразование не гарантируется.
174. КонтактнаяИнформацияВXML. Преобразует все входящие форматы контактной информации в XML.
119. КонтактнаяИнформацияОбъектов. Возвращает таблицу, содержащую контактную информацию нескольких объектов.
181. ОткрытьФормуКонтактнойИнформации. Открывает подходящую форму контактной информации для редактирования или просмотра.
115. ПараметрыФормыКонтактнойИнформации. Конструктор для структуры параметров открытия формы контактной информации. Состав полей может быть расширен в общем модуле РаботаСАдресамиКлиент свойствами с национальной спецификой.
Инструкция по внедрению библиотеки стандартных подсистем
Библиотека включает в себя набор универсальных функциональных подсистем,
предназначенных для использования в прикладных решениях на платформе “1С: Предприятие 8.3”
Файлы поставки содержит
1. 1Cv8.cf – файл поставки библиотеки. Не предназначен для создания
информационных баз по шаблону.
2. 1Cv8_demo.dt – демонстрационная база.
3. 1Cv8_demo.cf – файл поставки демонстрационной базы.
Когда я впервые внедрял БСП, я использовал файл 1Cv8_demo.cf, где уже все настроено и загрузил его в пустую конфигурацию, а затем включил возможность изменения конфигурации и методично удалял не нужные мне добавленные объекты в файле конфигурации 1Cv8_demo.cf и подготовил себе другой файл cf, который можно загружать в пустую конфигурацию без настройки перенесенных объектов библиотеки .
В целом процесс внедрения состоит из следующих этапов:
Этап 1 . Перенос объектов метаданных из файла поставки библиотеки в конфигурацию.
Этап 2. Настройка перенесенных объектов библиотеки.
Этап 3 . Использование объектов библиотеки при разработке конфигурации.
Все функциональные подсистемы, входящие состав библиотеки, относятся к родительской подсистеме «Стандартные подсистемы» в дереве объектов метаданных конфигуратора. Подсистемы, предназначенные для конфигураций, рассчитанных на работу в модели сервиса, подчинены подсистеме «Работа в модели сервиса».
Для задачи первоначального внедрения и последующих обновлений версий библиотеки в прикладных решениях в дистрибутив входит специальный инструмент – помощник внедрения (внешняя обработка ПервоеВнедрениеБСП.epf).
В его функции входит поддержка принятия решений по внедрению библиотеки в конфигурацию, а также автоматический контроль фактического результата внедрения. Поскольку принятие решений по внедрению и контроль их выполнения не требуют погружения в технические детали реализации, то проектирование, реализация и контроль могут выполняться разными специалистами и в разные моменты времени
Этап 1 Перенос объектов метаданных из файла
поставки библиотеки в конфигурацию.
Первое внедрение
Шаг 1. Для выполнения переноса объектов библиотеки в свою конфигурацию при первом внедрении нужно выбрать в режиме Конфигуратор команду меню Конфигурация – Сравнить, объединить с конфигурацией из файла. В диалоговом окне указать файл поставки библиотеки и подтвердить запрос о постановке к ней на поддержку.
Шаг 2 . В открывшемся окне сравнения и объединения конфигураций снять все флажки, ставить галку “включать область подчиненных подсистем” и отметить переносимые объекты с помощью команды Действия – Отметить по подсистемам конфигурации поставщика.
Из группы подсистем Стандартные подсистемы выбрать:
- обязательные подсистемы : Базовая функциональность, Обновление версии ИБ, Пользователи, Контактная информация. Отметим, что при внедрении подсистемы «Пользователи» для использования в модели сервиса
подсистема «Контактная информация» - подсистемы, которые требуется внедрить в вашу конфигурацию, например , сервисные подсистемы, нормативно-справочная информация и
классификаторы - если предполагается работа конфигурации в модели сервиса, то нужно включить дополнительные подсистемы, обязательные к переносу в конфигурацию для работы в модели сервиса
Далее нажать кнопку Установить.
Шаг 3. Дополнительно нужно установить или снять флажки для отдельных объектов библиотеки и их свойств и выбрать режим объединения Взять из файла (Действия – Установить режим для всех…) и нажать кнопку Выполнить. В окне со списком зависимых объектов нажать кнопку Продолжить.
Шаг 4. После завершения сравнения и объединения перейти ко второму этапу – настройка объектов библиотеки. В зависимости от числа внедряемых подсистем этот шаг может занять от одного до нескольких часов.
Обновление версии библиотеки
В этом разделе описана общая схема обновления на новую версию библиотеки. Отдельные особенности обновления каждой конкретной версии библиотеки приведены в сопроводительном документе updateSSL.htm, входящем в поставку библиотеки. Как правило, при переходе между редакциями, подредакциями и релизами библиотеки (первая,
вторая и третья цифры в номере версии) требуется выполнить дополнительные действия по обновлению, а при переходе между исправительными релизами библиотеки (четвертая цифра
в номере версии), как правило, никаких дополнительных действий не требуется. В редких случаях, когда дополнительные действия все же необходимы при обновлении на исправительный релиз библиотеки, соответствующие инструкции содержатся не только в updateSSL.htm, но и в файле readme.txt в разделе Важно. Для обновления версии библиотеки нужно выбрать команду меню Конфигурация – Поддержка – Обновить конфигурацию. В диалоговом окне указать вариант Выбор файла обновления, задать путь к файлу поставки библиотеки и подтвердить запрос об
обновлении версии конфигурации поставщика.
Шаг 1. Предварительно необходимо подготовить к удалению из конфигурации устаревшие объекты метаданных библиотеки. Для этого в открывшемся окне сравнения и объединения конфигураций снять все флажки напротив объектов метаданных, затем установить фильтр сравнения и объединения в значение Показывать присутствующие только в старой конфигурации поставщика в группе Новая конфигурация поставщика
Далее отметить все объекты метаданных флажками, выбрать режим объединения Взять из новой конфигурации поставщика (Действия – Установить режим для всех…) и нажать кнопку Выполнить.
При наличии ссылок на устаревшие объекты библиотеки из других объектов конфигурации или из других объектов самой библиотеки кнопка Продолжить недоступна. Следует вручную очистить все ссылки из других объектов конфигурации и перейти к шагу 2 (при этом ссылки из библиотечных объектов будут удалены автоматически на шаге 3).
Если же ссылок на устаревшие объекты библиотеки не было обнаружено и по кнопке Продолжить удалось поставить конфигурацию на поддержку, то следует отменить постановку на поддержку, вернувшись к исходной конфигурации БД (меню Конфигурация –Конфигурация базы данных – Вернуться к конфигурации БД).
Шаг 2. Повторно выполнить команду Конфигурация – Поддержка – Обновить конфигурацию, указав в варианте Выбор файла обновления путь к файлу поставки библиотеки. В открывшемся окне сравнения и объединения конфигураций снять все флажки и отметить переносимые объекты с помощью команды Действия – Отметить по подсистемам новой конфигурации поставщика. Из группы подсистем «Стандартные подсистемы» выбрать:
● обязательные подсистемы ;
● дополнительные подсистемы, обязательные к переносу в конфигурацию для работы в модели сервиса ;
● все ранее внедренные подсистемы, а также подсистемы, которые дополнительно требуется внедрить в вашу конфигурацию;
● подсистемы, от которых зависят отмеченные выше подсистемы,
Далее нажать кнопку Установить.
Затем отметить флажками для переноса этот же набор подсистем (объект метаданных «подсистема»), а так же подсистему Администрирование (если она была внедрена ранее или планируется внедрение) в окне сравнения и объединения конфигураций.
Выбрать режим объединения Взять из новой конфигурации поставщика (Действия –Установить режим для всех…).
Затем необходимо отметить к удалению из конфигурации все устаревшие объекты метаданных библиотеки. Для этого установить фильтр сравнения и объединения в значение Показывать присутствующие только в старой конфигурации поставщика в группе Новая конфигурация поставщика
Далее отметить все объекты метаданных флажками и нажать кнопку Выполнить. В окне со списком зависимых объектов нажать кнопку родолжить.
Шаг 3. После завершения сравнения и объединения перейти ко второму этапу – настройка объектов библиотеки.
2.2. Настройка объектов библиотеки
После завершения сравнения и объединения объекты метаданных библиотеки перенесены в конфигурацию, но еще не настроены. Для настройки перенесенных объектов библиотеки нужно выполнить инструкции указанной в файле:
Подсистема «Печать» библиотеки стандартных подсистем предназначена для формирования печатных форм объектов на основе табличных макетов (формат MXL) или макетов офисных документов в формате Office Open XML (docx).
Подсистема предоставляет инструменты для размещения команд печати на формах в подменю Печать, форму предпросмотра печатных форм, а также различные сервисные возможности по сохранению печатных форм в файлы, отправке по электронной почте и формированию изображений QR-кодов. Кроме того, в подсистему входит рабочее место по редактированию макетов печатных форм.
Настройка
Необходимо принять решение по поводу состава объектов конфигурации (справочников, документов и т. п.), которые требуется выводить на печать, и того, в каком виде должны формироваться печатные формы. Затем создать для них команды печати, разработав описательную часть, логику формирования печатной формы, и внести изменения в модули форм, в которых предполагается выводить команды печати.
Описательная часть находится в процедуре ДобавитьКомандыПечати, а логика формирования печатной формы зависит от того, в каком виде должны формироваться печатные формы:
- Формирование печатной формы в формате табличного документа (с предварительным просмотром или сразу на принтер).
- Формирование комплекта табличных документов (с предварительным просмотром или сразу на принтер).
- Формирование печатных форм с интерактивным запросом дополнительных параметров у пользователя.
- Вывод табличного документа в один из популярных форматов (Office Open XML, Microsoft Excel, Adobe PDF, HTML, текстовый документ и другие).
- Формирование печатной формы в виде офисных документов в формате Office Open XML (для тех случаев, когда возможностей табличного макета недостаточно).
Подключение объектов программы
Необходимо принять решение, для каких объектов программы разрабатываются команды печати и в каких их формах требуется выводить подменю с командами печати
При этом стоит учитывать сценарии подключения команд при помощи расширений. Т. е. если для объекта программы не планируется разрабатывать команды печати в составе конфигурации, но есть вероятность, что партнеры захотят подключить к этому объекту свои команды печати (при помощи расширений), то рекомендуется подключить этот объект.
- Объекты конфигурации, являющиеся поставщиками команд печати, следует перечислить в процедуре
ПриОпределенииОбъектовСКомандамиПечати модуля Управление Печатью Переопределяемый. - В модуле менеджера каждого из этих объектов, в области ПрограммныйИнтерфейс, должна быть определена процедура ДобавитьКомандыПечати по шаблону:
Если предполагается, что в этом подменю может быть выведено большое количество команд (более 10), то рекомендуется добавить вложенные группы кнопок с суффиксами “Важное”, “Обычное” и “СмТакже”. Например: “ПодменюПечатьВажное”, “ПодменюПечатьОбычное” и “ПодменюПечатьСмТакже”. Суффиксы этих групп указываются в свойстве Важность тех команд, которые должны выводиться в этих группах (подробнее про это свойство см. далее в таблице «Параметры команд печати»).
Далее, в формах объектов, подключенных на предыдущем шаге, в которых требуется выводить подменю с командами печати, нужно Встроить подсистему «Подключаемые команды»
В формах журналов документов подменю Печать по умолчанию заполняется командами документов, входящих в журнал. В случаях, когда команды печати необходимо брать непосредственно в модуле менеджера журнала документов, необходимо сделать соответствующую вставку кода в процедуре ПриПолученииНастроекСпискаКомандПечати общего модуля УправлениеПечатьюПереопределяемый:
Разработка процедуры «Печать»
1 . В модуль менеджера печати, указанного в параметре МенеджерПечати, добавить экспортную процедуру Печать:
2. Разместить в конфигурации макет табличного и
Добавить функцию, формирующую печатную форму (табличный документ), например:
3. В процедуре Печать разместить код для идентификации требуемой печатной формы и вызова функции по ее формированию . Например:
Формирование печатной формы в клиентском контексте
В отдельных случаях для формирования некоторых печатных форм может потребоваться клиентский контекст. Например, для запроса дополнительных параметров печатной формы у пользователя непосредственно перед печатью. В таких случаях механизм формирования печатной формы необходимо размещать в клиентском модуле, а при описании команды печати в процедуре ДобавитьКомандыПечати использовать параметр Обработчик для передачи управления в этот модуль.
Принцип создания команд, использующих клиентский контекст, несколько отличается от основного. Процедура Печать модуля менеджера объекта не вызывается механизмами подсистемы, поэтому создавать ее для такой команды не требуется.
Процесс создания такой команды выглядит следующим образом:
- В модуле менеджера объекта в процедуре ДобавитьКомандыПечати добавить описание команды (с использованием параметра Обработчик), например:
2. Добавить клиентскую экспортную функцию формирования печатной формы с единственным параметром, в который подсистема «Печать» будет передавать структуру параметров команды. Имя функции может быть произвольным, например:
Из этой функции подсистема «Печать» не ожидает никакого результата. Использование функции вместо процедуры обусловлено тем, что ее вызов осуществляется при помощи метода Вычислить().
Если клиентский контекст предполагает только запрос дополнительных параметров, а формирование табличного документа выполняется на сервере, то необходимо также выполнить инструкцию по разработке процедуры «Печать», а из клиентской функции выполнять передачу управления в процедуру УправлениеПечатьюКлиент.ВыполнитьКомандуПечати.
Функционал БСП по загрузке файлов, позволяет к любому справочнику или документу прикрепить файл или документ, в том числе возможно добавление файла напрямую со сканера.
В нашем случае для документа _ДемоСчетНаОплатуПокупателю, необходимо реализовать возможно прикрепления файла, для этого необходимо.
Создаем справочник для хранения файлов
Создаем одноименный справочник и в конце наименования добавляем текст “ПрисоединенныеФайлы“, получается _ДемоСчетНаОплатуПокупателюПрисоединенныеФайлы. Должно получится, как на рисунке ниже.
Структура справочника, такая
Справочник можно скопировать из уже существующей конфигурации, переименовать, как нужно и важно изменить тип реквизита ВладелецФайла, в нашем случае указать документ _ДемоСчетНаОплатуПокупателюПрисоединенныеФайлы.
Расширяем определяемые типы
Для типа Присоединенный Файл, добавляем в состав ссылку на созданный справочник с файлами
Для типа Присоединенный ФайлОбъект, добавляем в состав тот же справочник, но с типом Объект.
Для типа ВладелецПрисоединенныхФайлов, добавляем в состав ссылку на документ, то есть на владельца файлов
Тип ВладелецПрисоединенныхФайловОбъект, расширяется только в случае добавления файлов для справочников, для документа состав изменять не нужно.
Для определяемого типа ПереопределитьПолучаемуюФормуПрисоединенногоФайла, выбираем СправочникМенедежер созданный для файлов _ДемоСчетНаОплатуПокупателюПрисоединенныеФайлы.
Для определяемого типа УстановитьПометкуУдаленияПрисоединенныхФайловДокументов, добавим в состав ДокументОбъект _ДемоСчетНаОплатуПокупателю, для справочников данный определяемый тип изменять не нужно.
Добавляем необходимые обработчики
В форму документа добавим следующие обработчики из подсистемы работы с файлами:
С обработчиками формы закончено, дальше добавляем код:
После запуска, в форме документа должна появиться кнопка для добавления файлов, для просмотра файлов, необходимо кликнуть по надписи Файлы.
Читайте также: