Работа с таблицами

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

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

Для создания используйте кнопку [Таблица], которая вызывает окно мастера таблиц.

На вкладке «Свойства таблицы» мы задаем число строк и столбцов, выбираем расположение заголовков. Также здесь можно задавать размеры таблицы, толщину границ и отступы. В блоке «Выравнивание» настраивается обтекание текстом. На вкладке «Дополнительно» можно задать CSS-стиль оформления, а также присвоить таблице уникальный идентификатор, который используется для автоматической нумерации.

Чтобы отредактировать эти свойства, можно в любой момент вернуться к мастеру, используя пункт «Свойства таблицы» контекстного меню таблицы в режиме редактирования.

Настройка таблиц

Для настройки и редактирования свойств таблицы используйте ее контекстное меню. Оно позволяет добавлять строки и колонки, разбивать и объединять ячейки. Каждой ячейке мы можем задавать индивидуальные свойства – высоту и ширину, цвет фона и границ, выравнивание и переносы текста, а также присваивать свойства заголовка.

Кроме мастера создания и редактирования таблиц, мы можем использовать язык разметки (доступ с помощью кнопки [Источник] панели инструментов редактора). Приведенная на рисунке выше таблица в разметке будет выглядеть следующим образом:

Результат рендеринга разметки:

Размещение данных

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

Проиллюстрируем вышесказанное:

Импорт готовых таблиц

Импортировать готовые таблицы можно двумя способами:

1) используя буфер обмена – копируя таблицу в исходном документе и вставляя ее в вики-статью в режиме редактирования;
2) с помощью отдельной процедуры импорта – создавая документ по специальному шаблону «Страница из Office» и загружая в него файл с исходной таблицей, процедура импорта описана в статье "Импорт документов из файлов Office".

Сортировка и фильтрация данных

Наша платформа позволяет включать сортировку и фильтрацию данных в таблицах, для этого используется макрос «Sortable Table». В нем задаются два параметра:

1) "Sortable" (yes/no) – отвечает за сортировку данных по колонкам;
2) "Filtrable" (yes/no) – добавляет к заголовку таблицы поля фильтрации значений.

Простые вычисления в таблицах

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

Макрос «Calc»

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

1. Помещаем макрос в целевую ячейку, куда хотим вывести результаты вычислений.
2. В поле "Formula" макроса задаем формулу расчета с указанием ячеек-источников данных. Например, формула $A*$B+2*$C вычисляет произведение значений в первых двух ячейках текущей строки и прибавляет к нему удвоенное значение третьей. Символы A,B и C обозначают позицию ячейки (A – ячейка первой колонки, B – второй и т.д.); вместо заглавных латинских букв можно использовать выражение row.get(#), где в скобках дается номер колонки; в этом случае формула будет выглядеть так: $row.get(1)*$row.get(2)+2*$row.get(3).
3. В поле "Format" задается формат вывода результат вычислений – число знаков после точки (по умолчанию 0.00), также здесь можно задать единицы измерения.

Код макроса в разметке выглядит следующим образом:

Рассмотрим пример таблицы с вычисляемыми строками в разметке.

Результат рендеринга представлен ниже:

Ячейки колонки D являются вычисляемыми.

Макрос «Sum»

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

Код макроса в разметке выглядит следующим образом:

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

Результат рендеринга кода разметки:

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

Макрос «Summary»

Данный макрос позволяет нам проводить агрегацию данных и создавать сводные таблицы из нескольких таблиц-источников, находящихся на одной странице. Совместим с макросами «Sum» и «Calc» и учитывает результаты их вычислений.

Макрос «Summary» имеет следующие настройки (см. рисунок):

1) поле «Type» отвечает за тип сводной таблицы – по заголовкам (heading) или по колонкам (column), подробности чуть ниже;
2) в поле «Title» задается имя сводной таблицы;
3) в поле «Summary Title» вносится название итоговой строки сводной таблицы;
4) поле «Format 1» отвечает за формат вывода данных первой колонки сводной таблицы (здесь же можно задать единицы измерения);
5) поле «Format 2» отвечает за формат вывода данных второй колонки сводной таблицы (здесь также можно задать единицы измерения).

Если полю «Type» присвоено значение "heading", то элементы группируются по заголовкам разделов, в которых находятся таблицы-источники. Если полю «Type» присвоено значение "column", то элементы группируются по значению первого столбца таблицы-источника. 

К примеру, на странице имеется две таблицы с однотипными данными, которые будут служить источниками для сводных таблиц. Используя макрос «Summary», мы легко можем агрегировать данные из них; при этом мы можем получить сводные таблицы двух типов:

Код макроса этих двух сводных таблиц в режиме разметки будет выглядеть так:

Макрос «Summary» работает в пределах одной страницы. Если есть необходимость проводить агрегацию данных из разных вики-разделов и статей, используется более мощный инструмент – специальное расширение «Live Table».