1С-Битрикс: Управление сайтом

Экспорт. Детальное описание

Выгрузка (экспорт) данных из каталога позволяет организовать обмен данными между сайтом и другими сайтами или программами (например, с MS Excel). С помощью формы Настройка экспорта вы можете экспортировать данные как на основании предустановленных, так и на основании ваших собственных шаблонов экспорта. Кроме того, с помощью этой формы вы можете задавать предустановленные профили экспорта, выносить часто используемые шаблоны и профили экспорта в меню, настраивать автоматическое выполнение экспорта с помощью агентов и cron.

Разработчики могут найти примеры кода шаблонов в разделе Шаблоны Руководства разработчика.

Шаблоны экспорта могут быть двух типов: с дополнительными настройками экспорта (в том числе и с пошаговыми мастерами) или без настроек.

Шаблоны с настройками

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

Можно заранее создать набор необходимых параметров и сохранить его как профиль экспорта командой Добавить профиль. При выполнении профиля экспорта, отличного от профиля "по умолчанию", мастер экспорта не вызывается, а экспорт идет на основании ранее сохраненных в профиле параметров.

Установить на автоматическое выполнение с помощью агентов или cron (только для UNIX) можно любой профиль экспорта, отличный от профиля "по умолчанию". Это связано с тем, что при автоматическом выполнении не могут выполнятся запросы на ввод дополнительных параметров экспорта у пользователя, поэтому все необходимые параметры должны быть сохранены в профиле заранее.

Шаблоны без настроек

Выполняется (экспортирует данные) непосредственно после вызова. Профили экспорта не создаются. Шаблон не требует дополнительных параметров для своего выполнения, поэтому непосредственно устанавливается на автоматическое выполнение с помощью агентов или cron (только для UNIX).

Выполнение команды "Добавить в меню" приводит к добавлению соответствующего пункта в левое меню административной части. Этот пункт меню функционирует так же, как и соответствующая команда "Экспортировать" формы "Настройка экспорта".

Агенты

Агенты - это PHP функции которые запускаются с определённой периодичностью. В самом начале загрузки каждой страницы система автоматически проверяет есть ли агент который нуждается в запуске и в случае необходимости исполняет его. Не рекомендуется вешать на агенты длительные по времени / большие по объему выгрузки. Для этих случаев лучше использовать cron.

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

Утилита cron

Утилита cron работает в фоновом режиме и выполняет указанные задачи в указанное время. Выполнение задач с помощью cron не связано с активностью посетителей на сайте. Выполнение задач с помощью cron может быть назначено не только с определённой периодичностью, но и в строго заданное время.

Утилита cron доступна только на хостингах, работающих под операционными системами семейства UNIX.

При установке на автоматическое выполнение с помощью cron система выводит запрос на период / время выполнения экспорта и путь к интерпретатору php. Если будет указан период выполнения (в часах), то экспорт будет выполняться с таким периодом автоматически, начиная с текущего момента. Если будет указано время выполнения (часы и минуты), то экспорт будет выполняться автоматически каждый день в указанное время.

Путь к интерпретатору php может быть выяснен у хостинг-провайдера или указан в документации по хостингу.

Команда Повесить на cron добавляет соответствующую запись в конфигурационный файл /bitrix/crontab/crontab.cfg, который содержит текущий список задач для cron. После изменения набора задач, установленных на cron, необходимо заново установить конфигурационный файл. Если в форме установки на автоматическое выполнение отмечен флаг Установить автоматически, то форма пытается самостоятельно установить конфигурационный файл в cron. Автоматическая установка конфигурационного файла может не пройти (например, нет достаточных прав). В этом случае необходимо соединиться с вашим сайтом по SSH (SSH2) или какому-либо другому аналогичному протоколу, поддерживаемому вашим провайдером для удаленного доступа к shell, и провести установку конфигурационного файла вручную командой

crontab <полный_путь_к_конфигурационный_файл_ crontab.cfg>

Для просмотра списка установленных на cron задач нужно выполнить команду

crontab -l

Текущий список установленных на cron задач выводится так же внизу формы Настройка экспорта, если есть права на его получение.

Для удаления списка установленных на cron задач нужно выполнить команду

crontab -r

Если у вас установлены на cron задачи, которых нет в конфигурационном файле, то при применении этого файла такие задачи будут удалены.

Оболочкой для выполнения задач на cron является файл /bitrix/php_interface/include/catalog_export/cron_frame.php. Убедитесь, что в нем прописаны правильные пути к php и корню сайта.

© «Битрикс», 2001-2008, «1C-Битрикс», 2008   1С-Битрикс: Управление сайтом