Configuração de Amazon S3, DropBox, Google Drive e OneDrive CSV

Podemos gerar um arquivo separado por vírgulas (CSV) e importá-lo a partir de Amazon S3, DropBox, Google Drive e OneDrive. Essa é uma maneira simples de importar dados de outros serviços ou de exportar arquivos para backups ou compartilhamento com outros aplicativos. Para permitir o máximo de flexibilidade e compatibilidade com todos os serviços, a configuração é bastante abrangente. Veja a seguir como configurá-la:

• Defina o caminho para o arquivo que deseja que leiamos ou modifiquemos. Você pode incluir {tasktype} em qualquer parte do caminho, e nós o substituiremos pelo tipo de dados que a tarefa sincroniza — assim, /exports/{tasktype}.csv se torna /exports/Activity.csv em uma tarefa de Atividade e /exports/Sleep.csv em uma tarefa de Repouso. Isso permite que uma pasta contenha várias tarefas sem que elas se sobrescrevam mutuamente.
• Caso nos forneça uma pasta em vez de um arquivo, utilizaremos o FitnessSyncer-{tasktype}.csv contido nela; por exemplo, FitnessSyncer-Activity.csv.
• Indique o separador que devemos usar para o arquivo. Caso não encontre o que precisa, entre em contato conosco.
• Caso seu arquivo contenha blocos de comentários, selecione o caractere de prefixo de comentário. Caso não encontre o que precisa, entre em contato conosco.
• Se o seu arquivo contiver um bloco de texto na parte superior, você poderá alterar a linha inicial para o número da linha em que os cabeçalhos estão localizados.
• Para cada coluna dos seus dados, marque a caixa de seleção à esquerda do “Número da coluna” e, em seguida, insira o índice numérico da coluna. Por exemplo, em Excel, se a coluna for B1, esse valor seria 2.
• Para quaisquer dados que não constem em seu conjunto de dados, o senhor pode inserir um valor de substituição na coluna “Padrão”.
• Alguns arquivos CSV são resumos diários de dados de atividade e, nesses casos, talvez seja conveniente agrupá-los por data, para que não haja um grande número de registros por dia (como, por exemplo, um por minuto). Para isso, marque a caixa de seleção “Agrupar dados por data?” (atualmente, essa opção está disponível apenas para Atividades).
• Alguns arquivos CSV contêm dados detalhados por refeição e, nesses casos, talvez seja conveniente agrupá-los por data, para evitar uma grande quantidade de registros pequenos. Para isso, marque a caixa de seleção “Agrupar dados por refeição?” (atualmente, essa opção está disponível apenas para Informações Nutricionais).
• Alguns arquivos CSV vêm com um fuso horário não especificado e, nesses casos, utilizamos por padrão o fuso horário do seu Perfil. Se a data e a hora não especificadas estiverem, na verdade, em UTC, você poderá substituir essa configuração por meio da caixa de seleção “Forçar o fuso horário UTC para datas não especificadas?”.

Ao exportar seus dados, a opção “Resumo diário com contagens totais” oferece flexibilidade na sua linha de resumo. Quando desmarcada, ela exibirá os dados exatos, conforme mostrados em Stream. Se essa opção estiver marcada, a linha de resumo diário conterá o total de passos do dia. Caso não haja uma linha de resumo por padrão para essa data, uma será adicionada ao seu conjunto de dados.

Para facilitar o mapeamento das colunas, o(a) senhor(a) pode selecionar o botão “Escolher colunas fazendo upload de uma amostra”, o que permitirá que o(a) senhor(a) faça o upload de uma parte do arquivo como amostra, mapeie as colunas de forma interativa e salve essa configuração. Essa é uma ótima maneira de garantir que o(a) senhor(a) tenha todos os campos obrigatórios, como a data de início.

Todas as demais configurações são idênticas às das Origens ou Destinos.

Alguns serviços podem gerar arquivos CSV que representam uma atividade. Esses arquivos são compatíveis, mas é necessário utilizar a opção “Cloud Files” para configurar isso.

Para configurar Amazon S3, insira sua Chave de Acesso no campo “nome de usuário”, sua Chave Secreta no campo “senha” e, no campo “caminho”, utilize bucket/diretório/arquivo.

Caso receba uma mensagem de erro indicando que uma linha não possui uma data, uma atividade ou uma descrição, ou que não há informações suficientes para essa linha, é muito provável que esteja faltando um campo obrigatório ou que o dado não tenha podido ser analisado. Recomendamos utilizar nosso “Sample Uploader”, que listará os campos obrigatórios para esse tipo de dado.

Observação: Para tarefas de destino, não reescrevemos o arquivo, mas sim acrescentamos ao final do arquivo o que consideramos ser as novas informações. Caso você exclua o arquivo e deseje preenchê-lo novamente, ou caso tenha alterado a estrutura dos dados exportados, será necessário reiniciar a tarefa.

CSV nos aplicativos Android e iOS

Uma tarefa CSV é configurada aqui na web, e não nos aplicativos. O motivo está no mapeamento de colunas: há centenas de campos à escolha, e selecioná-los não é algo que a tela de um celular faça bem; portanto, em vez de oferecer apenas metade deles, os aplicativos redirecionam você para este site.

Os aplicativos exibem uma tarefa CSV exatamente como ela é. Ao abrir um deles, o formato do arquivo aparece como CSV, da mesma forma que aqui, e o caminho, o nome e a programação podem ser editados normalmente. O que os aplicativos não fazem é criar uma nova tarefa CSV, pois uma fonte CSV sem mapeamento de colunas não pode importar nada.

Quando o senhor precisar da correspondência — ou das configurações de dialeto, das aspas, do separador e da linha inicial —, o aplicativo abre este site na tarefa que o senhor estava visualizando, com a sessão iniciada, e o leva de volta ao aplicativo quando o senhor terminar. A tarefa é relida no caminho de volta; portanto, tudo o que o senhor alterou na web é o que o aplicativo exibe.

Caso já esteja conectado ao FitnessSyncer no navegador desse dispositivo, a transferência simplesmente utiliza essa sessão.

CSV e datas

Precisamos das datas de todos os itens que estão sendo importados.

• Escolha “Data (EUA)” se a sua data se parecer com uma destas:
  • 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
• Escolha “Data (fora dos EUA)” se a sua data se parecer com uma destas:
  • 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
• Escolha “Tempo em segundos” se seus dados se parecerem com “1564244017”.
• Escolha “Tempo em milissegundos” se seus dados se parecerem com “1564244017000”.
• Caso seu arquivo de dados possua colunas específicas para Ano, Mês e Dia, selecione essas três colunas.
• Caso a hora não seja especificada em um dos formatos acima, é possível incluí-la utilizando o Formato de Hora, que deve ser um dos seguintes:
  • 04:13:37 Z PM
  • 04:13:37 PM
  • 04:13 PM
  • 16:13:37 Z
  • 16:13:37
  • 16:13

Para a exportação de dados, utilizaremos o primeiro formato das configurações acima.

Caso o seu formato de data não corresponda a um dos formatos acima, entre em contato conosco.

CSV e valores enumerados

Alguns campos aceitam apenas um valor de um conjunto fixo de valores. Esses valores devem corresponder exatamente como mostrado abaixo — todas em letras maiúsculas, com sublinhados onde indicado — e não ao nome descritivo que exibimos em outras partes do FitnessSyncer. Um valor que não corresponda exatamente é ignorado silenciosamente para essa linha, em vez de rejeitar toda a importação; portanto, vale a pena verificar esses valores novamente caso um campo não esteja sendo importado conforme o esperado.

• Acompanhamento do ciclo menstrual, Nível de fluxo:
  • NONE (Nenhum)
  • SPOTTING (Sangramento intermenstrual)
  • LIGHT (Leve)
  • MEDIUM (Médio)
  • HEAVY (Intenso)
• Acompanhamento do ciclo menstrual, Muco cervical:
  • DRY (Seco)
  • STICKY (Pegajoso)
  • CREAMY (Cremoso)
  • WATERY (Aguado)
  • EGG_WHITE (Clara de ovo)
• Acompanhamento do ciclo menstrual, Teste de ovulação:
  • NEGATIVE (Negativo)
  • HIGH (Alto)
  • PEAK (Pico)
• Unidade de dosagem do medicamento:
  • ML (ML)
  • MG (MG)
  • MGML (MG/ML)
  • MCG (Micrograma)
  • TABLET (Tablet)