Konfiguracja Amazon S3, DropBox, Google Drive i OneDrive CSV

Możemy generować pliki rozdzielane przecinkami (CSV) oraz wczytywać je z Amazon S3, DropBox, Google Drive i OneDrive. Jest to prosty sposób na importowanie danych z innych usług lub eksportowanie plików w celu tworzenia kopii zapasowych lub udostępniania ich innym aplikacjom. Aby zapewnić maksymalną elastyczność i obsługę wszystkich usług, konfiguracja jest dość rozbudowana. Oto jak ją skonfigurować:

• Ustaw ścieżkę do pliku, który ma zostać odczytany lub zmodyfikowany. W dowolnym miejscu ścieżki możesz umieścić ciąg znaków „{tasktype}”, a my zastąpimy go rodzajem danych synchronizowanych przez dane zadanie — na przykład ciąg „/exports/{tasktype}.csv” zamieni się w „/exports/Activity.csv” w przypadku zadania typu „Aktywność” oraz w „/exports/Sleep.csv” w przypadku zadania typu „Uśpienie”. Dzięki temu w jednym folderze można przechowywać kilka zadań bez ryzyka ich wzajemnego nadpisania.
• Jeśli przekażesz nam folder zamiast pliku, wykorzystamy zawarty w nim token FitnessSyncer-{tasktype}.csv, na przykład FitnessSyncer-Activity.csv.
• Proszę wskazać separator, którego powinniśmy użyć w tym pliku. Jeśli nie znajdziesz odpowiedniego, skontaktuj się z nami.
• Jeśli plik zawiera bloki komentarzy, wybierz znak prefiksu komentarza. Jeśli nie znajdziesz odpowiedniego znaku, skontaktuj się z nami.
• Jeśli plik zawiera blok tekstu na początku, można zmienić wiersz początkowy na numer wiersza, w którym znajdują się nagłówki.
• Dla każdej kolumny w danych zaznacz pole wyboru po lewej stronie numeru kolumny, a następnie wprowadź indeks numeryczny tej kolumny. Na przykład w komórce Excel, jeśli kolumna to B1, wartość ta wynosiłaby 2.
• W przypadku danych, których nie ma w Twoim zbiorze, możesz wprowadzić wartość zastępczą w kolumnie „Domyślne”.
• Niektóre pliki CSV zawierają codzienne podsumowania danych dotyczących aktywności i w takich przypadkach warto pogrupować je według daty, aby uniknąć zbyt dużej liczby rekordów w ciągu dnia (np. jeden na minutę). W tym celu należy zaznaczyć pole wyboru „Grupuj dane według daty?” (opcja ta jest obecnie dostępna tylko dla aktywności).
• Niektóre pliki CSV zawierają szczegółowe dane dotyczące poszczególnych posiłków i w takich przypadkach warto pogrupować je według daty, aby uniknąć tworzenia wielu krótkich wpisów. W tym celu należy zaznaczyć pole wyboru „Grupuj dane według posiłków?” (opcja ta jest obecnie dostępna wyłącznie dla informacji o wartościach odżywczych).
• Niektóre pliki CSV zawierają nieokreśloną strefę czasową, a w takich przypadkach domyślnie stosowana jest strefa czasowa z Twojego profilu. Jeśli nieokreślona data i godzina są w rzeczywistości podane w czasie UTC, możesz to zmienić, zaznaczając pole wyboru „Wymuś strefę czasową UTC dla nieokreślonych dat?”.

Podczas eksportowania danych opcja „Podsumowanie dzienne z sumami” zapewnia elastyczność w zakresie wiersza podsumowującego. Jeśli opcja ta nie jest zaznaczona, wyświetlane będą dokładnie te same dane, co w polu Stream. Jeśli opcja ta jest zaznaczona, wiersz podsumowania dziennego będzie zawierał łączną liczbę kroków za dany dzień. Jeśli domyślnie nie ma wiersza podsumowującego dla danej daty, zostanie on dodany do zestawu danych.

Aby ułatwić przypisywanie kolumn, możesz kliknąć przycisk „Wybierz kolumny poprzez przesłanie próbki”, co pozwoli Ci przesłać fragment pliku, a następnie w trybie interaktywnym przypisać kolumny i zapisać tę konfigurację. Jest to świetny sposób na upewnienie się, że uwzględniono wszystkie wymagane pola, takie jak data rozpoczęcia.

Wszystkie pozostałe ustawienia są takie same jak w przypadku źródeł lub miejsc docelowych.

Niektóre usługi mogą generować pliki CSV, które reprezentują daną aktywność. Pliki te są obsługiwane, ale aby to skonfigurować, należy skorzystać z opcji „Cloud Files”.

Aby skonfigurować Amazon S3, wpisz swój klucz dostępu w polu „nazwa użytkownika”, klucz tajny w polu „hasło”, a w polu „ścieżka” podaj ścieżkę w formacie: bucket/katalog/plik.

Jeśli pojawi się komunikat o błędzie wskazujący, że w wierszu nie podano daty, czynności lub opisu albo że informacje w wierszu są niekompletne, najprawdopodobniej brakuje wymaganego pola lub nie udało się przetworzyć danych. Zalecamy skorzystanie z naszego narzędzia „Sample Uploader”, które wyświetli listę wymaganych pól dla danego typu danych.

Uwaga: W przypadku zadań docelowych nie przepisujemy pliku, lecz dołączamy do niego informacje, które uznajemy za nowe. Jeśli usuniesz plik i zechcesz go ponownie wypełnić lub zmieniłeś strukturę eksportowanych danych, konieczne będzie zresetowanie zadania.

CSV w aplikacjach Android i iOS

Zadanie CSV konfiguruje się tutaj, w sieci, a nie w aplikacjach. Powodem jest mapowanie kolumn: do wyboru są setki pól, a przeglądanie ich nie jest czymś, co dobrze wychodzi na ekranie telefonu, więc zamiast udostępniać połowę z nich, aplikacje przekierowują użytkownika na tę stronę.

Aplikacje wyświetlają zadanie CSV tak, jak na to zasługuje. Po otwarciu jednej z nich format pliku to CSV – tak samo jak tutaj – a ścieżka, nazwa i harmonogram są tam edytowalne jak zwykle. Aplikacje nie pozwalają jednak na utworzenie nowego zadania CSV, ponieważ źródło CSV bez mapowania kolumn nie może zaimportować żadnych danych.

Gdy potrzebujesz mapowania — lub ustawień dialektu, znaków cudzysłowu i separatora oraz wiersza początkowego — aplikacja otwiera tę stronę w miejscu, w którym przeglądałeś zadanie, loguje się i po zakończeniu przenosi cię z powrotem do aplikacji. Podczas powrotu zadanie jest ponownie odczytywane, więc aplikacja wyświetla dokładnie te zmiany, które wprowadziłeś w przeglądarce.

Jeśli jesteś już zalogowany do FitnessSyncer w przeglądarce na tym urządzeniu, funkcja „hand-off” po prostu wykorzystuje tę sesję.

CSV oraz daty

Wymagamy podania dat dla wszystkich importowanych pozycji.

• Wybierz opcję „Data (USA)”, jeśli data ma jeden z poniższych formatów:
  • 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
• Wybierz opcję „Data (poza USA)”, jeśli data ma jeden z poniższych formatów:
  • 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
• Wybierz opcję „Czas w sekundach”, jeśli Twoje dane mają postać „1564244017”.
• Wybierz opcję „Czas w milisekundach”, jeśli Twoje dane mają postać „1564244017000”.
• Jeśli w Twoim pliku z danymi znajdują się osobne kolumny o nazwach „Rok”, „Miesiąc” i „Dzień”, wybierz te trzy kolumny.
• Jeśli godzina nie jest podana w jednym z powyższych formatów, można ją podać, korzystając z formatu czasu, który musi być jednym z poniższych:
  • 04:13:37 Z PM
  • 04:13:37 PM
  • 04:13 PM
  • 16:13:37 Z
  • 16:13:37
  • 16:13

Do eksportu danych wykorzystamy pierwszy format spośród powyższych konfiguracji.

Jeśli format daty nie odpowiada żadnemu z powyższych, prosimy o kontakt.

CSV oraz wartości wyliczeniowe

Niektóre pola akceptują tylko jedną z wartości z ustalonego zestawu. Muszą one dokładnie odpowiadać podanym poniżej — wyłącznie wielkimi literami, z podkreśleniami tam, gdzie to wskazano — a nie nazwą opisową wyświetlaną w innym miejscu w FitnessSyncer. Wartość, która nie jest dokładnie zgodna, jest po cichu pomijana w danym wierszu, zamiast odrzucać cały import, dlatego warto je dokładnie sprawdzić, jeśli dane w polu nie pojawiają się zgodnie z oczekiwaniami.

• Śledzenie cyklu, Poziom przepływu:
  • NONE (Brak)
  • SPOTTING (Plamienie)
  • LIGHT (Skąpe)
  • MEDIUM (Umiarkowane)
  • HEAVY (Obfite)
• Śledzenie cyklu, Śluz szyjki macicy:
  • DRY (Suchy)
  • STICKY (Przyklejone)
  • CREAMY (Kremowy)
  • WATERY (Wodnisty)
  • EGG_WHITE (Białko jajka)
• Śledzenie cyklu, Test owulacyjny:
  • NEGATIVE (Negatywny)
  • HIGH (Wysoki)
  • PEAK (Szczyt)
• Jednostka dawki leku:
  • ML (ML)
  • MG (MG)
  • MGML (MG/ML)
  • MCG (Mikrogram)
  • TABLET (Tablet)