Перейти до вмісту

Інструкція з підключення графіків до Dashboard

Інструкція описує, як за кілька кроків побачити дані вашої облікової системи на дашборді: зареєструватися, підключити джерело даних і додати графіки. Найпоширеніше джерело — звітний HTTP-сервіс облікової системи; так само підключається будь-який сервіс, що віддає дані у форматі JSON.

1. Реєстрація та вхід

  1. Відкрийте сторінку реєстрації й укажіть ім’я, електронну пошту та пароль. Якщо на сторінці є кнопка входу через Google, можна скористатися нею.
  2. Після реєстрації з паролем підтвердьте пошту за посиланням із листа: без підтвердження кабінет недоступний.
  3. Якщо ви вже зареєстровані, скористайтеся сторінкою входу.

2. Організація, простір і дашборд

  1. У кабінеті натисніть «Створити організацію» й укажіть назву вашої компанії. Ви станете власником організації й зможете запросити до неї адміністраторів.
  2. У бічному меню оберіть «Новий простір» — простір об’єднує дашборди за темою, наприклад «Продажі» чи «Фінанси».
  3. Біля назви простору натисніть «+» або оберіть «Новий дашборд» і вкажіть назву дашборда.

3. Джерело даних

Джерело — це адреса сервісу, з якого дашборд читає дані. Джерела належать організації: одне джерело можна використовувати на будь-якому дашборді.

  1. У бічному меню відкрийте «Джерела даних» і натисніть «Додати джерело».
  2. Вкажіть «Назва джерела», оберіть тип «Облікова система» і заповніть поля:
    • Адреса звітного HTTP-сервісу — наприклад, https://erp.example.com:8443/base/hs/dashboard/. Підтримуються порти 80, 443 і 1024–65535.
    • Логін і Пароль — обліковий запис, під яким працює HTTP-сервіс. Пароль зберігається зашифрованим і більше ніде не показується.
    • Очікування — скільки секунд чекати відповіді, від 5 до 30.
    • «Дозволити HTTP без шифрування» — позначайте лише якщо сервіс не підтримує HTTPS: логін, пароль і дані тоді передаються відкрито.
  3. Натисніть «Зберегти джерело».

Для інших систем оберіть тип «Веб-сервіс (JSON)»: він приймає довільний JSON-масив записів, вхід Bearer-токеном, логіном і паролем або ключем доступу в заголовку. Також можна підключити Google-таблицю з доступом за посиланням.

4. Вибірка

Вибірка — конкретний запит до джерела, наприклад звіт про продажі. В одного джерела може бути багато вибірок.

  1. У картці джерела натисніть «Додати вибірку» й укажіть назву.
  2. Метод — POST (типовий для звітного HTTP-сервісу). Шлях можна лишити порожнім, якщо адреса сервісу вже повна.
  3. У полі «Тіло запиту (JSON)» вкажіть параметри запиту, наприклад {"Метод": "Продажі", "Дата1": "20250601000000", "Дата2": "20250831235959"}.
  4. Збережіть вибірку й натисніть «Перевірити дані» — під вибіркою з’являться отримані записи.
  5. За потреби відкрийте «Відповідність колонок»: у полі «Значення» оберіть основний показник, нижче — до семи додаткових показників, а також підпис, час і категорію. Для звітного HTTP-сервісу відповідність підбирається автоматично: основним стає перший числовий показник без пропусків, інші числові — додатковими.

5. Графіки на дашборді

  1. Відкрийте дашборд і натисніть «Редагувати», потім «Додати віджет».
  2. Вкажіть назву й одиниці, оберіть «Вибірка даних» і вид відображення. Типово стоїть «Як у джерелі»: вид графіка береться з відповіді сервісу. Кольори, межі шкали й пороги з відповіді діють за будь-якого виду. Можна обрати й вид вручну: число, лінійний графік, графік з областю, стовпчики, таблиця, кругова чи кільцева діаграма або шкала. Для шкали можна вказати «Максимум шкали», наприклад план продажу; він головніший за максимум із відповіді.
  3. Перетягуйте віджети за шапку й змінюйте їхній розмір за краї. Розташування зберігається автоматично.
  4. У меню дій дашборда пункт «Назва й опис» задає автооновлення даних, а пункт «Доступ» — глядачів і посилання на перегляд.

6. Тестовий звітний HTTP-сервіс

Щоб спробувати без власного сервісу, підключіть тестовий звітний сервіс:

  • Тип джерела: «Облікова система».
  • Адреса: http://194.62.137.215/ibms-dashboard-test-chart/hs/ibms/dashboard, позначте «Дозволити HTTP без шифрування».
  • Логін: ДашбордIBMS, пароль: 753.
  • Вибірка 1: метод POST, тіло {"Метод": "ТестовийГрафік1"}.
  • Вибірка 2 (з періодом): тіло {"Метод": "ТестовийГрафік2", "Дата1": "20250601000000", "Дата2": "20250831235959"}.

Обидві вибірки повертають по два показники за кілька місяців. Перевірити, що сервіс працює, можна в браузері: адреса сервісу запитає логін і пароль і покаже рядок {"Sucsess": true, "TextError": "", "Result": "http-сервіс (GET) працює!"} (поле Sucsess сервіс пише саме так; сервіс Dashboard приймає й написання Success).

7. Власний звітний HTTP-сервіс

  1. Завантажте тестову облікову базу з прикладом HTTP-сервісу (вхід у конфігуратор: Адміністратор, пароль 753) і розгорніть її.
  2. Опублікуйте HTTP-сервіс бази на веб-сервері так, щоб він був доступний з інтернету. Адреса матиме вигляд http[s]://<адреса сервера[:порт]>/<ім’я бази>/hs/ibms/dashboard. Адреси внутрішніх мереж (192.168.x.x, 10.x.x.x тощо) сервіс Dashboard не читає.
  3. У джерелі «Облікова система» вкажіть цю адресу й обліковий запис HTTP-сервісу тестової бази: логін ДашбордIBMS, пароль 753. Вибірки — ті самі, що для тестового сервісу.
  4. Сервіс має відповідати JSON-об’єктом: {"Sucsess": true, "TextError": "", "Result": {"Status": "OK", "TextError": "", "Result": {"type": "chart", "data": {"columns": [["Продажі", 100, 120]]}, "axis": {"x": {"categories": ["Січень", "Лютий"]}}}}}. Вкладений Result може бути також рядком із JSON; кодування — UTF-8, UTF-16 або Windows-1251.
  5. Поле type поруч із даними каже, що саме передано: chart — конфігурація графіка (поля data, axis тощо, як у прикладі); html — готова розмітка в полі html і стилі в полі css (показ HTML у віджетах буде підтримано пізніше; сервіс уже може віддавати цей формат). Відповідь без поля type читається як графік, тож наявні сервіси працюють без змін. Межі: html до 200 КБ, css до 50 КБ. Новим сервісам радимо вказувати type явно.
  6. З відповіді беруться дані: показники з data.columns чи data.rows, категорії осі з axis.x.categories чи data.x і назви показників з data.names. Тип графіка з відповіді застосовується у віджеті з видом «Як у джерелі», а кольори, межі шкали й пороги її кольору — за будь-якого виду; функції форматування з відповіді не виконуються.
  7. Якщо сервіс повертає "Sucsess": false (або "Success": false) чи "Status", відмінний від OK, текст TextError показується команді організації під час перевірки вибірки.

8. Якщо графік не з’явився

  • У «Джерелах даних» натисніть «Відповідь джерела» біля вибірки: буде видно адресу запиту, статус, тип і текст відповіді сервісу, зокрема повідомлення про помилку.
  • Статус 401 — перевірте логін і пароль; помилка адреси — перевірте порт і позначку HTTP; «Джерело не відповіло вчасно» — збільште час очікування або перевірте сервер.
  • Якщо дані отримано, але графік порожній, перевірте «Відповідність колонок» і вид відображення віджета.