Обзорное руководство по автоматизациям

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

Обзор

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

Преимущества:

• Автоматическое резервное копирование и синхронизация данных
• Не требуется ручное вмешательство
• Настраиваемая частота синхронизации
• Несколько типов автоматизаций для разных сценариев
• Работа в фоне (приложение не обязательно должно быть открыто)

Сценарии использования:

• Автоматическое облачное резервное копирование
• Интеграция с системами умного дома
• API-интеграции для пользовательских приложений
• Платформы анализа и визуализации данных
• Обмен данными о здоровье с медицинскими учреждениями

Ограничения:

• Доступ к данным о здоровье: Приложениям запрещён доступ к данным о здоровье, пока iPhone заблокирован. Автоматизации выполняются только в периоды, когда устройство разблокировано. Это ограничение Apple, его нельзя обойти. Подробнее
• Фоновая обработка: iOS ограничивает фоновую обработку для экономии заряда батареи. Автоматизации зависят от фонового обновления приложений и могут не запускаться сразу, если:
  • для приложения отключено фоновое обновление приложений
  • устройство в режиме энергосбережения
  • устройство длительное время неактивно
  • системные ресурсы ограничены
  • несколько приложений конкурируют за время фонового выполнения
• Планирование: В связи с фоновой обработкой iOS также не позволяет приложениям работать в фоне в заданное время. Это означает, что даже при установке определённой частоты синхронизации автоматизации не гарантированно запустятся точно в указанное время. Устройство должно быть разблокировано, и iOS определит, когда автоматизация выполнится в фоне. Автоматизации также можно запустить вручную следующими способами:
  • Виджет автоматизаций: нажмите значок виджета на домашнем экране, чтобы запустить автоматизацию
  • Команды — Выполнить автоматизацию: используйте действие Выполнить автоматизацию, чтобы запустить настроенную автоматизацию (см. Расписание через «Команды»)
  • Ручной запуск в приложении: откройте автоматизацию в Health Auto Export и выполните Ручной экспорт
• Расписание напоминаний: Каждая автоматизация может по желанию напомнить разблокировать устройство и открыть Health Auto Export. Включите Включить напоминания, затем задайте Частоту напоминаний: Ежечасно, Каждый день или Выбранные дни. Для ежечасных используется Минута часа; для ежедневных и выбранных дней — Время напоминания. Напоминание не означает, что автоматизация уже выполнилась, и может появиться после успешной фоновой синхронизации.
  • Изменения напоминаний вступают в силу после сохранения автоматизации. Редактор показывает Следующее напоминание после сохранения.
  • Нажатие напоминания открывает автоматизацию.
  • Открыть и синхронизировать — действие в уведомлении. Оно открывает приложение и сразу запускает эту автоматизацию. Автоматизация должна быть включена.
  • Если автоматизация удалена, отключена, уже выполняется или не может запуститься с текущим доступом, приложение возвращается на экран «Автоматизации».
  • Для напоминаний нужно разрешение на уведомления. Доступ к уведомлениям показывает статус. Если уведомления отклонены, используйте Открыть настройки уведомлений.
• Частота синхронизации: Частота синхронизации определяет, как часто вы хотите, чтобы автоматизация выполнялась в фоне. Это не точное расписание и не гарантирует, что приложение откроется или будет работать в фоне с таким интервалом. Возможность фоновой работы управляется системой.
• Открытие приложения: Автоматизации и синхронизация с Mac работают, пока Health Auto Export остаётся открытым. Запуск также можно начать с виджета автоматизаций, «Команд» или ручного экспорта.

Производительность

Имейте в виду, что 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. Предупреждения (например, медленный запрос данных о здоровье) означают, что запуск завершён, но один из шагов занял дольше ожидаемого. Ошибки означают, что шаг не выполнен (загрузка, чтение данных о здоровье, аутентификация и т. п.). Если ничего не загружено, ошибка поясняет, не найдены ли данные в диапазоне дат или данные не удалось полностью прочитать (например, устройство заблокировалось во время экспорта):

• “No health data was found in this date range, so nothing was uploaded.”
• “Health data could not be fully read. The device may have locked during the export. Nothing was uploaded.”

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. Обратитесь в службу поддержки, если проблема сохраняется