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 檔案是活動資料的每日摘要，在這種情況下，您可能希望按日期將這些資料分組，以免每天產生大量記錄（例如每分鐘一次）。 若要執行此操作，請勾選「按日期分組資料？」核取方塊（此功能目前僅適用於「活動」）。
• 某些 CSV 檔案包含每餐的詳細資料，在這種情況下，您可能希望將這些資料按日期分組，以免產生大量零散的記錄。若要執行此操作，請勾選「按餐次分組資料？」核取方塊（此功能目前僅適用於營養資訊）。
• 某些 CSV 檔案所附的時區未經明確標示，在此情況下，系統會預設採用您個人設定檔中的時區。若未經明確標示的日期與時間實際上是以 UTC 為基準，您可以透過勾選「對未明確標示的日期強制使用 UTC 時區？」核取方塊來覆寫此設定。

在匯出資料時，「每日摘要包含總計」選項可讓您彈性設定摘要行。若未勾選此選項，系統將顯示與 Stream 中完全相同的数据。若勾選此選項，每日摘要行將包含該日的總步數。 若該日期預設沒有摘要行，系統將會在您的資料集中新增一行。

為了協助進行欄位對應，您可以點選「上傳樣本以選擇欄位」按鈕，系統將允許您上傳檔案的一部分作為樣本，接著以互動方式進行欄位對應，並儲存該設定。這是確保您已包含所有必要欄位（例如開始日期）的絕佳方法。

其餘所有設定皆與「來源」或「目標」相同。

某些服務可能會產生代表某項活動的 CSV 檔案。系統支援此類檔案，但您必須使用「Cloud Files」選項來進行設定。

要設定 Amazon S3，請將您的存取金鑰輸入至「使用者名稱」欄位，將您的密鑰輸入至「密碼」欄位，而路徑則請使用 bucket/directory/file。

若您收到錯誤訊息，指出某筆資料缺少日期、活動、描述，或資訊不完整，這很可能是因為您遺漏了必填欄位，或是系統無法解析該資料。我們建議您使用我們的「範例上傳工具」，該工具會列出該資料類型的必填欄位。

注意：對於目標任務，我們不會重寫檔案，而是將我們認為是新資訊的內容追加到檔案末尾。如果您刪除了檔案並希望重新填入資料，或者您已變更了匯出資料的結構，則需要重置該任務。

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 (平板電腦)