Apple Health 데이터를 Dropbox와 동기화

Dropbox 자동화를 사용하면 건강 데이터를 Dropbox에 자동으로 백업할 수 있습니다. 파일은 폴더로 구성되며 JSON 또는 CSV 형식으로 내보낼 수 있어 모든 기기에서 건강 데이터에 쉽게 액세스하거나 다른 사람과 공유할 수 있습니다.

개요

Dropbox 자동화는 건강 데이터를 Dropbox 계정의 지정된 폴더에 자동으로 업로드합니다. 파일은 날짜 범위(일, 주, 월 또는 연도)별로 구성되며 Dropbox 액세스 권한이 있는 모든 기기에서 액세스할 수 있습니다.

사용 사례:

• 건강 데이터의 자동 클라우드 백업
• 여러 기기에서 건강 데이터 액세스
• 의료 제공자와 건강 데이터 공유
• 장기 데이터 보관
• Dropbox에 액세스할 수 있는 다른 서비스와의 통합

제한 사항

• 건강 데이터 액세스: iPhone이 잠겨 있는 동안 앱은 건강 데이터에 액세스할 수 없습니다. 자동화는 기기가 잠금 해제된 기간에만 실행됩니다. 이로 인해 데이터 신선도에 영향을 줄 수 있습니다. 데이터를 최신 상태로 유지하려면 수동 동기화 지침을 참조하세요.

• 백그라운드 처리: iOS는 배터리 수명을 보존하기 위해 백그라운드 처리를 제한합니다. 자동화는 백그라운드 앱 새로 고침에 의존하며 다음 경우 즉시 실행되지 않을 수 있습니다:

  • 앱의 백그라운드 앱 새로 고침이 비활성화된 경우
  • 기기가 저전력 모드에 있는 경우
  • 기기가 장기간 비활성 상태인 경우
  • 시스템 리소스가 제한된 경우
  • 여러 앱이 백그라운드 실행 시간을 경쟁하는 경우

사전 요구 사항

• Dropbox 계정
• 인터넷 연결

구성

메인 탐색에서 자동 내보내기 화면으로 이동한 다음 "새 자동화"를 탭하고 자동화 유형으로 "Dropbox"를 선택합니다.

자동화 이름

자동화에 대한 설명 이름을 입력합니다(예: "일일 건강 백업", "주간 건강 내보내기"). 이 이름은 자동화를 식별하는 데 사용됩니다.

활성화된 상태 및 알림

자동화 상태 및 알림 기본 설정을 구성합니다:

• 상태 활성화됨 - 자동화를 활성화하거나 비활성화하려면 전환
• 캐시 업데이트 시 알림 - 캐시된 데이터가 업데이트될 때 알림 수신
• 실행 시 알림 - 자동화가 데이터를 업로드할 때마다 알림 수신

자동화 유형

자동화 유형으로 "Dropbox"를 선택합니다. 이는 건강 데이터가 내보내질 위치를 결정합니다.

Dropbox 연결

다른 설정을 구성하기 전에 Dropbox 계정을 연결해야 합니다.

Dropbox 연결

1. "Dropbox 연결" 버튼을 탭
2. Dropbox의 승인 페이지로 리디렉션됩니다
3. 요청 시 Dropbox 계정에 로그인
4. 앱이 요청한 권한을 검토하고 승인
5. 제공된 코드를 복사한 다음 Health Auto Export로 돌아가서 붙여넣어 계속 진행

참고: 앱은 Dropbox의 자체 폴더에서 파일을 만들고 관리하기 위한 액세스를 요청합니다. 생성한 폴더에만 액세스하며 전체 Dropbox에 액세스하지 않습니다.

폴더 이름

연결 후 건강 데이터가 저장될 Dropbox의 폴더 이름을 입력합니다.

폴더 이름 예:

• 건강 데이터
• 일일 백업
• 건강 내보내기
• 내 건강 지표

참고: 폴더가 존재하지 않으면 Dropbox "Apps" 디렉토리에 자동으로 생성됩니다. 파일 시스템에 문제를 일으킬 수 있는 특수 문자 사용을 피하세요.

연결 관리

연결 후 Dropbox 연결을 관리할 수 있습니다:

1. Dropbox 구성 섹션에서 "연결 관리"를 탭
2. 연결 상태 보기
3. 필요 시 다시 연결
4. 다른 계정을 사용하려면 연결 해제

데이터 유형 설정

데이터 유형

내보낼 건강 데이터 유형을 선택합니다:

• 건강 지표 - 걸음 수, 심박수, 수면 및 기타 건강 측정값
• 운동 - 운동 및 피트니스 활동
• 증상 - 건강 증상 및 상태
• 심전도 - 심전도 판독값
• 심박수 알림 - 높음/낮음/불규칙한 심박수 이벤트
• 마음 상태 - 기분 및 정신 상태 항목(iOS 18.0+)
• 주기 추적 - 월경 주기 및 생식 건강 데이터
• 약물 - 약물 로그 및 순응도(iOS 26.0+)

건강 지표 구성

건강 지표가 선택된 경우:

건강 지표 선택 - 포함할 특정 지표를 선택합니다. 사용 가능한 모든 지표를 선택하거나 특정 지표를 선택할 수 있습니다.

팁: 필요한 지표만 선택하면 파일 크기를 줄이고 업로드 속도를 향상시킬 수 있습니다.

선호 소스 - 여러 소스가 동일한 지표를 제공할 때 어떤 데이터 소스에 우선순위를 둘지 구성합니다.

운동 구성

운동이 선택된 경우:

경로 데이터 포함 - 위치 데이터가 있는 운동의 GPX 경로 파일을 포함하려면 켜기

운동 지표 포함 - 운동 중 수집된 건강 지표(심박수, 칼로리 등)를 포함하려면 켜기

참고: 운동 지표를 포함하면 추가 데이터 조회가 필요하며 파일 크기와 처리 시간이 증가할 수 있습니다.

시간 그룹화(운동 지표) - 내보내기 버전 2를 사용하고 운동 지표 포함이 활성화된 경우:

• 분 - 운동 지표를 분별로 그룹화
• 초 - 운동 지표를 초별로 그룹화

내보내기 설정

내보내기 형식

내보낸 데이터의 형식을 선택합니다:

• JSON 형식 - 중첩된 개체가 있는 상세한 데이터 구조를 제공합니다. 애플리케이션, 데이터베이스 및 상세한 분석에 가장 적합합니다. JSON 형식에는 수면 단계 및 AFib 판독값과 같은 복잡한 데이터 유형에 대한 더 자세한 정보가 포함됩니다.

• CSV 형식 - Excel, Numbers 또는 Google Sheets와 같은 스프레드시트 애플리케이션에 쉽게 가져올 수 있는 표 형식의 데이터를 제공합니다. 간단한 데이터 분석 및 보기에 가장 적합합니다.

팁: 포괄적인 데이터 저장에는 JSON을 사용하고 스프레드시트 애플리케이션에서 쉽게 보려면 CSV를 사용합니다.

내보내기 버전

내보내기 버전을 선택합니다. 버전 관리를 통해 자신의 속도로 내보내기의 업데이트된 버전 간에 전환할 수 있으며 워크플로우의 중단 변경을 최소화합니다.

• 버전 1 - 레거시 형식, 이 형식에 의존하는 기존 워크플로우가 있는 경우 사용
• 버전 2 - 건강 지표에 대한 현지화 지원 및 향상된 운동 데이터와 더 자세한 메타데이터 옵션이 있는 현재 형식

날짜 범위

데이터를 파일로 구성하는 방법을 선택합니다:

• 일 - 각 일에 대한 별도 파일 생성
• 주 - 각 주에 대한 별도 파일 생성
• 월 - 각 월에 대한 별도 파일 생성
• 연도 - 각 연도에 대한 별도 파일 생성

파일 구성:

• 파일은 포함된 날짜 범위를 기반으로 이름이 지정됩니다
• 각 파일에는 해당 기간의 모든 데이터가 포함됩니다
• 파일은 폴더 이름에 지정된 폴더에 저장됩니다

시간 그룹화

각 파일 내에서 데이터를 집계하는 방법을 선택합니다. 사용 가능한 옵션은 선택한 날짜 범위에 따라 다릅니다:

참고: 더 세분화된 집계(분/시간)는 더 큰 파일을 생성하지만 더 자세한 데이터를 제공합니다. 덜 세분화된 집계(일/주/월)는 요약된 데이터로 더 작은 파일을 생성합니다.

데이터 요약

건강 지표 데이터 유형과 함께 JSON 형식을 사용하는 경우 데이터 요약을 켜거나 끕니다.

• 켜기 - 집계된 데이터 요약 제공(기본값)
• 끄기 - 가능한 경우 비집계 데이터를 제공하여 개별 데이터 포인트 표시

참고: 이 설정은 건강 지표가 있는 JSON 형식에만 적용됩니다. CSV 형식을 사용하거나 여러 지표가 선택된 경우 데이터는 항상 집계됩니다.

동기화 빈도

자동화가 Dropbox에 데이터를 업로드해야 하는 빈도를 구성합니다:

숫자와 간격을 선택합니다.

테스트 및 확인

수동 테스트

1. 자동화 구성 화면에서 "수동 내보내기"를 탭
2. 날짜 범위 선택
3. 파일을 업로드하려면 "내보내기"를 탭
4. Dropbox 폴더를 확인하여 파일이 업로드되었는지 확인

활동 로그 보기

1. 자동화 구성 화면에서 "활동 로그 보기"를 탭
2. 최근 자동화 실행 검토
3. 업로드 오류 또는 연결 문제 확인
4. 업로드 타임스탬프 확인

문제 해결

일반적인 문제

"유효성 검사 오류: Dropbox 토큰을 찾을 수 없습니다. 토큰을 얻으려면 Dropbox에 연결하세요."

• 앱을 승인하려면 "Dropbox 연결"을 탭
• 승인 프로세스를 완료했는지 확인

연결/토큰 오류

• 다시 연결하려면 "연결 관리"를 탭
• 인터넷 연결 확인
• Dropbox 계정이 활성화되어 있는지 확인
• 토큰이 만료된 경우 앱 재승인

Dropbox에 파일이 표시되지 않음

• 업로드가 완료될 때까지 잠시 기다립니다
• 인터넷 연결 확인
• 업로드 오류에 대한 활동 로그 확인
• 자동화가 활성화되어 있는지 확인

업로드 실패

• 인터넷 연결 확인
• 사용 가능한 Dropbox 저장 공간이 있는지 확인
• 특정 오류 메시지에 대한 활동 로그 확인
• 연결을 테스트하려면 수동 내보내기 시도

토큰 만료

• 토큰은 만료되면 자동으로 새로 고침됩니다
• 새로 고침이 실패하면 다시 연결해야 할 수 있습니다
• 필요 시 다시 연결하려면 "연결 관리"를 탭

오류 메시지

다음과 같은 경우 앱이 오류 메시지를 표시합니다:

• Dropbox 연결이 실패한 경우
• 네트워크 문제로 인해 업로드가 실패한 경우
• Dropbox 저장 공간 할당량이 초과된 경우
• 잘못된 폴더 이름 또는 경로
• 토큰 새로 고침이 실패한 경우

HTTP 상태 코드 및 Dropbox API 오류 메시지를 포함한 자세한 오류 정보는 활동 로그를 확인하세요.

팁 및 모범 사례

1. 파일 형식:

   • 포괄적인 데이터 저장에는 JSON 사용
   • 스프레드시트 애플리케이션에서 쉽게 보려면 CSV 사용
   • 형식을 선택할 때 사용 사례 고려

2. 동기화 빈도:

   • 더 자주 동기화하면 데이터 신선도가 향상됩니다

3. 데이터 선택:

   • 파일 크기를 줄이려면 필요한 지표만 선택
   • Dropbox 저장 공간 제한 고려

4. 액세스:

   • 파일은 Dropbox가 있는 모든 기기에서 액세스할 수 있습니다
   • 필요 시 의료 제공자와 폴더 공유
   • 협업을 위해 Dropbox의 공유 기능 사용