Многоуровневая нумерация в отчете СКД (программный вывод)




Принцип обмена данными из 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='\

7 Comments

  1. dhurricane

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

    Reply
  2. lmnlmn

    (1) Спасибо за подсказку. Вообще в реальной ситуации этот алгоритм используется в кросс-таблице с группировкой колонок и проблем нет. Но я добавлю группировку колонок в пример и проверю. Если будут сбои в нумерации — доработаю алгоритм и на этот случай.

    Reply
  3. lmnlmn

    (1) Внес исправления в код и пример. Теперь корректно нумерует и при наличии группировок колонок. Но нумерация работает только по строкам. По колонкам лучше не нумеровать.

    Reply
  4. dhurricane

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

    НомераКУдалению = Новый Массив;
    Для Каждого Номер Из СтекНомеров Цикл
    Если Номер.Уровень <= УровеньОтчетаСКД Тогда
    СтрНомерПоИерархии = СтрНомерПоИерархии + Номер.Номер + «.»;
    Иначе
    //Чистим элементы стека нижних уровней
    НомераКУдалению.Добавить(Номер);
    КонецЕсли
    КонецЦикла;
    Для каждого Номер Из НомераКУдалению Цикл
    СтекНомеров.Удалить(Номер);
    КонецЦикла;

    Показать

    Ну и хотел бы предложить небольшое упрощение Вашего алгоритма в целом. А именно избавиться от вычисляемого поля «НомерПоИерархии», а вместо него в выбранные поля добавить «СистемныеПоля.Уровень». Тогда при выводе строк отчета можно значение уровня получать прямо из макета, вычислять номер в иерархии и устанавливать его обратно в системное поле.

    Reply
  5. lmnlmn

    (4) Вообще по удалению, формально, ваш вариант «каноничнее», но в данном алгоритме это к проблемам не приведет так как номера нижних уровней надо просто отсечь. Но, да, «дурной тон» в программировании.

    С системными полями идея хорошая, но на практике есть одна проблема. Если другой разработчик (да я и сам через полгодика запамятовать могу) будет дорабатывать отчет, то он будет долго и с проклятиями недоумевать что за ерунда вместо уровня пишется, пока разберется в происходящем. А вычисляемое поле с понятным именем путаницу не вносит. Вообще для коллег можно в выражении вычисляемого поля написать «заполняется программно», например.

    Reply
  6. dhurricane

    (5)

    но в данном алгоритме это к проблемам не приведет

    Проблемы будут при удалении нескольких строк, т.е. если разница в уровне между предшествующей и текущей строкой будет больше 1. Для Вашего примера: если «Трансмиссию» переместить на верхний уровень из под подчинения «Автомобилю», то на платформе 8.3.13.1809 в файловой базе получим номера, представленные на скрине ниже.

    то он будет долго и с проклятиями недоумевать что за ерунда вместо уровня пишется, пока разберется в происходящем

    Согласен, предложенный мной вариант вносит путаницу.

    Reply
  7. lmnlmn

    (6)

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

    Спасибо, проглядел. Исправил.

    Reply

Leave a Comment

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