Оценка объектов

В SMP предоставляется возможность оценивать объекты системы и наглядно отображать их рейтинг.

Настройка процесса оценки объектов рассматривается на примере оценки статей базы знаний.

Настройка оценки объектов на примере статьи базы знаний

Описание процесса оценки статьи базы знаний в интерфейсе оператора:

  • пользователь выставляет оценку статье базы знаний:
  • оценка пользователя учитывается и рассчитывается средняя оценка статьи;
  • пользователь видит свою оценку и среднюю оценку статьи.

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

Определение класса, объекты которого будут оцениваться

Определите класс, объекты которого будут оцениваться. Оценка может выставляться объектам системных и пользовательских классов.

Для примера, в системе создается пользовательский класс "База знаний" (knBase) и тип "Статья" (article), см. Настройка классов и типов объектов.

Создание и настройка пользовательского класса "Оценка"

Возможность оценки объектов определяется наличием пользовательского класса "Оценка" (mark), вложенного в класс, объекты которого будут оцениваться. Объекты класса "Оценка" предназначены для хранения истории выставленных оценок. Объект класса "Оценка" автоматически создается при выставлении оценки объекту (статье базы знаний).

Выполните настройки класса "Оценка":

  1. Создайте пользовательский класс "Оценка" (mark), вложенный в пользовательский класс "База знаний" (knBase), см. Настройка классов и типов объектов.
  2. В классе "Оценка" (mark) создайте одноименный тип "Оценка" (mark), см. Настройка классов и типов объектов.
  3. В классе "Оценка" (mark) добавьте пользовательский атрибут "Поставленная оценка" (value), типа "Целое число" — в данный атрибут будет записываться оценка, которую выставил пользователь определенному объекту (статье Базы знаний), см. Настройка атрибутов класса и типа объектов:

Отображение в карточке статьи базы знаний списка всех выставленных оценок

В классе "База знаний" (knBase) на карточке объекта разместите контент "Список вложенных объектов" класса "Оценка" (mark), см. Контент "Список вложенных объектов".

Необходимо запретить добавление объектов из списка, чтобы исключить возможность "накручивания" средней оценки.

Создание и настройка справочника "Оценки"

Пользовательский справочник "Оценки" предназначен для добавления и хранения возможных вариантов оценок, выставляемых какому-либо объекту. Каждый элемент справочника представляет собой отдельную оценку. Название элемента справочника должно соответствовать выставляемой оценке.

Выполните настройки справочника "Оценки":

  1. Создайте пользовательский справочник "Оценки" (marks), см. Настройка справочника.

  2. В справочник "Оценки" (marks) добавьте элементы, см. Настройка папок и элементов справочника:

    • "1" (mark_1), файл с рисунком, соответствующим оценке 1: .
    • "2" (mark_2), файл с рисунком, соответствующим оценке 2: .
    • "3" (mark_3), файл с рисунком, соответствующим оценке 3: .
    • "4" (mark_4), файл с рисунком, соответствующим оценке 4: .
    • "5" (mark_5), файл с рисунком, соответствующим оценке 5: .

Добавление атрибутов для выставления и отображения оценки объекта

Атрибут "Оцените статью" используется для выставления оценки объекту. Атрибут "Ваша оценка" используется для отображения оценки после заполнения атрибута "Оцените статью". Атрибут "Средняя оценка" используется для отображения средней оценки объекта.

Выполните настройки пользовательских атрибутов в классе "База знаний" (knBase) , см. Настройка атрибутов класса и типа объектов:

  • "Оцените статью" (myMarkNew), типа "Элемент справочника", справочник "Оценки" (marks), представление для отображения: Название, представление для редактирования: Список элементов справочника, сортировка списка: по названию (все остальные параметры остаются со значениями по умолчанию).

  • "Ваша оценка" (yourMark), вычислимый, типа "Элемент справочника", справочник "Оценки" (marks), представление для отображения: Изображение (все остальные параметры остаются со значениями по умолчанию).

    // ПАРАМЕТРЫ ----------------------------------------------------------

    MARK = "mark" // Код класса "Оценка"

    VALUE = "value" // Код атрибута "Поставленная оценка" класса "Оценка"

    MARKS = "marks" // Код справочника "Оценки"

    MARK1 = "mark_1" // Код элемента справочника с оценкой "1"

    MARK2 = "mark_2" // Код элемента справочника с оценкой "2"

    MARK3 = "mark_3" // Код элемента справочника с оценкой "3"

    MARK4 = "mark_4" // Код элемента справочника с оценкой "4"

    MARK5 = "mark_5" // Код элемента справочника с оценкой "5"

    //ОСНОВНОЙ БЛОК--------------------------------------------------------

    def myMark

    try

    {

    myMark = utils.get(MARK, ['parent': subject, 'author': user])[VALUE];

    }

    catch (Exception e)

    {

    return;

    }

    if (myMark == 1)

    {

    return utils.get(MARKS, ['code': MARK1]);

    }

    if (myMark == 2)

    {

    return utils.get(MARKS, ['code': MARK2]);

    }

    if (myMark == 3)

    {

    return utils.get(MARKS, ['code': MARK3]);

    }

    if (myMark == 4)

    {

    return utils.get(MARKS, ['code': MARK4]);

    }

    if (myMark == 5)

    {

    return utils.get(MARKS, ['code': MARK5]);

    }

  • "Средняя оценка" (avMark), вычислимый, типа "Вещественное число" (все остальные параметры остаются со значениями по умолчанию).

    // ПАРАМЕТРЫ ----------------------------------------------------------

    MARK = "mark" // Код класса "Оценка"

    VALUE = "value" // Код атрибута "Поставленная оценка" класса "Оценка"

    //ОСНОВНОЙ БЛОК--------------------------------------------------------

    def marks = utils.find(MARK, ['parent': subject])

    def totalValue = 0

    marks.each { totalValue += it[VALUE] }

    return ((int)(totalValue/marks.size()*10))/10

Настройка действия по событию для создания объекта класса "Оценка" после редактирования атрибута "Оцените статью"

Действие по событию определяется скриптом:

  • Начало работы скрипта: изменение атрибута "Оцените статью" (myMarkNew) класса "База знаний" (knBase).
  • Результат выполнения скрипта: создается объект класса "Оценка" (mark), связанный с текущей статьей базы знаний. Выставленной оценке ставится в соответствие целое число, в зависимости от атрибута типа "Элемент справочника", для вычисления среднего значения оценки.

Выполните настройки действия по событию:

  1. Создайте и включите действие по событию "Оценка статьи базы знаний", типа скрипт, для класса "База знаний" (knBase), по событию "изменение объекта", выполнять синхронно Да, см. Скриптовое действие по событию.

    Действие "Действие — оценка статьи базы знаний" выполняется синхронно. Использование большого количества синхронных действий может привести к существенному снижению производительности системы.

    // ПАРАМЕТРЫ ----------------------------------------------------------

    MY_MARK_NEW = "myMarkNew" // Код атрибута "Оцените статью" класса "База знаний"

    MARK1 = "mark_1" // Код элемента справочника с оценкой "1"

    MARK2 = "mark_2" // Код элемента справочника с оценкой "2"

    MARK3 = "mark_3" // Код элемента справочника с оценкой "3"

    MARK4 = "mark_4" // Код элемента справочника с оценкой "4"

    MARK5 = "mark_5" // Код элемента справочника с оценкой "5"

    MARK_FQN = 'mark$mark' // Полный код типа "Оценка" класса "Оценка"

    VALUE = "value" // Код атрибута "Поставленная оценка" класса "Оценка"

    //ОСНОВНОЙ БЛОК--------------------------------------------------------

    def map = [(MARK1) : 1, (MARK2) : 2, (MARK3) : 3, (MARK4) : 4, (MARK5) : 5,];

    def value = map.get(subject[MY_MARK_NEW].code);

    utils.create(MARK_FQN, ['parent': subject, 'title': 'Оценка', 'author':user, 'value': value])

    utils.edit(subject, [(MY_MARK_NEW) : null])

  2. Добавьте скрипт-условие на действие по событию, который будет проверять изменение именно атрибута "Оцените статью" класса "База знаний", см. Условия выполнения действия по событию.

    // ПАРАМЕТРЫ ----------------------------------------------------------

    MARK_ARTICLE = "myMarkNew" // Код атрибута "Оцените статью" класса "База знаний"

    //ОСНОВНОЙ БЛОК--------------------------------------------------------

    if (oldSubject[MARK_ARTICLE].equals(subject[MARK_ARTICLE]) || !subject[MARK_ARTICLE])

    {

    return "Атрибут '${MARK_ARTICLE}' не изменился";

    }

    return "";

Отображение атрибутов оценки в карточках оцениваемых объектов

Выполните настройки для отображения атрибутов:

  1. Объедините атрибуты "Оцените статью","Ваша оценка" и "Средняя оценка" в группу атрибутов "Оценка статьи", см. Группы атрибутов.

  2. Разместите данную группу атрибутов на карточке оцениваемого класса объектов (например, класса "База знаний" (knBase)) в контенте "Параметры объекта", см. Контент "Параметры объекта".

  3. Атрибут "Средняя оценка" добавьте в группу атрибутов для отображения в списке статей базы знаний, см. Группы атрибутов.

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

Выполните настройки прав:

  1. Создайте маркеры прав, см. Настройка маркера прав.

    • маркер прав с атрибутом "Ваша оценка";
    • маркер прав с атрибутом "Оцените статью".
  2. В матрице прав установите значение маркеров Да.

  3. Добавьте скрипты, см. Настройка матрицы прав:

    • Для маркера "Ваша оценка" скрипт определяет, оценил ли пользователь статью базы знаний. Если да, то атрибут "Ваша оценка" доступен для просмотра.

      // ПАРАМЕТРЫ ----------------------------------------------------------

      param1 = "mark" // Код класса "Оценка"

      //ОСНОВНОЙ БЛОК--------------------------------------------------------

      def userMarks = utils.find('mark', ['parent': subject, 'author': user]).size()

      return userMarks > 0

    • Для маркера "Оцените статью" скрипт определяет, оценил ли пользователь статью базы знаний. Если нет, то атрибут "Оцените статью" доступен для просмотра.

      // ПАРАМЕТРЫ ----------------------------------------------------------

      param1 = "mark" // Код класса "Оценка"

      //ОСНОВНОЙ БЛОК--------------------------------------------------------

      def userMarks = utils.find('mark', ['parent': subject, 'author': user]).size()

      return userMarks == 0

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

Чтобы нелицензированные пользователи могли выставить оценки статьям базы знаний, необходимо дать им право на просмотр карточек и атрибутов класса "База знаний" (knBase), а также на редактирование атрибута "Оцените статью" (myMarkNew).

Выполните настройки прав:

  1. Добавьте пользовательскую вычислимую роль для класса "База знаний" (knBase), флажок "Определить права доступа пользователя к объекту" включен, см. Роли пользователей.

    Скрипт, определяющий права доступа пользователя к объекту.

    return true;

  2. Обратитесь в клиентский сервис ITSM 365 и сообщите код вычислимой роли для добавления в лицензионный файл. Загрузите лицензионный файл в систему, см. Выгрузка/загрузка данных в систему.
  3. Создайте профиль для нелицензированных пользователей с данной ролью, см. Добавление профиля прав доступа.
  4. Выполните для созданного профиля аналогичные настройки маркеров прав "Ваша оценка" и "Оцените статью" (см. Настройка прав на просмотр и редактирования атрибутов оценки объектов для лицензированного пользователя).

Оценка объекта в интерфейсе оператора

После выполнения вышеуказанных настроек пользователь может оценивать объекты класса "База знаний" (knBase).

Чтобы выставить оценку статье базы знаний, выполните следующие действия:

  1. В карточке компании перейдите на вкладку "База знаний".
  2. Откройте карточку статьи базы знаний.
  3. Нажмите ссылку "Редактировать" в блоке "Оценка статьи".
  4. На форме редактирования выберите оценку из раскрывающегося списка и нажмите кнопку Сохранить.

После этих действий в карточке статьи в блоке "Оценка статьи" отобразится ваша оценка и средняя оценка статьи.