Примеры форматирования

Сценарий 1. Форматирование данных, отображаемых в индикаторе

В Desktop Designer вы можете создать индикатор для вывода какой-либо значимой информации и отформатировать это значение для создания эффектной визуализации данных. Для реализации данного сценария необходимо выполнить несколько шагов:

1. Создать индикатор на базе виджета Текст;

2. Вывести нужное значение и отформатировать его:

   • округлить;

   • изменить цвет значения и фона;

   • разделить разряды значения для удобного восприятия.

3. Изменить цвет значения и фона.

Шаг 1. Создание индикатора на базе виджета Текст

Dasktop Designer позволяет создать индикатор на базе виджета Текст. Для этого выполните следующие шаги:

1. Откройте приложение Desktop Designer.

2. Создайте новый дашборд или откройте существующий.

3. Перейдите на вкладку Вставка и выберите виджет Текст:

   

4. Привяжите виджет к базе данных и укажите необходимый показатель и измерение. В нашем примере это база данных ViQube и показатель Цена за единицу.
   Просмотреть загруженные данные можно нажав на кнопку Просмотр данных в виде таблицы:

   

5. Для завершения создания индикатора озаглавим его. Можно также изменить фон заголовка:

   

Шаг 2. Вывод нужного значения и его форматирование

Теперь достаточно ввести команду @value в поле Настройка текста > Текст для вывода в виджет самого первого значения таблицы. Но у нас другая задача. Нам нужно вывести определенное значение и отформатировать его. Для этого нам необходимо сделать следующее:

• вывести данные, например, по февралю (вторая строка таблицы);

• округлить значение;

• добавить слово руб.;

• разделить разряды значения для удобного восприятия.

Все это можно выполнить одной командой, введенной в поле Текст:

Math.round(@array[1]).toLocaleString('ru') + " руб."

Где
Math.round – функция округления;
@array[1] – строка с необходимым нам значением. В таблице это вторая строка, но мы указали 1, так как первая строка имеет индекс 0.
toLocaleString('ru') – преобразует числовое значение в строковое и возвращает это значение, используя указанный языковой стандарт;
+ " руб." – добавленный текст.

То же самое можно сделать и другими способами:

Math.round(@value).toString().replace(/(?!^)(?=(?:\d{3})+(?:.|$))/gm, '')+ " руб."
или
Math.round(@array[1]).toString().replace(/\B(?=(\d{3})+(?!\d))/g, " " )+ " руб."

Шаг 3. Изменение цвета значения и фона

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

Форматирование данных, отображаемых в графике

Desktop Designer позволяет гибко настраивать визуализацию отображаемых данных для фокусировки внимания на их отдельных элементах в графиках, гистограммах и т.д. В нашем примере мы будем придерживаться следующего сценария:

• Загрузка графика с настроенными данными.

• Форматирование значений.

  • Изменение значений по оси Y.

  • Изменение значений по оси Х.

  • Изменение значений на точках графика.

Шаг 1. Загрузка графика с настроенными данными

1. Откройте приложение Desktop Designer.

2. Откройте ранее созданный дашборд:
   

   

3. Выберите виджет, который хотите отформатировать. В нашем примере это График:
   

   

4. На вкладке Настройки озаглавим график и изменим фон заголовка:
   

   

Шаг 2. Форматирование значений

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

Начнем со значений по оси Y. В данный момент на оси отображаются четырехзначные числа, что не всегда удобно. Давайте заменим их на сокращенный вариант. Для этого введем следующую команду в поле Ось Y > Форматирование:

@value > 1000 ? @value/1000+' тыс.':@value

Где
@value > 1000 – условие, при котором значение должно быть больше тысячи (в нашем примере это все значения по оси Y);
@value/1000 – деление значения на 1000, если удовлетворяется условие;
+' тыс.' – добавление текста к значению.

Теперь заменим сокращенные названия месяцев по оси Х на полные названия. Для этого выполним следующую команду в поле Ось Х > Форматирование:

@value == 'Янв' ? @value = 'Январь' :@value && @value == 'Фев' ? @value = 'Февраль':@value && @value == 'Мар' ? @value = 'Март' :@value &&@value == 'Апр' ? @value = 'Апрель' :@value &&@value == 'Май' ? @value = 'Май' :@value &&@value == 'Июн' ? @value = 'Июнь' :@value &&@value == 'Июл' ? @value = 'Июль' :@value &&@value == 'Авг' ? @value = 'Август' :@value

Где
@value == 'Янв' – условие, при котором значение должно быть Янв;
@value = 'Январь' – замена значения новым (Январь) при удовлетворении условия;

И, наконец, расставим значения на точках и немного модифицируемым их. Для этого выполним следующие действия:

1. Нажмите на Подписи и поставьте галочку на Подписи точек/столбцов – отобразятся значения на точках графика:
   

   

2. Теперь выделим значения жирным и добавим к ним слово шт. Для этого воспользуемся следующей командой:
   '<b>'+@value.y + '</b>' + ' шт.'
   Где
   '<b>'+@value.y + '</b>' - все значения по оси Y, обрамленные HTML тэгами, которые делают текст жирным;
   ' шт.' – добавленный текст.
   

   

Также, с помощью настроек, можно поменять цвет фона, добавить рамку и тень: