Как прикрепить путь к фотографии в документе 1С и открывать её по кнопке

← На главную

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

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

Шаг 1. Создание реквизита для хранения пути

Для начала проанализируем, какой тип данных необходим для хранения пути к файлу. Путь к файлу — это текстовая строка. Рассмотрим подробнее особенности настройки этого реквизита в конфигураторе:

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

Шаг 2. Размещение и настройка элемента управления на форме

Пользователю должно быть удобно работать с новым полем. Ввод пути вручную с клавиатуры или обычное копирование из проводника крайне непрактичны. Нам необходимо настроить интерфейс так, чтобы пользователь мог нажать на кнопку выбора (три точки), выбрать нужный файл в диалоговом окне Windows, а система сама записала полный путь в созданный реквизит.

Выясним по шагам, как настроить элемент формы:

Откроем форму документа в редакторе форм.
Перетащим наш реквизит ПутьКФото на форму, чтобы создалось поле ввода.
Откроем палитру свойств созданного поля ввода.
Найдем свойство КнопкаВыбора и установим его значение в Истина. Это действие добавит к полю ввода привычную кнопку с тремя точками.
Для реализации открытия файла по кнопке мы также включим свойство КнопкаОткрытия, установив его в значение Истина. Это добавит кнопку с изображением лупы.

Шаг 3. Реализация интерактивного выбора файла

Теперь напишем обработчик события нажатия на кнопку выбора (три точки). Нам потребуется использовать стандартный объект платформы ДиалогВыбораФайла.

Создадим событие НачалоВыбора для нашего поля ввода на форме. Ниже приведен детальный пример программного кода, который решает эту задачу:


Процедура ПутьКФотоНачалоВыбора(Элемент, СтандартнаяОбработка)
    
    // Отменяем стандартное поведение платформы, чтобы запустить свой алгоритм
    СтандартнаяОбработка = Ложь; 
    
    // Инициализируем диалог выбора в режиме открытия одного файла
    Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Открытие);
    Диалог.Заголовок = "Выберите файл фотографии";
    
    // Настраиваем фильтр файлов, чтобы скрыть лишние форматы
    Диалог.Фильтр = "Изображения (*.jpg;*.png;*.bmp)|*.jpg;*.png;*.bmp|Все файлы (*.*)|*.*"; 
    Диалог.МножественныйВыбор = Ложь;
    
    // Отображаем диалог пользователю
    Если Диалог.Выбрать() Тогда
        // Записываем полученный путь обратно в реквизит нашего документа
        ЭтотОбъект.ПутьКФото = Диалог.ПолноеИмяФайла; 
    КонецЕсли;

КонецПроцедуры

В этом коде мы использовали метод Выбрать(), который останавливает исполнение потока и ожидает выбора пользователя. Если пользователь выбрал файл и нажал "Открыть", метод возвращает истину, и мы извлекаем полный путь через свойство ПолноеИмяФайла.

Шаг 4. Открытие файла во внешнем приложении Windows

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

Для этого мы привяжемся к событию Открытие нашего поля ввода. Платформа 1С предоставляет системную функцию ЗапуститьПриложение(). Она позволяет открыть любой зарегистрированный в операционной системе документ через ассоциированное с ним приложение по умолчанию.

Рассмотрим пример кода обработчика события открытия:


Процедура ПутьКФотоОткрытие(Элемент, СтандартнаяОбработка)
    
    // Отменяем стандартное поведение системы
    СтандартнаяОбработка = Ложь;
    
    // Проверим, заполнено ли поле пути
    Если Не ЗначениеЗаполнено(ЭтотОбъект.ПутьКФото) Тогда
        Предупреждение("Путь к фотографии не указан!");
        Возврат;
    КонецЕсли;
    
    // Выполним проверку физического существования файла на диске
    ПроверяемыйФайл = Новый Файл(ЭтотОбъект.ПутьКФото);
    Если ПроверяемыйФайл.Существует() Тогда
        // Запускаем внешнее приложение, ассоциированное с расширением файла
        Попытка
            ЗапуститьПриложение(ЭтотОбъект.ПутьКФото);
        Исключение
            Сообщить("Не удалось открыть файл: " + ОписаниеОшибки(), СтатусСообщения.Важное);
        КонецПопытки;
    Иначе
        Предупреждение("Файл по указанному пути не найден или доступ к нему ограничен!");
    КонецЕсли;

КонецПроцедуры

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

Шаг 5. Работа в клиент-серверном режиме и сетевые папки

Проанализируем крайне важную архитектурную проблему, возникающую в клиент-серверных базах данных. Если пользователи запускают систему с разных физических компьютеров, то хранение локальных путей вида C:\MyPhotos\photo.jpg приведет к ошибкам доступа у всех коллег, кроме автора записи.

Существует два основных способа решения этой проблемы:

Использование UNC-путей (сетевых папок): Все фотографии должны храниться в общей папке на сервере, к которой предоставлен общий сетевой доступ. Путь к такому файлу выглядит следующим образом: \\ИмяСервера\ОбщаяПапка\фото.jpg. У всех пользователей 1С должны быть настроены права доступа (чтение/запись) к этой сетевой папке на уровне операционной системы Windows.
Автоматическое копирование файлов в общее хранилище: Мы можем запрограммировать систему так, чтобы при выборе любого локального файла программа автоматически копировала его на сетевой ресурс и записывала в реквизит документа уже сетевой UNC-путь.

Разберем, как модифицировать процедуру выбора файла для автоматического копирования в сетевой каталог:


Процедура ПутьКФотоНачалоВыбораСКопированием(Элемент, СтандартнаяОбработка)
    
    СтандартнаяОбработка = Ложь;
    
    Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Открытие);
    Диалог.Заголовок = "Выберите файл для загрузки в хранилище";
    Диалог.Фильтр = "Изображения (*.jpg;*.png)|*.jpg;*.png";
    
    Если Диалог.Выбрать() Тогда
        
        ЛокальныйПуть = Диалог.ПолноеИмяФайла;
        ВыбранныйФайл = Новый Файл(ЛокальныйПуть);
        
        // Определяем сетевой каталог для хранения фото документов
        СетевойКаталог = "\\FileServer\SharedPhotos\Documents\";
        
        // Формируем имя файла-приемника во избежание конфликтов имен (например, добавляя код или номер документа)
        ИмяФайлаПриемника = ЭтотОбъект.Номер + "_" + ВыбранныйФайл.Имя;
        РезультирующийСетевойПуть = СетевойКаталог + ИмяФайлаПриемника;
        
        Попытка
            // Убедимся, что целевая папка существует
            СоздатьКаталог(СетевойКаталог);
            
            // Копируем файл средствами платформы 1С
            КопироватьФайл(ЛокальныйПуть, РезультирующийСетевойПуть);
            
            // Записываем сетевой путь в документ
            ЭтотОбъект.ПутьКФото = РезультирующийСетевойПуть;
            Сообщить("Файл успешно скопирован в сетевое хранилище.");
        Исключение
            Сообщить("Ошибка при копировании файла в сетевую папку: " + ОписаниеОшибки(), СтатусСообщения.Важное);
        КонецПопытки;
        
    КонецЕсли;

КонецПроцедуры

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

Шаг 6. Отображение картинки прямо на форме 1С

Давайте сделаем интерфейс еще более удобным. Намного приятнее, когда пользователь видит фотографию сразу при открытии документа прямо в окне 1С, без необходимости запускать сторонние программы просмотра.

В обычных формах для этого используется элемент управления ПолеКартинки. Разберем по шагам, как это реализовать:

Добавим на форму элемент управления типа ПолеКартинки и дадим ему имя ДекорацияФото.
В свойствах этого поля установим параметр РазмерКартинки в значение Пропорционально. Это позволит масштабировать любые фотографии под физический размер созданной рамки без искажения пропорций изображения.
Напишем процедуру для динамической загрузки картинки из файла:


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

Осталось настроить вызов этой процедуры в ключевых точках жизненного цикла формы:

В обработчике события формы ПриОткрытии — чтобы при открытии уже сохраненного документа картинка загружалась автоматически.
В обработчике события ПриИзменении поля ввода пути — чтобы изображение мгновенно менялось сразу после того, как пользователь выбрал новый файл.

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

← На главную