Описание

Этот раздел содержит PHP-решение для работы с комментариями к задачам в Битрикс24.

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

// INPUT - получение переменных
$taskId = "{{TaskId}}"; // ID задачи. Пример: 123
$commentText = "{{CommentText}}"; // Текст комментария. Пример: "Это новый комментарий к задаче."

$result = \Bitrix\Tasks\Comments\CommentManager::add([
    'TASK_ID' => $taskId,
    'POST_MESSAGE' => $commentText,
    'AUTHOR_ID' => 10, // ID текущего пользователя
]);

// PROCESS - обработка результатов
$operationStatus = 'ERROR';
$commentId = null;
$errorMessages = [];

if ($result->isSuccess()) {
    $operationStatus = 'SUCCESS';
    $commentId = $result->getId();
    // LOG - отчет о выполнении
    $this->WriteToTrackingService("Комментарий успешно добавлен. ID комментария: " . $commentId);
} else {
    $errors = $result->getErrors();
    foreach ($errors as $error) {
        $errorMessages[] = $error->getMessage();
    }
    // LOG - отчет о выполнении
    $this->WriteToTrackingService("Ошибка при добавлении комментария: " . implode(", ", $errorMessages));
}

// OUTPUT - возврат переменных
$rootActivity = $this->GetRootActivity();
$rootActivity->SetVariable("CommentOperationStatus", $operationStatus); // Статус операции (SUCCESS/ERROR)
$rootActivity->SetVariable("CommentId", $commentId); // ID добавленного комментария
$rootActivity->SetVariable("CommentErrorMessages", implode(", ", $errorMessages)); // Сообщения об ошибках, если есть

Параметры

  • TaskId (int): ID задачи, к которой добавляется комментарий.
  • CommentText (string): Текст комментария, который будет добавлен.

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

  • CommentOperationStatus (string): Статус выполнения операции: SUCCESS в случае успеха, ERROR в случае ошибки.
  • CommentId (int): ID добавленного комментария, если операция прошла успешно.
  • CommentErrorMessages (string): Сообщения об ошибках, разделенные запятыми, если операция завершилась с ошибкой.