Другие команды
Команды, не вошедшие в предыдущие разделы.
Примечание: все команды располагаются в пространсве имен
Bitrix\Tasks\V2\Public\Command\Task
Напоминания
UpdateReminderCommand
UpdateReminderCommand обновляет существующее напоминание в задаче.
Входные аргументы:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
$reminder |
Reminder |
Да | Объект напоминания с новыми данными |
Пример использования:
use Bitrix\Tasks\V2\Public\Command\Task\Reminder\UpdateReminderCommand;
use Bitrix\Tasks\V2\Internal\Entity\Task\Reminder;
$reminder = new Reminder(
id: 1,
remindBy: RemindBy::Deadline,
before: 3600 // за час до дедлайна
);
$command = new UpdateReminderCommand($reminder);
if ($result->isSuccess()) {
echo "Напоминание обновлено.";
} else {
// Обработка ошибок
}
Объект Reminder
Команда UpdateReminderCommand принимает объект Bitrix\Tasks\V2\Internal\Entity\Task\Reminder. Рассмотрим его структуру и возможные значения.
Параметры объекта:
| Поле | Тип | Обязательный | Описание |
|---|---|---|---|
id |
int |
Да (для обновления) | ID существующего напоминания |
userId |
int |
Нет | ID пользователя (по умолчанию текущий) |
taskId |
int |
Нет | ID задачи для напоминания |
nextRemindTs |
int |
Нет | Дата и время следующего напоминания (timestamp) |
remindBy |
RemindBy |
Нет | Триггер напоминания (deadline, date, recurring) |
remindVia |
RemindVia |
Нет | Канал уведомления (notification, email) |
recipient |
Recipient |
Нет | Получатель (responsible, creator, accomplice, myself) |
rrule |
array |
Нет | Правило повторения (iCalendar RRule) |
before |
int |
Нет | За сколько секунд до события напомнить |
RemindBy
Перечисление RemindBy (Bitrix\Tasks\V2\Internal\Entity\Task\Reminder\RemindBy) определяет, по какому событию сработает напоминание.
| Значение | Описание |
|---|---|
Deadline |
Напоминание, привязанное к крайнему сроку задачи. |
Date |
Напоминание по конкретной дате и времени. |
Recurring |
Повторяющееся напоминание по правилу rrule. |
RemindVia
Перечисление RemindVia (Bitrix\Tasks\V2\Internal\Entity\Task\Reminder\RemindVia) задает канал отправки уведомления.
| Значение | Описание |
|---|---|
Notification |
Стандартное всплывающее уведомление в системе. |
Email |
Уведомление по электронной почте. |
Recipient
Перечисление Recipient (Bitrix\Tasks\V2\Internal\Entity\Task\Reminder\Recipient) указывает, кому будет отправлено уведомление.
| Значение | Описание |
|---|---|
Responsible |
Ответственному за задачу. |
Creator |
Постановщику задачи. |
Accomplice |
Соисполнителю. |
Myself |
Текущему пользователю (создателю напоминания). |