Технология доработок типовой конфигурации 8.х для обновления за 30 минут




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

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

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

<?php // Полная загрузка сервисных книжек, создан 2024-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='\

20 Comments

  1. TMV

    (0), где упоминание расширений?

    Reply
  2. ИНТЕГРА

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

    Reply
  3. Astafan

    На счет п.3.4. не совсем понял. Можно поподробней?

    Для изменения формы использую следующий подход: делаю копию типовой и вношу туда все изменения. Новая форма открывается с помощью подписки ДокументаМенеджера на событие ОбработкаПолученияФормы.

    Reply
  4. Armando

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

    Reply
  5. Trise

    (3) Astafan, при сравнении двух модулей не понять, какие процедуры были изменены в типовой а какие просто обновление, для этого создается процедуоа где указываются все измененные процедуры.

    Reply
  6. unichkin

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

    Процедура ПриОткрытии()
    // Типовой код….
    мод_ПриОткрытии();
    
    КонецПроцедуры;
    
    // Типовой код….
    
    ////////////////////////////////////////////////////////////­//////////////////////////////
    // МОДИФИЦИРОВАННЫЕ ОБРАБОТЧИКИ СОБЫТИЙ ФОРМЫ
    Процедура мод_ПриОткрытии()
    // свой код…
    
    КонецПроцедуры;
    

    Показать

    Что это дает? То, что при обновлении конфы — если будет изменена типовая процедура в режиме сравнения объединения при объединении модулей можно смело ставить галку напротив типовой процедуры. Она будет перезатерта, ну и что — ведь конце модуля остался наш буферный вызов, из названия которого сразу ясно и понятно куда его нужно вставить! Кроме этого — сразу видно какие процедуры были изменены, и это очень удобно — не надо тратить драгоценное время на просмотр всего модуля. Тут конечно есть свои нюансы — если нужно сделать пару изменений в разных частях процедуры например. Я в таких случаях ВЕСЬ текст исходной процедуры выношу в блок «Удаленные фрагменты кода» (уфк_ПриОткрытии()), в типовой процедуре ставлю комментарий «Фрагмент изменен» — и опять вызываю свой буферный обработчик. Т.е. получается так:

    Процедура ПриОткрытии()
    
    //{[*] (фрагмент изменен)
    // уфк_ПриОткрытии()
    //———————-ЗАМЕНЕНО НА———————
    мод_ПриОткрытии();
    //}
    
    КонецПроцедуры;
    
    // Типовой код….
    
    ////////////////////////////////////////////////////////////­//////////////////////////////
    // МОДИФИЦИРОВАННЫЕ ОБРАБОТЧИКИ СОБЫТИЙ ФОРМЫ
    
    Процедура мод_ПриОткрытии()
    // свой код…
    
    КонецПроцедуры;
    
    ////////////////////////////////////////////////////////////­//////////////////////////////
    // УДАЛЕННЫЕ ФРАГМЕНТЫ КОДА
    Процедура уфк_ПриОткрытии()
    // Исходный типовой код
    КонецПроцедуры;
    

    Показать

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

    Reply
  7. Armando

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

    УстановитьДействие(«ПриОткрытии», «МойОбработчикПриОткрытии»);
    
    Процедура МойОбработчикПриОткрытии(Отказ)
    
    // вызов типового обработкчика
    ПриОткрытии(Отказ);
    
    // тут наш кот
    
    КонецПроцедуры
    

    Показать

    Reply
  8. Trise

    (2) ИНТЕГРА, Смы(6) unichkin, К сожалению не нашел статей по «мягкой» доработке. Кидайте ссылку обязательно добавлю в статью.

    Reply
  9. Trise

    (3) Astafan, На счет копии типовой формы, появится необходимость отслеживать, что в ней поменялось, что-бы перенести на копию, как боритесь с такой проблемой? Или создание копии типовой равносильно снятию типовой с поддержки?

    Reply
  10. Trise

    (4) Armando, тоже верно. Добавлю аргументов в мою пользу: это можно рассматривать как требования от Заказчика, что-бы не перетереть изменения от исполнителей, особенно, когда их несколько и исполнитель не выполняет обновление.

    Reply
  11. Trise

    (6) unichkin, Пункт 3.4 как раз нужен что-бы случайно не перезатереть типовые процедуры. Уточнил описание пункта.

    Reply
  12. unichkin

    (8)

    Методика переопределения и вызова обработчиков событий формы в 1С 8

    Методика упрощения поддержки конфигураций. Переопределение и вызов обработчиков событий для УФ 1С 8.2-8.3

    (7) Armando, можно и так — но это затрагивает область программы. И как раз на этом методе основана статья из первой ссылки. ИМХО (6) — как то нагляднее, но это конечно только мое мнение 🙂

    Reply
  13. unichkin

    (11) «чего, собственно, нигде не встречал» — ключевой момент, к сожалению. Все ведь уже придумано до нас, но об этом либо не знают, либо на это кладут. По крайней мере мой опыт говорит так. И ладно бы инфостарт — ведь есть замечательный ресурс ИТС, библия каждого 1С-ника, особенно начинающего. До кучи кину-ка я ссылку вот еще на это:

    Система стандартов и методик разработки конфигураций для платформы 1С:Предприятие 8.

    з.ы. Для тех, кто лишен доступа к ИТС существует недельный тест-драйв — это я на всякий.

    Reply
  14. Trise

    (12) unichkin, за статьи спасибо! Жалко, что только для управляемых форм подходит.

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

    Reply
  15. unichkin

    (14) «Жалко, что только для управляемых форм подходит.» — неправда ваша. Две статьи, одна для обычных, другая для УФ. В задачи стандарта входит минимизация времени понимания одним кодером «дампа подсознания» другого. А это тоже влияет на время обновления 🙂 Никакие ухищрения не помогут и не спасут, если двое делают «хорошо», но каждый по-своему.

    //

    Для объектов — дополню:

    — ни в коем случае НИКОГДА не трогать именования типовых реквизитов, это очень пагубно сказывается на времени сравненияобъединения, я уж не говорю про разработку

    — Все добавленные объекты переносить вверх соотв. ветки дерева метаданных — это во-первых оч. удобно при разработке — свои объекты всегда сверху, во вторых при том-же сравнении объединении будет меньше типовых в которых «Порядок объекта изменен»

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

    Reply
  16. maxg

    При использовании внешних программ для сравнения/объединения пункт 3.2 неактуален.

    Reply
  17. maxg

    Подробнее можно посмотреть в этом вебинаре https://www.youtube.com/watch?v=9bfKwomErfU&feature=youtu.be

    Reply
  18. b-dm

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

    Reply
  19. q_i

    Добавлю свои 5 коп. Как убедиться, что измененную конфигурацию обновили успешно и ничего не отвалилилось?

    Итак, после обновления у нас есть 4 cf-ника:

    ПоставщикСтарая — старая конфигурация поставщика;

    ПоставщикНовая — новая конфигурация поставщика — та, на которую обновляем;

    ОсновнаяСтарая — измененная конфигурация, по сути это ПоставщикСтарая с нашими изменениями;

    ОсновнаяНовая — то, что получилось после обновления ОсновнаяСтарая с помощью ПоставщикНовая.

    Теперь в двух конфигураторах сравниваем попарно:

    ПоставщикСтарая и ПоставщикНовая;

    ОсновнаяСтарая и ОсновнаяНовая.

    Для каждого сравнения конфигураций формируем полный «Отчет о сравнении объектов…» (для всех объектов конфигурации) в формате «Подробно», с подчиненными объектами метаданных (см. cmp.png) и сохраняем эти отчеты в текстовые файлы. Эти два текстовых файла сравниваем с помощью любой сравнивалки текста (я использую WinMerge). Так вот не считая технической информации, такой как номера строк с изменным/удаленным кодом и т.п., эти файлы НЕ ДОЛЖНЫ ОТЛИЧАТЬСЯ! Потому что оба отчёта показывают одно и то же — разницу, которую добавила в конфигурацию 1С.

    После этого сравниваем попарно:

    ПоставщикСтарая и ОсновнаяСтарая;

    ПоставщикНовая и ОсновнаяНовая.

    Аналогично сохраняем отчеты о сравнении в текстовые файлы и сравниваем эти текстовые файлы. Они тоже НЕ ДОЛЖНЫ ОТЛИЧАТЬСЯ! Потому что оба отчёта показывают одно и то же — разницу, которую добавили в конфигурацию мы.

    Если что-то отличается (помимо технической информации) — значит или не накатили какое-то изменение из типовой, или затерли какое-то свое изменение.

    P.S. Чтобы убрать из отчетов о сравнении неинформативный хлам (такой как номера строк с изменным/удаленным кодом и т.п.), можно выполнить в текстовых файлах с отчетами следующие замены по регекспам:

    1. Заменить что: #k8SjZc9Dxk(s*)Объект присутствует только в(.+) конфигурации: d+ — d+$

    Заменить на что: $1Объект присутствует только в$2 конфигурации: N — N

    2. Заменить что: #k8SjZc9Dxk(s*)Изменено: d+ — d+$

    Заменить на что: $1Изменено: N — N

    P.P.S. Если кому нужно — могу выложить эти замены в виде макроса для Notepad++

    Reply
  20. Dr.ZIG

    В своих разработках использую все рекомендации из статьи, только допёр до них самостоятельно. Дополню:

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

    2) для добавления предопределённых элементов можно использовать дополнительный справочник «ПредопределённыеЭлементы», с одним лишь реквизитом «Значение», имеющий тип значения «Любая ссылка», соответственно можно к нему и через код и через запросы обращаться, получая значение из соответствующего реквизита, например, «Справочники.ПредопределённыеЭлементы.Контрагенты_ОсновнойКонтаргент.Значение» — вернёт заранее заданный элемент справочника контрагенты Или в запросе через соединение с этим справочником используя конструкцию «Значение()» в условиях к справочнику «ПредопределённыеЭлементы».

    Reply

Leave a Comment

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