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

Podemos criar um ficheiro separado por vírgulas (CSV) e lê-los a partir de Amazon S3, DropBox, Google Drive e OneDrive. Esta é uma forma simples de importar dados de outros serviços ou de exportar ficheiros para cópias de segurança ou para partilha com outras aplicações. Para permitir a máxima flexibilidade e compatibilidade com todos os serviços, a configuração é bastante abrangente. Eis como deve configurá-la:

• Defina o caminho para o ficheiro que pretende que leiamos ou modifiquemos. Pode incluir «{tasktype}» em qualquer parte do caminho, e iremos substituí-lo pelo tipo de dados que a tarefa sincroniza — assim, «/exports/{tasktype}.csv» passa a ser «/exports/Activity.csv» numa tarefa de «Atividade» e «/exports/Sleep.csv» numa tarefa de «Repouso». Isto permite que uma pasta contenha várias tarefas sem que estas se sobrescrevam mutuamente.
• Se nos fornecer uma pasta em vez de um ficheiro, utilizaremos o FitnessSyncer-{tasktype}.csv dentro dela, por exemplo, FitnessSyncer-Activity.csv.
• Indique o separador que devemos utilizar para o ficheiro. Caso não encontre o que necessita, contacte-nos.
• Se o seu ficheiro contiver blocos de comentários, selecione o carácter de prefixo de comentário. Caso não encontre o que necessita, contacte-nos.
• Se o seu ficheiro contiver um bloco de texto na parte superior, pode alterar a linha inicial para o número da linha em que se encontram os cabeçalhos.
• Para cada coluna dos seus dados, assinale a caixa de seleção à esquerda do «Número da coluna» e, em seguida, introduza o índice numérico da coluna. Por exemplo, em Excel, se a coluna for B1, este valor seria 2.
• No caso de quaisquer dados que não constem nos seus registos, pode introduzir um valor de substituição na coluna «Padrão».
• Alguns ficheiros CSV são resumos diários de dados de atividade e, nesses casos, poderá querer agrupá-los por data, para que não tenha muitos registos por dia (por exemplo, um por minuto). Para tal, assinale a caixa de seleção «Agrupar dados por data?» (esta opção está atualmente disponível apenas para as Atividades).
• Alguns ficheiros CSV contêm dados detalhados por refeição e, nesses casos, poderá querer agrupá-los por data, para não ficar com muitos registos pequenos. Para tal, assinale a caixa de seleção «Agrupar dados por refeição?» (esta opção está, de momento, disponível apenas para a Informação Nutricional).
• Alguns ficheiros CSV incluem um fuso horário não especificado e, nesses casos, utilizamos por predefinição o fuso horário do seu Perfil. Se a data e a hora não especificadas estiverem, na realidade, em UTC, pode substituir essa configuração através da caixa de seleção «Forçar o fuso horário UTC para datas não especificadas?».

Ao exportar os seus dados, a opção «Resumo diário com contagens totais» oferece-lhe flexibilidade na sua linha de resumo. Se não estiver marcada, serão apresentados os dados exatos tal como constam na sua Stream. Se esta opção estiver marcada, a linha de resumo diário conterá o total de passos do dia. Se, por predefinição, não existir uma linha de resumo para essa data, será adicionada uma ao seu conjunto de dados.

Para facilitar o mapeamento das colunas, pode selecionar o botão «Escolher colunas através do envio de uma amostra», o que lhe permitirá enviar uma amostra do ficheiro, mapear as colunas de forma interativa e guardar essa configuração. Esta é uma excelente forma de garantir que dispõe de todos os campos obrigatórios, tais como a data de início.

Todas as restantes definições são idênticas às das «Fontes» ou «Destinos».

Alguns serviços podem produzir ficheiros CSV que representam uma atividade. Esses ficheiros são suportados, mas deverá utilizar a opção «Cloud Files» para configurar esta funcionalidade.

Para configurar o Amazon S3, introduza a sua Chave de Acesso no campo «Nome de utilizador», a sua Chave Secreta no campo «Palavra-passe» e, no campo «Caminho», utilize «bucket/directory/file».

Se receber uma mensagem de erro a indicar 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 a faltar um campo obrigatório ou que não tenha sido possível analisar os dados. Recomendamos que utilize o nosso «Sample Uploader», que irá apresentar os campos obrigatórios para esse tipo de dados.

Nota: No caso das tarefas de destino, não reescrevemos o ficheiro, mas sim acrescentamos ao ficheiro aquilo que consideramos ser a nova informação. Se eliminar o ficheiro e pretender preenchê-lo novamente, ou se tiver alterado a estrutura dos seus dados exportados, terá de reiniciar a tarefa.

CSV nas aplicações Android e iOS

Uma tarefa CSV é configurada aqui na Web, em vez de nas aplicações. A razão prende-se com o mapeamento das colunas: existem centenas de campos à escolha, e a sua seleção não é algo que o ecrã de um telemóvel consiga fazer bem; por isso, em vez de apresentarem apenas metade deles, as aplicações redirecionam-no para este site.

As aplicações apresentam uma tarefa CSV tal como ela é. Ao abrir uma delas, o formato do ficheiro indica CSV, tal como aqui, e o caminho, o nome e a programação são todos editáveis, como habitualmente. O que as aplicações não fazem é criar uma nova tarefa CSV, porque uma fonte CSV sem um mapeamento de colunas não consegue importar nada.

Quando necessitar da correspondência — ou das definições de dialecto, das aspas, do separador e da linha inicial —, a aplicação abre este site na tarefa que estava a visualizar, com a sua sessão iniciada, e volta a redirecioná-lo para a aplicação quando terminar. A tarefa é relida no caminho de volta, pelo que tudo o que tiver alterado na Web é o que a aplicação apresenta.

Se já tiver iniciado sessão no FitnessSyncer no navegador desse dispositivo, a transferência de sessão limita-se a utilizar essa sessão.

CSV e datas

Solicitamos que nos sejam indicadas as datas relativas a todos os artigos a importar.

• Escolha «Data (EUA)» se a sua data tiver um dos seguintes formatos:
  • 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 tiver um dos seguintes formatos:
  • 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 os seus dados se assemelharem a «1564244017».
• Escolha «Tempo em milissegundos» se os seus dados se assemelharem a «1564244017000».
• Se o seu conjunto de dados tiver colunas próprias para Ano, Mês e Dia, selecione essas três colunas.
• Caso a hora não seja especificada num dos formatos acima referidos, pode 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 referidas.

Se o seu formato de data não corresponder a nenhum dos acima indicados, por favor, contacte-nos.

CSV e valores enumerados

Alguns campos aceitam apenas um valor de um conjunto fixo de valores. Estes devem corresponder exatamente como se mostra abaixo — em maiúsculas, com sublinhados onde indicado — e não ao nome descritivo que apresentamos noutras partes do FitnessSyncer. Um valor que não corresponda exatamente é ignorado silenciosamente nessa linha, em vez de rejeitar toda a importação; por isso, vale a pena verificar estes valores com atenção caso um campo não esteja a ser importado conforme o esperado.

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