Обмен 1С с сайтом. Расширенная выгрузка на сайт Битрикс. HTML-описание номенклатуры: заполнение и выгрузка на сайт Битрикс

Расширения не предназначены для модуля обмена Битрикс 8.х.!

ВОЗМОЖНОСТИ

• После установки расширения на форме номенклатуры появляется кнопка редактирования описания номенклатуры в html-редакторе. Редактор позволяет форматировать текст описания (шрифт, заливка, списки, таблицы и т.д.), добавлять картинки.

• Описание в формате html выгружается на сайт Битрикс с помощью модуля обмена Битрикс.

ОСОБЕННОСТИ

• Редактор html сохраняет описания в виде присоединённых файлов номенклатуры с наименованием «_html-описание номенклатуры_». Это обычные текстовые присоединённые файлы.

• Присоединённые файлы описаний хранятся непосредственно в базе независимо от выбранного режима хранения файлов («в базе / в томах на диске»).
• Редактор html реализован с помощью внешнего редактора TinyMCE
• Типовой реквизит номенклатуры «Описание» не затрагивается.
• При выгрузке html-описания проверяется его заполненность. Если оно не заполнено, в качестве описания выгружается значение типового реквизита номенклатуры "Описание".
• Картинки встраиваются в тело html.

Технические требования

Расширения не предназначены для модуля обмена Битрикс 8.х.

• Расширения тестировались на:
• - конфигурациях «Управление торговлей» версий 11.5.8.267, 11.4.6.200 и и 11.3.4.103. Расширения в конфигурации УТ 11.3.4.103 работают при условии, что режим совместимости конфигурации изменён с 8.3.8 на 8.3.9 и выше (в том числе режим "Не использовать")
• - модулях обмена Битрикс версий 7.0.1.6, 7.0.1.17, 7.0.2.11.

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

• Расширения предназначены для конфигураций с режимом совместимости не ниже 8.3.9 (или с режимом совместимости «Не использовать»). Если режим совместимости вашей конфигурации ниже 8.3.9, мы можем перенести функционал расширений в вашу конфигурацию.
• Расширения работают только при условии, что обмен с сайтом выполняется с помощью модуля обмена Битрикс.
• Версия модуля обмена Битрикс должна быть не ниже 7.0.0.0, т.к. в этой версии появилась возможность задавать свой алгоритм выгрузки стандартных реквизитов без необходимости вносить изменения в конфигурацию. Этот механизм используется для выгрузки html-описания вместо типового описания. Если версия вашего модуля обмена ниже 7.0.0.0, мы можем перенести функционал выгрузки описания в вашу конфигурацию.
• Расширения НЕ работают с типовым модулем обмена, который включён в поставку конфигурации.
• Редактор html реализован с помощью внешнего редактора TinyMCE. Вы можете проверить функциональные возможности редактора с помощью бесплатной обработки «ТестРедакторHTML.epf», которая прикреплена к публикации.

Расширение предназначено для заполнения html-описаний номенклатуры в 1С и выгрузки этих описаний на сайт Битрикс.

Обработка тестировалась на платформе 8.3 и конфигурациях:

• УТ 11.3.4.103 (в режиме совместимости конфигурации 8.3.9)
• УТ 11.4.6.200
• УТ 11.5.8.267
• Управление нашей фирмой 3.0.1.255
• Управление нашей фирмой 3.0.5.183

Обработка тестировалась на модулях обмена Битрикс:

• 7.0.1.6
• 7.0.1.17
• 7.0.2.11

Внимание! На сайте Битрикс https://1c.1c-bitrix.ru/ecommerce/download.php поддержка 7-й версии только до версии УТ11.5.8.

Если Вы будете обновлять УТ до 11.5.9 - могут быть проблемы с Битриксом. Финальной 8й версии до сих пор нет.

Состав поставки

Включает архив, внутри которого находятся:

• Расширение «ГИ_HTMLОписаниеНоменклатуры.cfe» - включает функционал по заполнению описания номенклатуры в формате html.
• Расширение «ГИ_РасширениеМодуляОбменаССайтом_ОбщегоНазначения_HTMLОписания.cfe» - включает дополнительный функционал для выгрузки html-описания на сайт. Это расширение необходимо подключать, если вам нужно выгружать html-описания на сайт.
• Текстовый файл «Код выгрузки описания.txt» - программный код, который необходимо указать в настройках модуля обмена с сайтом Битрикс. Это необходимо сделать, если вам нужно выгружать html-описания на сайт.

Также публикация включает бесплатную обработку «ТестРедакторHTML.epf», с помощью которой вы можете проверить функциональные возможности редактора html. 

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

НАСТРОЙКА ВЫГРУЗКИ HTML-ОПИСАНИЙ НА САЙТ

Для выгрузки html-описаний номенклатуры на сайт необходимо:

• Установить расширение «ГИ_РасширениеМодуляОбменаССайтом_ОбщегоНазначения_HTMLОписания.cfe»
• Указать в настройках модуля обмена программный код из файла «Код выгрузки описания.txt»:

Код алгоритма для конфигурации УНФ: 

ГИ_НаменованиеФайлаСОписанием = "_html-описание номенклатуры_";

ГИ_ЗначенияОписанийНоменклатуры = Новый Соответствие();

ГИ_НужноСформироватьТаблицуОписаний = Ложь;
Если ПараметрыОбмена.Свойство("ГИ_ЗначенияОписанийНоменклатуры") Тогда
    
    Если ПараметрыОбмена.ГИ_ЗначенияОписанийНоменклатуры[ [Номенклатура] ] = Неопределено Тогда
        ГИ_НужноСформироватьТаблицуОписаний = Истина;
    Иначе
        ГИ_ЗначенияОписанийНоменклатуры = ПараметрыОбмена.ГИ_ЗначенияОписанийНоменклатуры;
    КонецЕсли;
    
Иначе
    ГИ_НужноСформироватьТаблицуОписаний = Истина;
КонецЕсли;

Если ГИ_НужноСформироватьТаблицуОписаний Тогда    
    
    ГИ_ПараметрыКонфигурации = ГИHTML_ОбщегоНазначения.ПолучитьПараметрыКонфигурации();

    Запрос = Новый Запрос;
    Запрос.УстановитьПараметр("ГИ_НаменованиеФайлаСОписанием", ГИ_НаменованиеФайлаСОписанием);
    Запрос.МенеджерВременныхТаблиц = [МенеджерВременныхТаблиц];
    Запрос.Текст = "
    |ВЫБРАТЬ
    |    Ссылка,
    |    ВладелецФайла КАК Номенклатура
    |ПОМЕСТИТЬ
    |    ГИ_ФайлыОписаний
    |ИЗ
    |    Справочник.НоменклатураПрисоединенныеФайлы
    |ГДЕ
    |    ВладелецФайла В (ВЫБРАТЬ Номенклатура ИЗ ВремНоменклатура)
    |        И
    |    Наименование = &ГИ_НаменованиеФайлаСОписанием
    |ИНДЕКСИРОВАТЬ ПО
    |    Ссылка
    |;
    |
    |ВЫБРАТЬ
    |    ФайлыОписаний.Номенклатура КАК Номенклатура,
    |    ДвоичныеДанныеФайлов." + ГИ_ПараметрыКонфигурации.ИмяРесурсаХранимыйФайл + " КАК ДвоичныеДанные
    |ПОМЕСТИТЬ
    |    ГИ_ФайлыОписанийДвоичныеДанные
    |ИЗ
    |    ГИ_ФайлыОписаний КАК ФайлыОписаний
    |    ВНУТРЕННЕЕ СОЕДИНЕНИЕ
    |    РегистрСведений." + ГИ_ПараметрыКонфигурации.ИмяРегистраПрисоединенныеФайлы + " КАК ДвоичныеДанныеФайлов
    |    ПО
    |        ДвоичныеДанныеФайлов." + ГИ_ПараметрыКонфигурации.ИмяИзмеренияПрисоединенныйФайл + " = ФайлыОписаний.Ссылка    
    |ИНДЕКСИРОВАТЬ ПО
    |    Номенклатура    
    |;
    |
    |ВЫБРАТЬ
    |    СпрНоменклатура.Ссылка КАК Номенклатура,
    |    СпрНоменклатура.Комментарий КАК ТиповоеОписание,
    |    ФайлыОписанийДвоичныеДанные.ДвоичныеДанные КАК ДвоичныеДанныеФайлаОписания,
    |    ( ФайлыОписанийДвоичныеДанные.ДвоичныеДанные ЕСТЬ NULL ) КАК ВыгружатьТиповоеОписание
    |ИЗ
    |    Справочник.Номенклатура КАК СпрНоменклатура
    |    
    |    ВНУТРЕННЕЕ СОЕДИНЕНИЕ
    |    ВремНоменклатура КАК ВремНоменклатура
    |    ПО
    |        ВремНоменклатура.Номенклатура = СпрНоменклатура.Ссылка
    |        
    |    ЛЕВОЕ СОЕДИНЕНИЕ
    |    ГИ_ФайлыОписанийДвоичныеДанные КАК ФайлыОписанийДвоичныеДанные
    |    ПО
    |        ФайлыОписанийДвоичныеДанные.Номенклатура = СпрНоменклатура.Ссылка
    |;";
    
    Выборка = Запрос.Выполнить().Выбрать();
    Пока Выборка.Следующий() Цикл
    
        ГИ_Описание = Неопределено;
        Если Выборка.ВыгружатьТиповоеОписание Тогда
            ГИ_Описание = Выборка.ТиповоеОписание;
        Иначе
            ГИ_Описание = ПолучитьСтрокуИзДвоичныхДанных(Выборка.ДвоичныеДанныеФайлаОписания.Получить(), КодировкаТекста.Системная);    
        КонецЕсли;

        ГИ_ЗначенияОписанийНоменклатуры.Вставить(
            Выборка.Номенклатура,
            ГИ_Описание
        );
        
    КонецЦикла;
    
    ПараметрыОбмена.Вставить("ГИ_ЗначенияОписанийНоменклатуры", ГИ_ЗначенияОписанийНоменклатуры);
    
КонецЕсли;

[Результат] = ГИ_ЗначенияОписанийНоменклатуры[ [Номенклатура] ];