task-comment-item-add.md

Добавить комментарий task.commentitem.add

{% if build == 'dev' %}

{% note alert "TO-DO не выгружается на prod" %}

• не указаны типы параметров
• отсутствуют примеры (должно быть три примера - curl, js, php)
• отсутствует ответ в случае ошибки
• отсутствует ответ в случае успеха
• добавить описание, что можно проверять право на изменение специальным методом

{% endnote %}

{% endif %}

{% note warning "Мы еще обновляем эту страницу" %}

Тут может не хватать некоторых данных — дополним в ближайшее время

{% endnote %}

Scope: task

Кто может выполнять метод: любой пользователь

Метод task.commentitem.addсоздает новый комментарий к задаче. Возвращает идентификатор добавленного комментария.

Параметры

#| || Параметр / Тип | Описание || || TASKID^*^ unknown | Идентификатор задачи. || || FIELDS^*^ unknown | Массив полей данных по задаче (POST_MESSAGE — обязательное поле). || |#

{% include Сноска о параметрах %}

{% note info %}

Соблюдение порядка следования параметров в запросе обязательно. При его нарушении запрос будет выполнен с ошибками.

{% endnote %}

Поля

#| || Поле / Тип | Описание || || AUTHOR_ID unknown | Идентификатор пользователя, от имени которого создается комментарий. || || AUTHOR_NAME unknown | Имя пользователя (опционально). || || AUTHOR_EMAIL unknown | E-mail пользователя (опционально). || || USE_SMILES unknown | (Y|N) — парсить или нет комментарии на наличие смайлов. || || POST_MESSAGE unknown | Текст сообщения. || || UF_FORUM_MESSAGE_DOC unknown | Массив файлов с диска для прикрепления вида ['n123', ...] || |#

Пример

{% list tabs %}

• JS

  // Добавляем новый комментарий с текстом "HELLO" для задачи с ID=13
  BX24.callMethod(
      'task.commentitem.add',
      [13, {'POST_MESSAGE': 'HELLO'}],
      function(result){
          console.info(result.data());
          console.log(result);
      }
  );

{% endlist %}

{% include Сноска о примерах %}

Продолжите изучение

• {#T}