Amazon S3、DropBox、Google Drive、およびOneDrive CSV の構成

カンマ区切りファイル（CSV）を作成したり、Amazon S3、DropBox、Google Drive、OneDriveから読み込んだりすることができます。 これは、他のサービスからデータをインポートしたり、バックアップや他のアプリケーションとの共有のためにファイルをエクスポートしたりするための簡単な方法です。最大限の柔軟性を確保し、あらゆるサービスに対応できるよう、設定項目は充実しています。設定方法は以下の通りです：

• 読み取りまたは変更してほしいファイルへのパスを設定してください。パスの任意の場所に「{tasktype}」を含めることができます。これを、タスクが同期するデータの種類に置き換えます。つまり、「/exports/{tasktype}.csv」はアクティビティ・タスクでは「/exports/Activity.csv」に、スリープ・タスクでは「/exports/Sleep.csv」になります。これにより、1つのフォルダに複数のタスクを格納しても、互いに上書きされることはありません。
• ファイルではなくフォルダを指定された場合、その中の「FitnessSyncer-{tasktype}.csv」を使用します。例えば、「FitnessSyncer-Activity.csv」などです。
• ファイルに使用する区切り文字を指定してください。必要な区切り文字が見つからない場合は、弊社までお問い合わせください。
• ファイルにコメントブロックが含まれている場合は、コメントのプレフィックス文字を選択してください。必要なものが見つからない場合は、弊社までお問い合わせください。
• ファイルの上部にテキストのブロックが含まれている場合は、開始行をヘッダーがある行番号に変更することができます。
• データの各列について、「列番号」の左にあるチェックボックスを選択し、その列の数値インデックスを入力してください。たとえば、Excelの場合、列がB1であれば、この値は2になります。
• データに含まれていない項目については、「デフォルト」列に上書き値を入力することができます。
• 一部のCSVファイルは活動データの日次集計であるため、1日あたりのレコード数が多くなりすぎないように（例えば1分ごとに1件など）、日付ごとにグループ化したい場合があるかもしれません。 これを行うには、「データを日付ごとにグループ化しますか？」チェックボックスにチェックを入れてください（現在、この機能は「アクティビティ」でのみ利用可能です）。
• 一部のCSVファイルには、食事ごとの詳細データが含まれている場合があります。そのような場合、細かい記録が大量に生成されないよう、日付ごとにグループ化したいことがあるでしょう。その場合は、「データを食事ごとにグループ化しますか？」のチェックボックスにチェックを入れてください（この機能は現在、栄養情報のみに利用可能です）。
• 一部のCSVファイルには、タイムゾーンが指定されていない場合があります。そのような場合、デフォルトではプロファイルに設定されているタイムゾーンが適用されます。タイムゾーンが指定されていない日付と時刻が実際にはUTCである場合は、「タイムゾーンが指定されていない日付に対してUTCタイムゾーンを強制する？」チェックボックスをオンにすることで、この設定を上書きすることができます。

データをエクスポートする際、「合計数を表示する日別サマリー」オプションを使用すると、サマリー行の表示を柔軟に設定できます。このオプションがチェックされていない場合、Streamに表示されているデータがそのまま表示されます。このオプションがチェックされている場合、日別サマリー行にはその日の総歩数が表示されます。 その日付にデフォルトで集計行がない場合、データセットに集計行が追加されます。

列のマッピングを容易にするために、「サンプルをアップロードして列を選択」ボタンを選択することができます。これにより、ファイルの一部をサンプルとしてアップロードし、対話形式で列をマッピングして、その設定を保存することができます。これは、開始日などの必須フィールドがすべて含まれていることを確認するのに最適な方法です。

その他の設定はすべて、「送信元」や「送信先」と同様です。

一部のサービスでは、アクティビティを表す CSV ファイルが生成される場合があります。このようなファイルはサポートされていますが、設定を行うには「Cloud Files」オプションを使用する必要があります。

Amazon S3を設定するには、ユーザー名欄にアクセスキーを、パスワード欄にシークレットキーを入力し、パスには「バケット/ディレクトリ/ファイル」を指定してください。

行に日付、アクティビティ、説明が指定されていない、またはその行に必要な情報が不足していることを示すエラーが表示された場合は、おそらく必須フィールドが入力されていないか、またはそのデータが解析できなかった可能性があります。そのデータタイプに必要な必須フィールドが一覧表示される「サンプルアップローダー」のご利用をお勧めします。

注：宛先タスクの場合、ファイルを書き換えるのではなく、新しい情報と思われる内容をファイルの末尾に追加します。ファイルを削除して内容を再入力したい場合や、エクスポートしたデータの構造を変更した場合は、タスクを「リセット」する必要があります。

CSVは、AndroidおよびiOSアプリ内で

CSVタスクは、アプリ内ではなくこのWeb上で設定されます。その理由は列のマッピングにあります。選択可能なフィールドが数百もあるため、それらを一つひとつ確認するのはスマートフォンの画面では不向きです。そのため、アプリではその半分しか表示せず、残りの半分についてはこのサイトへ誘導する仕組みになっています。

アプリでは、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」のような形式の場合は、「 ミリ秒単位の時間 」を選択してください。
• 日付データに「 年」、「 月」、「 日」の各列が個別に用意されている場合は、これら3つの列を選択してください。
• 時間が上記のいずれかの形式で指定されていない場合は、「時間形式」を使用して時間を指定することができます。この場合、時間形式は以下のいずれかでなければなりません：
  • 04:13:37 Z PM
  • 04:13:37 PM
  • 04:13 PM
  • 16:13:37 Z
  • 16:13:37
  • 16:13

データのエクスポートには、上記の設定のうち最初の形式を使用します。

日付の形式が上記のいずれにも該当しない場合は、弊社までご連絡ください。

CSV および列挙値

一部のフィールドでは、あらかじめ決められた値のセットの中から1つしか指定できません。これらの値は、以下に示す通り（すべて大文字、指定された箇所にはアンダースコアを使用）と完全に一致している必要があります。FitnessSyncerの他の箇所に表示されている「フレンドリーネーム」とは異なります。 値が完全に一致しない場合、インポート全体が拒否されるのではなく、その行についてはその値が黙ってスキップされます。そのため、フィールドが期待どおりに取り込まれていない場合は、これらの項目を再確認することをお勧めします。

• 生理周期の記録, 流量レベル:
  • NONE (なし)
  • SPOTTING (不正出血)
  • LIGHT (少量)
  • MEDIUM (中量)
  • HEAVY (多量)
• 生理周期の記録, 子宮頸管粘液:
  • DRY (ドライ)
  • STICKY (固定)
  • CREAMY (クリーミー)
  • WATERY (水っぽい)
  • EGG_WHITE (卵白)
• 生理周期の記録, 排卵検査:
  • NEGATIVE (否定)
  • HIGH (高い)
  • PEAK (ピーク)
• 薬剤の投与単位:
  • ML (ML)
  • MG (MG)
  • MGML (MG/ML)
  • MCG (マイクログラム)
  • TABLET (タブレット)