Інтеграція з MikBill➧
Доступно з версії 0.19+ Документація MikBill
Налаштування взаємодії з MikBill➧
Отримання даних з Wildcore в MikBill➧
1. Створюємо користувацьку роль та користувача для MikBill:➧
Переходимо в: користувачі ⇒ ролі, натискаємо "створити нову роль". Ім'я ролі для прикладу: mb_dms Встановлюємо прапорці:
- Система: !!! Дозволити авторизацію інших користувачів (генерувати ключі)
- Користувачі: Список користувачів, Оновлення інформації про себе
- Компонент Діагностика: Діагностика інтерфейсу (для білінгу)
- ОЛТ'и: Інфо з ОЛТів
- Світчі: Інфо зі світчів
Натискаємо "створити".
Переходимо в: користувачі ⇒ користувачі, натискаємо "створити користувача" Заповнюємо всі поля, вибираємо групи пристроїв, доступні цьому користувачу, а також роль, створену вище: mb_dms Логін для прикладу - mikbill
Натискаємо "створити".
2. Генеруємо API-ключ (токен) для цього користувача➧
З консолі:
Приклад:
root@debian# wca user:generate-key mikbill 365d
+--------+------------------------+-----------------------------------------------------+-----------------------------+
| ID | User | Key | Expired At |
+--------+------------------------+-----------------------------------------------------+-----------------------------+
| 4780 | ID: 65 | cd1f08c-dcea-4603-34d-471deb7c9387 | 2024-11-14 14:37:04 |
| | Login: mikbill | | |
| | Name: Биллинг | | |
+--------+------------------------+-----------------------------------------------------+-----------------------------+
3. Якщо адмінка білінгу працює на ssl, то також слід перевести wildcore на ssl➧
З консолі (приклад для Ubuntu/Debian):
Приклад конфігурації nginx (перед отриманням сертифікату):
4. Увімкнення інтеграції в mikbill➧
Ідемо: Налаштування ⇒ Системні опції ⇒ Зовнішні інтеграції, розділ Wildcore
Ставимо галку: Увімкнути
Вказуємо адресу Wildcore: https://dms.ispnet.demo
Вказуємо API ключ, згенерований в п.2
Зберігаємо.
На даному етапі Mikbill вже буде отримувати дані про сигнали ону та відображати їх в картці абонента (якщо у пристрою тип onu/ont і SN/MAC знайдено в wildcore).
Оновлення сигналів відбувається при кожному відкритті облікового запису.
Також в картці абонента Mikbill додано вкладку Wildcore, де можна переглянути інформацію безпосередньо з самого wildcore.
Для цього логін співробітника Mikbill повинен збігатися з логіном в wildcore і у його ролі повинні бути відповідні права:
- User management → Оновити власну інформацію
- OLTs → Інформація з OLTs
- Switches → Інформація зі світчів
Якщо прав не буде вистачати, то буде показана помилка: Wildcore iframe permission denied
Також за необхідності можна налаштувати масштаб завантажуваної в білінг сторінки.
Для цього ідемо: Конфігурація ⇒ Конфігурація системи ⇒ вкладка Конфігурація системи і міняємо параметр WEB_ZOOM_IFRAME.
За замовчуванням стоїть 1 (100%).
Вказуємо за своїм смаком 0.9 (90%), 0.75 (75%), і т.д.
Сторінка з ONU:
Для цього у абонента повинно бути додано пристрій: тип onu/ont. Білінг буде шукати пристрій в wildcore за onumac/onusn.
Сторінка порту в комутатора:
Для цього у абонента повинен бути вказаний свіч і порт, білінг буде шукати пристрій в wildcore за IP (тип пристрою: SWITCH, IP свіча в довіднику мікбілл повинен збігатися з IP свіча в вайлдкор)
Отримання даних з Mikbill в Wildcore➧
Wildcore з Mikbill може отримувати дані про абонентів, відображаючи їх в картці відповідного ONU або інтерфейсу комутатора:
- UID клієнта
- Посилання на картку абонента
- Номер договору
- Логін
- Адреса абонента (Місто, вулиця, будинок, квартира)
Увімкнення інтеграції➧
1. Активуємо компонент mikbill_integration➧
Ідемо в: Конфігурація ⇒ Конфігурація системи, вкладка Компоненти і активуємо компонент mikbill_integration
Після цього, во вкладці Конфігурація системи, з'явиться розділ налаштувань MikBill.
Пишемо туди адресу адмінки білінгу, ключ API, який генерували для білінгу в п.2,
і вибираємо яке з полів буде доступно в глобальному пошуку Wildcore (uid, номер договору, або логін).
Жмемо зберегти
2. Активуємо автоматичну синхронізацію➧
В Конфігурація ⇒ Конфігурація системи, вкладка планувальник активувати синхронізацію(також можна налаштувати бажаний час синхронізації, в форматі crontab).
В даному прикладі синхронізація буде відбуватися двічі на добу: о 4:00 і о 12:00.
Для ручного запуску синхронізації (актуально при першому запуску) – виконайте в консолі команду:
Всі ОНУ та порти свічів (призначені в облікових записах абонентів) будуть доповнені даними з білінгу.➧
При кліці по посиланню - у новій вкладці відкриється обліковий запис в mikbill.
Також у глобальному пошуку тепер можна шукати абонентів за UID, логіном або номером договору (в залежності від того, що обрано для глобального пошуку)➧
FAQ➧
Питання 1. В білінгу, в розділі wildcore відкривається ону, яка завжди офлайн, хоча абонент працює. Чому так?➧
Відповідь: Ймовірно, ону з таким ідентифікатором (onumac, onusn) присутня (або працювала раніше) на інших портах або OLT. Wildcore шукає ону за ідентифікатором і відкриває перший результат з пошуку. Видаліть ону з цим ідентифікатором з усіх неактуальних портів та OLT.
Питання 2. Я видалив повторюючіся ону з неактуальних портів та OLT, але всеодно відкривається "видалена ону". Що робити?➧
Відповідь: Трошки зачекайте (до 10-15 хвилин), поки OLT переопитається, і дані в БД оновляться.
Продовження слідує