Тултипы (подробное описание)
Общая информация#
Для размещения справочной информации на аналитическом элементе (в некоторых видах отображения) существуют метки и тултипы. Функционал марок и тултипов довольно схожий, однако тултипы отличаются тем, что отображаются только по наведению, и у одной точки может быть только один тултип.
Далее мы будем рассматривать пример конфигурации метки на карте, поскольку на ней для одной координаты возможно наличие нескольких срезов (наборов серий по одному значению листового измерения).
Исходные данные#
Допустим, мы имеем следующий набор мер и измерений:
Тогда, для одной из координат ([59.93895,30.315636]) мы имеем следующий набор данных:
| Измерение/Мера | НМЦК (СРЕД) | Количество или объем (СУММ) |
|---|---|---|
| САНКТ-ПЕТЕРБУРГ | 843 400 474 | 781 375 |
| ЛЕНИНГРАДСКА ОБЛ | 137 111 260 | 822 |
Срезы же будут такие:
НМЦК (СРЕД) | САНКТ-ПЕТЕРБУРГ | 843 400 474
НМЦК (СРЕД) | ЛЕНИНГРАДСКАЯ ОБЛ | 137 111 260
Количество или объем (СУММ) | САНКТ-ПЕТЕРБУРГ | 781 375
Количество или объем (СУММ) | ЛЕНИНГРАДСКАЯ ОБЛ | 822
Наполнение#
Чтобы сконфигурировать текст метки/тултипа, в редакторе имеются следующие вспомогательные элементы:
- Токен-переменная (начинается с символа
#) - позволяет выбрать конкретные данные из конфигурации, которые необходимо отобразить в данном месте (название меры/измерения, значение меры/измерения):
- Токен-срез (начинается с символа
$) - позволяет вывести конкретное значение среза через выбор значений измерений/мер:
Важное замечание
Если конфигурация среза в токене не совпадает со срезом, который используется для вывода информации, то будет выведен прочерк -. Чтобы избавиться от ненужных срезов, используйте фильтры (см. раздел "Фильтрация").
- Повторяющийся блок (контент в квадратных скобках
[]) - позволяет вывести данные по всем срезам, которые имеются для данной точки:
- Экранированные скобки (квадратные скобки со слешом
\[,\]) - позволяют не учитывать квадратные скобки при формировании повторяющегося блока, например, для вывода массива данных:
Повторяющийся блок#
Когда в опредленной точек на карте/графике имеется несколько срезов, нужно уметь выводить для них данные. По умолчанию срез, который используется для токена-переменной и токена-среза, - это первый срез в массиве. Например, если мы для нашего примера попытаемся вывести данные для переменной #Мера, то из всех четырех срезов, которые имеются у нас в примере, будет использован только первый срез и будет выведено число 843 400 474.
Для того, чтобы вывести информацию по всем срезам, имеется функционал повторяющегося блока. Он работает следующим образом: проходя слева направо по тексту происходит поиск контента между открывающей и закрывающей квадратной скобкой (для котрывающей скобки находится первая закрывающая скобка). Весь контент и все форматирование (включая переносы), которое находится между скобками, дублируется по кол-ву серзов в данной точке.
Фильтрация#
В случае, если необходимо использовать часть срезов в точке или необходимо ограничить вывод информации только для одной точки, необходимо использовать функционал фильтрации.
Например, мы хотим вывести информацию только для региона САНКТ-ПЕТЕРБУРГ. Если мы зададим в марке отображение информации с помощью повторяющегося блока, то получим следующую картинку:
Проблема в том, что в каждой точке есть срез данных. Если бы мы использовали токен-срез, то получили бы кучу прочерков у точек, где нет такого региона, и только в одном месте валидную информацию. Чтобы ограничить вывод данных только для нужного нам региона, мы можем добавить фильтр и необходимое значение измерения:
В таком случае мы делаем две вещи:
- Отфильтровываем точки, в которых нет срезов со значением региона
САНКТ-ПЕТЕРБУРГ; - В точке, где есть срезы с данным регионом, оставляем только валидные срезы.
Предположим, что мы захотели вывести информацию не только для региона САНКТ-ПЕТЕРБУРГ, но и для региона ЛЕНИНГРАДСКАЯ ОБЛ. Тогда добавляем его так же в конфиге фильтра и получаем необходимые данные:
Если мы хотим, чтобы для ЛЕНИНГРАДСКАЯ ОБЛ был более строгий вывод с информацией только о НМЦК (СРЕД), то нам необходимо добавить еще один фильтр с заданием нужного значения региона и меры, и убрать значение региона из предыдущего фильтра:
