Коллекция картинок в 1С: что это, где хранится и как работать с графикой в конфигурациях

В системе 1С:Предприятие термин «коллекция картинок» часто вызывает вопросы у начинающих разработчиков и пользователей. Это не отдельный модуль или внешняя обработка, а встроенный механизм для хранения и управления графическими файлами прямо внутри конфигурации. Коллекция позволяет привязывать изображения к объектам метаданных — будь то справочники, документы, отчёты или даже элементы интерфейса (кнопки, пиктограммы).

На практике это означает, что вы можете добавить логотип компании в печатную форму счета, иконку для пользовательской команды или иллюстрацию к товару в справочнике — и все эти файлы будут храниться не на диске, а непосредственно в базе данных 1С. Главное преимущество: картинки становятся частью конфигурации и автоматически переносятся при обновлении или выгрузке/загрузке базы, что избавляет от необходимости вручную копировать файлы на каждый рабочий компьютер.

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

Что такое коллекция картинок в 1С и зачем она нужна

Коллекция картинок — это специализированный объект в дереве метаданных 1С, предназначенный для централизованного хранения графических файлов. Его основная задача — обеспечить доступ к изображениям из любого места конфигурации без привязки к физическим путям на диске. Например, если вы разрабатываете отчёт с логотипом компании, то вместо того, чтобы указывать путь вида C:\Images\logo.png (что не сработает на другом компьютере), вы просто ссылаетесь на картинку из коллекции по её имени.

Преимущества такого подхода:

• 📦 Портативность: изображения переносятся вместе с конфигурацией при обновлении или передаче базы.
• 🔒 Безопасность: файлы хранятся внутри базы, их нельзя случайно удалить или подменить извне.
• 🔄 Версионность: при изменении картинки старая версия остаётся в истории конфигурации (если используется система контроля версий).
• 🎨 Унификация: все изображения доступны в одном месте, что упрощает их управление.

Коллекция поддерживает основные графические форматы: .bmp, .jpg, .png, .gif и .tiff. Однако есть ограничения: например, анимированные GIF будут отображаться как статичные, а прозрачность в PNG может не поддерживаться в старых версиях платформы. Также

Где хранится коллекция картинок физически

Физически картинки из коллекции хранятся внутри файла конфигурации (.cf) или непосредственно в базе данных (для файловых и клиент-серверных вариантов). Это означает, что:

• 📂 В файловом варианте 1С изображения записаны в бинарном виде в таблицах базы (1Cv8.1CD).
• 🖥️ В клиент-серверном варианте картинки хранятся в соответствующих таблицах СУБД (например, в Microsoft SQL Server или PostgreSQL).
• 🔄 При выгрузке/загрузке конфигурации через Конфигуратор изображения автоматически переносятся вместе с метаданными.

Чтобы увидеть список всех картинок в коллекции, откройте Конфигуратор и перейдите в ветку метаданных: Общие → КоллекцияКартинок. Здесь отобразятся все добавленные изображения с указанием их имён и размеров. Обратите внимание: имена картинок чувствительны к регистру! То есть Logo.png и logo.PNG — это два разных объекта.

⚠️ Внимание: если вы удалите картинку из коллекции, все ссылки на неё в конфигурации (например, в печатных формах или формах документов) станут неработоспособными. Перед удалением проверьте, где используется изображение, с помощью отчёта Поиск ссылок на объект (доступно в Конфигураторе через контекстное меню картинки).

Как добавить картинку в коллекцию: пошаговая инструкция

Добавление изображения в коллекцию осуществляется через Конфигуратор. Вот подробный алгоритм:

1. Откройте конфигурацию в режиме Конфигуратор (с правами администратора).
2. В дереве метаданных найдите ветку Общие → КоллекцияКартинок. Если её нет — создайте (см. совет выше).
3. Кликните правой кнопкой по коллекции и выберите Добавить.
4. В открывшемся окне укажите:
   • 📌 Имя (латиницей, без пробелов, например CompanyLogo).
   • 🖼️ Файл — путь к изображению на диске (поддерживаются форматы BMP, JPG, PNG, GIF).
   • 📝 Комментарий (необязательно, но полезно для документации).
5. Нажмите ОК — картинка будет добавлена в коллекцию.

☑️ Проверка перед добавлением картинки

Файл имеет поддерживаемый форматИмя уникально (нет дублей)Размер файла не превышает 2 МБКартинка оптимизирована (нет лишних метаданных)

Выполнено: 0 / 4

После добавления изображение можно использовать в:

• 📄 Печатных формах (например, логотип в шаблоне документа).
• 🖥️ Формах (иконки кнопок, фоновые изображения).
• 📊 Отчётах (графические элементы диаграмм).
• 📋 Справочниках (миниатюры товаров).

⚠️ Внимание: если вы добавляете картинку в коллекцию для управляемого приложения (например, для веб-клиента), убедитесь, что её размер не превышает 2 МБ. В противном случае возможны ошибки при загрузке формы в браузере. Для больших изображений используйте внешние хранилища (например, HTTP-ресурсы).

Как получить доступ к картинке из встроенного языка 1С

Для работы с изображениями из коллекции в 1С:Предприятие 8 используется объект Картинка. Чтобы загрузить картинку из коллекции в код, используйте метод ПолучитьИзКоллекции(). Пример:

// Получаем картинку по имени из коллекции
КартинкаОбъект = Картинки.ПолучитьИзКоллекции("CompanyLogo");

// Отображаем картинку в форме
ЭлементыФормы.ИзображениеЛоготипа.Картинка = КартинкаОбъект;

Если нужно динамически подгрузить картинку (например, в зависимости от условий), используйте конструкцию:

ИмяКартинки = ?(Условие, "Logo1", "Logo2");
Если Картинки.НайтиПоИмени(ИмяКартинки) <> Неопределено Тогда
Картинка = Картинки.ПолучитьИзКоллекции(ИмяКартинки);
КонецЕсли;

Для сохранения картинки во внешний файл (например, для экспорта) используйте метод Записать():

КартинкаОбъект.Записать("C:\Temp\ExportedLogo.png");

⚠️ Внимание: при работе с картинками в тонком клиенте или веб-клиенте некоторые методы (например, Записать()) могут быть недоступны из-за ограничений безопасности. В таких случаях используйте серверные процедуры или временные файлы.

Как проверить, существует ли картинка в коллекции?

Используйте метод Картинки.НайтиПоИмени("ИмяКартинки"). Если он возвращает Неопределено, картинки нет. Это безопаснее, чем ловить исключение при попытке получить несуществующее изображение.

Типичные ошибки при работе с коллекцией картинок

Даже опытные разработчики сталкиваются с проблемами при использовании коллекции. Вот наиболее распространённые ошибки и способы их решения:

Ошибка	Причина	Решение
Картинка не найдена в коллекции	Опечатка в имени или картинка удалена	Проверьте имя через Картинки.НайтиПоИмени()
Неверный формат файла	Попытка загрузить .svg или .webp	Конвертируйте в PNG или JPG
Картинка не отображается в форме	Неверный размер элемента ПолеКартинки	Настройте свойства Растягивать и РежимОтображения
Ошибка при записи в файл	Отсутствуют права на папку или неверный путь	Используйте ПолучитьИмяВременногоФайла() для временных файлов

Ещё одна частая проблема — исчезновение картинок после обновления конфигурации. Это происходит, если:

• 🔄 Обновление выполнялось с заменой конфигурации (а не слиянием).
• 🗑️ Картинки были добавлены в расширение, которое отключили.
• 🛠️ В новой версии конфигурации коллекция картинок переопределена.

Чтобы избежать потери изображений, всегда:

1. Сохраняйте резервную копию коллекции (экспортируйте картинки в файл через Конфигуратор).
2. Используйте систему контроля версий (например, Git для .cf-файлов).
3. Документируйте изменения в коллекции (ведите журнал добавленных/удалённых картинок).

Альтернативы коллекции картинок: когда её лучше не использовать

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

• 📈 Большой объём графики: если в системе сотни высококачественных изображений (например, фотографии товаров), коллекция раздует размер базы. В таких случаях используйте:
• 🖼️ Внешнее хранилище (папка на диске или сетевой ресурс) с привязкой путей в справочниках.
• 🌐 HTTP-ресурсы (картинки хранятся на веб-сервере, в 1С подгружаются по URL).
• 🗃️ Специализированные обработки (например, "Хранилище файлов" от 1С-Битрикс).
• 🔄 Частые обновления изображений: если картинки меняются ежедневно (например, акционные баннеры), их проще хранить вне базы.
• 📱 Мобильные приложения: для 1С:Мобильная платформа коллекция картинок может быть неоптимальна из-за ограничений на размер базы.

Пример кода для загрузки картинки по URL (альтернатива коллекции):

// Загружаем картинку по ссылке и отображаем в форме
HTTPСоединение = Новый HTTPСоединение("www.example.com");
HTTPЗапрос = Новый HTTPЗапрос("/images/logo.png");
HTTPОтвет = HTTPСоединение.Получить(HTTPЗапрос);
Картинка = Новый Картинка(HTTPОтвет.ПолучитьТелоКакДвоичныеДанные());
ЭлементыФормы.Изображение.Картинка = Картинка;

⚠️ Внимание: при использовании внешних файлов убедитесь, что:

• 🔐 Пути к файлам относительные (например, .\Images\logo.png), а не абсолютные (C:\..).
• 📂 Папка с изображениями доступна всем пользователям (настройте права на сетевой ресурс).
• 🔄 Предусмотрен механизм синхронизации файлов при обновлении системы.

Практические примеры использования коллекции картинок

Разберём реальные сценарии, где коллекция картинок незаменима:

1. Логотип компании в печатных формах:

   Добавьте лого в коллекцию под именем CompanyLogo, затем вставьте его в макет печатной формы (например, счета или накладной). Пример кода для вывода:

   Макет = Документы.СчетНаОплату.ПечатнаяФорма();
   Макет.Картинка = Картинки.ПолучитьИзКоллекции("CompanyLogo");
   Результат = Макет.Получить();

2. Иконки для пользовательских команд:

   Создайте в коллекции иконки для кнопок (например, IconAdd, IconDelete) и привяжите их к командам через свойство Картинка в Конфигураторе.

3. Фоновое изображение для формы:

   В свойствах формы укажите картинку из коллекции как фон (ФоновоеИзображение). Это полезно для брендирования интерфейса.

4. Миниатюры товаров в справочнике:

   Свяжите картинки с элементами справочника "Номенклатура", используя реквизит типа ХранилищеЗначения (для хранения ссылки на имя картинки в коллекции).

Для динамической смены картинок (например, в зависимости от статуса документа) используйте следующий подход:

Статус = Документ.Статус;
ИмяКартинки = ?(
Статус = Перечисления.СтатусыДокумента.Оплачен,
"IconPaid",
Статус = Перечисления.СтатусыДокумента.Отменен,
"IconCanceled",
"IconDefault"
);
ЭлементыФормы.ИндикаторСтатуса.Картинка = Картинки.ПолучитьИзКоллекции(ИмяКартинки);

FAQ: Частые вопросы о коллекции картинок в 1С

Для Каждого КартинкаИзКоллекции Из Картинки Цикл
ИмяФайла = "C:\Export\" + КартинкаИзКоллекции.Имя + ".png";
КартинкаИзКоллекции.Картинка.Записать(ИмяФайла);
КонецЦикла;