Конфигурация Amazon S3, DropBox, Google Drive и OneDrive CSV

Мы можем создавать файлы с разделителем-запятой (CSV) и считывать их из Amazon S3, DropBox, Google Drive и OneDrive. Это простой способ импорта данных из других сервисов или экспорта файлов для резервного копирования либо обмена с другими приложениями. Для обеспечения максимальной гибкости и поддержки всех сервисов набор настроек весьма обширен. Вот как его настроить:

• Укажите путь к файлу, который мы должны прочитать или изменить. Вы можете включить {tasktype} в любом месте пути, и мы заменим его типом данных, которые синхронизирует данное задание — так, например, /exports/{tasktype}.csv станет /exports/Activity.csv для задания «Активность» и /exports/Sleep.csv для задания «Сон». Это позволяет хранить в одной папке несколько заданий, не перезаписывая их друг другом.
• Если вы предоставите нам папку, а не файл, мы будем использовать значение FitnessSyncer-{tasktype}.csv, находящееся внутри неё, например, FitnessSyncer-Activity.csv.
• Укажите разделитель, который следует использовать для данного файла. Если вы не нашли нужный разделитель, свяжитесь с нами.
• Если ваш файл содержит блоки комментариев, выберите символ-префикс комментария. Если вы не нашли нужный символ, свяжитесь с нами.
• Если в вашем файле в верхней части находится блок текста, вы можете изменить начальную строку на номер строки, в которой расположены заголовки.
• Для каждого столбца в ваших данных установите флажок слева от поля «Номер столбца», а затем введите числовой индекс столбца. Например, в ячейке Excel для столбца B1 это значение будет равно 2.
• Для любых данных, которых нет в вашем наборе данных, вы можете ввести значение переопределения в столбце «По умолчанию».
• Некоторые файлы CSV представляют собой ежедневные сводки данных об активности, и в таких случаях вам может потребоваться сгруппировать их по дате, чтобы избежать появления большого количества записей за день (например, по одной в минуту). Для этого установите флажок «Группировать данные по дате?» (в настоящее время эта функция доступна только для данных о физической активности).
• Некоторые файлы CSV содержат подробные данные по каждому приёму пищи, и в таких случаях вы, возможно, захотите сгруппировать их по дате, чтобы избежать появления большого количества мелких записей. Для этого установите флажок «Группировать данные по приёмам пищи?» (в настоящее время эта функция доступна только для информации о питании).
• Некоторые файлы CSV содержат неуказанный часовой пояс, и в таких случаях по умолчанию используется часовой пояс, указанный в вашем профиле. Если дата и время без указания часового пояса на самом деле приведены в формате UTC, вы можете переопределить это значение с помощью флажка «Принудительно использовать часовой пояс UTC для дат без указания часового пояса?».

При экспорте данных параметр «Ежедневная сводка с итоговыми показателями» обеспечивает гибкость настройки сводной строки. Если этот параметр не отмечен, будут отображаться точные данные, указанные в ячейке Stream. Если этот параметр отмечен, строка ежедневной сводки будет содержать общее количество шагов за день. Если по умолчанию для данной даты строка сводки отсутствует, она будет добавлена в ваш набор данных.

Чтобы упростить сопоставление столбцов, вы можете нажать кнопку «Выбрать столбцы путем загрузки образца», что позволит вам загрузить образец файла, а затем в интерактивном режиме сопоставить столбцы и сохранить эту конфигурацию. Это отличный способ убедиться, что у вас есть все необходимые поля, такие как дата начала.

Все остальные настройки аналогичны настройкам «Источников» или «Пунктив назначения».

Некоторые сервисы могут создавать файлы CSV, представляющие какое-либо действие. Такие файлы поддерживаются, однако для настройки этой функции необходимо использовать опцию «Cloud Files».

Чтобы настроить Amazon S3, введите ключ доступа в поле «Имя пользователя», секретный ключ — в поле «Пароль», а в качестве пути укажите «бакет/каталог/файл».

Если вы получаете сообщение об ошибке, указывающее, что в строке отсутствует дата, действие или описание либо что информации для данной строки недостаточно, скорее всего, вы пропустили обязательное поле или его не удалось обработать. Мы рекомендуем воспользоваться нашим инструментом «Sample Uploader», в котором приведен список обязательных полей для данного типа данных.

Примечание: при выполнении задач назначения мы не перезаписываем файл, а добавляем к нему данные, которые, по нашему мнению, представляют собой новую информацию. Если вы удалили файл и хотите заново заполнить его или изменили структуру экспортируемых данных, вам необходимо сбросить задачу.

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 (Планшет)