Пользовательский виджет "Картосхема"

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

1. Создать карту на основе которой будет построен виджет и добавить её на сервер.
2. Создать новый виджет-картосхему.

Добавление карты

1. Создайте векторное изображение картосхемы в редакторе SVG файлов, или скачайте готовый файл из интернета.
2. Откройте получившийся файл в редакторе кода.
3. Скопируйте получившийся код и вставьте в форму кода на портале https://highcharts.github.io/map-from-svg/.
4. Нажмите кнопку Load и посмотрите, что получилось справа:
   
   
   
   
5. Кликните на View Highcharts Maps config и скопируйте код карты в окне справа:
   
   
   
   
6. Вставьте код в блокнот и добавьте каждому контуру региона следующие параметры:
   • hc-code – ID региона, который вы потом сможете использовать в таблицах и т.д. Можно, например, использовать код ОКАТО региона;
   • short-name – неполное название региона. Например, Коми;

   • full-name – полное название региона. Например, Республика Коми.
     Например:

     "full-name": "Республика Саха (Якутия)",
     "short-name": "Якутия",
     "hc-code": "98000000000",

     
     
     
     

7. Сохраните получившийся код в формате *.js.
8. Назовите файл, например, russia_wiki.js.
9. Добавьте получившийся файл на сервер в папку по адресу /docker-volume/dashboard-viewer/customjs.
   Образец готового файла:
   russia_wiki.js

Создание виджета

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

1. Откройте приложение Dashboard Designer.
2. На вкладке Пользовательские виджеты, нажмите кнопку Создать:
   
   
   
   
3. В открывшемся окне введите название виджета.
4. В поле Код виджета (JavaScript) вставьте код из файла widgets_kod.js (см. ниже):
   
   widgets_kod.js
   
   
   

5. Нажмите кнопку Создать:
   
   
   
   

   Важно!

   Если у вас другое имя карты, не забудьте указать его:

   

6. Добавьте виджет в рабочую область.
7. На вкладке Привязка данных, привяжите виджет к данным:
   
   

Виджет отобразит загруженные данные:

Пример

Рассмотрим пример подготовки данных для работы с картосхемой:

1. Создайте измерение, одним из атрибутов которых будет геокод из файла карты (в нашем случае это файл russia-wiki.js).
   
   
   
   
2. Укажите в свойствах элементов измерения данные из файла russia-wiki.js:
   
   
   
   
3. При привязке данных к созданному виджету Картосхема в Dashboard Designer, укажите геокод в качестве одного из измерений:
   
   
   
   
4. Данные отобразятся на картосхеме:
   
   

Материалы по теме

• Создание/редактирование/удаление измерения
• Добавление измерений и показателей