Amazon S3, DropBox, Google Drive, OneDrive 및 CSV 구성

쉼표로 구분된 파일(CSV)을 생성할 수 있으며, Amazon S3, DropBox, Google Drive, OneDrive에서 해당 파일을 읽어올 수 있습니다. 이는 다른 서비스에서 데이터를 가져오거나, 백업 또는 다른 애플리케이션과의 공유를 위해 파일을 내보내는 간단한 방법입니다. 최대한의 유연성을 보장하고 모든 서비스를 지원하기 위해 구성 옵션이 매우 다양합니다. 구성 방법은 다음과 같습니다:

• 읽거나 수정할 파일의 경로를 설정하세요. 경로의 어느 곳에나 ‘{tasktype}’를 포함시킬 수 있으며, 이 부분은 작업이 동기화하는 데이터 유형으로 대체됩니다. 즉, ‘/exports/{tasktype}.csv’는 ‘Activity’ 작업에서는 ‘/exports/Activity.csv’로, ‘Sleep’ 작업에서는 ‘/exports/Sleep.csv’로 바뀝니다. 이를 통해 하나의 폴더에 여러 작업을 저장해도 서로 덮어쓰는 일이 없습니다.
• 파일 대신 폴더를 제공해 주시면, 해당 폴더 내의 ‘FitnessSyncer-{tasktype}.csv’을 사용하게 됩니다. 예를 들어, ‘FitnessSyncer-Activity.csv’과 같이요.
• 파일에 사용할 구분 기호를 지정해 주세요. 필요한 구분 기호를 찾을 수 없는 경우 당사에 문의해 주십시오.
• 파일에 주석 블록이 포함되어 있다면 주석 접두사 문자를 선택하십시오. 필요한 문자를 찾을 수 없는 경우 당사에 문의해 주십시오.
• 파일 상단에 텍스트 블록이 포함되어 있다면, 시작 행을 헤더가 있는 행 번호로 변경할 수 있습니다.
• 데이터의 각 열에 대해, ‘열 번호’ 왼쪽에 있는 확인란을 선택한 다음 해당 열의 숫자 인덱스를 입력하십시오. 예를 들어, Excel에서 열이 B1인 경우, 이 값은 2가 됩니다.
• 데이터에 없는 항목이 있는 경우, ‘기본값’ 열에 대체 값을 입력할 수 있습니다.
• 일부 CSV 파일은 활동 데이터의 일일 요약본이며, 이러한 경우 하루에 기록이 너무 많이 쌓이지 않도록(예: 1분마다 한 번씩) 날짜별로 그룹화할 수 있습니다. 이를 위해 “날짜별로 데이터 그룹화?” 확인란을 선택하십시오(현재 이 기능은 ‘활동’에서만 사용할 수 있습니다).
• 일부 CSV 파일에는 식사별 상세 데이터가 포함되어 있는데, 이러한 경우 작은 규모의 기록이 너무 많이 생기지 않도록 날짜별로 그룹화할 수 있습니다. 이를 위해 “식사별로 데이터 그룹화?” 확인란을 선택하십시오(현재 이 기능은 영양 정보에서만 사용할 수 있습니다).
• 일부 CSV 파일에는 시간대 정보가 명시되지 않은 경우가 있으며, 이 경우 기본적으로 사용자의 프로필에 설정된 시간대를 적용합니다. 시간대 정보가 명시되지 않은 날짜와 시간이 실제로 UTC인 경우, “시간대 정보가 명시되지 않은 날짜에 대해 UTC 시간대를 강제 적용할까요?” 확인란을 통해 이를 재설정할 수 있습니다.

데이터를 내보낼 때, “총계 포함 일별 요약” 옵션을 사용하면 요약 행을 유연하게 설정할 수 있습니다. 이 옵션을 선택하지 않으면 Stream에 표시된 것과 동일한 정확한 데이터가 표시됩니다. 이 옵션을 선택하면 일별 요약 행에 해당 일의 총 걸음 수가 포함됩니다. 해당 날짜에 기본적으로 요약 행이 없는 경우, 데이터 세트에 요약 행이 하나 추가됩니다.

열 매핑을 쉽게 수행하려면 “샘플 업로드로 열 선택” 버튼을 클릭하세요. 이 버튼을 클릭하면 파일의 일부를 샘플로 업로드한 후, 대화형 방식으로 열을 매핑하고 해당 설정을 저장할 수 있습니다. 이는 시작 날짜와 같은 필수 필드가 모두 포함되었는지 확인하는 데 매우 유용한 방법입니다.

그 외의 모든 설정은 ‘소스’나 ‘대상’과 동일합니다.

일부 서비스에서는 특정 활동을 나타내는 CSV 파일을 생성할 수 있습니다. 이러한 파일은 지원되지만, 이를 구성하려면 ‘Cloud Files’ 옵션을 사용해야 합니다.

Amazon S3을 구성하려면, 사용자 이름 필드에 액세스 키를, 비밀 키 필드에 비밀 키를 입력하고, 경로에는 버킷/디렉터리/파일 형식을 사용하십시오.

행에 날짜가 지정되지 않았거나, 활동 또는 설명이 없거나, 해당 행에 대한 정보가 불충분하다는 오류 메시지가 표시된다면, 필수 입력란이 누락되었거나 데이터를 파싱할 수 없었던 것일 가능성이 높습니다. 해당 데이터 유형의 필수 입력란을 확인할 수 있는 ‘샘플 업로더’를 사용하시기를 권장합니다.

참고: 대상 작업의 경우, 파일을 다시 작성하지 않고 새로운 정보로 판단되는 내용을 파일 끝에 추가합니다. 파일을 삭제한 후 다시 채우려는 경우나 내보낸 데이터의 구조를 변경한 경우에는 해당 작업을 ‘재설정’해야 합니다.

CSV Android 및 iOS 앱에서

CSV 작업은 앱이 아닌 웹에서 설정됩니다. 그 이유는 열 매핑 때문입니다. 선택할 수 있는 필드가 수백 개나 되는데, 휴대폰 화면으로는 이를 일일이 살펴보기 어렵기 때문에, 앱은 필드의 절반 정도만 제공하는 대신 사용자를 이 사이트로 연결해 줍니다.

앱에서는 CSV 작업이 실제로 어떤 것인지 정확히 표시해 줍니다. 앱을 하나 열어보면 파일 형식이 여기와 마찬가지로 CSV으로 표시되며, 경로, 이름, 일정 등은 평소와 같이 모두 편집할 수 있습니다. 단, 앱에서는 새로운 CSV 작업을 생성할 수 없습니다. 열 매핑이 없는 CSV 소스는 어떤 데이터도 가져올 수 없기 때문입니다.

매핑 정보(또는 방언 설정, 따옴표 및 구분자, 시작 행 등)가 필요할 때, 앱은 사용자가 보고 있던 작업 페이지로 이 사이트를 열어주고, 로그인한 상태로 유지한 뒤, 작업이 끝나면 다시 앱으로 돌아오게 합니다. 돌아오는 과정에서 작업 내용이 다시 불러오기 때문에, 웹에서 변경한 모든 내용이 앱에 반영됩니다.

해당 기기의 브라우저에서 이미 FitnessSyncer에 로그인되어 있는 경우, 핸드오프 기능은 단순히 해당 세션을 사용합니다.

CSV 및 날짜

수입되는 모든 품목에 대한 날짜 정보를 제출해 주셔야 합니다.

• 날짜가 다음 중 하나와 유사한 경우 ‘날짜 (미국)’을 선택하십시오:
  • 07/27/2019 16:13:37
  • 07/27/2019 16:13
  • 07/27/2019
  • Jul 27, 2019
  • July 27, 2019
  • 2019-07-27 16:13:37
  • 2019-07-27 16:13:37 Z
  • 2019-07-27T16:13:37Z
  • 2019-07-27T16:13:37
  • July 27, 2019 04:13:37 PM
  • July 27, 2019 04:13 PM
  • July 27, 2019 - 04:13:37 PM
  • July 27, 2019 16:13:37
  • July 27, 2019 16:13
  • July 27 2019 04:13:37 PM
  • July 27 2019 04:13 PM
  • July 27 2019 - 04:13:37 PM
  • July 27 2019 16:13:37
  • July 27 2019 16:13
  • Jul 27, 2019 04:13:37 PM
  • Jul 27, 2019 04:13 PM
  • Jul 27, 2019 16:13:37
  • Jul 27, 2019 16:13
  • 2019-07-27 16:13Z
  • 2019-07-27 16:13
  • 27-Jul-2019 16:13
  • 07-27-2019 16:13
  • 07-27-2019
  • 16:13:37 PM Jul 27 2019
  • 2019-07-27
  • 2019/07/27 16:13:37
  • 2019/07/27 16:13
• 날짜가 다음 중 하나와 유사한 경우 ‘날짜 (미국 이외 지역)’을 선택하십시오:
  • 27/07/2019 16:13:37
  • 27/07/2019 16:13
  • 27/07/2019
  • 27 Jul 2019
  • 27 July 2019
  • 2019-07-27 16:13:37
  • 2019-07-27 16:13:37 Z
  • 2019-07-27T16:13:37Z
  • 2019-07-27T16:13:37
  • 2019-07-27 16:13
  • 27 July 2019 04:13:37 PM
  • 27 July 2019 04:13 PM
  • 27 July 2019 16:13:37
  • 27 July 2019 16:13
  • 27 Jul 2019 04:13:37 PM
  • 27 Jul 2019 04:13 PM
  • 27 Jul 2019 16:13:37
  • 27 Jul 2019 16:13
  • 27-Jul-2019 16:13
  • 2019-07-27
  • 27-Jul-19
  • 27.07.2019 16:13:37
  • 2019/07/27 16:13:37
  • 2019/07/27 16:13
  • 27.07.2019 16:13Z
  • 27.Jul.2019 16:13
  • 27.07.2019
  • 2019.07.27 16:13Z
  • 27.Jul.2019 16:13
  • 2019.07.27
  • 27/Jul/2019
  • 20190727
• 데이터가 ‘1564244017’과 같은 형식이라면 ‘시간 (초)’을 선택하십시오.
• 데이터가 ‘1564244017000’과 같은 형식이라면 ‘밀리초 단위의 시간’을 선택하십시오.
• 날짜 데이터에 ‘연도’, ‘월’, ‘날’에 해당하는 별도의 열이 있다면, 이 세 열을 선택하십시오.
• 시간이 위의 형식 중 하나로 지정되지 않은 경우, ‘시간 형식’을 사용하여 시간을 포함할 수 있으며, 이 형식은 다음 중 하나여야 합니다:
  • 04:13:37 Z PM
  • 04:13:37 PM
  • 04:13 PM
  • 16:13:37 Z
  • 16:13:37
  • 16:13

데이터 내보내기에는 위 설정 중 첫 번째 형식을 사용할 것입니다.

사용 중인 날짜 형식이 위의 형식 중 어느 것과도 일치하지 않는 경우, 당사로 문의해 주시기 바랍니다.

CSV 및 열거형 값

몇몇 필드는 미리 정해진 값 집합 중 하나만 허용합니다. 이러한 값은 아래와 같이 정확히 일치해야 합니다(모두 대문자로 표기하며, 표시된 위치에는 밑줄을 사용). FitnessSyncer의 다른 곳에 표시되는 ‘친숙한 이름’과는 다릅니다. 정확히 일치하지 않는 값은 전체 가져오기 작업을 거부하는 대신 해당 행에서 조용히 건너뛰어지므로, 필드 값이 예상대로 반영되지 않는 경우 이 부분을 다시 한 번 확인해 볼 가치가 있습니다.

• 생리 주기 추적, 유량 레벨:
  • NONE (없음)
  • SPOTTING (점적 출혈)
  • LIGHT (적음)
  • MEDIUM (보통)
  • HEAVY (많음)
• 생리 주기 추적, 자궁경부 점액:
  • DRY (건조한)
  • STICKY (고정)
  • CREAMY (크리미한)
  • WATERY (묽은)
  • EGG_WHITE (달걀 흰자)
• 생리 주기 추적, 배란 검사:
  • NEGATIVE (부정)
  • HIGH (높음)
  • PEAK (피크)
• 약물 투여 단위:
  • ML (ML)
  • MG (MG)
  • MGML (MG/ML)
  • MCG (마이크로그램)
  • TABLET (태블릿)