Комментирование

Материал из 3v-wiki
< Платформа 3V‎ | Формы
Версия от 09:45, 1 декабря 2021; A.kazanceva (обсуждение | вклад) (Новая страница: «{{DISPLAYTITLE:Комментирование}} Комментирование - это чат пользователей внутри платформы, кот...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к навигации Перейти к поиску


Комментирование - это чат пользователей внутри платформы, которое поддерживает отметку пользователей и прикрепление файлов.

Настроить отчёт комментирования

Для того, чтобы настроить отчёт нужно создать справочник со следующими атрибутами:

Код Тип Описание
NAME Строка Текст комментария.
ORD Целое число Системный атрибут.
PARENT_ID Целое число Системный атрибут.
CREATOR_ID Строка Задание правила вывода элементов.
CREATOR_NAME Строка Имя и фамилия пользователя.
CREATE_DATE Дата Дата и время добавления комментария
(отображение даты в зависимости от системных настроек).
FILE_LINK Файл Прикреплённый к комментарию.
WAS_CHANGED Логический флаг Флаг, менялся ли комментарий.
WAS_DELETED Логический флаг Флаг, удалили ли комментарий.
WHOM_TO_NOTIFY Строка Кому отправлены уведомления.
WHOM_TO_NOTIFY_EMAIL Строка E-mail отмеченный пользователей.
IS_INTERNAL Строка Флаг, прочитано ли сообщение.
BLOCK_ID Элемент справочника Идентификатор блока, куда относятся комментарии, если комментариев
несколько на форме. Необязательное поле.
LINK_TO_SOURCE Строка Ссылка на карточку, в которой отмечен пользователь.

На созданном справочнике следует создать отчёт через кнопку в выпадающем меню "Сохранить как".

Настроить список пользователей для упоминания

В функционале комментирования подключена возможность упоминания пользователей. В большинстве случаев пользователю должен быть разрешен отдельный пул пользователей для упоминания, для этого следует настроить отчёт на внешнем справочнике.

Создать соединение с источником

Чтобы настроить внешний справочник требуется создать Соединение с источником на источнике /subjects/api/SubjectsDataSource/.

JSON объекта Соединение
1 {
2   "dbType": "Web",
3   "connectionString": "https://.../subjects/api/SubjectsDataSource/",
4   "id": 1,
5   "name": "Соединение с серверными субъектами"
6 }

Настроить внешний справочник

После создания соединения с источником следует выбрать его в качестве соединения в конструкторе внешнего справочника и задать идентификатор объекта "User".

настройка внешнего справочника.png

Создать и настроить отчёт

После создания внешнего справочника следует создать отчёт, где в боковик отдать созданный внешний справочник и настроить фильтрация на отображение его строк. Более подробно о фильтрации в отчёте можно прочитать здесь

конструктор отчетов для комментариев польз.png

Подключить комментирование на форму

Для того, чтобы подключить комментирование на форму следует настроить действие ShowCommentsAction, где !!!что-то про свойства!!!!!! и подключить его к кнопке.


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

Кейс: настройка комментирования на кнопку в форме с настройкой упоминания пользователей.

Создать и настроить отчёт, содержащий комментарии

По инструкции выше создать отчёт, который используется для хранения комментариев.

Создать и настроить отчёт, содержащий список пользователей

По инструкции выше создать отчёт, который используется для фильтрации пользователей, доступных для упоминания. Для того, чтобы были доступны только актуальные пользователи на стенде study.3v-cloud.com, следует настроить следующую фильтрацию:

фильтрация пользователей.png

Настроить кнопку с действием

Создать кнопку и задать ей идентификатор действия. Действие следует настроить следующим образом

 1 {
 2  "mentionsObjectCode": "Report_USERS_FOR_COMMENTS",
 3  "mentionsObjectParameters": [],
 4  "useMentions": false,
 5  "metaObjectId": 763,
 6  "parameters": [
 7   {
 8    "id": 1,
 9    "expressionId": null,
10    "value": 1,
11    "hasMultipleValues": false,
12    "dataType": "Undefined"
13   }
14  ],
15  "discriminator": "ShowCommentsAction",
16  "comment": null,
17  "enableExpressionId": null,
18  "id": 1,
19  "name": "Показать комментарии",
20  "code": null
21 }

, где metaObjectId - это идентификатор настроенного отчёта, содержащего комментарий, а mentionsObjectCode - это код отчёта, содержащего список пользователей.