Przewodnik po automatyzacjach — przegląd

Automatyzacje pozwalają automatycznie eksportować i synchronizować dane Apple Health z różnymi miejscami docelowymi bez ręcznej interwencji. Ten przewodnik przedstawia funkcję automatyzacji i zawiera linki do szczegółowych instrukcji dla każdego typu automatyzacji.

Przegląd

Automatyzacje to skonfigurowane przepływy pracy, które automatycznie eksportują dane zdrowotne do usług zewnętrznych, magazynu w chmurze lub innych miejsc docelowych. Po skonfigurowaniu mogą działać automatycznie w tle.

Korzyści:

• Automatyczna kopia zapasowa i synchronizacja danych
• Brak konieczności ręcznej interwencji
• Konfigurowalna częstotliwość synchronizacji
• Wiele typów automatyzacji do różnych zastosowań
• Działanie w tle (aplikacja nie musi być otwarta)

Zastosowania:

• Automatyczne kopie zapasowe w chmurze
• Integracja z systemami automatyki domowej
• Integracje API dla własnych aplikacji
• Platformy analizy i wizualizacji danych
• Udostępnianie danych zdrowotnych dostawcom opieki zdrowotnej

Ograniczenia:

• Dostęp do danych zdrowotnych: Aplikacje nie mogą uzyskiwać dostępu do danych zdrowotnych, gdy iPhone jest zablokowany. Automatyzacje uruchamiają się tylko wtedy, gdy urządzenie jest odblokowane. Jest to ograniczenie Apple, którego nie można obejść. Więcej informacji
• Przetwarzanie w tle: iOS ogranicza przetwarzanie w tle, aby oszczędzać baterię. Automatyzacje polegają na Odświeżaniu aplikacji w tle i mogą nie uruchomić się od razu, jeśli:
  • Odświeżanie aplikacji w tle jest wyłączone dla aplikacji
  • Urządzenie jest w trybie niskiego zużycia energii
  • Urządzenie było nieaktywne przez dłuższy czas
  • Zasoby systemowe są ograniczone
  • Wiele aplikacji konkuruje o czas wykonywania w tle
• Harmonogram: W związku z przetwarzaniem w tle iOS nie pozwala też aplikacjom działać w tle o określonej godzinie. Oznacza to, że nawet po ustawieniu określonej częstotliwości synchronizacji nie ma gwarancji, że automatyzacje uruchomią się dokładnie o wyznaczonym czasie. Urządzenie musi być odblokowane, a iOS decyduje, kiedy automatyzacja uruchomi się w tle. Automatyzacje można też uruchomić ręcznie na następujące sposoby:
  • Widżet Automatyzacje: dotknij ikony widżetu, aby uruchomić automatyzację
  • Skróty — Uruchom automatyzację: użyj akcji Uruchom automatyzację, aby uruchomić skonfigurowaną automatyzację (zobacz Zaplanuj automatyzację za pomocą Shortcuts)
  • Uruchom ręcznie w aplikacji: Przejdź do automatyzacji w Health Auto Export, a następnie wykonaj Eksport ręczny
• Zaplanuj przypomnienia: Każda automatyzacja może opcjonalnie przypomnieć o odblokowaniu urządzenia i otwarciu Health Auto Export. Włącz Włącz przypomnienia, a następnie ustaw Częstotliwość przypomnień na Co godzinę, Codziennie lub Wybrane dni. Przypomnienia godzinowe używają Minuta w godzinie; codzienne i wybrane dni używają Czas przypomnienia. Przypomnienie nie oznacza, że automatyzacja została uruchomiona, i może pojawić się także po udanej synchronizacji w tle.
  • Zmiany przypomnień obowiązują po zapisaniu automatyzacji. Edytor pokazuje Następne przypomnienie po zapisaniu.
  • Stuknięcie przypomnienia otwiera automatyzację.
  • Otwórz i synchronizuj to akcja na powiadomieniu. Otwiera aplikację i natychmiast uruchamia tę automatyzację. Automatyzacja musi być włączona.
  • Jeśli automatyzacja została usunięta, wyłączona, już działa lub nie może działać przy bieżącym dostępie, aplikacja wraca do ekranu Automatyzacje.
  • Do przypomnień wymagane jest uprawnienie do powiadomień. Dostęp do powiadomień pokazuje bieżący stan. Jeśli powiadomienia są odrzucone, użyj Otwórz ustawienia powiadomień.
• Częstotliwość synchronizacji: Częstotliwość synchronizacji automatyzacji określa, jak często chcesz, aby automatyzacja działała w tle. To nie jest dokładny harmonogram i nie gwarantuje, że aplikacja otworzy się lub uruchomi w tle w tym interwale. Możliwość działania w tle jest zarządzana przez system.
• Otwieranie aplikacji: Automatyzacje i Synchronizacja z Macem działają, gdy Health Auto Export pozostaje otwarty. Możesz też rozpocząć uruchomienie z widżetu automatyzacji, Skrótów lub ręcznego eksportu.

Wydajność

Pamiętaj, że iOS jest zoptymalizowany pod krótkotrwałe zadania na urządzeniu mobilnym z bardzo ścisłymi ograniczeniami wydajnościowymi. Zadania w tle zwykle muszą zakończyć się w ciągu 30 sekund i mają ograniczoną ilość pamięci. Health Auto Export oferuje dużą elastyczność i możliwość dostosowania, dlatego warto zrozumieć, jak określone konfiguracje wpływają na wydajność aplikacji i wyniki.

• Konfiguracja: Automatyzacje generujące duże ilości danych mogą spowodować zakończenie procesu przez system i uniemożliwić działanie automatyzacji w tle. Następujące konfiguracje mogą generować duże ilości danych:
  • Automatyzacje skonfigurowane do eksportu wszystkich metryk zdrowotnych.
    • Zalecenie: wybieraj tylko metryki zdrowotne, które mają zapisane dane w Apple Health, i tylko dane, których faktycznie planujesz używać. Nawet puste typy danych wpływają na wydajność. Możesz też rozdzielić wybrane metryki zdrowotne na kilka automatyzacji — ułatwi to obsługę przez system.
  • Automatyzacje z grupowaniem czasowym w sekundach lub minutach albo z wyłączonym podsumowaniem danych. Tak szczegółowe zapytania mogą długo trwać i kolidować z ograniczeniami systemu.
    • Zalecenie: choć najbardziej szczegółowe dane mogą wydawać się idealne, rozważ, czy taki poziom szczegółowości jest potrzebny dla każdej metryki lub typu danych. Rozważ kilka automatyzacji z różnymi ustawieniami.
  • Przy eksporcie treningów na świeżym powietrzu, takich jak jazda na rowerze, bieganie, wędrówki itp. z danymi trasy, GPS i powiązane metryki zdrowotne mogą tworzyć duże ładunki danych.
• Rozmiar ładunku: Szczególnie przy eksporcie REST API pamiętaj, że duże ładunki mogą powodować błędy serwera. Upewnij się, że backend jest skonfigurowany do obsługi ładunków o wielkości nawet kilkuset megabajtów.
• Częstotliwość synchronizacji: Dodaj widżet Automatyzacje na ekran główny, aby automatyzacje częściej uruchamiały się w tle (zobacz Przewodnik konfiguracji widżetu Automatyzacje).
• Częstotliwość przypomnień: Używaj przypomnień godzinowych tylko wtedy, gdy naprawdę chcesz częstych monitów. Codzienne lub wybrane dni są mniej uciążliwe dla większości rutyn.
• Stan na liście podczas działania: Gdy automatyzacja przygotowuje dane, jej wiersz na liście Automatyzacje pokazuje pierścień postępu. Podczas przesyłania pokazuje spinner.

Dostępne typy automatyzacji

Health Auto Export obsługuje kilka typów automatyzacji, każdy przeznaczony do określonych zastosowań:

REST API

Wysyłaj dane zdrowotne do dowolnej usługi internetowej akceptującej żądania HTTP POST. Idealne do własnych backendów, webhooków i interfejsów API firm trzecich.

Przewodnik: Przewodnik po automatyzacji REST API

Home Assistant

Synchronizuj metryki zdrowotne z Home Assistant jako stany czujników. Idealne do integracji danych zdrowotnych z automatyzacją inteligentnego domu.

Przewodnik: Przewodnik po automatyzacji Home Assistant

MQTT

Publikuj dane zdrowotne do brokera MQTT. Świetne dla platform IoT i systemów opartych na MQTT.

Przewodnik: Przewodnik po automatyzacji MQTT

Dropbox

Automatycznie twórz kopie zapasowe danych zdrowotnych w Dropbox. Pliki są organizowane w folderach i dostępne z dowolnego urządzenia.

Przewodnik: Przewodnik po automatyzacji Dropbox

Google Drive

Automatycznie twórz kopie zapasowe danych zdrowotnych w Google Drive. Pliki CSV można przekonwertować na Arkusze Google w celu łatwego przeglądania.

Przewodnik: Przewodnik po automatyzacji Google Drive

iCloud Drive

Zapisuj dane zdrowotne bezpośrednio w iCloud Drive. Prosta konfiguracja bez uwierzytelniania.

Przewodnik: Przewodnik po automatyzacji iCloud Drive

Kalendarz

Twórz wydarzenia kalendarza na podstawie danych zdrowotnych. Wizualizuj treningi, kamienie milowe zdrowia i inne wydarzenia w kalendarzu.

Przewodnik: Przewodnik po automatyzacji Kalendarz

E-mail

Wysyłaj eksporty danych zdrowotnych jako załączniki e-mail na wybrany adres. Idealne do lekkich, zaplanowanych dostaw do skrzynki odbiorczej.

Przewodnik: Przewodnik automatyzacji e-mail

Tworzenie pierwszej automatyzacji

1. Otwórz pasek boczny, a następnie stuknij Automatyzacje
2. Dotknij „Nowa automatyzacja”
3. Wybierz typ automatyzacji
4. Skonfiguruj ustawienia specyficzne dla automatyzacji (zobacz poszczególne przewodniki)
5. Skonfiguruj ustawienia wspólne (typ danych, częstotliwość synchronizacji itd.)
6. Dotknij „Aktualizuj”, aby zapisać
7. Włącz automatyzację

Tworzenie kopii zapasowych i przywracanie automatyzacji

Health Auto Export może tworzyć kopię zapasową ustawień automatyzacji w iCloud Drive, aby można je było przywrócić na nowym urządzeniu lub po ponownej instalacji aplikacji. Jest to oddzielone od danych zdrowotnych eksportowanych przez automatyzacje.

• Gdzie znajdują się kopie zapasowe: Ustawienia automatyzacji są zapisywane jako pliki JSON w iCloud Drive w folderze Auto Export/Automations (widocznym w aplikacji Pliki).
• Kiedy tworzona jest kopia zapasowa: Za każdym razem, gdy zapisujesz automatyzację (dotykając Aktualizuj lub opuszczając ekran edycji), automatyzacja jest automatycznie kopiowana.
• Włączanie i wyłączanie: Otwórz listę automatyzacji i przejdź do Ustawień automatyzacji, następnie użyj Kopia zapasowa w iCloud Drive. Domyślnie jest włączone. Po wyłączeniu zostaniesz zapytany, czy usunąć istniejące pliki kopii zapasowej z iCloud Drive — automatyzacje pozostaną na urządzeniu w obu przypadkach.

Przywracanie

Jeśli otworzysz Automatyczne eksporty i nie masz jeszcze automatyzacji, ale w iCloud Drive są dostępne kopie zapasowe, pojawi się przycisk Przywróć z iCloud Drive. Dotknięcie go przywraca automatyzacje.

Kilka rzeczy do zapamiętania po przywróceniu:

• Połącz ponownie konta: Ze względu na prywatność tokeny logowania do usług takich jak Dropbox i Google Drive nie są uwzględniane w kopiach zapasowych. Po przywróceniu połącz te usługi ponownie w każdej automatyzacji.
• Włącz ponownie automatyzacje: Przywrócone automatyzacje startują jako wyłączone, aby nic nie uruchomiło się nieoczekiwanie ze przestarzałymi ustawieniami. Przejrzyj każdą z nich i włącz, gdy będziesz gotowy.
• Częściowe przywracanie: Jeśli niektórych automatyzacji nie można przywrócić (na przykład plik nie został jeszcze pobrany, klucz szyfrowania nie jest jeszcze dostępny lub została utworzona przez nowszą wersję aplikacji), pozostałe i tak zostaną przywrócone i zobaczysz, które zostały pominięte.

Uwaga: Nagłówki żądań i dane logowania wpisane w automatyzację (np. hasło MQTT) są szyfrowane w plikach kopii zapasowej iCloud Drive. Przywracanie na nowym urządzeniu wymaga iCloud Keychain, aby aplikacja mogła je odszyfrować. Ręcznie udostępnione/eksportowane pliki pozostają niezaszyfrowanym zwykłym JSON.

Dzienniki aktywności

Każda automatyzacja ma Dzienniki aktywności z historią uruchomień.

1. Otwórz automatyzację i dotknij Wyświetl dzienniki aktywności.
2. Zdarzenia są pogrupowane według uruchomienia (najnowsze na górze). Rozwiń uruchomienie, aby zobaczyć poszczególne zdarzenia.
3. Ostrzeżenia (np. wolne zapytanie o dane zdrowotne) oznaczają, że uruchomienie zakończyło się, ale krok trwał dłużej niż oczekiwano. Błędy oznaczają, że krok się nie powiódł (przesyłanie, odczyt danych zdrowotnych, uwierzytelnianie itp.). Jeśli nic nie zostało przesłane, błąd wyjaśnia, czy w zakresie dat nie znaleziono danych zdrowotnych, czy danych nie udało się w pełni odczytać (na przykład dlatego, że urządzenie zablokowało się podczas eksportu):

• “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. Wyczyść (pasek narzędzi) usuwa tylko historię aktywności tej automatyzacji, a nie ogólne dzienniki diagnostyczne aplikacji.
5. Udostępnij (pasek narzędzi) eksportuje pełny diagnostyczny plik ZIP Dzienników zdarzeń aplikacji — ten sam pakiet co Ustawienia → Zaawansowane → Eksportuj dzienniki zdarzeń. Zobacz Przewodnik po dziennikach zdarzeń aplikacji.

Wolne zapytania w dziennikach aktywności

• Jeśli pobranie danych zdrowotnych trwa długo, w dziennikach aktywności mogą pojawić się ostrzeżenia wolne zapytanie o dane zdrowotne, a nie błędy.
• Aby przyspieszyć uruchomienia: wybierz mniej metryk zdrowotnych, krótszy zakres dat, włącz Podsumuj dane i wybierz grubsze Grupowanie czasowe (godziny, dni lub tygodnie).
• Automatyzacje w czasie rzeczywistym celowo używają drobniejszego grupowania i mogą częściej rejestrować ostrzeżenia o wolnych zapytaniach.

Ostrzeżenie ustawień eksportu

Podczas konfigurowania automatyzacji metryk zdrowotnych (nie Home Assistant) pod Ustawieniami eksportu może pojawić się stopka, jeśli konfiguracja może być wolna:

• Podsumuj dane jest wyłączone lub grupowanie czasowe to minuty lub sekundy, oraz
• Wybrano więcej niż 10 metryk zdrowotnych

Stopka sugeruje mniej metryk, krótszy zakres dat, Podsumuj dane lub grubsze grupowanie czasowe. Linkuje do tego przewodnika. Ostrzeżenia o wolnych zapytaniach w dziennikach aktywności są oddzielne i pojawiają się po uruchomieniu, gdy zapytania przekroczą progi.

Najlepsze praktyki

1. Automatyczna synchronizacja:

• Ładuj urządzenie i używaj Lustrzania iPhone’a
  • Podczas ładowania iOS mniej ogranicza wydajność, więc dane mogą synchronizować się częściej
  • Przy Lustrzaniu iPhone’a urządzenie zachowuje się jak odblokowane. Health Auto Export może wtedy uzyskać dostęp do danych zdrowotnych potrzebnych do działań automatycznych

2. Częstotliwość synchronizacji:

• Równowaga między aktualnością danych a zużyciem zasobów
• Codzienna synchronizacja sprawdza się w większości przypadków
• Częstsza synchronizacja przy potrzebach w czasie rzeczywistym
• Rzadsza synchronizacja dla danych podsumowujących

3. Wybór danych:

• Wybieraj tylko potrzebne metryki
• Skraca czas przetwarzania i rozmiar danych
• Rozważ osobne automatyzacje dla różnych grup metryk. Naraz działa tylko jedna automatyzacja; podział i tak pomaga utrzymać mniejszy ładunek.

4. Testowanie:

• Uruchom eksport ręczny
• Sprawdź, czy dane pojawiły się w miejscu docelowym
• Sprawdź dzienniki aktywności pod kątem błędów
• Uważnie monitoruj pierwsze synchronizacje

5. Monitorowanie:

• Regularnie przeglądaj dzienniki aktywności
• Sprawdzaj wskaźniki statusu automatyzacji
• Użyj Powiadamiaj przy uruchomieniu lub Powiadamiaj o aktualizacji cache, aby wiedzieć, że uruchomienie nastąpiło. Użyj Zaplanuj przypomnienia, gdy chcesz monitu o odblokowanie i otwarcie aplikacji.
• Monitoruj miejsce docelowe pod kątem odebranych danych

6. Bezpieczeństwo:

• Używaj bezpiecznych metod uwierzytelniania
• Aktualizuj dane logowania
• Używaj HTTPS/TLS, gdy jest dostępne
• Przeglądaj ustawienia prywatności

7. Wydajność:

• Używaj odpowiedniego grupowania czasowego
• Rozważ ustawienia zakresu dat dla magazynu w chmurze
• Monitoruj zużycie baterii i danych
• Przeglądaj Dzienniki aktywności pod kątem ostrzeżeń o wolnych zapytaniach

8. Strategia kopii zapasowej:

• Używaj wielu typów automatyzacji dla redundancji
• Łącz magazyn w chmurze z integracjami API
• Przechowuj kopie lokalne, gdy to możliwe
• Testuj procedury przywracania

9. Rozwiązywanie problemów:

• Najpierw sprawdź dzienniki aktywności
• Zweryfikuj połączenie sieciowe
• Sprawdź dane uwierzytelniające
• Zobacz poszczególne przewodniki automatyzacji w przypadku konkretnych problemów

Widżet Automatyzacje

Dodaj widżet „Automatyzacje” na ekran główny, aby:

• monitorować status automatyzacji na pierwszy rzut oka
• ręcznie uruchamiać automatyzacje
• optymalizować przesyłanie w tle

Uzyskiwanie pomocy

Jeśli potrzebujesz pomocy z określonym typem automatyzacji:

1. Zobacz przewodnik dla danego typu automatyzacji
2. Sprawdź dzienniki aktywności pod kątem komunikatów o błędach
3. Przejrzyj sekcje rozwiązywania problemów
4. Skontaktuj się z pomocą techniczną, jeśli problemy się utrzymują