Использование подсистемы БСП "Заполнение объектов"




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

23 Comments

  1. killovolt

    Хорошее описание, писал аналогичную статью про заполнение объектов через вызов клиентского метода. Ваше бы описание на тот момент сильно упростило мне реализацию.

    Reply
  2. ids79

    (1) Спасибо. Хотел раньше написать статью, но вот, только сейчас собрался.

    Reply
  3. AnderWonder

    В БСП ветки 2.4.5 есть баг, который не позволяет подключить подсистему к регистрам сведений. Нужно поправить функцию ЗарегистрироватьИсточник в модуле ПодключаемыеКоманды:

    //Исправление бага БСП — не учитывались регистры сведений
    //Источник.ТипСсылкиДанных = Тип(Источник.Вид + «Ссылка.» + ОбъектМетаданных.Имя);
    Если СтрНайти(Источник.Вид, «РЕГИСТРСВЕДЕНИЙ») Тогда
    Источник.ТипСсылкиДанных = Тип(Источник.Вид + «НаборЗаписей.» + ОбъектМетаданных.
    Иначе
    Источник.ТипСсылкиДанных = Тип(Источник.Вид + «Ссылка.» + ОбъектМетаданных.Имя);
    КонецЕсли;
    // Исправление бага БСП
    Reply
  4. ids79

    (3)Спасибо за дополнение.

    Reply
  5. PLAstic

    Хотел бы добавить, что нет ни одного примера команды из формы документа. Там есть нюанс.

    Команду мы вызываем из уже открытой формы, но по алгоритму создаётся ещё одна форма и в ней вызывается обработчик команды (если у команды значится, что он в модуле формы). Так вот, этой форме в качестве владельца передаётся наша открытая форма.

    Мне требовалось выбрать интерактивно некий документ и передать управление обработчику оповещения. Я указал, что он находится не в модуле формы (ЭтаФорма), а в модуле её владельца (ЭтаФорма.Владелец). Тогда по завершении выбора управление перешло в мою открытую форму в процедуру обработки оповещения.

    Reply
  6. ids79

    (5)

    Хотел бы добавить, что нет ни одного примера команды из формы документа

    Почему же, первая команда «Команда из формы обработки» как раз такого вида.

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

    Reply
  7. PLAstic

    (6) Сверим код?

     Команда = КомандыЗаполнения.Добавить();
    Команда.Идентификатор = «ЗаполнитьИзУстановкиГСМ»;
    Команда.Представление = «Заполнить по расходу ГСМ»;
    Команда.Важность = «Важное»;
    Команда.ВидимостьВФормах = «ФормаДокументаУпр»;  // здесь «ФормаЭлемента» из твоего примера не проходит, это документ
    Команда.МножественныйВыбор = Ложь;
    Команда.РежимЗаписи = «НеЗаписывать»;
    Команда.ИзменяетВыбранныеОбъекты = Истина;  // обязательно указание, чтобы блокировать команду без прав. (см.документацию)
    Команда.ИмяФормы = «Форма.ФормаДокументаУпр»;  // у меня несколько форм документа — обычная и две управляемые
    Команда.Обработчик = «КомандаЗаполнитьИзУстановкиГСМ»;
    

    Показать

    Присутствуют неочевидные параметры, которые в примере не были раскрыты. Выяснил отладкой и чтением документации БСП.

    Спасибо, что дал стартовый код.

    Reply
  8. ids79

    (7)Параметры «ВидимостьВФормах» и «ИзменяетВыбранныеОбъекты» — описаны в статье. Параметр «ИмяФормы» обязательно указывать только если не указан параметр «Обработчик». Или, если у документа есть обычные формы выдается ошибка?

    Reply
  9. PLAstic

    (8) Я предлагаю сравнить с примером из статьи и признать, что это пример не для документа, а для обработки (или даже справочника, раз там «ФормаЭлемента») и добавить в статью пример для документа с описанием всех ваших дополнений. Например, закомментарить параметр «ВидимостьВФормах «, раз он не всегда обязателен, и дать корректное значение в случае, когда он нужен (вместо явно некорректного «ФормаЭлемента»).

    Ещё неплохо дать бы ссылку на ИТС. Например, https://its.1c.ru/db/bsp302doc#content:35:1:issogl2_%D1%80%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%­BA%D0%B0_%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4_%D0%B7%D0%B0%D­0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F

    Reply
  10. ids79

    (9)Название формы — это мелочь, естественно оно должно быть разным при разных вариантах использования. Не думаю, что имеет смысл делать разные варианты с разными названиями форм. В примерах я постарался покрыть большинство различных вариантов использования. Конечно же это не все.

    В предыдущем посте я не много напутал. Параметр «ИмяФормы» — это имя формы обработки заполнения, а не имя формы объекта назначения. Можно не заполнять, если форма в обработке одна и указан параметр «Обработчик».

    Ссылка в тему, спасибо.

    Reply
  11. inf012

    Здравствуйте. А можно использовать этот механизм для переопределения команды заполнения, а не для создания новой кнопки и команды?

    Надо, чтобы выполнилась типовая процедура заполнения и после нее необходим ряд «косметических» действий с ТЧ.

    Reply
  12. sparhh

    Хорошо сделали.

    Данная подсистема существенно расширяет возможности ЗаполненияОбъекта.

    Добавляет возможность гибко настраивать условия и главное преимущество — красиво ложится на расширения. То есть это развитие идеи внешних обработок в концепции расширений.

    Вопрос: есть ли чтото подобное для Регламентных заданий.

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

    Как этот момент решается в расширениях?

    Reply
  13. rukalico

    Пытался по текущей публикации и документации с БСП приделать обработку к документу не получилось.

    По комментам вроде кто-то к документу цеплял.. нет ли там какой-то заморочки?

    Все сделал по документации, но не взлетает.

    Reply
  14. ids79

    (13)Что конкретно хотите, прикрепить обработку заполнения к документу?

    Где размещаете код?

    На клиенте или на сервере хотите выполнять?

    Код скиньте.

    Мало что понятно из Вашего комментария.

    Reply
  15. sparhh

    (14) (13) Присоединяюсь..

    Дело вот в чем — тестирую Заполнение документа по указанному механизму.

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

    При этом в Расширении все работает (!)

    Если же делать в самой конфе без расширения, то не работает (!)

    То есть вообще не выходит в подменю Заполнение сама команда.

    Делаю все по ссылке ИТС. Если можете проверьте ваш же вариант для случая: документ, НЕ расширение, модуль менеджера обработки.

    Reply
  16. sparhh

    (15) Судя по отладке такой вариант может работать только для расширений.. ?…

    Reply
  17. ids79

    (15)Странно, должно работать. А не забыли обработку в нужную подсистему включить?

    Пришлите код обработки, попробую посмотреть.

    Reply
  18. sparhh

    Присылать то особо и нечего:

    Процедура ПриОпределенииНастроек(Настройки) Экспорт
    
    Настройки.ДобавитьКомандыЗаполнения = Истина;
    Настройки.Размещение.Добавить(Метаданные.Документы.ЗаказКлиента);
    
    КонецПроцедуры
    
    Процедура ДобавитьКомандыЗаполнения(КомандыЗаполнения, Параметры) Экспорт
    
    Команда = КомандыЗаполнения.Добавить();
    Команда.Идентификатор = «Команда3»;
    Команда.Представление = «Команда из формы обработки (Ctrl+Shift+D)»;
    Команда.Важность = «Обычное»;
    Команда.ВидимостьВФормах = «ФормаДокумента»;
    Команда.МножественныйВыбор = Ложь;
    Команда.РежимЗаписи = «НеЗаписывать»;
    Команда.СочетаниеКлавиш = Новый СочетаниеКлавиш(Клавиша.D, Ложь, Истина, Истина);
    Команда.ИмяФормы = «Форма»;
    Команда.Обработчик = «КомандаЗаполненияИзФормыОбработки»;
    
    КонецПроцедуры
    

    Показать

    Этот же код в расширении отрабатывает, а без расширения НЕТ.

    В обоих случая обработка включена в подсистему ПодключаемыОтчетыИОбработки.

    Reply
  19. ids79

    (18)Если обработка с командами заполнения создана в основной конфигурации, необходимо запустить на выполнение обработку вспомогательных данных в части базовой функциональности. Для расширений это все делается «на лету» — обновление ВД не требуется.

    Reply
  20. sparhh

    (19) Спасибо огромное!

    Получилось, сам упустил этот момент.

    Reply
  21. sparhh

    Все сработало, но остался вопрос: как делать это правильно для варианта «обработка встроена в конфигурацию»?

    Вывзывать ОбновлениеВспомогательныхДанных вручную неудобно, расширения не используем.

    Reply
  22. ids79

    (21)Посмотрите, что делает обновление вспомогательных данных и выполняйте это код при запуске системы. Как вариант.

    Reply
  23. inetalex_dominant

    Вопрос: а как сделать, чтобы кнопка заполнения добавлялась в конкретную панель на форме?

    Reply

Leave a Comment

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