Skip to main content

Доработки модуля ввода данных

Бизнес-требования

  • Пользователь должен видеть корректную подпись и форматирование строки итогов, без схлопывания текста и с явным словом «Итого»; ввод и отображение должны соответствовать типу данных полей.
  • После удаления строк идентификаторы строк должны оставаться последовательными и предсказуемыми для ссылок, формул и интеграций.
  • Наличие комментария к ячейке должно быть заметно в интерфейсе без открытия каждой ячейки.
  • Ограничения видимости столбцов формы, заданные в DIS для пользователя, не должны обходиться при открытии той же формы во Fastboard: пользователь не видит столбцы, которые ему запрещены.
  • В модальных окнах со длинными списками выбора должен быть быстрый поиск по списку.
  • В базовом и режиме редактирования доступность элементов настройки и работы с формой должна соответствовать правилам: выражение настраивается только в режиме редактирования; строка итогов доступна всегда; бизнес-процесс виден в режиме редактирования, но не настраивается; консолидация работает в штатном режиме без лишних ограничений.

Решение

Строка итогов

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

Расположение:

  • Модуль ввода данных → ПКМ по форме → Добавить/редактировать строку итогов → Модальное окно редактирования строки итогов

Изменения:

  • Добавить чекбокс "Показывать подпись «Итого» в первом столбце", по умолчанию не выбран
    • Если выбран чекбокс "Показывать подпись «Итого» в первом столбце", то для первого столбца в блоке выбора операции агрегирования будет недоступен раскрывающийся список
  • В раскрывающихся списках для выбора агрегации недоступны варианты, которые не применимы для типа данных столбца: функции СУММ, СРЗНАЧ, ПРОИЗВЕД, МАКС, МИН не работают на столбцах с НЕ числовым типом данных
Системная логика – фронтенд
  • Если выбран чекбокс "Показывать подпись «Итого» в первом столбце", то блокируется возможность подсчета итогов по этому столбцу, в этом столбце в строке итогов пишется "Итого"+
  • В раскрывающихся списках для каждого столбца должны быть только те варианты агрегации, которые доступны для указанного типа:
    • Для типов "Целое число" и "Дробное число" – все варианты агрегации
    • Для остальных типов – варианты агрегации НЕ СЧИТАТЬ, СЧЁТ, СЧЁТЗ

Пересчёт идентификаторов строк при удалении

Системная логика – бэкенд

При выполнении запроса на удаление (table/{tableId}/batch с передачей в теле запроса непустого массива delete) пересчитывать идентификаторы в системном столбце id заново, начиная с 1 по порядку без пропусков и возвращать на фронт

Визуальная индикация комментария к ячейке

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

Расположение:

  • Модуль ввода данных → ячейки формы

Изменения:

  • Ячейка с комментарием отличается от ячейки без комментария: добавляется маркер угла
  • При наведении на ячейку с маркером комментария доступен просмотр текста комментария.
Системная логика – бэкенд
  • Возвращать на фронт вместе с данными ячеек метку hasComments логического типа для каждой ячейки формы: True, если есть хотя бы один комментарий, False, если нет ни одного комментария
  • Возвращать на фронт вместе с меткой комментария список комментов массивом объектов:
    • каждый объект включает в себя текст комментария, автора, дату и время создания, 
    • отдельный массив для каждой ячейки с комментариями
Системная логика – фронтенд
  • При наличии комментария у ячейки (hasComments = "True") рисовать маркер на углу ячейки
  • При наведении курсора на ячейку с комментариями показывать во всплывающем окне комментарии списком в формате:
    • Блок первого комментария:
      • Автор + дата/время
      • Комментарий
      • Строка отступа
    • Блок второго комментария
    • и т.д. для всех комментариев
  • Если комментариев больше 5, то показывать последние 5

Согласованность ограничений видимости столбцов МВД и Fastboard (CLS)

Краткий сценарий:

  • МВД отдает в FB список в формате: юзер айди в FB: список запрещенных столбцов
  • Бэк FB создает таблицу-связь между юзерами и источниками-МВД
  • В этой таблице-связи указываются userId, sourceId, bannedColumns – запрещенные колонки
  • Фронт запрашивает file_preview от имени юзера. Бэк отдает только те колонки, которых нет в bannedColumns
  • При вызове запроса на формирование скрипта с колонкой, которая недоступна пользователю (например, при вызове script/{id}/table/without-save) не пропускать такие запросы с возвратом ошибки
  • Если есть возможность, контролировать загрузку данных из таких источников: например, устанавливать constraint для столбцов для определенных юзеров

Системная логика – бэкенд МВД
  • При получении запроса PUT table/{tableId}/access/columns на обновление прав доступа к таблице передавать в Fastboard тело запроса с фронта:
    • Заменяя user_id на user_id в Fastboard
    • Добавляя table_id той формы, из которой пришли изменения
    • Оставляя только can_read, игнорируя can_edit
{
  "table_id": "id",
  [
      {
          "column_name": "string",
          "permissions": [
              {
                  "user_id": "id",
                  "can_read": "boolean"
              }
          ]
      },
      {
          "column_name": "string",
          "permissions": []
      }
  ]
}

 

Системная логика – бэкенд Fastboard
  • Требуется таблица-связь пользователей с источниками, необходимо, чтобы в этой таблице было поле bannedColumns (запрещенные столбцы)
  • Настроить получение от МВД запросов на ограничение доступов к столбцам определенных источников, определенных пользователей:
    • Если для user_id и table_id приходит column_name с permission.can_read = "False", то в таблицу-связь этого юзера и этой таблицы источника-МВД добавляется значение column_name в bannedColumns
  • При любых запросах с фронта к этой таблице возвращать только те столбцы, которых нет в bannedColumns (например, в запросе file_preview)
  • При вызове запроса на формирование скрипта с колонкой, которая недоступна пользователю (например, при вызове script/{id}/table/without-save) не пропускать такие запросы с возвратом ошибки
  • Если есть возможность, контролировать загрузку данных из таких источников: например, устанавливать constraint для столбцов таблиц для определенных юзеров
    • Если такой возможности нет, написать об этом в таске

Поиск по спискам в модальных окнах

Проблема: во многих полях ввода есть шеврон для раскрытия списка, но самого списка, по сути, нет – система отдает в формате подсказки возможные варианты

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

Расположение:

  • Модуль ввода данных -> модальные окна с длинным списком выбора (конкретный перечень — в подзадаче инвентаризации).

Изменения:

  • Над списком или в шапке модального окна — поле поиска с фильтрацией по подстроке без учёта регистра (или по правилам продукта).
  • Пустой поиск показывает полный список; при отсутствии результатов — понятное сообщение.
Системная логика – фронтенд
  • Реализация поиска для модалок со списком целиком на клиенте: фильтрация уже загруженного списка; при необходимости дебаунс ввода.
  • Для модалок, где список подгружается с сервера страницами, при доработке API — параметр поиска в запросе списка и согласованное поведение пустой выдачи (оформляется отдельным подпунктом при появлении изменений на бэкенде).

Базовый режим и режим редактирования: доступность элементов

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

Расположение:

  • Модуль ввода данных -> панели и меню настроек формы.

Правила доступности:

  • Выражение: настройка «Выражение» доступна только при включённом режиме редактирования; в базовом режиме скрыта или недоступна.
  • Строка итогов: работает всегда, вне зависимости от режима (отображение и использование итогов; при отдельном редакторе правил итогирования границы базового режима согласовать с продуктовой политикой, см. примечания).
  • Бизнес-процесс: в режиме редактирования секция отображается, элементы настройки привязки и параметров недоступны (только просмотр, read-only или disabled).
  • Консолидация: в обоих режимах без искусственного отключения в базовом режиме, если иное не следует из политики безопасности.
Системная логика – фронтенд
  • Единые флаги режима редактирования для условного рендера и недоступности (disabled) элементов настройки; единые точки входа для меню и панелей настроек.

Критерии приёмки

  • В строке итогов отображается слово «Итого» (или локализованный эквивалент); при стандартных размерах окна и колонок текст не сливается в нечитаемую строку; значения итогов соответствуют типам столбцов, при ошибке типа пользователь видит явную обратную связь.
  • В консолидации при сопоставлении полей допустимы символы, согласованные с бэкендом, без ограничения «только латиница»; алиас задаётся, сохраняется и отображается в интерфейсе настроек и связанных местах.
  • После удаления строк набор идентификаторов или порядковых номеров согласован с зафиксированной в реализации моделью и не ломает консолидацию, ссылки и повторное открытие формы; отображаемая нумерация без «дыр», если нумерация показывается.
  • Ячейка с комментарием визуально отличима сразу после добавления комментария и при последующем просмотре таблицы.
  • Пользователь с запретом на столбцы в DIS не видит эти столбцы во Fastboard при загрузке и дальнейшей работе; для этого пользователя не передаётся содержимое запрещённых столбцов в обход правил CLS.
  • В согласованном перечне модальных окон модуля ввода данных поиск по списку фильтрует элементы ожидаемо; при отсутствии совпадений отображается понятное состояние пустого списка.
  • В базовом режиме настройка выражения недоступна; строка итогов отображается и используется; консолидация работает штатно; в режиме редактирования выражение настраивается; бизнес-процесс виден, но не настраивается.

Примечания для постановки в работу

  • Уточнить у заказчика, относится ли формулировка «строка итогов работает всегда» только к просмотру итогов или также к изменению правил итогирования в базовом режиме — от этого зависит точное правило disabled для редактора итогов.
  • Для поиска в модальных окнах зафиксировать явный список экранов в подзадаче инвентаризации.
  • При необходимости запрета обхода настроек через прямой вызов API добавить проверки на бэкенде и тогда дополнить соответствующий подраздел документа разделом «Системная логика – бэкенд».
Back to top