Прикрепление внешних файлов к документам и справочникам 1С 8.3 (управляемые формы)




Принцип обмена данными из 1С с сайтом (на MySQL) и выдачи (публикации) этих данных по запросу.
PHP-Скрипт автоматической загрузки данных из файла данных в формате CSV в базу данных сайта работающего на WordPress.

В продолжение моей темы: 1С:Альфа-Авто Автосалон Автосервис: обмен с сайтом.
С помощью данного скрипта можно загружать в автоматическом режиме, по расписанию, данные сервисных книжек (ремонтов авто) из 1С:Альфа-Авто Автосалон Автосервис.
Также можно загружать данные в ручном режиме: для этого делается скрытая страница, где размещается специальная кнопка.
Комментарии размещенные внутри скрипта разъяснят логику и порядок действия.
Комментарии с "/////    echo" использовались для отладки.
Дополнительно создана таблица для журналирования результатов загрузки данных.
Скрипт включает в себя защиту от SQL инъекций (думаю безопасность соблюдена в полной мере).
В кратце:
1. Пишется скрипт, который запускает этот.
2. Создается регламентное задание в WordPress, по которому запускается скрипт из п.1. 
3. Этот скрипт осуществляет проверку на существование файла обмена в папке.
4. Если данные не новые, загрузка не производится.
5. Если данные новые, очищается таблица сервисных книжек.
6. Загружаются новые данные.

Собственно сам скрипт:

<?php // Полная загрузка сервисных книжек, создан 2025-01-05 12:44:55

global $wpdb2;
global $failure;
global $file_hist;

/////  echo '<H2><b>Старт загрузки</b></H2><br>';

$failure=FALSE;
//подключаемся к базе
$wpdb2 = include_once 'connection.php'; ; // подключаемся к MySQL
// если не удалось подключиться, и нужно оборвать PHP с сообщением об этой ошибке
if (!empty($wpdb2->error))
{
/////   echo '<H2><b>Ошибка подключения к БД, завершение.</b></H2><br>';
$failure=TRUE;
wp_die( $wpdb2->error );
}

$m_size_file=0;
$m_mtime_file=0;
$m_comment='';
/////проверка существования файлов выгрузки из 1С
////файл выгрузки сервисных книжек
$file_hist = ABSPATH.'/_1c_alfa_exchange/AA_hist.csv';
if (!file_exists($file_hist))
{
/////   echo '<H2><b>Файл обмена с сервисными книжками не существует.</b></H2><br>';
$m_comment='Файл обмена с сервисными книжками не существует';
$failure=TRUE;
}

/////инициируем таблицу лога
/////если не существует файла то возврат и ничего не делаем
if ($failure){
///включает защиту от SQL инъекций и данные можно передавать как есть, например: $_GET['foo']
/////   echo '<H2><b>Попытка вставить запись в лог таблицу</b></H2><br>';
$insert_fail_zapros=$wpdb2->insert('vin_logs', array('time_stamp'=>time(),'last_mtime_upload'=>$m_mtime_file,'last_size_upload'=>$m_size_file,'comment'=>$m_comment));
wp_die();
/////    echo '<H2><b>Возврат в начало.</b></H2><br>';
return $failure;
}
/////проверка лога загрузки, что бы не загружать тоже самое
$masiv_data_file=stat($file_hist);   ////передаем в массив свойство файла
$m_size_file=$masiv_data_file[7];    ////получаем размер файла
$m_mtime_file=$masiv_data_file[9];   ////получаем дату модификации файла
////создаем запрос на получение последней удачной загрузки
////выбираем по штампу времени создания (редактирования) файла загрузки AA_hist.csv, $m_mtime_file

/////   echo '<H2><b>Размер файла: '.$m_size_file.'</b></H2><br>';
/////   echo '<H2><b>Штамп времени файла: '.$m_mtime_file.'</b></H2><br>';
/////   echo '<H2><b>Формирование запроса на выборку из лога</b></H2><br>';
////препарируем запрос
$text_zaprosa=$wpdb2->prepare("SELECT * FROM `vin_logs` WHERE `last_mtime_upload` = %s", $m_mtime_file);
$results=$wpdb2->get_results($text_zaprosa);

if ($results)
{   foreach ( $results as $r)
{
////если штамп времени и размер файла совпадают, возврат
if (($r->last_mtime_upload==$m_mtime_file) && ($r->last_size_upload==$m_size_file))
{////echo '<H2><b>Возврат в начало, т.к. найдена запись в логе.</b></H2><br>';
$insert_fail_zapros=$wpdb2->insert('vin_logs', array('time_stamp'=>time(),'last_mtime_upload'=>$m_mtime_file,'last_size_upload'=>$m_size_file,'comment'=>'Загрузка отменена, новых данных нет, т.к. найдена запись в логе.'));
wp_die();
return $failure;
}
}
}
////если данные новые, пишем в лог запись о начале загрузки
/////echo '<H2><b>Попытка вставить запись о начале загрузки в лог таблицу</b></H2><br>';
$insert_fail_zapros=$wpdb2->insert('vin_logs', array('time_stamp'=>time(),'last_mtime_upload'=>0, 'last_size_upload'=>$m_size_file, 'comment'=>'Начало загрузки'));

////очищаем таблицу
$clear_tbl_zap=$wpdb2->prepare("TRUNCATE TABLE %s", 'vin_history');
$clear_tbl_zap_repl=str_replace("'","`",$clear_tbl_zap);
$results=$wpdb2->query($clear_tbl_zap_repl);
/////   echo '<H2><b>Очистка таблицы сервисных книжек</b></H2><br>';
if (empty($results))
{
/////   echo '<H2><b>Ошибка очистки таблицы книжек, завершение.</b></H2><br>';
//// если очистка не удалась, возврат
$failure=TRUE;
wp_die();
return $failure;
}

////загружаем данные
$table='vin_history';         // Имя таблицы для импорта
//$file_hist Имя CSV файла, откуда берется информация     // (путь от корня web-сервера)
$delim=';';          // Разделитель полей в CSV файле
$enclosed='"';      // Кавычки для содержимого полей
$escaped='\

27 Comments

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

    Хранение произвольных данных в конфигурации(сканов, фотографий, документов и тд) не самый хороший вариант.

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

    Смотрю базу размер 76 Гб. База на SQL сервере. Какой то талантливый парень дописал хранение документов в реквизит объекта.

    Начинаю разбираться… в итоге вес учётных данных в базе 1.5 Гб. А всё остальное натолкали пользователи, сканов, фотографий и тд . Пришлось выносить во внешнее хранилище….

    Вес некоторых фотографий доходил до 7 Мб. Натолкают 10-15 фотографий в базу… а потом у них тормозит всё….

    Reply
  2. omenfarsh

    (1) TODD22, согласен с вами полностью! Но я столкнулся с другой ситуацией, когда надо было написать конфигурацию для учета заявок и к каждой заявке прикреплять несколько документов (решения, отчет по выполнению и т.д.). При этом базу часто переносят с компьютера на компьютер и прикрепленные файлы могут просто остаться в другом месте. Т.к. конфа была самописная и весила менее 10Мб, то мое решение оказалось вполне уместным.

    Reply
  3. 91197ch

    А мы в этих же управляемых формах сделали так: есть закладка «Файлы» в нее добавляешь файл, а он передает этот файл в секретный каталог на сервере и сохраняет внутри программы путь к этому файлу. В итоге в Базе хранятся лишь ссылка на файлы. Сами файлы в каталоге на сервере, который архивируется каждый день. И база не растет и ограничений на файлы нет. Есть правда пока нюанс. Работает только внутри сети. Если кто-то заходит через Web сервер то доступ к файлам не дается.

    Reply
  4. Franco

    1.Скриншот через «о». Но это так, к слову

    2.Хорошо было бы не привязывать 1 одному дркументу или справочнику владельцу. Сделать регистр сведений, измерения: «Ссылка на владельца» и «Ссылка на файл».

    Тогда можно 1 хранимый файл привязывать к нескольким. Это кажется лишним? Ничего подобного — у меня уже такая необходимость случилась.

    Тогда при добавлении справочника, допустим, «Номенклатура» его тип можно добавить в тип измерения.

    3.Да, программа будет жутко торможить при считывании об’екта. Но при указании ссылки на справочник файлов или при испролльзовании связывающего регистра — никак. У меня ещё и не такие монстры в наследство достались…

    4.И всё же файлы лучше хранить на диске — в справочнике файлы указывать ссылку на местоположение на сетевом диске. (у этого местоположения доступ пользователя, от которого запущен сервер 1С и недоступность пользователей). И — самое интересное — файлы легко архивировать

    5.А вот шаблоны, бланки договоров и прочее «редкое и маломеняемое» — это да, самые что ни на есть хранимые файлы

    6.Адрес временного хранилища в реквизите хранить не имеет смысла. Файл во временном хранилище живёт пока открыта форма, где он загружен.

    Reply
  5. Franco

    Забыл

    Откажитесь от «ПолучитьФайлы» и «ПоместитьФайлы» в пользу «НачатьПолучениеФайлов» и «НачатьПомещениеФайлов». Рефакторинг в конфигурации в помощь.

    Reply
  6. omenfarsh

    Спасибо всем за комментарии! Буду улучшать свой «шаблон» дальше и по возможности им поделюсь!

    Reply
  7. TODD22
    &НаСервере
    Процедура ПриЗаписиНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи)
    //Удалить файл из временного хранилища
    Если ЭтоАдресВременногоХранилища(СсылкаНаФайлВоВременномХранилище) Тогда
    УдалитьИзВременногоХранилища(СсылкаНаФайлВоВременномХранилище);
    КонецЕсли;
    КонецПроцедуры
    

    Мне кажется вот эта часть кода не нужна. Если временное хранилище привязано к форме то после закрытия формы оно будет очищено автоматически.

    И принудительно при записи объекта его большого смысла очищать нет.

    Reply
  8. wunderland

    Все равно коллега — молодец. Сделал, оформил, выложил… Понятно и доступно. А набор напильников у каждого свой 🙂

    Reply
  9. sermalp

    (3) 91197ch, А есть ли доступ к секретному каталогу для пользователя от которого агент 1С работает?

    Reply
  10. sermalp

    (1) TODD22, можете сказать оптимальное, на ваш взгляд, решение задачи — хранение файлов в локальном каталоге; и как их потом отдавать (скачать) пользователю при клике по гиперссылке, например?

    Reply
  11. MeatCrash

    А нет ли у Вас случайно такого же примера, в котором ссылки на файлы были помещены в табличную часть документа? И где их можно было выбирать и видеть куда эти ссылки указывают (с указанием пути до файла и его имени)?

    Reply
  12. HamitovaRaisa

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

    Reply
  13. omenfarsh

    (12) HamitovaRaisa, справочник с файлами не обязательно делать доступным для клиента, можно лишь оставить переход по ссылкам из формы документа или справочника. С Регистрами, если честно, не пробывал, но как минимум в Измерения нельзя добавить ХранилищеЗначения.

    Reply
  14. AnryMc
    Итак, справочник «Файлы» будет содержать два реквизита: Файл (для хранения двоичных данных), ИмяФайла (для хранения имени загруженного файла) и СсылкаНаВладельца (для привязки файла к нужному для нас документу).

    Файл + ИмяФайла + СсылкаНаВладельца <> 2 реквизита

    Reply
  15. user613332_victor241

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

    {Документ.ТестФайлы.Форма.ФормаДокумента.Форма(22)}: Ошибка при вызове метода контекста (Выполнить)

    ТЗ = Запрос.Выполнить().Выгрузить();

    по причине:

    {(5, 9)}: Таблица не найдена «КритерийОтбора.СвязанныеДокументы»

    <<?>>КритерийОтбора.СвязанныеДокументы(&ЗначениеКритерияОтбора) КАК СтруктураПодчиненности

    Reply
  16. user613332_victor241

    Приношу свои извинения, разобрался в чем дело))

    Reply
  17. omenfarsh

    (16) Отлично)))

    Reply
  18. Rebelwek

    Отличный пример! Все получилось

    Reply
  19. esqado
    И перетаскиваем в нее реквизиты так как показано на картинке ниже.

    Видимо что-то сломалось.

    Reply
  20. user778376

    На шаге «5» — И перетаскиваем в нее реквизиты так как показано на картинке ниже. Аналогично создаем еще одну такую группу с названием «Файлы» и перетаскиваем в нее «Список Документов»

    Картинки нет ; ) И тут чтот не понятно.

    Reply
  21. user797081

    Со скринами что то нет то, не показываются

    Reply
  22. deutsch2008

    на веб клиенте работает?

    Reply
  23. omenfarsh

    (22)День добрый.

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

    Reply
  24. OksanaSub

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

    Reply
  25. TyuminIS

    Хорошая статья, только, на мой взгляд, лучше хранить в регистре сведеней, тогда при удалении объекта (документа например) автоматически будут удаляться и файлы…

    Reply
  26. niktory

    Спасибо большое, очень помогли.

    Reply
  27. Jokemas

    Модальность на УФ? Зачем? Создайте справочник, киньте в него нужные реквизиты: Имя файла — имя файла с расширением, Наименование — без расширения, объект — составной тип, сюда пихаем все документы, которые будут записывать файл, ну и хранилище — хранилище значения.

    В форме самого документа создаем команду, пишем код.

    Подобный пример разбирал Павел Чистов. Это кусок из моей конфигурации.

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

    Показать

    Reply

Leave a Comment

Ваш адрес email не будет опубликован. Обязательные поля помечены *