Інтеграція з Google-календарем
Див. також: Календар
Починаючи з версії 3.21, в ERP можна налаштувати інтеграцію з Google Календарем: https://calendar.google.com/calendar/u/0/gp
Як це працює? Пряма інтеграція з особистим Google Календарем або особистим обліковим записом Google співробітника не має особливого сенсу. З одного боку, для цього потрібно було б надати компанії доступ до особистого календаря, на що частина співробітників може не погодитися. З іншого боку, неможливо заборонити окремі дії з подіями в календарі (наприклад, зміну дат проведення робіт), хоча в ERP співробітники можуть не мати таких прав. Тому використовується інший підхід.
Система автоматично створює екземпляри календарів співробітників, окремо для кожного, під власним обліковим записом. Співробітникам надається спільний доступ (лише для читання) до "їхнього календаря". Співробітник підключає цей календар як додатковий у Google Календарі. Редагувати події він не може: усім керує диспетчер/ERP.
Порядок інтеграції:
1) Створити окремий центральний Google-акаунт для інтеграції (або використати якийсь наявний)
2) Підключитися до https://console.cloud.google.com/ і створити проєкт
3) Підключити до проєкту API - Google Calendar API
4) Створити OAuth credentials типу Web application із зазначенням URL до ERP. Режим External. Credential спочатку створюється в тестовому статусі на 7 днів. Не забудьте перевести його в Production після налаштування і тестування.
Authorized redirect URIs: https://erp.your_net.com/api.php?cat=google https://erp.your_net.com/settings_task/google_calendar
Після цього потрібно зайти й авторизуватися з акаунта інтеграції.
Помилка: Error 400: redirect_uri_mismatch - не вказано коректний URL в "Authorized redirect URIs" Помилка: Error 403: access_denied
Додавання тестових акаунтів (зокрема акаунта інтеграції) виконується в розділі "Audience" - "Test users".
5) В ERP у розділі "Налаштування - Завдання - Google-календар" увімкнути роботу з календарем і вказати всі параметри
6) У "Картці співробітника - Редагування" перевірити коректність email, встановити прапорець прив'язки до Google-календаря і зберегти. Буде додано й показано інформацію про CalendarID
7) У Google Календарі основного інтеграційного облікового запису буде видно всі календарі співробітників (список). Далі співробітнику надійде лист із пропозицією приєднатися до розшареного календаря, створеного для нього. Запрошення потрібно прийняти.
Нотатки:
1) Під час початкового створення календаря одразу будуть додані всі завдання, у які цей співробітник призначений, починаючи з дати добу тому.
2) У разі зміни email співробітника календар буде пересоздано.
3) У разі видалення email і/або вимкнення роботи з календарем у співробітника календар буде видалено. Цей підхід можна використовувати і для пересоздання календаря та подій у ньому в разі проблем із синхронізацією.
4) У застосунку Google Календар, можливо, потрібно буде увімкнути цей календар у списку (він може підключитися, але за замовчуванням бути вимкненим).
5) Для Apple iOS також можна встановити застосунок Google Календар.
6) У разі звільнення співробітника календар вимикається і видаляється.
7) Опційно в календарі виводяться роботи за підрозділами цього співробітника.
14) Виводяться тільки завдання із системними ролями "Не виконано" і "В роботі". У разі зміни статусу завдання події відповідно додаються або видаляються, якщо це потрібно.