Работа с файлами

Команды этого раздела позволяют управлять вложениями в задачах: добавлять и удалять файлы.

Примечание: все команды располагаются в пространсве имен Bitrix\Tasks\V2\Public\Command\Task\Attachment

AttachFilesCommand

AttachFilesCommand прикрепляет один или несколько файлов к задаче. Файлы должны быть предварительно загружены в файловое хранилище.

Входные аргументы:

Параметр Тип Обязательный Описание
$taskId int Да ID задачи для прикрепления файлов
$userId int Да ID пользователя, выполняющего действие
$fileIds array Да Массив ID файлов для прикрепления
$useConsistency bool Нет Использовать консистентность данных (по умолчанию false)

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

use Bitrix\Tasks\V2\Public\Command\Task\Attachment\AttachFilesCommand;

$command = new AttachFilesCommand(
    taskId: 123,
    userId: 1,
    fileIds: [10, 20, 30],
    useConsistency: true
);

$result = $command->run();

if ($result->isSuccess()) {
    echo "Файлы успешно прикреплены.";
} else {
    // Обработка ошибок
}

DetachFilesCommand

DetachFilesCommand открепляет один или несколько файлов от задачи. Сами файлы при этом не удаляются из системы.

Входные аргументы:

Параметр Тип Обязательный Описание
$taskId int Да ID задачи, у которой удаляются файлы
$userId int Да ID пользователя, выполняющего действие
$fileIds array Да Массив ID файлов для открепления
$useConsistency bool Нет Использовать консистентность данных (по умолчанию false)

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

use Bitrix\Tasks\V2\Public\Command\Task\Attachment\DetachFilesCommand;

$command = new DetachFilesCommand(
    taskId: 123,
    userId: 1,
    fileIds: [10, 20],
    useConsistency: false
);

$result = $command->run();

if ($result->isSuccess()) {
    echo "Файлы успешно откреплены.";
} else {
    // Обработка ошибок
}