Печать (Ctrl+P)

1С: Предприятие 8.3.13 . Документация
Руководство администратора
Глава 33. Расширение конфигурации

33.1. Общая информация

33.1.1. Термины и определения

Механизм расширения конфигурации ‑ это специальный механизм, предназначенный для доработки расширяемой конфигурации без изменения этой конфигурации (в том числе без снятия с поддержки).

При рассмотрении механизма расширения конфигурации будут использоваться следующие термины:

● Расширяемая конфигурация ‑ основная конфигурация информационной базы, для которой применяется расширение или для которой расширение разрабатывается.

● Расширение конфигурации ‑ набор объектов конфигурации, подключаемых к расширяемой конфигурации и содержащий набор объектов, добавляемых к расширяемой конфигурации. Расширение может включать в себя как объекты расширяемой конфигурации, так и объекты, которые отсутствуют в расширяемой конфигурации.

● Собственный объект ‑ самодостаточный объект конфигурации, который может находиться как в расширяемой конфигурации, так и в расширении.

● Заимствованный объект ‑ собственный объект, добавленный в расширение конфигурации.

● Расширяемый объект ‑ собственный объект, для которого в заимствованном объекте изменены какие-либо параметры (свойства, формы и т. д.).

● Расширяющий объект ‑ это заимствованный объект, в который внесены изменения относительно расширяемого объекта. Наличие в заимствованном объекте только контролируемых свойств не делает заимствованный объект расширяющим.

● Результирующий объект ‑ это собственный объект плюс объединение всех расширяющих объектов (если расширений несколько). Если для собственного объекта нет расширяющих объектов ‑ он становится результирующим «без изменений». Т.е. в конфигурации, с которой работает пользователь ‑ все объекты являются результирующими, вне зависимости от наличия и количества установленных расширений.

● Расширяющее свойство ‑ свойство заимствованного объекта, которое изменяет одноименное свойство расширяемого объекта.

● Контролируемое свойство ‑ свойство заимствованного объекта, значение которого проверяется при подключении расширения к расширяемой конфигурации. Если при подключении расширения (в режиме 1С:Предприятие) значение контролируемого свойства в расширении не совпадет со значением этого же свойства в расширяемой конфигурации, расширение не будет подключено.

● Модифицируемое свойство ‑ свойство заимствованного объекта, значение которого в результирующем объекте будет получаться из расширения.

● Расширение данных ‑ это возможность расширять структуру хранимых данных расширяемой конфигурации с помощью заимствованных и собственных объектов расширения.

Свойство заимствованного объекта не может быть одновременно контролируемым и модифицируемым.

33.1.2. Краткое описание механизма

Основное назначение расширения конфигурации ‑ это доработка прикладного решения при внедрении (или в «облаке») под нужды клиента. При этом дорабатываемую конфигурацию не надо снимать с поддержки. В результате сохраняется простота обновления типового прикладного решения, стоящего на поддержке, с необходимостью выполнять доработки. При разработке расширения следует понимать некоторые особенности функционирования расширения конфигурации. Так, расширяемая конфигурация в любой момент может быть изменена, например, в результате обновления. При этом разработчик расширения не может никак повлиять на возможность или невозможность обновления. Также следует учитывать тот факт, что в системе могут функционировать более одного расширения и автор каждого расширения (в общем случае) не знает, как функционирует другое расширение.

Объекты, размещенные в расширении конфигурации, могут изменять поведение существующих объектов расширяемой конфигурации, не изменяя структуру данных, которые хранятся в информационной базе. В тоже время объекты, расположенные в расширении конфигурации, имеют возможность дополнять структуру хранения расширяемых объектов конфигурации (добавлять реквизиты) и создавать собственные объекты расширения, которые будут хранить «свои» данные в информационной базе расширяемой конфигурации.

Каждое расширение имеет свое назначение (свойство расширения Назначение расширения конфигурации). Назначение расширения конфигурации описывает, для какой цели создается это расширение. Расширение может иметь одно из следующих назначений:

● Исправление ‑ такое расширение предназначено для исправления ошибок в прикладном решении. В таких расширениях предполагается использование потенциально «опасных» возможностей расширений, например, применение расширения метода с помощью аннотации Вместо. Исправления предназначено для определенной версии прикладного решения. При выходе следующей версии этого решения автор расширения должен проводить анализ применимости созданных расширений в новой версии. Допускается наличие нескольких расширений с таким назначением, но необходимо обеспечить отсутствие конфликтов между такими расширениями, например, несколько таких расширений не должны расширять один и тот же метод с разными целями. Такие расширения могут не учитывать наличия расширений другого назначения.

● Адаптация ‑ такое расширение предназначено для адаптации прикладного решения под условия конкретного клиента. В таких расширениях рекомендуется не использовать потенциально «опасных» возможностей, т. е. тех возможностей, которые могут привести к конфликту расширений при их совместной работе или которые зависят от порядка подключения расширений. Тем не менее, допускается аккуратное использование «опасных» возможностей, при условии, что автор расширения берет на себя полную ответственность за обеспечение корректного функционирования результирующей конфигурации в новых версиях прикладных решений, и с учетом расширений, имеющих назначение Исправление. Предполагается, что в каждый момент времени в информационной базе существует минимальное количество таких расширений. Если в одно расширение невозможно включить весь набор изменений, то рекомендуется расширения с назначениемАдаптация разбивать по максимально крупным блокам расширяемого прикладного решения.

● Дополнение ‑ такое расширение предназначено для реализации новых возможностей прикладных решений, которые минимально привязаны к конкретной версии прикладного решения. Примером такого расширения может служить создание нового набора отчетов, который отсутствует в расширяемом прикладном решении. Предполагается, что такие расширения должны корректно работать в случае обновления расширяемого прикладного решения. При этом расширение с назначением Дополнение не должно учитывать в своей работе возможное наличие расширений с другим назначением. Предполагается, что таких расширений может быть произвольное количество.

Если расширение подключается к разделенной информационной базе, то для такого расширения имеется возможность указать область действия расширения: вся информационная база или область данных. Подробнее про эту возможность см. .

Расширение создается в конфигураторе, хранится в информационной базе и может быть сохранено в файл. Для добавления (подключения) расширения, сохраненного в файл, в прикладное решение конкретного клиента нет необходимости использовать конфигуратор. Подключить расширение можно с помощью специальной стандартной функции (Все функции ‑ Стандартные ‑ Управление расширениями конфигурации). Подключить расширение также можно с помощью инструментария прикладного решения, которое использует программный интерфейс, предоставляемый платформой. Подключение расширения (интерактивно или из встроенного языка) возможно в следующих случаях:

1. в небезопасном режиме (см. );

2. в том случае, когда профиль безопасности (подробнее см. ), под управлением которого работает сеанс, разрешает доступ к подключаемому расширению.

33.1.3. Особенности и ограничения

В расширении конфигурации не поддерживается создание следующих собственных объектов:

● Параметры сеанса.

● Общие реквизиты.

● Критерии отбора.

● Подписки на события.

● Регламентные задания.

● Функциональные опции и параметры функциональных опций.

● Определяемые типы.

● Хранилища настроек.

● Языки.

● Константы.

● Журналы документов.

● Бизнес-процессы и задачи.

● Внешние источники данных.

Не поддерживается расширение следующих объектов:

● Нельзя создавать подчиненные подсистемы.

● Если объект не может быть собственным объектом расширения ‑ его расширение также не поддерживается.

● Состав значений перечислений;

● Не поддерживается добавление реквизитов и табличных частей для:

● План видов характеристик;

● План счетов;

● План видов расчетов.

● Не поддерживается изменение структуры регистров всех видов. Поддерживается только расширение состава регистраторов.

Среди контролируемых свойств следует особо выделить:

● Состав плана обмена;

● Предопределенные элементы для справочников, планов видов характеристик, планов счетов и планов видов расчетов.

При расширении данных следует помнить о следующих особенностях и ограничениях:

● В расширении не поддерживается использование типа ЛюбаяСсылка. Тип ЛюбаяСсылка, использованный в расширяемой конфигурации, не включает в себя типы, предоставленные расширениями.

● В расширении конфигурации не поддерживается использование заимствованных определяемых типов.

● После подключения расширения конфигурации, расширяющего данные, не поддерживается использование фоновой реструктуризация.

● Тестирование и исправление обрабатывает только структуры данных расширяемой конфигурации.

● Особенности поведения системы с включенным разделением см. .

В базовых версиях прикладных решений работа с расширениями не поддерживается.

При обновлении конфигурации выдается служебное сообщение «ОбщаяКартинка.Обсуждения: Имя не уникально!» даже на пустой базе. Что можно сделать не программисту, а просто уверенному пользователю? Спасибо.

Получите еще секретный бонус и полный доступ к справочной системе БухЭксперт8 на 14 дней бесплатно

Все комментарии (4)

Здравствуйте!
Уточните пожалуйста, с какого на какой релиз пытаетесь обновиться?
Также уточните, после появления сообщения обновление прерывается? До конца обновить не получается?
Как обновляете? Из конфигуратора или из пользовательского режима?

Добрый день!
Вообще это сообщение выходит при обновлении через конфигуратор будь то ЗКГУ, ЗУП, БГУ (смотрела на разных организациях) и разных последних релизов. Выходит после ответа на «…Обновить конфигурацию?» Обновлению не мешает, все проходит в штатном режиме. Но напрягает непонимание сути. Спасибо!

Поискал информацию по этой ошибке в интернете. Получается, что картинку «Обсуждения», вставили в платформу 8.3.13.1513 и забыли удалить из типовых. Насколько я понял это влияет только на невозможность автоматического обновления. Через конфигуратор обновление выполняется. Так что можно не обращать внимание

После перехода на новую версию платформы Вы можете встречать ошибки такого вида:

• ОбщаяКартинка.Обсуждения: Имя не уникально!
• ОбщаяКартинка.История: Имя не уникально!
• ОбщаяКартинка.СохранитьНастройкиОтчета: Имя не уникально!
• ОбщаяКартинка.ОткрытьФайл: Имя не уникально!

Давайте разберемся с тем, о чем Вам сообщает новая версия платформы. В платформе 1С есть 2 вида картинок:

1. Встроенные в платформу картинки. Эти картинки добавляют разработчики фирмы 1С.
2. Картинки типовой конфигурации. Эти картинки добавляют разработчики используемой Вами типовой конфигурации.

В случае, если они начинают пересекаться — большим приоритетом обладают картинки, встроенные в платформу. И тогда платформа предупреждает Вас о необходимости изменения имени картинки в Вашей конфигурации. Рассмотрим пример — при обновлении конфигурации выводится сообщение (конфигурация 1С:Деньги): ОбщаяКартинка.История: Имя не уникально!

Теперь сравним имена картинок в конфигурации (ветка «Общие картинки») и имена стандартных (платформенных) картинок. В обоих списках есть картинка История. Именно это и приводит к ошибке при обновлении.

Таким образом, для исправления ошибки нужно изменить имя картинки в Вашей конфигурации. Если Вы используете типовую конфигурацию и она недоступна для редактирования ( находится на поддержке ) — Вам нужно дождаться обновления типовой конфигурации, в которое будет включено переименование общей картинки.

Если ошибка мешает обновлению конфигурации 1С — запустите обновление на более ранней платформе 1С, на которой ранее этой ошибки не было.

Добавить комментарий Отменить ответ

• Исправляем «В документе отсутствуют этапы оплаты. Печать счета на оплату не требуется»
• Использование аннотации &ИзменениеИКонтроль на примерах
• Дополнительные реквизиты по видам номенклатуры (УТ11, КА2, ERP2)
• Расширения конфигурации и ошибка «Установлен безопасный режим. Выполнение операции запрещено»
• Исправляем ошибку «Метод объекта не обнаружен (ПодготовитьКоллекциюПечатныхФорм)»

Наше расширение полностью изменит список номенклатуры и добавит в него очень удобные инструменты для работы с номенклатурой и корзину для оформления заказов клиентов.

Формируйте свои уникальные прайс-листы с возможностью загрузки в 1С.

Ошибки конфигурации программ — некорректная настройка программного обеспечения (избыточные права доступа, открытые порты или интерфейсы и т.п.), в результате которой компьютерная система или данные могут быть скомпрометированы. Конфигурирование под определенные платформы является важнейшим этапом внедрения любого программного продукта и условием успешности работы с ним; чем сложнее решение, тем выше риск ошибиться.

Отдельные личности или группы злоумышленников используют подобные нестыковки в собственных целях. Независимо от характера любой сбой приводит к ослаблению встроенных защитных механизмов и делает машину уязвимой перед хакерскими атаками.

Классификация ошибок конфигурации программ

Наиболее частой причиной ошибок конфигурации программ является человеческий фактор. Администратор системы может не знать о редко используемых функциях или забыть закрыть доступ к компьютерной системе, в результате чего любой желающий от его имени сможет выполнить какие угодно действия.

Перечислим основные ошибки, которые могут использоваться преступниками для последующего взлома.

• Неполадки логического типа возникают в процессе редактирования конфигурационных параметров, из-за некорректного ввода переменных для расчетов или несовпадения отдельных результатов, что скорее всего приведет к появлению сбоев в работе или к полному зависанию программы.
• Системные ошибки заключаются в переполнении памяти, неверной адресации, потере данных или появлении ссылок на несуществующие объекты.
• Нарушение целостности структуры данных.
• Оставленные активными отладочные переключатели для внесения изменений в готовый продукт и исправления обнаруженных сбоев.
• В Windows 10 встречаются недочеты в текстовых файлах, содержащих данные об основных параметрах конфигурации.
• Полное отсутствие антивирусных программ или устаревшие сигнатурные базы.

Во всех вышеперечисленных случаях злоумышленники будут активно использовать возникшие неполадки для внедрения вредоносного кода или скрытого запуска различных приложений.

Объект воздействия

Ошибки конфигурации могут возникнуть в любом приложении, однако наиболее уязвимыми для действий взломщиков являются параметры, связанные с функционированием ОС Windows, серверного программного обеспечения, программных продуктов 1С и других решений, использующих многоуровневые инженерные расчеты и гиперссылки.

Распространенными объектами воздействия являются устаревшие версии компонентов операционной системы и иного программного обеспечения, а также системный реестр. С помощью специализированных инструментов злоумышленники обнаруживают неправильно настроенное сетевое оборудование, уязвимые устройства интернета вещей. Настройки по умолчанию становятся причиной обхода механизмов безопасности, защищающих смартфоны.

Причины возникновения ошибок конфигурации

Основные источники ошибок конфигурации многочисленны:

• неточности в программном коде, дизайне или реализации, допущенные в процессе разработки и написания программы;
• неверная инсталляция продукта или несоблюдение рекомендаций разработчиков (например, закрыть запущенные приложения в процессе установки или отключить интернет);
• внешние факторы: перебои с питанием компьютера или подключенного к нему оборудования, неверная работа драйверов или иных компонентов ОС;
• переполнение жесткого диска или памяти, в результате чего проведенные изменения не сохраняются полностью;
• халатность, неопытность пользователей или умышленное причинение вреда сообщниками злоумышленников;
• случайное или намеренное внешнее вмешательство с целью вызвать сбой и внедрить сторонний код, запустить вредоносную программу.

Некоторые проблемы возникают в результате комбинации совершенных ранее действий, которые по отдельности не приводят к появлению неполадок подобного рода.

Анализ риска появления ошибок конфигурации

От появления подобных ошибок никто не застрахован. Они могут возникнуть из-за неверных действий пользователей и после сбоев в работе аппаратной части. Хуже, что возникающие неполадки могут использоваться злоумышленниками для заражения компьютера.

Если при установке или запуске появилось сообщение об обнаруженной ошибке конфигурации (например, показанный выше «синий экран смерти»), необходимо выполнить следующие действия:

• Проверить совместимость инсталлируемого программного обеспечения с операционной системой и ее компонентами; если это является причиной конфликта, можно попробовать установить другую версию или заменить программу аналогом.
• Попробовать запустить приложение с правами администратора.
• Перезагрузить компьютер; возможно, неисправность носила разовый характер и после перезапуска системы не повторится.
• Проверить версии служебных компонентов, необходимых для работы программ (например, Microsoft Visual C++), при необходимости скачать их с официального сайта производителя и переустановить.
• Проверить реестр на соответствие параметров, связанных с проблемным приложением, значениям по умолчанию.

Если вышеперечисленные шаги не дали требуемого результата, можно попытаться переустановить приложение.

Важно внимательно изучать документацию к программным продуктам, особенно к комплексным решениям для корпоративной среды, и стараться не упускать потенциально опасные параметры, которые могли бы эксплуатироваться злоумышленниками. И домашнему пользователю, и администратору полезно знать, какая функциональность программного обеспечения избыточна для его задач, и отключать лишнее. Например, обычной рабочей станции совершенно не обязательно служить HTTP-сервером, поддерживая порт 80 открытым для внешних соединений.

Обновление платформы ➥ Как самостоятельно обновить платформу 1С:Підприємство 8.3 ➾ Если у вас типовая (без изменений и доработок) конфигурация 1С:Підприємство, ➾ то обновить платформу достаточно просто. Данная статья поможет вам разобраться в обновлении платформы, ✔не прибегая к помощи специалиста.

В данной статье рассмотрен самый распространенный вариант обновления платформы (на примере обновления с платформы 8.2.19.130 на 8.3.6.2299) – обновление платформы 1С:Підприємство для Windows на компьютере пользователя, при скачивании дистрибутива обновления с сайта поддержки пользователей.

Обновление НЕтиповой, измененной конфигурации 1С:Підприємство

3 способа — обновление типовой, не доработанной программы 1С:Підприємство

1С:Підприємство — подборка материалов для пользователей учетных систем

Для установки платформы, нужно выполнить абсолютно те же действия, что и для обновления платформы.

НАВИГАТОР ПО СТАТЬЕ:

Обратить внимание! При предыдущих переходах с платформы на платформу (с 8.1 на 8.2, например) требовалась конвертация конфигураций и внешних обработок. При переходе с версии 8.2 на 8.3 никакая конвертация не требуется. Переход осуществляется по стандартному порядку обновления платформы.

ВАЖНО! Перед тем как приступать к обновлению платформы необходимо сделать архивную копию информационной базы.

Скачать дистрибутив обновления платформы 1С:Підприємство 8.1, 8.2, 8.3

Для обновления (установки) технологической платформы необходимо скачать дистрибутив обновления. Для этого на сайте «Портал информационно-технологического сопровождения» следует перейти на страницу «Обновление программ», нажав на кнопку «Узнать больше» в разделе «Обновление программ» (Рис.1).

Рисунок 1 – главная страница «Портала информационно-технологического сопровождения»

На странице «1С:Обновление программ» по кнопке «Скачать обновление программы» нужно перейти к параметрам авторизации и ввести логин и пароль (Рис. 2).

Рисунок 2 – авторизация на сайте технической поддержки

Как узнать актуальную версию платформы?

Сделать это можно как показано на Рис.З.

В открывшемся окне списка доступных продуктов на скачивание нужно выбрать раздел «Технологическая платформа 8.3», затем версию платформы (по примеру 8.3.6.2299). Далее нужно выбрать пункт «Технологическая платформа 1С:Підприємство для Windows», и нажать на гиперссылку «Скачать дистрибутив» (Рис. 3).

Рисунок 3 – выбор дистрибутива обновления платформы 1С:Підприємство

Новости о выходе новых релизов конфигураций и платформы мы публикуем и на наших страницах социальных сетей. Подписывайтесь на наши страницы Facebook или Twitter, — вы будете всегда в курсе новостей касательно выхода обновлений.

Историю обновлений типовых конфигураций вы можете посмотреть по ссылкам на соответствующие страницы Обновлений в нашем блоге:

• БУ Бухгалтерія для України, обновления,
• УТП Управління торговим підприємством для України, обновления,
• УВП Управління виробничим підприємством для України, обновления,
• ЗУП Зарплата та управління персоналом для України, обновления,
• УНФ Управління невеликою фірмою, обновления
• УТ Управління торгівлею, обновления,
• ДОК Документообіг, обновления.

Как узнать свою версию платформы 1C:Підприємство?

Откройте программу. Нажмите Справка / О программе… Рядом с логотипом в скобках указана версия вашей платформы:

Создание резервной копии информационной базы

Перед обновлением платформы необходимо всем пользователям завершить работу с программой. Далее заходим в 1С:Підприємство в режим «Конфигуратор», и делаем выгрузку базы (Рис. 3.1):

Сохраняем в любое место на жестком диске. (Рис. 3.2)

Совет: создайте папку «Архивные копии» или «Backup», куда вы будете всегда сохранять резервную копию базы перед обновлением. В названии файла указывайте дату сохранения (так будет удобнее искать нужную копию базы, если понадобится).

Если у вас получилось скачать 1С:Підприємство нужной версии, необходимо разархивировать файлы платформы. Далее нужно установить платформу, при нажатии на файл setup.exe в разархивированной папке (Рис. 4).

Рисунок 4 – файл установки платформы

Обновление платформы версии 8.3 (файловый вариант) информационной базы

Для начала установки платформы (по примеру 1С:Підприємство 8.3), нужно нажать кнопку «Далее» (Рис. 5).

Рисунок 5 – первоначальное окно установки платформы 1С:Підприємство 8.3

На следующем шаге выбирается состав компонентов платформы и папка для установки. Состав компонентов изменять не нужно, рекомендуется устанавливать 1С:Підприємство в папку по умолчанию. После выбора необходимо нажать «Далее» (Рис. 6).

Рисунок 6 – выбор компонентов программы 1С:Підприємство 8.3

Далее нужно выбрать язык установки (русский/украинский), либо уставить значение «Системные установки», в этом случае 1С:Підприємство установится на языке операционной системы. После выбора необходимо нажать кнопку «Далее» (Рис. 7).

Рисунок 7 – выбор языка интерфейса по умолчанию в 1С:Підприємство 8.3

Теперь все готово для начала установки. Необходимо нажать кнопку «Установить» (Рис. 8).

Рисунок 8 – начало установки платформы 1С:Підприємство 8.3

Далее происходит процесс установки платформы (Рис. 9).

Рисунок 9 – процесс установки платформы 1С:Підприємство 8.3

После установки, на последнем шаге, система предложит установить драйвер ключа защиты.

Он нужен только в том случае, если используется аппаратная защита, т.е. USB HASP ключ. Если используется программная лицензия без USB HASP ключа защиты, нужно убрать флаг.

Также, если используется USB HASP ключ защиты и происходит обновление платформы, а не установка впервые, то установка драйвера защиты не требуется, так как он уже установлен вместе с более старым релизом платформы. Для продолжения установки необходимо нажать кнопку «Далее» (Рис. 10).

Рисунок 10 – установка драйвера защиты 1С:Підприємство 8.3

После вывода окна с оповещением о завершении установки, нужно нажать кнопку «Готово» (Рис. 11).

Рисунок 11 – окно завершения установки платформы 1С:Підприємство 8.3

Установка на этом завершена.

Далее вы еще раз можете проверить версию платформы, как мы отмечали выше, чтобы убедиться, что все прошло успешно.

Обновление платформы версии 8.2 (файловый вариант) информационной базы

Важно! Данное действие необходимо провести на всех рабочих местах, где используется 1С:Підприємство 8.2

Перед выполнением обновления всем пользователям необходимо выйти из программы.

Скачайте дистрибутив (Технологическая платформа 1С:Підприємство для Windows)

Откройте скачанный архив с дистрибутивом и извлеките файлы в любую папку на жестком диске.

Запустите файл setup.exe

Перед вами откроется установочное окно:

Выбираем компонент «1С:Підприємство»:

Вы также можете добавить или отключить доступные языки интерфейса.

Нажмите на плюс (раскрыть список) в строке «Додаткові інтерфейси:

Включите или отключите нужные языки:

Жмем Далее. Выбираем язык интерфейса, используемый по умолчанию:

Жмем Далее и Установить:

После установки нажимаем Готово.

Важно! Если у текущего пользователя недостаточно прав на установку программ, или нет доступа к программным файлам, программа установки выдаст сообщение об ошибке. Код ошибки может быть разным. В таком случае позвоните нам по тел.: (044) 230-87-50. Наш специалист проконсультирует вас либо подключится к вам удаленно и обновит платформу.

Обновление платформы с помощью диска ИТС

Вставьте в CD-ROM диск, на котором есть надпись: «ДИСТРИБУТИВ ПЛАТФОРМЫ 1С:Підприємство 8.2». После автозапуска диска появляется следующее окошко. (Рис.4.1.)

Дальше жмем «Просмотр CD». Появляется следующее окошко: (рис. 4.2.)

Выбираем 1С:Підприємство. Формы отчетности, релизы программ и конфигураций. Открывается окно:

Жмем на релиз платформы:

Если все сделано правильно, появляется следующее окошко: (Рис.4.3.). В нем внимательно читаем, и выбираем 32-битную версию (или 64 разрядную если у вас такая ОС). Согласно рисунку, жмем один раз на ссылку «копировать файлы комплекта на жесткий диск»

В появившемся окне необходимо указать путь к папке сохранения файлов. В примере это будет «C:\..\»

Дальше жмем на кнопку «копировать»

Процесс копирования может занять несколько минут, если все правильно, увидим следующее сообщение

После окончания процесса копирования, заходим в каталог с сохраненными файлами и запускаем файл «setup.exe».

Далее действия аналогичны тем, что описаны выше.

Материалы подготовлены компанией TQM systems. Являемся официальным партнером, оказываем комплексные услуги 1С:Підприємство.

Всегда рады взаимовыгодному сотрудничеству.

*Копирование материала возможно только с ссылкой на источник и указанием автора материала. Благодарим за уважение интеллектуальных прав собственности.TQM systems

Печать (Ctrl+P) В данном разделе описаны наиболее частые варианты использования механизма работы с временным хранилищем и файлами.

Сохранение данных из файла во временное хранилище

Помещение одного файла

Метод ПоместитьФайл() помещает файл из локальной файловой системы во временное хранилище. Метод может принимать адрес во временном хранилище, по которому нужно сохранить файл. Если же адрес не определен или является пустой строкой, то будет создан новый адрес и метод вернет его через специальный параметр.
Примечание. Объем данных, перемещаемых между клиентом и сервером, за один вызов метода ПоместитьФайл(), не должен превышать 4 Gb (в сериализованном виде).
Если параметр, определяющий интерактивный режим работы, равен Истина, то метод отобразит стандартное диалоговое окно выбора файла, в котором можно выбрать файл для помещения в хранилище. В этом случае метод также вернет адрес выбранного файла.
В качестве результата метод возвращает Ложь, если пользователь в интерактивном режиме отказался от совершения операции в диалоге выбора файла.

Помещение набора файлов

Метод ПоместитьФайлы() помещает во временное хранилище несколько файлов за один вызов. Существует несколько различных способов использования этого метода:
● предварительно сформировать список добавляемых файлов, например, когда предварительно выбрал файлы, которые необходимо поместить в информационную базу;
● передать в метод маску поиска файлов, например, когда требуется поместить в информационную базу все файлы определенного вида,например, все картинки;
● передать в метод предварительно подготовленный объект ДиалогВыбораФайла в режиме открытия файлов.
После окончания работы метод может вернуть список реально добавленных файлов.

// СписокФайлов – реквизит формы типа СписокЗначений,
// содержащий список добавляемых файлов
МассивФайлов = Новый Массив;
Для каждого ЭлементСписка Из СписокФайлов Цикл
МассивФайлов.Добавить(Новый ОписаниеПередаваемогоФайла(ЭлементСписка, ));
КонецЦикла;
ПомещенныеФайлы = Новый Массив;
Результат = ПоместитьФайлы(МассивФайлов, ПомещенныеФайлы, , Ложь, УникальныйИдентификатор);

Примечание 1. Для использования метода ПоместитьФайлы() в веб-клиенте требуется подключение расширения работы с файлами .
Примечание 2. Объем данных, перемещаемых между клиентом и сервером, за один вызов метода ПоместитьФайлы(), не должен превышать 4 Gb (в сериализованном виде).

Помещение данных во временное хранилище

Метод ПоместитьВоВременноеХранилище() схож с методом ПоместитьФайл(), за исключением того, что данные для записи во временное хранилище
представляются не в виде пути в файловой системе, а в виде значения. Точно так же, если не указан существующий адрес во временном хранилище, создается новый адрес. Адрес возвращается как результат функции. Так же как и для файлов, размещенные данные обязательно принадлежат какой-либо форме и автоматически удаляются после ее удаления.
Примечание. Объем данных, перемещаемых между клиентом и сервером, за один вызов метода ПоместитьВоВременноеХранилище(), не должен превышать 4 Gb (в сериализованном виде).
Внимание! При помещении во временное хранилище фактическая сериализация значения не выполняется. Помещается ссылка на значение, которая хранится в кеше в течение 20 минут. По истечении этого периода значение сериализуется, записывается на диск (в хранилище сеансовых данных) и удаляется из кеша.

Получение данных из временного хранилища

При записи объекта в информационную базу может понадобиться извлечь данные из временного хранилища и поместить их, например, в реквизит объекта информационной базы. Для этого существует специальный метод – ПолучитьИзВременногоХранилища(). Этот метод извлекает данные из временного хранилища и возвращает их в качестве результата выполнения. Для получения данных необходимо указать адрес во временном
хранилище. Этот адрес возвращают методы помещения данных во временное хранилище в случае их успешного выполнения (см. предыдущие разделы).
Внимание! При получении на сервере значения из временного хранилища следует учитывать то, что оно получается по ссылке. В действительности, ссылка эта указывает на значение, которое хранится в кеше. В течение 20 минут, с момента помещения в хранилище или же с момента последнего обращения, значение сохранится в кеше, а затем записывается на диск и из кеша удаляется. При следующем обращении значение загружается с диска и снова помещается в кеш.
После десериализации и восстановления значения из временного хранилища ссылки не восстанавливаются. Значение в кеше восстанавливается с диска. Но после сериализации/десериализации восстановить ссылки на другие объекты внутри значения невозможно.

Удаление данных из временного хранилища

После того как данные сохранены в реквизите объекта информационной базы, данные во временном хранилище можно удалить. Для этого есть метод
УдалитьИзВременногоХранилища(), который производит удаление. Метод принимает в параметре адрес во временном хранилище.

Проверка адреса на принадлежность временному хранилищу

Адрес может указывать как на временное хранилище, так и на реквизит в информационной базе. Для проверки его типа существует метод
ЭтоАдресВременногоХранилища(). Он проверяет, что переданный адрес является адресом, указывающим на хранилище. Возвращает Истина, если адрес указывает на временное хранилище.

Получение адреса реквизита

После того как данные помещены в реквизит объекта информационной базы, может потребоваться получить доступ к ним с помощью файловых методов.
Но прежде чем получить данные, например из реквизита, необходимо получить адрес этого реквизита. Для этого существует метод ПолучитьНавигационнуюСсылку().

Он может вернуть адрес значения в информационной базе по исходным параметрам. Для этого необходимо передать ключ объекта (это может быть
как ссылка на объект, так и ключ записи регистра сведений) и имя реквизита. Если нужно получить адрес значения, хранимого в реквизите
табличной части, то к имени реквизита в параметре, задающем имя реквизита, необходимо добавить имя табличной части и точку «.». Например: Товары.Изображение

Получение файла из информационной базы

Получение одного файла

Метод ПолучитьФайл() получает файл из информационной базы и сохраняет его в локальную файловую систему пользователя. Первый параметр определяет адрес файла в реквизите объекта информационной базы или во временном хранилище файлов. Сохранение не произойдет, если у пользователя, от имени которого выполняется операция, отсутствует право Просмотр на реквизит объекта информационной базы. Второй параметр определяет место сохранения получаемого файла. В неинтерактивном режиме необходимо указать путь. В интерактивном режиме параметр является
опциональным.
По умолчанию метод исполняется в интерактивном режиме. Это значит, что будет сформировано диалоговое окно, в котором можно указать действие с полученным файлом: запустить его или сохранить в указанное пользователем место файловой системы. Если выбран интерактивный режим, а параметр Имя файла не указан, то операция открытия файла недоступна. Метод возвращает значение типа Булево. Ложь означает, что пользователь выбрал отмену операции в диалоговом окне сохранения файлов в интерактивном режиме.

Получение набора файлов

Метод ПолучитьФайлы() позволяет получить и сохранить в локальной файловой системе пользователя несколько файлов, хранящихся в информационной базе. В качестве параметра передается список выгружаемых файлов.

// СписокФайлов – список значений, содержащий ссылки на элементы
// справочника, в котором расположены выгружаемые файлы
// Представлением списка значений является имя выгружаемого файла
МассивФайлов = Новый Массив;
Для каждого ЭлементСписка Из СписокФайлов Цикл
Файл = Новый Файл(Строка(ЭлементСписка.Значение));
ПолучаемыйФайл = Новый ОписаниеПередаваемогоФайла;
ПолучаемыйФайл.Имя = ЭлементСписка.Представление;
ПолучаемыйФайл.Хранение = ПолучитьНавигационнуюСсылку(ЭлементСписка.Значение, «Данные”);
МассивФайлов.Добавить(ПолучаемыйФайл);
КонецЦикла;
ПолученныеФайлы = Новый Массив;
Результат = ПолучитьФайлы(МассивФайлов, ПолученныеФайлы, ПутьВыгружаемыхФайлов, Ложь);
Если НЕ Результат Тогда
Сообщение = Новый СообщениеПользователю;
Сообщение.Текст = «Ошибка получения файлов!”;
Сообщение.Сообщить();
КонецЕсли;

После окончания работы метод может вернуть список реально выгруженных файлов с указанием полного имени каждого сохраненного файла.
ПРИМЕЧАНИЕ. Для использования метода ПолучитьФайлы() в веб-клиенте требуется подключение расширения работы с файлами . В случае если свойство Имя объекта ОписаниеПередаваемогоФайла содержит абсолютный путь к файлу, файл будет сохранен по этому пути, без учета параметра РасположениеФайлов.
В качестве параметра РасположениеФайлов может выступать или путь в локальной файловой системе, или объект ДиалогВыбораФайлов в режиме выбора каталога или сохранения файлов. Если в качестве значения параметра РасположениеФайлов указан объект ДиалогВыбораФайлов в режиме
сохранения файлов, то:

● диалог будет вызываться для каждого передаваемого файла, кроме тех файлов, для которых свойство Имя объекта ОписаниеПередаваемогоФайла содержит абсолютный путь;
● в качестве начального имени файла в диалоге будет использоваться значение свойства Имя объекта ОписаниеПередаваемогоФайла;
● если для какого-либо файла будет выбран отказ от сохранения, то свойство Имя объекта ОписаниеПереданногоФайла будет содержать пустую строку;
● метод ПолучитьФайлы() вернет значение Истина, если хотя бы один файл получен успешно;
● следует учитывать, что собственно получение файлов выполняется после того, как пользователь ответит на вопросы по указанию имени и пути
всех получаемых файлов;
● если у пользователя, от имени которого выполняется метод ПолучитьФайлы(), отсутствует право Просмотр хотя бы на один реквизит объекта информационной базы, откуда выполняется получение файлов – неудачей завершится вся операция.
Пример:

Если выбран интерактивный режим выбора каталога сохранения файлов, то веб-клиент будет дополнительно запрашивать разрешение на сохранение файлов, указанных с абсолютными путями. В случае неинтерактивного сохранения (путь к каталогу указан в соответствующем параметре) запрос будет выполнен для всего списка сохраняемых файлов.

Пример использования файловых методов

// Получение в интерактивном режиме файла с диска
// и помещение его во временное хранилище.
&НаКлиенте
Процедура ВыбратьФайлСДискаИЗаписать()
Перем ВыбранноеИмя;
Перем АдресВременногоХранилища;
НовыйОбъект = Объект.Ссылка.Пустая();
Если ПоместитьФайл(АдресВременногоХранилища, «”, ВыбранноеИмя, Истина) Тогда
Объект.ИмяФайла = ВыбранноеИмя;
ПоместитьФайлОбъекта(АдресВременногоХранилища);
КонецЕсли;
КонецПроцедуры
// Копирование файла из временного хранилища в реквизит
// справочника, запись объекта, удаление файла из временного
// хранилища.
&НаСервере
Процедура ПоместитьФайлОбъекта(АдресВременногоХранилища)
ЭлементСправочника = РеквизитФормыВЗначение(«Объект”);
ДвоичныеДанные = ПолучитьИзВременногоХранилища(АдресВременногоХранилища);
ЭлементСправочника.ДанныеФайла = Новый ХранилищеЗначения(ДвоичныеДанные, Новый СжатиеДанных());
Файл = Новый Файл(ЭлементСправочника.ИмяФайла);
ЭлементСправочника.ИмяФайла = Файл.Имя;
ЭлементСправочника.Записать();
Модифицированность = Ложь;
УдалитьИзВременногоХранилища(АдресВременногоХранилища);
ЗначениеВРеквизитФормы(ЭлементСправочника, «Объект”);
КонецПроцедуры
// Считывание файла из реквизита и сохранение его
// на локальном диске в интерактивном режиме.
&НаКлиенте
Процедура ПрочитатьФайлИСохранитьНаДиск()
Адрес = ПолучитьНавигационнуюСсылку(Объект.Ссылка,”ДанныеФайла”);
ПолучитьФайл(Адрес, Объект.ИмяФайла, Истина);
КонецПроцедуры

Разрешение на выполнение группы операций с файлами

При выполнении некоторых операций в веб-клиенте может потребоваться получить разрешение на несколько операций по работе с файлами.
Например, необходимо выполнить получение документа из информационной базы и затем открыть сохраненный документ с помощью ассоциированного приложения.
Для выполнения этой операции потребуется отвечать на вопрос о сохранении документа и на вопрос о необходимости запуска. Если операций будет больше, вопросов пользователю также станет больше.
Для уменьшения количества вопросов можно воспользоваться методом ЗапроситьРазрешениеПользователя(). При использовании этого метода
пользователю отображается список всех операций, которые планируется выполнить, и предлагается разрешить выполнение группы операций. Если пользователь разрешил выполнение, то запрошенные операции будут выполняться без дополнительных запросов пользователю. Если разрешение не предоставлено, операции будут выполняться в обычном режиме: один запрос на одну операцию.
ПРИМЕЧАНИЕ. Для использования метода ЗапроситьРазрешениеПользователя() в веб-клиенте требуется подключить расширение работы с файлами .
Рассмотрим пример использования метода:

Если ПодключитьРасширениеРаботыСФайлами() Тогда
Ссылка = ПолучитьНавигационнуюСсылку(Объект.Ссылка, «ДанныеФайла”);
// Формирование описания передаваемых файлов (в данном случае файл один)
ПередаваемыеФайлы = Новый Массив;
Описание = Новый ОписаниеПередаваемогоФайла(Объект.ИмяФайла, Ссылка);
ПередаваемыеФайлы.Добавить(Описание);
// Готовим объект для получения информации о полученных файлах
ПереданныеФайлы = Новый Массив;

Следует отметить несколько особенностей применения метода ЗапроситьРазрешениеПользователя().

1. Разрешение запрашивается только для следующих методов:

2. Разрешение запрашивается для конкретного набора параметров метода. Если при реальном исполнении метода работы с файлами значения параметров будут отличаться от тех, для которых получено разрешение, это разрешение не будет действовать и пользователь получит отдельный запрос на подтверждение выполнения операции.

3. Если необходимо выполнить две (или более) одинаковые операции с файлами (даже с одинаковым набором параметров), следует указать соответствующее количество элементов в массиве параметров метода ЗапроситьРазрешениеПользователя(). Например, если необходимо дважды получить из информационной базы один и тот же файл и поместить его в фиксированное место файловой системы, следует запросить разрешение
на две операции.

4. Если запрашивается разрешение на операцию, при выполнении которой выполняется интерактивная операция (например, функции ПолучитьФайлы() в качестве параметра передается объект ДиалогВыбораФайла), то такая операция исключается из запроса.

Полученные разрешения сохраняются либо до выполнения разрешенного вызова, либо до окончания исполнения встроенного языка.
ПРИМЕЧАНИЕ. В толстом и тонком клиентах ЗапроситьРазрешениеПользователя() метод всегда возвращает значение Истина, без взаимодействия с пользователем.

Работа с временным хранилищем в фоновом задании

В механизме работы с временным хранилищем есть возможность передать данные из фонового задания в сеанс, инициировавший фоновое задание.
Для такой передачи следует в родительском сеансе поместить во временное хранилище пустое значение (с помощью метода ПоместитьВоВременноеХранилище()), указав какой-либо идентификатор создаваемого временного хранилища (параметр Адрес). Затем полученный адрес передать в фоновое задание через параметры фонового задания. Далее, если в фоновом задании этот адрес использовать в качестве значения параметра Адрес метода ПоместитьВоВРеменноеХранилище(), то результат будет скопирован в сеанс, из которого было запущено фоновое задание.
Данные, помещенные во временное хранилище в фоновом задании, не будут доступны из родительского сеанса до момента завершения фонового задания.

Поддержка адресов в поле картинки

Элемент формы Поле вида Поле картинки поддерживает отображение картинки, заданной адресом значения (которое может быть картинкой или двоичными данными) во временном хранилище или в базе данных.
Для этого в свойстве Данные элемента формы необходимо задать реквизит строкового типа. Значение этого реквизита и будет интерпретироваться как адрес картинки.

// Пример 1
// Привязка поля картинки к адресу картинки во временном
// хранилище. АдресКартинки – реквизит формы строкового типа
ПоместитьФайл(АдресКартинки, ИсходноеИмя, ВыбранноеИмя, Истина, УникальныйИдентификатор);
// Пример 2
// Получение адреса картинки из реквизита объекта
// информационной базы
ФайлКартинки = Объект.ФайлКартинки;
Если Не ФайлКартинки.Пустая() Тогда
АдресКартинки = ПолучитьНавигационнуюСсылку(ФайлКартинки, «ДанныеФайла”);
Иначе
АдресКартинки = «”;
Конецесли;

Доступ к стандартным каталогам

При использовании системы требуется некоторое место в файловой системе, где можно хранить различные файловые данные, которые с одной стороны являются временными, а с другой – должны храниться достаточно длительное время. К таким файлам можно отнести черновики для систем управления документооборотом, внешние компоненты, работающие на стороне клиентского компьютера и т. д.
Для хранения таких файлов предназначен специальный каталог, который привязан к конкретному пользователю конкретной информационной базы.
Один и тот же пользователь, работающий с двумя информационными базами, будет иметь доступ к двум разным каталогам хранения данных пользователя. Местоположение данного каталога определяется с помощью метода РабочийКаталогДанныхПользователя(). Если каталог отсутствует, то он создается при первом обращении к нему. Если создание каталога невозможно – система вызывает исключение.
ПРИМЕЧАНИЕ. Метод РабочийКаталогДанныхПользователя()не доступен на стороне сервера.
В операционной системе имеется специальный каталог, выделенный для постоянного хранения данных пользователя. Это могут быть какие-то
отчеты, печатные формы документов и т. д. В этот каталог помещаются данные, которые в дальнейшем могут быть отправлены внешним
потребителям. Для доступа к этому каталогу предназначен метод КаталогДокументов(). Физическое расположение каталога зависит от операционной
системы, где исполняется приложение и приведено в синтакс-помощнике.