Печать (Ctrl+P)
Инструкция по внедрению библиотеки стандартных подсистем
Библиотека включает в себя набор универсальных функциональных подсистем,
предназначенных для использования в прикладных решениях на платформе “1С: Предприятие 8.3”
Файлы поставки содержит
1. 1Cv8.cf – файл поставки библиотеки. Не предназначен для создания
информационных баз по шаблону.
2. 1Cv8_demo.dt – демонстрационная база.
3. 1Cv8_demo.cf – файл поставки демонстрационной базы.
Первое внедрение подсистем библиотеки в конфигурацию и обновление версии уже внедренной библиотеки заметно отличаются. После загрузки файла 1Cv8.cf в пустую конфигурацию, нужно выполнить настройку объектов библиотеки как описано в разделе 2.2, иначе при запуске в режиме предприятия будет выдано сообщение
Когда я впервые внедрял БСП, я использовал файл 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
. После завершения сравнения и объединения перейти ко второму этапу – настройка объектов библиотеки.
Как правило, конфигурации в 1с пишутся для пользователей. Все конфигурации разные, но довольно часто в разных конфигурациях используются одни и те же объекты, которые незначительно отличаются один от другого. Действительно сложно представить себе конфигурацию, где не фигурировали бы такие сущности как номенклатура, контрагенты, пользователи, валюта. Да и некоторые задачи являются типовыми: возможность базового разграничения прав, работа с электронной почтой, задачи пользователям и т.д. Но есть конфигурация, которая облегчает работу программиста, в ней собраны и структурированы стандартные задачи, которые ставят перед программистами работодатели.
Если вы работали с разними типовыми конфигурациями от 1с, то заметили что в основе своей они довольно похожи, многие базовые функции одинаковы для всех типовых конфигураций. Также из БСП можно добавить в собственную конфигурацию такие стандартные справочники как организации, банки, классификатор валют и многое другое.
Мы постараемся разобраться какие подсистемы, за что отвечают и как они взаимосвязаны между собой.
Если вы решили использовать БСП, то это не означает что нужно использовать все подсистемы, которые в нее входят. В БСП входит специальный помощник внедрения, используя который помогает существенно сэкономить время при разработке новой конфигурации. Помощник выполнен в виде пошагового мастера, используя который разработчик указывает подсистемы, которые ему нужны, а мастер создаст заготовку, с которой можно работать в дальнейшем. По сути дела мы получаем заготовку для будущей конфигурации.
Если мы запустим БСП в режиме тонкого клиента, то увидим такое окно
Нас на начальном этапе интересует закладка «»Инструменты разработчика», с помощью которой мы запустим «Помощник внедрения БСП»
Сам поморник выглядит как пошаговый помошник.
На первом этапе мы выбираем подсистемы, которые будут нам нужны в разрабатываемой конфигурации.
Например, так
После этого нужно указать файл, в котором сохраним указание настройки. Файл формата хмл.
После чего переходим ко второму этапу.
На втором этапе указываете дополнительные параметры для каждой из выбранных подсистем.
После того как вы выбрали все параметры, система проверти все ли было корректно выбрано и предложит разные варианты отслеживания ошибок
Или в таком виде:
В следующих статьях мы продолжим изучение работы с библиотекой стандартных подсистем.
«1С:Библиотека стандартных подсистем» (далее БСП) предназначена для разработок на базе «1С:Предприятие». Исходная версия БСП, созданная в 2010, разрабатывалась для конфигурирования решений самой 1С. Таким образом, в основе всех типовых продуктов, выпускаемых 1С, лежит БСП.
Использование БСП дало возможность решить такие задачи, как стандартизация прикладных программ и экономия времени программистов. Так как весь базовый функционал заложен в БСП и остается его только внедрить, не стало необходимости разработки стандартных функциональных блоков.
Установка БСП. Файлы поставки
БСП – это не решение, это всего лишь инструмент для программиста. Ее нет в продаже, ее получают по подписке на ИТС заказчики или франчайзи 1С.
Установка библиотеки
Рис.1
Следуя за установщиком, проходим шаги и жмем «Готово».
Рис.2
Рис.3
Рис.4
Добавляем новую информационную базу по кнопке «Добавить» и выбираем «Создание новой информационной базы», и далее – до нажатия «Готово».
Рис.5
Рис.6
Рис.7
Рис.8
Рис.9
Рис.10
Поставка БСП включает демо-базу с вариантом установки и следующие файлы:
- 1Cv8.cf файл поставки библиотеки, не предназначенный для создания ИБ по шаблону;
- 1Cv8_international.cf файл поставки международной версии библиотеки, также не предназначен для работы с шаблонами;
- 1Cv8_demo.dt демобаза;
- 1Cv8_demo.cf файл поставки демобазы.
Рис.11
Рис.12
Данный пример рассматривается с использованием версии 3.0.1.240. Файлы конфигурации расположены в подкаталоге \1c\SSL\3_0_1_240\. Обращаем внимание, что данная версия используется с платформой 1С 8.3 не ниже версии 8.3.12.1412.
При установке библиотеки можно столкнуться с «Ошибкой SDBL. Таблица или поле ConfigVersion не содержится в разделе FROM».
Рис.13
Данная проблема решается выгрузкой и загрузкой файла Dt (у насслучае был загружен демо-файл из комплекта поставки).
Рис.14
Помощник внедрения БСП
Рис.15
Рис.16
ПервоеВнедрениеБСП.epf – внешняя обработка, название которой говорит само за себя. С ее помощью можно отобрать подсистемы под внедрение, учитывая их взаимосвязи, оставить настройки для сравнения (объединения), удалить избыточные, неиспользуемые фрагменты кода подсистем.
Пошаговый помощник доступен из раздела «Инструменты разработчика-Первое внедрение БСП».
Рис.17
С помощью помощника создается также заготовка для создаваемой конфигурации. Справа можно ознакомиться с описанием каждой выбираемой подсистемой.
Рис.18
Рис.19
Рис.20
Прописываем доппараметры для каждой выбранной нами подсистемы.
Переносим данные, согласно нашей настройке, в создаваемую, пустую конфигурацию.В режиме «Конфигуратор» заходим в нее.
Рис.21
Для наглядности переименуем ее в «Моя_конфигурация».
В первый раз в режиме конфигуратора указываем «Конфигурация-Сравнить, объединить с конфигурацией из файла», указав в диалоге файл поставки библиотеки и подтвердив запрос о поддержке.
Рис.22
На вопрос «Выполнить полную загрузку конфигурации?» отвечаем отрицательно.
Рис.23
Рис.24
Мы видим сравнение двух конфигураций – «Моя_Конфигурация» и «Библиотеки стандартных подсистем».
Рис.25
В окне сравнения можно загрузить настройки из ранее сохраненного с помощью помощника файла через «Действия-Загрузить настройки из файла».
Рис.26
В открывшемся окне выбрать наш ранее сохраненный с помощником файл – «ФайлНастроекСравнения».
Рис.27
Обратим внимание, что подсистемы будут выделены, в зависимости от того, какие были определены при настройке помощником. Так, если выделить только базовую функциональность (Рис.28), окно конфигурации будет выглядеть следующим образом:
Рис.28
Рис.29
Т.е. мы видим, что выделены галочками не все объекты конфигурации.
Теперь настроим подчиненные подсистемы, отметив переносимые объекты, через «Действия-Отметить по подсистемам файла». Активируем «Включать область подчиненных подсистем».
Рис.30
Рис.31
По умолчанию внедряются все подсистемы, поэтому надо снять все флажки, оставив только нужные (перед внедрением библиотеки стандартных подсистем в свою конфигурацию необходимо изучить перечень внедряемых подсистем).
Из «Стандартные подсистемы» выбираем обязательные, независимо от того, какой функционал нужен. Среди них – базовый функционал, обновление версий базы, пользователи, контакты.
Также существуют допсистемы, обязательные к переносу для работы в модели сервиса, и необязательные, предполагающие выборочную установку. Определить их связь можно по таблицам, ознакомившись со статьей на сайте ИТС .
Рис.32
Выбрав подсистемы, нажимаем кнопку «Установить».
Также отдельным элементам можно выбрать режим объединения – «Взять из файла» или «Объединить с приоритетом основной конфигурации» (для этого нажать на нем правой кнопкой мышки).
Рис.33
Эти действия можно применить ко всем элементам, установив через меню «Действия-Установить режим для всех».
Рис.34
Рис.35
Рис.36
Рис.37
Рис.38
Перед обновлением конфигурации необходимо установить в ее свойствах номер версии создаваемой конфигурации, иначе при открытии программы появится ошибка о том, что не заполнено свойство версии конфигурации.
Рис.39
Рис.41
Обратите внимание, что по завершению процессов, объекты метаданных перенесены, но пока не настроены. Поэтому необходимо начать настройку объектов БСП.
Есть конфигурация, которая облегчает работу разработчика, избавляя его от таких «тривиальных» работ – это «Библиотека стандартных подсистем» (БСП), которая включает в себя набор универсальных функциональных подсистем и фрагменты раздела «Администрирование», предназначенных для использования в прикладных решениях на платформе «1С:Предприятие». Библиотека не является законченным (с предметной точки зрения) прикладным решением, но при этом подсистемы библиотеки могут использоваться в конфигурации-потребителе как все вместе, так и по отдельности. И для этого в БСП входит специальный помощник внедрения, использование которого помогает существенно сэкономить время при разработке новой конфигурации.
Сам помощник выполнен в виде пошагового мастера, с помощью которого разработчик указывает нужные ему подсистемы, а мастер создаст заготовку, с которой можно работать в дальнейшем. По сути дела мы получаем заготовку для будущей конфигурации.
Запустим БСП (у нас редакция 2.3, версия 2.3.3.63), перейдем в раздел «Инструменты разработчика» U94; «Первое внедрение БСП» :
Здесь нам откроется «Помощник внедрения БСП»
. Сам помощник выглядит как пошаговый помощник, где на первом этапе мы выбираем подсистемы, которые будут нам нужны в разрабатываемой конфигурации. После этого нужно указать файл (в формате xml), в котором сохраним эти настройки.
После чего переходим ко второму этапу: указываем дополнительные параметры для каждой из выбранных подсистем.
После выбора всех параметров система проверит, все ли было корректно выбрано и предложит разные варианты отслеживания ошибок (Таблица внедрения подсистем или Отчет по внедрению БСП).
В статье кратко описана работа с «Помощником внедрения БСП», потому что этот инструмент не очень популярен. Чаще на практике разработчики действуют по такой схеме: на пустую конфигурацию устанавливают необходимые подсистемы БСП (здесь еще может помочь «Помощник внедрения БСП»), но обычно с БСП на новую пустую конфигурацию переносят все подсистемы.
У нас есть две конфигурации: первая (основная) - со всеми подсистемами БСП, вторая (файла) - БП.
1. Включить возможность редактирования основной конфигурации.
2. Вызвать меню Конфигурация - Сравнить , объединить с конфигурацией из файла .
3. Выбрать файл с расширением cf конфигурации БП.
4. На предложение постановки на поддержку ответить Да.
6. Выполнить Действия - Отметить по подсистемам.
7. Отметить подсистемы, которые отсутствуют в нашей основной конфигурации – взять из файла, но подсистемы, которых нет в конфигурации из файла, нужно оставить в основной конфигурации (по умолчания так и будет), далее нажать Установить.
8. Отметить к объединению свойства корневого элемента: Основные роли, Модуль управляемого приложения, Модуль сеанса, Модуль внешнего соединения, Модуль обычного приложения, Режим использования модальности, Режим использования синхронных вызовов расширений платформы и внешних компонент, Режим совместимости интерфейса, Режим совместимости. Нажать Выполнить.
9. В окне Настройка правил поддержки - Ок .
10. Обновить конфигурацию базы данных (F7) .
И подобные служебные сообщения :
«… (объект входит в состав одноименного общего реквизита)» или «… : Использование определяемых типов в режиме совместимости Х.Х.Х. (к примеру, автор) и ниже недопустимо» ; «ОбщаяКартинка: Имя не уникально!»
12. Для объекта, который входит в состав одноименного общего реквизита – снять с поддержки, удалить объект и ссылки на него. Выполнить поиск ссылок на удаляемые объекты – удалить ссылки.
13. Поменяйте режим совместимости выше Х.Х.Х.
14. Обновить конфигурацию базы данных (F7). Далее, если возвращаетесь на пункт 11, выполнить пункти 12 и 13, потом 14.
В принципе это и все – «автоматическая» часть работы закончена. Начинается самый «интересный» этап работ: если Вы уже подумали, что конфигурация «взлетела», то, скорее всего, Вы сильно ошибаетесь.
Для начала проверяйте общие модули, включены ли подсистемы в командный интерфейс и прочее моменты. Когда все «как бы готово», приступайте к отладке.
И так выполняете отладку до тех пор, пока не убедитесь в отсутствии ошибок.
