AddByEvents
Описание и параметры
int CStatEvent::AddByEvents( string event1, string event2, string event3, string date, string gid, mixed money = "", string currency = "", string chargeback = "N" )
Добавляет событие по заданным идентификаторам типа события и специальному параметру. Если типа события с идентификаторами event1, event2 не существует, то он будет автоматически создан с указанными идентификаторами.
Параметры метода
| Параметр | Описание |
|---|---|
| event1 | Идентификатор типа события event1. |
| event2 | Идентификатор типа события event2. |
| event3 | Дополнительный параметр event3 события. |
| date | Дата в текущем формате. |
| gid | Специальный параметр в котором закодированы все необходимые данные для добавления события. |
| money | Денежная сумма. |
| currency | Трехсимвольный идентификатор валюты. Идентификаторы валют задаются в модуле "Валюты". |
| chargeback | Флаг отрицательной суммы. Используется когда необходимо зафиксировать событие о возврате денег (chargeback). Возможные значения:
|
Возвращаемое значение
Метод возвращает ID добавленного события в случае успеха, и 0, если событие не было добавлено по каким либо причинам.
Смотрите также
Примеры использования
<?
// добавим событие по типу softkey/buy
// если такого типа нет, то он автоматически будет создан
// специальный параметр события в незакодированном виде
$gid = "BITRIX_SM.995.82.N0.25.N.ru";
// дата должна быть заданы в формате текущего сайта или языка
$date = "23.12.2005 18:15:10";
CStatEvent::AddByEvents("softkey", "buy", "", $date, $gid, "899", "USD");
?>
<?
// добавим событие по типу regnow/buy
// если такого типа нет, то он автоматически будет создан
// специальный параметр события в закодированном виде
$gid = "BITRIX_SM.OTk1LjgyLk4wLjI1Lk4ucnU%3D";
// дата должна быть заданы в формате текущего сайта или языка
$date = "01.06.2005";
CStatEvent::AddByEvents("regnow", "buy", "", $date, $gid, "199", "EUR");
?>
© «Битрикс», 2001-2025, «1С-Битрикс», 2025