Создание подключаемой обработки табличной части с диалогом запроса параметров заполнения (управляемые формы)




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

14 Comments

  1. Lapitskiy

    Суть прекрасно описано.

    Но есть одно НО.

    Документ записывается после обработки, а это методически не верное решение.

    А причина — в изменении данных «Объект», а правильно изменять данные «Форма».

    Тогда всё измененное, сразу отобразится на форме, без костылей типа «Записать», «Прочитать».

    Reply
  2. Mirage78

    (1) К сожалению, пришлось задействовать этот грубый вариант «Объект/Записать/Прочитать», и причина в ограничениях платформы. Смысл обработки именно в обработке, а не в заполнении табличной части с нуля. Изменять существующую табличную часть формы проблематично …

    Reply
  3. ltfriend

    Код модуля с регистрацией обработки можно существенно сократить

    Функция СведенияОВнешнейОбработке() Экспорт
    
    ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке();
    ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиЗаполнениеОбъекта();
    ПараметрыРегистрации.Наименование = НСтр(«ru=’Пример обработки табличной части с диалогом запроса параметров'»);
    ПараметрыРегистрации.Информация = НСтр(«ru=’Дополнительная обработка табличной части'»);
    ПараметрыРегистрации.Версия = «1.0»;
    ПараметрыРегистрации.Назначение.Добавить(«Документ.РеализацияТоваровУслуг»);
    
    Команда = ПараметрыРегистрации.Команды.Добавить();
    Команда.Идентификатор = «ЗаменитьФинансирование»;
    Команда.Представление = «Тестовая обработка»;
    Команда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы();
    
    Возврат ПараметрыРегистрации;
    
    КонецФункции
    

    Показать

    Да и формой можно тоже обойтись одной. Вот полный код формы (без всяких «записей-перезаписей»):

    &НаСервере
    Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    
    ОбъектНазначения = Параметры.ОбъектыНазначения[0];
    
    КонецПроцедуры
    
    &НаКлиенте
    Процедура ВыполнитьОбработку(Команда)
    
    ПараметрыФормы = Новый Структура(«Ключ», ОбъектНазначения);
    ФормаДокумента = ПолучитьФорму(«Документ.РеализацияТоваровУслуг.ФормаОбъекта», ПараметрыФормы);
    
    ОбъектДокумента = ФормаДокумента.Объект;
    
    ЗаполнитьДокументНаСервере(ОбъектДокумента);
    
    КопироватьДанныеФормы(ОбъектДокумента, ФормаДокумента.Объект);
    
    ФормаДокумента.Модифицированность = Истина;
    
    Закрыть();
    
    КонецПроцедуры
    
    &НаСервере
    Процедура ЗаполнитьДокументНаСервере(ОбъектДокумента)
    
    Для каждого СтрокаТовар Из ОбъектДокумента.Товары Цикл
    Если СтрокаТовар.Номенклатура = Номенклатура Тогда
    СтрокаТовар.Цена = СтрокаТовар.Цена + СтрокаТовар.Цена/100 * ИзменениеЦены;
    СтрокаТовар.Сумма = СтрокаТовар.Сумма + СтрокаТовар.Сумма/100 * ИзменениеЦены;
    КонецЕсли;
    КонецЦикла;
    
    КонецПроцедуры
    

    Показать

    Reply
  4. Mirage78

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

    Или речь о том, что можно не возвращаться с параметрами на основную … Думаю да, я начинал с основной, поэтому на автомате и вернулся к ней получив параметры.

    Reply
  5. ltfriend

    (4) Одна форма — это то, что можно нарисовать одну форму с параметрами, в параметрах регистрации указываем вид ОткрытиеФормы, в форме при создании на сервере запоминаем объект назначения (ссылка на документ), при нажатии на кнопку выполняем заполнение (процедура ВыполнитьОбработку в коде выше — это обработчик команды кнопки).

    Reply
  6. Mirage78

    (5) Упс, забыл про вид, спасибо.

    Reply
  7. OksDallas

    (5)

    Управление торговлей, редакция 11 (11.4.5.24)

    К сожалению, не поняла, как можно указать в параметрах регистрации вид ОткрытиеФормы. Пробовала вот так:

        …
    ПараметрыРегистрации = Новый Структура;
    МассивНазначений = Новый Массив;
    МассивНазначений.Добавить(«Документ.СообщениеSMS»);
    
    ПараметрыРегистрации.Вставить(«Вид», «ОткрытиеФормы»);
    ПараметрыРегистрации.Вставить(«Назначение», МассивНазначений);
    ПараметрыРегистрации.Вставить(«Наименование», «Заполнить по подразделению»);
    ПараметрыРегистрации.Вставить(«Версия», «1.0»);
    ПараметрыРегистрации.Вставить(«БезопасныйРежим», Истина);
    ПараметрыРегистрации.Вставить(«Информация», «Дополнительная обработка табличной части к документу Сообщение SMS»);
    …
    

    Показать

    Дает ошибку с ссылкой на отсутствие соответствующего перечисления ВидыДополнительныхОтчетовИОбработок. Действительно, в перечислении есть только следующее:

    — ДополнительнаяОбработка

    — ДополнительныйОтчет

    — ЗаполнениеОбъекта

    — Отчет

    — ПечатнаяФорма

    — СозданиеСвязанныхОбъектов

    — ШаблонСообщения

    — РасчетСкидкиНаценки

    — ПроверкаУсловияПредоставленияСкидкиНаценки

    В УФ еще плаваю — куда влезла, что делаю???

    Reply
  8. OksDallas

    Все, нашла. «ОткрытиеФормы» надо в ТаблицуКоманд привязывать.

    ДобавитьКоманду(ТаблицаКоманд, «Заполнить документ», «Заполнить документ», «ОткрытиеФормы», Истина);

    Reply
  9. Mirage78

    (8) именно, я не стал поправлять Павла, просто понял о чём речь …

    Reply
  10. Stivens

    (3) Убился. В Клиент-серверном варианте открывает второй экземпляр формы документа. Причем в первом старые данные, во втором — новые.

    В файловом все нормально, изменяет именно вызвавшую форму.

    Reply
  11. alexd73

    Спасибо за мануал. подскажите, если я хочу выгрузить накладную в xml по кнопке — тоже надо делать через «ЗаполнениеОбъекта»? Или как?

    И мне формы не нужны. Надо просто создать файл и вывести сообщение об этом.

    подскажите эти моменты.

    Заранее спасибо!

    Reply
  12. independ

    (11) да, или через внешнюю печатную форму или создание связанных объектов и проч. Учитывая, что файл нужен на клиенте, то логику обработки проще поместить в модуль формы, вызов сделать в процедуре ПриОткрытии(), после всех манипуляций там же выполнить закрытие формы, т.е. форма обработки на экране не появится.

    Reply
  13. androidT1C

    (10) Ветка старая, но:

    если вместо:

    ПараметрыФормы = Новый Структура(«Ключ», Поступление);

    ФормаДокумента = ПолучитьФорму(«Документ.ПоступлениеТоваровУслуг.ФормаОбъекта», ПараметрыФормы);

    написать:

    ФормаДокумента = ВладелецФормы;

    то будет работа именно с формой текущего документа

    Reply
  14. German_Tagil

    Придется обращаться к первоисточнику

    Reply

Leave a Comment

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