⟵ сюдатуда ⟶
  • Таблицы
  • Общий вид
  • Плейсменты
  • Управление
  • Дерево
  • Настройки вида
  • Поля
  • Типы полей
  • Отображение скрытых полей
  • Индикация настроек
  • Дополнительная информация по полю
  • Фильтрация по значениям
  • Поиск значений
  • Изменение данных
  • Редактирование настроек поля
  • Редактирование значений
  • Строка добавления
  • Редактирование источника для селектов
  • Редактирование в окнах
  • Панель
  • Редактирование порядка строк
  • Сопутсвующее
  • Нотификации
  • Печать
  • Отладка
  • Секции
  • Назначение секций
  • Место и вид хранения настроек секций
  • Параметры секций
  • Документация

    Интерфейс

    Таблицы

    Общий вид

    Видео-инструкция c таймкодами ⟶

    Все таблицы имеют типовой вид и смешанный интерфейс создатель-пользователь. Элементы интерфейса, видимые только создателю, имеют красный цвет.

    Типовой вид таблицы Totum:

    Общий вид таблицы

    Плейсменты

    Таблицы имеют 4 базовых плейсмента для размещения полей картинка 👆.

    • Хедер — расположен после заголовка таблицы. Поля автоматически переносятся на следующую строку при уменьшении размера окна.

    • Префильтр — определяет условия фильтрации значений Строчной части передаваемые в браузер пользователя.

    • Строчная часть — может иметь множество колонок в ширину, для горизонтальной прокрутки используйте клик-энд-драг левой кнопкой мыши.

    • Футеры

      • Футеры колонок — расположены под соответствующими колонками строчной части.
      • Общий футер — расположен после строчной части, функционал аналогичен Хедеру.

    Тот или иной плейсмент может отсутствовать в зависимости от типа таблицы:

    Области таблиц

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

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

    Порядок аналогичен расположению в таблице: Хедер —> Префильтр —> Строчная часть —> Футеры колонок —> Футер.

    Управление

    Управление таблицей

    • Name-таблицы — задается при создании, не изменяется, кликабелен. При клике левой кнопкой мыши сохраняет name в буфере и используется для дальнейшей вставки в код.

    • Тип таблицы — задается при создании, в последствии не изменяется.

    • Список таблиц и Список полей — параметры таблицы и полей в том виде в котором они хранятся в схеме. Смотри раздел документации по системным таблицам.

    Дерево

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

    Показываются в соответствии со своим номером сортировки. Возможно скрыть таблицу из дерева для всех или только для отдельных ролей.

    Дерево отображается в виде верхнего меню категорий и левой колонки. Колонку с деревом можно скрыть.

    Дерево

    Показаны все типы таблиц с соответствующими им иконками расположенные как в дереве так и в цикле.

    Настройки вида

    Пользователи и Создатель могут настраивать и сохранять удобные им виды отображения полей.

    Для этого используется 👁 (глаз) расположенный под заголовком таблицы.

    При помощи наборов быстро переключатся между различными наборами полей.

    Глаз

    • Индивидуальные настройки полей сохраняются для связки пользователь-браузер.

    • Создатель имеет возможность переводить свои персональные настройки в общедоступные (хранящиеся на сервере).

    Одинарный щелчок правой кнопкой мыши на глазе выводит вид по умолчанию, двойной используется для Создателя для скрытия видимых только ему полей.

    Поля

    Типы полей

    В Тотум 15 стандартных типов полей. Для роли Создатель тип поля всегда отображается в заголовке в виде иконки!

    Список полей с их иконками:

    Типы полей

    • Тип в виде иконки.

    • Номер сортировки в плейсменте.

    • Для типа Ярлык тип поля источника.

    • Заголовок поля.

    • Name-поля (он кликабелен, при клике сохраняется в буфер для последующей вставки в код).

    • Выпадающее меню (для пользователей оно может быть скрыто).

    Отображение скрытых полей

    Если поле скрыто (постоянно или временно), то для Создателя оно все равно будет отображаться специальным образов в области между name-таблицы и Хедером/Префильтром/Строчной частью.

    Есть несколько особенностей индикации скрытых полей:

    Скрытые поля

    Для того что бы определить к какому плейсменту относится скрытое поле есть специальный индикатор.

    Определение плейсмента скрытого поля

    Индикация настроек

    При наличии некоторых наиболее часто встречающихся настроек полей в заголовок поля выведена их индикация.

    Список иконок индикации:

    Индикация настроек

    При клике на иконки индикации в заголовке поля открывается меню с пояснениями.

    • Индикация поля и направления сортировки по умолчанию — все таблицы имеют в настройках поле сортировки (для этого примера это id). В заголовке таблицы есть соответствующая индикация этого поля с указанием направления сортировки.

    Дополнительная информация по полю

    Доступна по каждому полю при клике правой кнопкой мыши на поле.

    Панелька

    Фильтрация по значениям

    Доступна при включенной опции поля Фильтр по полю.

    Для расчетных полей с зафиксированными значениями возможна фильтрация по признаку фиксации.

    Фильтр

    Поиск значений

    Во всех строках поиска имеющихся в Тотум реализован поиск по вхождениям вводимых значений без учета регистра.

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

    Например:

    Значения
    Поле 1
    Поле 2
    Поле 3

    Поиск: по → Результат: Поле 1, Поле 2, Поле 3

    Поиск: по 2 → Результат: Поле 2

    Поиск: 2 по → Результат: Поле 2

    Изменение данных

    Редактирование настроек поля

    Доступ к редактированию настроек, дублированию и созданию новых полей — через выпадающее меню (для роли Создатель доступно всегда).

    Быстрый способ открыть панель редактирования поля — клик правой кнопкой мыши на иконке выпадающего меню.

    Настройки поля

    • Дублировать — открывает панель редактирования в режиме добавления поля, подставляя в нее настройки текущего поля.

    • Вставить — открывает панель редактирования поля в режиме добавления нового поля подставляя текущую таблицу, плейсмент, сортировку (sort + 10), при успешном добавлении сдвигает у всех последующих полей сортировку на +10.

    • Удалить — запускает таймер удаления поля. Таймер настраивается в Составе таблиц. При достижении нулевой точки обратного отсчета, поле удаляется безвозвратно.

    Редактирование значений

    Поля на редактирование открываются двойным кликом левой кнопкой мыши.

    При выделении нескольких полей (доступно для строчной части) возможно применение нового значения ко всем выделенным полям.

    Множественное редактирование

    Если поле имеет код то при вводе значения вручную или кодом-действия оно будет зафиксировано на этом значении. Для сброса зафиксированного значения используйте ластик, а для кодов-действий функцию clear().

    Управление с клавиатуры:

    • ENTER— сохраняет.

    • ESC — отменяет.

    • SHIFT+ENTER — сохраняет и переводит на ячейку вниз (для строчной части).

    • ALT+ENTER — сохраняет и переводит на ячейку вправо (для строчной части).

    • SHIFT+CLICK — выделяет область.

    • ALT+CLICK — расширяет выделение.

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

    • +10 — сложение, прибавит 10.

    • +-10 — вычитание, отнимет 10.

    • *10 — умножение, умножит на 10.

    • /10 — деление, разделит на 10

    • % — проценты:

      • +10% — добавит 10%
      • +-10% — вычтет 10%

    Строка добавления

    Строка добавления всегда показывается первой (верхней) в таблице и имеет специальное цветовое выделение.

    Введенные значения сохраняются в базу только после сохранения строки. Обращение к этим значениям из других таблиц возможно только после сохранения.

    Кнопки в строке добавления всегда заблокированы!

    Сохраненные строки до обновления страницы показываются сверху таблицы, независимо от типа сортировки таблицы.

    Для таблиц с n-сортировкой доступна опция Показывать по месту сортировки сразу после сохранения.

    Строка добавления

    • ENTER — сохраняет и переводит на ячейку вправо.

    • ESC — отменяет ввод.

    • TAB — сохраняет и переводит на ячейку вправо.

    В таблицах c табличной единицей пересчета место строки добавления в порядке расчета — в конце (несмотря на ее отображение). Таким образом возможно обращение к значениям предыдущих строк.

    Место строки добавления

    Строка добавления не имеет id!

    Если для таблицы активна панель, то добавление может быть осуществлено через панель.

    Редактирование источника для селектов

    Если для типа поля Селект и Селект-дерево настроен параметр Таблица селекта для изменения, то при открытии поля на редактирование возможно получить доступ к панели в таблице источнике.

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

    Источник

    Редактирование в окнах

    Типы полей Текст, Селект-дерево, Данные и Файл имеют всплывающие окна, в которых осуществляется редактирование их значений.

    Некоторые типы полей редактируются во всплывающих окнах.

    Например Селект-дерево:

    Селект-дерево

    Например редактор Текст-JSON:

    JSON

    Панель

    Если включен параметр таблицы Панель, то строки могут быть показаны в виде панели.

    Панель формируется автоматически и содержит 2 колонки, порядок полей сохраняется по вертикали — сначала левая колонка, потом правая.

    Панель

    Сохранение измененных значений происходит в момент нажатия кнопки Сохранить.

    Если выбрано несколько строк, то панели этих строк будут открыты последовательно.

    Редактирование порядка строк

    Для таблиц у которых включена Сортировка по полю порядок возможно вручную задавать порядок строк.

    Сортировка

    К полю содержащему порядок сортировки строк можно обратиться из Кодов через #n или select(...; field: 'n'; ...).

    При изменении сортировки, номера n изменяются в соответствии с новым порядком.

    При вставке новой строки между существующими в табличной единице пересчетаn обновляется для всех последующих строк.

    Для таблиц со строчной единицей пересчета — при вставке полей через insert(...; after: id), n приобретает дробное значение вида 3.0001. Каждая следующая вставка добавляет 3 ноля перед дробной единицей 3.0000001.

    Дробное число может быть большим, но если вы знаете, что у вас новые строки постоянно добавляются перед существующими — производите периодическую нормализацию n при помощи функции normalizeN().

    Сопутсвующее

    Нотификации

    В Тотум встроен механизм нотификаций.

    Нотификации показываются в верхнем правом углу. Пользователь может их закрыть или отложить уведомление на 10 минут.

    Наличие нотификаций проверяется по настраиваемому интервалу.

    Нотификации

    Печать

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

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

    Печать

    Помимо этого можно изменять шаблон печати, а также вызывать печать при помощи кнопок и функции linkToPrint.

    Отладка

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

    После того как будет произведена запись отладочной информации можно вызвать окно отладчика (подробнее смотрите раздел отладка).

    Отладка

    Секции

    Назначение секций

    Секции позволяют структурировать интерфейс в хедере и футере.

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

    Секции

    Поля внутри секций могут быть объединены в группы blocknum имеющие собственные номера. Это выполняется при помощи функции setFloatFormat() параметром blocknum:.

    При недостаточной ширине экрана поля будут переносится в пределах группы.

    Поля могут быть перенесены принудительно параметром nextline: true функции setFloatFormat().

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

    Место и вид хранения настроек секций

    Настройки секции хранятся в параметре Заголовок (sectionTitle) в виде строки и применяются только при активном параметре С новой строки (tableBreakBefore) в первом поле секции.

    Если поле будет отключено в параметре Показывать в WEB (showInWeb), то параметры секции также перестанут быть активными.

    При скрытии поля через глаз параметры секции не отключаются.

    Если у поля активно С новой строки (tableBreakBefore) но отключен Заголовок (sectionTitle), то поле будет отображаться с новой строки и будет наследовать параметры предыдущей секции. В отличии от nextline: true функции setFloatFormat() поле будет отделено от группы даже если имеет такой же blocknum:.

    Вид настроек секции:

    • ** — инициализируют начало строки с параметрами секции.

    • : — разделяет параметр и его значение.

    • , — разделяет номера групп и неймы полей при их перечислении.

    • ; — разделяет параметры.

      Заголовок секции**param_1:blocknum,field_name:value;param_2:blocknum,field_name:value;
      
      Заголовок секции**plate:1:yellowgreen; -- назначает плашке группы 1 цвет yellowgreen
      

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

    Создание секции

    Для редактирования и удаления — клавиши управления рядом с названием Секции. При редактировании первая строка всегда зарезирвирована под название секции. Если вы хотите, что бы название было пустым — оставьте первую строку пустой.

    Редактирование секции

    Параметры секций

    • label: false — скрывает заголовок секции.

    • gap: 10 — добавляет отступ между полями в секции.

    • gap: 1, 2, fieldname1 : 10 — изменяет отступы в конкретных группах и полях.

    • title: false or true — режим в котором скрываются названия полей.

    • title: 1, 3, fieldname1 : false or true — только для определенных номеров групп и полей.

    • border: false or true or color — назначает обводку и стандартный background поля. /

    • border: 1, 2, fieldname1 : false or true or color — для конкретных групп и полей. /

    • plate: false or true or yellowgreen — замена цвета плашки или ее отмена если передать false. /

    • plate: 1, 3 : false or true or yellowgreen — для конкретных групп. /

    • outline: true or false or yellowgreen — добавляет обводку для всех групп. Если указан цвет, то с цветом. /

    • outline: 1, 2 : true or false or yellowgreen — для конкретных групп. /

    • plateh: 400 or 80vh or false — устанавливает высоту всех групп. /

    • plateh: 2 : 400 or 80vh or false — устанавливает высоту конкретной группы. /

    • platemh: 400 or 80vh or false — устанавливает максимальную высоту всех групп. /

    • platemh: 2, 3 : 400 or 80vh or false — устанавливает максимальную высоту конкретных групп. /

    В border, plate, outline, plateh и platemh можно указать значение через / — значение перед дробью будет работать, когда в секции нет переноса групп из-за недостаточной ширины экрана. После дроби — когда есть перенос.

    Например: plate: 1 : false/true — до переноса плашка будет скрыта, после переноса хотя бы одной группы — показана.

    В plateh и platemh может быть использован CSS calc

    CSS calc

    При редактировании первая строка всегда зарезирвирована под название секции. Если вы хотите, что бы название было пустым — оставьте первую строку пустой.

    ⟵ сюда туда ⟶