Документация для разработчиков
Темная тема

crm.timeline.comment.add

Scope: crm Права на выполнение: для всех

crm.timeline.comment.add(fields)

Добавляет новый комментарий в таймлайн.

Параметры

Параметр Описание
fields Набор полей - массив вида array ("поле"=>"значение"[, ...]), содержащий значения полей. Обязательные поля - поле ENTITY_ID
Поле ОписаниеТипПримечание
ENTITY_ID ID элемента, к которому привязана записи в таймлайне. integer Неизменяемое\Обязательное
и ENTITY_TYPE
Поле ОписаниеТипПримечание
ENTITY_TYPE Тип элемента, к которому привязан комментарий.
Значения:
  • lead - лид;
  • deal - сделка;
  • contact - контакт;
  • company - компания;
  • order - заказ.
string Неизменяемое\Обязательное
.
Примечание: чтобы узнать требуемый формат полей, выполните метод crm.timeline.comment.fields и посмотрите формат пришедших значений этих полей.

Внимание!С версии crm 23.100.0 принимаются только параметры с ключем fields в нижнем регистре. Другие недокументированные варианты: Fields, FIELDS, arFields не принимаются.

Пример

BX24.callMethod(
	"crm.timeline.comment.add",
	{
		fields:
		{
			"ENTITY_ID": 10,
			"ENTITY_TYPE": "deal",
			"COMMENT": "New comment was added"
		}
	},
	function(result)
	{
		if(result.error())
			console.error(result.error());
		else
			console.info("Добавлен новый комментарий. ID - " + result.data());
	}
);


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Miller Miller
Сообщение не промодерировано, возможны ошибки и неточности.
В элемент смарт процесса

$params = [
           'fields' => [
               'ENTITY_ID' => ID_элемента_смарт_процесса,
               'ENTITY_TYPE_ID' => ID_смарт_процесса,
               'COMMENT' => $comment
           ]
       ];
0
Miller Miller
Сообщение не промодерировано, возможны ошибки и неточности.
В элемент смарт процесса:
Код
$params = [
            'fields' => [
                'ENTITY_ID' => ID_элемента_смарт_процесса,
                'ENTITY_TYPE_ID' => ID_смарт_процесса,
                'COMMENT' => $comment
            ]
        ];
0
rend88
Сообщение не промодерировано, возможны ошибки и неточности.
а если  это смарт ?
0
Андрей Кудряшов
Сообщение не промодерировано, возможны ошибки и неточности.
Коллеги, подскажите, пожалуйста, как сделать закреп комментария через функцию CRest:call?
2
Андрей Гомзин
Сообщение не промодерировано, возможны ошибки и неточности.
Если нужно прикрепить в комментарий файл (например, pdf после его создания генератором документов):
Код
$newfile = base64_encode(file_get_contents($file_pdf));
$data = array(
   'fields' => array(
      "ENTITY_ID" => $deal_id,
      "ENTITY_TYPE" => "deal",
      "COMMENT" => "Был создан новый документ по шаблону:\r\n".$public_url,
      "SETTINGS" => array('HAS_FILES' => 'Y'),
      "FILES" => array(
         array($doc_title.'.pdf', $newfile),
      ),
   ),
);

где $file_pdf - внешняя ссылка на загрузку файла

Если перед этим вызывался метод crm.documentgenerator.document.get (после ожидания трансформации pdf файла), то получение данных для комментария такое ($result - ответ метода):
Код
$res = (array)json_decode($result);
$public_url = $res['result']->document->publicUrl;
$file_pdf = $res['result']->document->pdfUrlMachine;
$doc_title = $res['result']->document->title;
1
Валерий Гречуха
Сообщение не промодерировано, возможны ошибки и неточности.
Пример

Тело запроса:
Код
{
   "fields": {
      "ENTITY_ID": 231210,
      "ENTITY_TYPE": "contact",
      "AUTHOR_ID": 1,
      "COMMENT": "Test comment [URL=/crm/deal/details/26/]test123[/URL]"
   }
}


Ответ:
Код
{
   "result": 231930,
   "time": {
      "start": 1664464144.5458059,
      "finish": 1664464144.6996231,
      "duration": 0.15381717681884766,
      "processing": 0.11148309707641602,
      "date_start": "2022-09-29T18:09:04+03:00",
      "date_finish": "2022-09-29T18:09:04+03:00",
      "operating_reset_at": 1664464744,
      "operating": 0
   }
}
10
alexander.shataloff
Сообщение не промодерировано, возможны ошибки и неточности.
Смарт-процессы и смарт-счета
ENTITY_TYPE => 'dynamic_' . entityTypeId
3
Дмитрий Салтановский
Цитата
Есть задача скопировать комментарии из контакта в сделку.
Зачем копировать, если можно один и тот же комментарий привязать и к контакту и к сделке с помощью
Код
crm.timeline.bindings.bind();
© «Битрикс», 2001-2024, «1С-Битрикс», 2024