Оглядовий посібник з автоматизацій

Автоматизації дозволяють автоматично експортувати та синхронізувати дані Apple Health з різними призначеннями без ручного втручання. У цьому посібнику наведено огляд функції автоматизацій і посилання на детальні посібники для кожного типу автоматизації.

Огляд

Автоматизації — це налаштовані робочі процеси, які автоматично експортують ваші дані про здоров’я до зовнішніх сервісів, хмарного сховища чи інших призначень. Після налаштування автоматизації можуть виконуватися автоматично у фоновому режимі.

Переваги:

• Автоматичне резервне копіювання та синхронізація даних
• Не потрібне ручне втручання
• Налаштовувана частота синхронізації
• Кілька типів автоматизацій для різних сценаріїв
• Робота у фоні (застосунок не обов’язково має бути відкритим)

Сценарії використання:

• Автоматичне хмарне резервне копіювання
• Інтеграція з системами розумного дому
• API-інтеграції для власних застосунків
• Платформи аналізу та візуалізації даних
• Обмін даними про здоров’я з медичними закладами

Обмеження:

• Доступ до даних про здоров’я: Застосункам заборонено отримувати доступ до даних про здоров’я, поки iPhone заблоковано. Автоматизації виконуються лише в періоди, коли пристрій розблоковано. Це обмеження Apple, його не можна обійти. Докладніше
• Фонова обробка: iOS обмежує фонову обробку для економії заряду акумулятора. Автоматизації залежать від фонового оновлення застосунків і можуть не запускатися одразу, якщо:
  • для застосунку вимкнено фонове оновлення застосунків
  • пристрій у режимі енергозбереження
  • пристрій довго неактивний
  • системні ресурси обмежені
  • кілька застосунків конкурують за час фонового виконання
• Планування: У зв’язку з фоновою обробкою iOS також не дозволяє застосункам працювати у фоні в заданий час. Це означає, що навіть при встановленні певного інтервалу синхронізації автоматизації не гарантовано запустяться точно в указаний час. Пристрій має бути розблокованим, і iOS визначить, коли автоматизація виконається у фоні. Автоматизації також можна запустити вручну такими способами:
  • Віджет автоматизацій: натисніть значок віджета, щоб запустити автоматизацію
  • Команди — Запустити автоматизацію: використовуйте дію Запустити автоматизацію, щоб запустити налаштовану автоматизацію (див. Заплануйте автоматизацію за допомогою ярликів)
  • Ручний запуск у застосунку: відкрийте автоматизацію в Health Auto Export і виконайте Ручний експорт
• Синхронізація на передньому плані: Поки Health Auto Export відкритий на передньому плані, відповідні автоматизації можуть знову виконуватися з регулярним інтервалом (приблизно кожні 60 секунд). Пристрій залишається активним під час використання на передньому плані, тож синхронізація може тривати. Цикл на передньому плані призупиняється лише при досягненні пристроєм критичного теплового стану; за тепліших (некритичних) умов синхронізація на передньому плані все ще можлива. Обмеження фонового планування вище діють, коли застосунок не на передньому плані.

Продуктивність

Пам’ятайте, що iOS оптимізований для короткочасних завдань на мобільному пристрої з дуже суворими обмеженнями продуктивності. Фонові завдання зазвичай мають завершитися протягом 30 секунд і обмежені в обсязі пам’яті. Health Auto Export пропонує великий ступінь гнучкості та налаштування, тому важливо розуміти, як певні конфігурації впливають на продуктивність застосунку та результати.

• Конфігурація: Автоматизації, які створюють великі обсяги даних, можуть призвести до завершення процесу системою, і автоматизації не працюватимуть у фоні. Наступні конфігурації можуть створювати великі обсяги даних:
  • Автоматизації, налаштовані на експорт усіх показників здоров’я.
    • Рекомендація: вибирайте лише показники здоров’я, для яких у Apple Health є збережені дані, і лише ті дані, які ви дійсно плануєте використовувати. Навіть порожні типи даних впливають на продуктивність. Можна також розділити вибрані показники між кількома автоматизаціями — це полегшує обробку для системи.
  • Автоматизації з групуванням за часом у секундах або хвилинах або з вимкненим підсумовуванням даних. Такі детальні запити можуть тривати довго й суперечити системним обмеженням.
    • Рекомендація: хоча здається ідеальним мати максимально детальні дані, подумайте, чи потрібен такий рівень деталізації для кожного показника чи типу даних. Розгляньте кілька автоматизацій з різними налаштуваннями.
  • Під час експорту тренувань на відкритому повітрі, таких як велосипед, біг, піші походи тощо з даними маршруту, GPS і пов’язані показники здоров’я можуть створювати великі обсяги даних.
• Розмір даних: Особливо при експорті через REST API враховуйте, що великі обсяги даних можуть спричиняти помилки сервера. Переконайтеся, що ваш бекенд налаштований на обробку обсягів даних, можливо, кількох сотень мегабайт.
• Частота синхронізації: Додайте віджет автоматизацій на головний екран, щоб автоматизації надійніше працювали у фоні (див. Посібник з налаштування віджета автоматизацій).

Доступні типи автоматизацій

Health Auto Export підтримує кілька типів автоматизацій, кожен із яких призначений для певних сценаріїв:

REST API

Надсилання даних про здоров’я до будь-якого веб-сервісу, що приймає HTTP POST-запити. Ідеально для власних серверів, вебхуків і сторонніх API.

Посібник: Посібник з автоматизації REST API

Home Assistant

Синхронізація показників здоров’я з Home Assistant як стани датчиків. Чудово підходить для інтеграції даних про здоров’я в автоматизації розумного дому.

Посібник: Посібник з автоматизації Home Assistant

MQTT

Публікація даних про здоров’я в MQTT-брокер. Підходить для IoT-платформ і систем на базі MQTT.

Посібник: Посібник з автоматизації MQTT

Dropbox

Автоматичне резервне копіювання даних про здоров’я в Dropbox. Файли організовані в папках і доступні з будь-якого пристрою.

Посібник: Посібник з автоматизації Dropbox

Google Drive

Автоматичне резервне копіювання даних про здоров’я в Google Drive. CSV-файли можна перетворити на Google Таблиці для зручного перегляду.

Посібник: Посібник з автоматизації Google Drive

iCloud Drive

Збереження даних про здоров’я безпосередньо в iCloud Drive. Просте налаштування без автентифікації.

Посібник: Посібник з автоматизації iCloud Drive

Календар

Створення подій календаря на основі ваших даних про здоров’я. Візуалізація тренувань, віх здоров’я та інших подій у календарі.

Посібник: Посібник з автоматизації Календаря

Створення першої автоматизації

1. Перейдіть на екран «Автоматичні експорти» з головної навігації
2. Натисніть «Нова автоматизація»
3. Виберіть тип автоматизації
4. Налаштуйте параметри, специфічні для автоматизації (див. окремі посібники)
5. Налаштуйте загальні параметри (тип даних, частота синхронізації тощо)
6. Натисніть «Оновити» для збереження
7. Увімкніть автоматизацію

Резервне копіювання та відновлення автоматизацій

Health Auto Export може створювати резервну копію налаштувань автоматизацій у iCloud Drive, щоб ви могли відновити їх на новому пристрої або після перевстановлення застосунку. Це окремо від даних про здоров’я, які експортують ваші автоматизації.

• Де зберігаються резервні копії: Налаштування автоматизацій зберігаються як JSON-файли в iCloud Drive у папці Auto Export/Automations (видно в застосунку «Файли»).
• Коли створюється резервна копія: Щоразу, коли ви зберігаєте автоматизацію (натискаючи Оновити або залишаючи екран редагування), автоматизація автоматично резервується.
• Увімкнення або вимкнення: Відкрийте список автоматизацій і перейдіть до Налаштувань автоматизації, потім скористайтеся Резервне копіювання в iCloud Drive. За замовчуванням увімкнено. Якщо вимкнете, вас запитають, чи видалити наявні файли резервної копії з iCloud Drive — автоматизації залишаться на пристрої в обох випадках.

Відновлення

Якщо ви відкриєте «Автоматичні експорти» і ще не маєте автоматизацій, але в iCloud Drive є резервні копії, з’явиться кнопка Відновити з iCloud Drive. Натиснувши її, ви повернете свої автоматизації.

Кілька речей після відновлення:

• Повторно підключіть облікові записи: З міркувань конфіденційності токени входу для сервісів на кшталт Dropbox і Google Drive не входять до резервних копій. Після відновлення знову підключіть ці сервіси в кожній автоматизації.
• Знову ввімкніть автоматизації: Відновлені автоматизації починають як вимкнені, щоб нічого не запустилося несподівано з застарілими налаштуваннями. Перегляньте кожну й увімкніть, коли будете готові.
• Часткове відновлення: Якщо деякі автоматизації не вдається відновити (наприклад, файл ще не завантажено, ключ шифрування ще недоступний або автоматизацію створено новішою версією застосунку), решта все одно відновлюється, і ви побачите, які пропущено.

Примітка: Заголовки запитів і облікові дані, які ви ввели в автоматизацію (наприклад, пароль MQTT), зашифровані у файлах резервної копії iCloud Drive. Відновлення на новому пристрої вимагає iCloud Keychain, щоб застосунок міг їх розшифрувати. Файли, якими ви поділилися або експортували вручну, залишаються незашифрованим звичайним JSON.

Журнали активності

У кожної автоматизації є журнали активності з історією її запусків.

1. Відкрийте автоматизацію та натисніть Переглянути журнали активності.
2. Події згруповані за запуском (спочатку найновіші). Розгорніть запуск, щоб побачити окремі події.
3. Попередження (наприклад, повільний запит даних про здоров’я) означають, що запуск завершено, але один із кроків тривав довше, ніж очікувалося. Помилки означають, що крок не виконано (завантаження, читання HealthKit, автентифікація тощо).
4. Очистити (панель інструментів) видаляє лише історію активності цієї автоматизації, а не загальні діагностичні журнали застосунку.
5. Поділитися (панель інструментів) експортує повний діагностичний ZIP App Event Logs — той самий пакет, що й Налаштування → Додатково → Експорт журналів подій. Див. Посібник із журналів подій застосунку.

Повільні запити в журналах активності

• Якщо автоматизація довго отримує дані про здоров’я, у журналах активності можуть з’явитися попередження повільний запит даних про здоров’я, а не помилки.
• Щоб прискорити запуски: виберіть менше показників здоров’я, використовуйте коротший діапазон дат, увімкніть Підсумовувати дані та виберіть більшу Групування за часом (години, дні або тижні).
• Автоматизації в реальному часі за задумом використовують дрібніше групування і можуть частіше реєструвати попередження про повільні запити.

Попередження налаштувань експорту

Під час налаштування автоматизації показників здоров’я (не Home Assistant) під Налаштуваннями експорту може з’явитися примітка внизу, якщо конфігурація може працювати повільно:

• Підсумовувати дані вимкнено або групування за часом — хвилини чи секунди, і
• вибрано понад 10 показників здоров’я

Примітка пропонує менше показників, коротший діапазон дат, увімкнути «Підсумовувати дані» або обрати грубше групування за часом. Вона посилається на цей посібник. Попередження про повільні запити в журналах активності окремі й з’являються після запуску, коли запити перевищують порогові значення.

Рекомендації

1. Автоматична синхронізація:

• Заряджайте пристрій і використовуйте «Дзеркалювання iPhone»
  • Під час зарядки iOS менше обмежує продуктивність, тож дані можуть синхронізуватися частіше
  • Під час дзеркалювання iPhone пристрій поводиться так само, як при розблокуванні, і Health Auto Export може отримувати дані про здоров’я для автоматичних дій

2. Частота синхронізації:

• Баланс між актуальністю даних і використанням ресурсів
• Щоденна синхронізація підходить для більшості сценаріїв
• Частіша синхронізація для задач у реальному часі
• Рідша — для зведених даних

3. Вибір даних:

• Вибирайте лише потрібні показники
• Скорочує час обробки та обсяг даних
• Розгляньте окремі автоматизації для різних груп показників

4. Тестування:

• Виконайте ручний експорт
• Переконайтеся, що дані з’явилися в призначенні
• Перевірте журнали активності на помилки
• Уважно стежте за першими синхронізаціями

5. Моніторинг:

• Регулярно переглядайте журнали активності
• Перевіряйте індикатори стану автоматизацій
• Налаштуйте сповіщення для важливих автоматизацій
• Перевіряйте отримання даних у призначенні

6. Безпека:

• Використовуйте надійні методи автентифікації
• Оновлюйте облікові дані
• Використовуйте HTTPS/TLS, коли доступно
• Перевіряйте налаштування конфіденційності

7. Продуктивність:

• Використовуйте відповідне групування за часом
• Враховуйте налаштування діапазону дат для хмарного сховища
• Стежте за витратом акумулятора та трафіку
• Переглядайте журнали активності на попередження про повільні запити

8. Стратегія резервного копіювання:

• Використовуйте кілька типів автоматизацій для надлишковості
• Поєднуйте хмарне сховище з API-інтеграціями
• Зберігайте локальні резервні копії, коли можливо
• Перевіряйте процедури відновлення

9. Усунення несправностей:

• Спочатку перевірте журнали активності
• Перевірте мережеве з’єднання
• Перевірте облікові дані
• Див. окремі посібники з автоматизацій для конкретних проблем

Віджет автоматизацій

Додайте віджет «Автоматизації» на головний екран, щоб:

• бачити стан автоматизацій з першого погляду
• запускати автоматизації вручну
• оптимізувати фонові завантаження

Отримання допомоги

Якщо потрібна допомога з конкретним типом автоматизації:

1. Зверніться до відповідного посібника з автоматизації
2. Перевірте журнали активності на повідомлення про помилки
3. Перегляньте розділи усунення несправностей
4. Зверніться до служби підтримки, якщо проблема не зникає