AddAgent

Описание и параметры

mixed
CAgent::AddAgent(
	string name, 
	string module = "", 
	string period = "N", 
	int interval = 86400, 
	string datecheck = "", 
	string active = "Y",
	string next_exec = "", 
	int sort = 100
)

Метод регистрирует новую функцию-агент. Статический метод.

Параметры

next_exec = next_exec + interval

next_exec = дата последнего запуска + interval

Возвращаемые значения

При успешном выполнении, возвращает ID вновь добавленного агента, иначе - false. Если агент ничего не возвращает, он удаляется. Как правило он должен вернуть вызов самого себя.

Смотрите также

• Агенты
• CAgent::RemoveAgent
• CAgent::RemoveModuleAgents
• Структура файлов

Примеры использования

<?
// добавим агент модуля "Статистика"
CAgent::AddAgent(
	"CStatistic::CleanUpStatistics_2();", // имя функции
	"statistic",                          // идентификатор модуля
	"N",                                  // агент не критичен к кол-ву запусков
	86400,                                // интервал запуска - 1 сутки
	"07.04.2005 20:03:26",                // дата первой проверки на запуск
	"Y",                                  // агент активен
	"07.04.2005 20:03:26",                // дата первого запуска
	30);
?>

<?
// добавим агент модуля "Техподдержка"
CAgent::AddAgent(
	"CTicket::AutoClose();",  // имя функции
	"support",                // идентификатор модуля
	"N",                      // агент не критичен к кол-ву запусков
	86400,                    // интервал запуска - 1 сутки
	"",                       // дата первой проверки - текущее
	"Y",                      // агент активен
	"",                       // дата первого запуска - текущее
	30);
?>

<?
// добавим произвольный агент не принадлежащий ни одному модулю
CAgent::AddAgent("My_Agent_Function();");
?>

<?
// файл /bitrix/php_interface/init.php

function My_Agent_Function()
{
	// выполняем какие-либо действия
	return "My_Agent_Function();";
}
?>

<?
// добавим произвольный агент принадлежащий модулю
// с идентификатором my_module

CAgent::AddAgent(
	"CMyModule::Agent007(1)", 
	"my_module", 
	"Y", 
	86400);
?>

<?
// данный агент будет запущен ровно 7 раз с периодичностью раз в сутки, 
// после чего будет удален из таблицы агентов.

Class CMyModule
{
	function Agent007($cnt=1)
	{
		echo "Hello!";
		if($cnt>=7)
			return "";
		return "CMyModule::Agent007(".($cnt+1).")";
	}
}
?>