Documentação: formato de inscrições CSV/Excel

Formato de Arquivo CSV/Excel de Inscrições
Além dos formatos padronizados de importação como LENEX (.lef/.lxf) e SDIF (.sd3), você pode importar inscrições para competições de natação e águas abertas utilizando arquivos de texto (.,csv, .txt) ou planilhas Excel (.xlsx).
O formato do arquivo segue uma especificação simples e direta, conforme a especificação original da Swimrankings.net, desenvolvida por Christian Kaufmann. A Sports Timing Brasil adota esse formato por entender que ele oferece uma alternativa ágil, acessível e de fácil manipulação para equipes, treinadores e organizadores que gerenciam inscrições fora dos softwares tradicionais de gestão.
Estrutura Geral do Arquivo
- Linha 1 (Identificação do Evento): Contém as informações da competição: nome do evento, cidade, país, tipo de piscina (comprimento) e data. Todos os campos devem ser separados por ponto e vírgula (
;). - Linha 2 (Cabeçalho das Colunas): Contém os nomes das colunas em letras maiúsculas (UPPERCASE), separados por ponto e vírgula (
;). As colunas podem estar em qualquer ordem. - Linha 3 em diante (Inscrições): Contém as inscrições, sendo uma inscrição por linha.
Colunas Necessárias (Mínimas)
Para uma importação válida, o arquivo precisa conter pelo menos as seguintes colunas:
DISTANCE: A distância da prova em metros (ex:50,100,200,400,800,1500). Para provas de revezamento, é a distância percorrida por um único atleta (ex:100em um revezamento 4x100).STROKE: O estilo da prova. Valores permitidos:FREE(Livre),BACK(Costas),BREAST(Peito),FLY(Borboleta) ouMEDLEY(Medley).ENTRYTIME: O tempo de balizamento/inscrição no formatoMM:SS.ZZouSS.ZZ(ex:1:02.50,54.30ouNTcaso não possua tempo). Atenção: alguns sistemas usam 99:99.99 para sinalizar um atleta sem tempo... nunca faça isso em arquivos importados!!!.GENDER: Gênero do atleta ou, no caso de revezamentos, o gênero da prova. Valores permitidos:M(Masculino),F(Feminino) ouX(Misto).CLUBCODE: O código ou sigla oficial do clube/equipe (ex:ECP,CRF,MTC). Utilize valores oficiais da sua federação.CLUBNAME: Nome completo do clube ou equipe.RELAYCOUNT: Número de atletas da prova. Para inscrições individuais, utilize1. Para revezamentos (ex: 4x100), utilize4.FIRSTNAME: Primeiro nome do atleta (para provas individuais).LASTNAME: Sobrenome do atleta (para provas individuais).FULLNAME: Nome completo do atleta (para provas individuais, feito para países que utilizam apenas o nome completo comumente).BIRTHDATE: Data de nascimento do atleta no formatoDD.MM.YYYYouDD/MM/YYYY. Deixe em branco para revezamentos (veja também a colunaYOB, apenas em casos extremos).LICENSE: Número de licença/registro oficial do atleta na federação. No caso do Brasil, este campo deve ser preenchido exclusivamente com o ID CBDA do atleta. Se não souber, pode deixar em branco.NATION: Nacionalidade do atleta (código ISO de 3 letras, ex:BRA,ARG,SUI), o mesmo utilizado pela World Aquatics (AQUA).
Colunas Opcionais
Você também pode incluir as seguintes colunas opcionais no arquivo para enriquecer os dados ou atender a especificidades da competição:
YOB: Ano de nascimento do atleta com 4 dígitos (ex:2005). Pode ser usado no lugar deBIRTHDATEcaso você não possua a data completa. Nota: Recomendamos fortemente a utilização da data completa (BIRTHDATE), pois o uso do ano isolado converterá a data de nascimento para01/01do ano informado.CLUBNATION: País do clube (código ISO de 3 letras). Se omitido, será considerado por padrão a mesma nacionalidade informada emNATION(registro do atleta).HANDICAP: Classe funcional para atletas paralímpicos (ex:S9,SB8,SM9), utilizada para balizamento e organização por classes adaptadas.EXCEPTION: Código de exceção/restrição funcional para atletas paralímpicos.RELAYNUMBER: Número de identificação da equipe no revezamento. Essencial caso o mesmo clube inscreva mais de uma formação na mesma prova (ex: Equipe A =1, Equipe B =2).
Atletas do Revezamento
Para incluir a escalação dos atletas no revezamento, você pode adicionar colunas com o sufixo <n>, onde <n> é o número do nadador (1 a 4). Exemplo:
FIRSTNAME1,LASTNAME1,GENDER1,BIRTHDATE1(ouYOB1),LICENSE1(1º nadador)FIRSTNAME2,LASTNAME2,GENDER2,BIRTHDATE2(ouYOB2),LICENSE2(2º nadador)- ...e assim por diante até o nadador 4.
Exemplo de Arquivo CSV
Abaixo está um exemplo completo com o cabeçalho da competição, duas inscrições individuais e uma de revezamento:
Troféu Brasil de Natação;Rio de Janeiro;BRA;LCM;15.08.2026
RELAYCOUNT;DISTANCE;STROKE;LASTNAME;FIRSTNAME;GENDER;BIRTHDATE;CLUBCODE;CLUBNAME;NATION;ENTRYTIME;LASTNAME1;FIRSTNAME1;GENDER1;BIRTHDATE1;LASTNAME2;FIRSTNAME2;GENDER2;BIRTHDATE2;LASTNAME3;FIRSTNAME3;GENDER3;BIRTHDATE3;LASTNAME4;FIRSTNAME4;GENDER4;BIRTHDATE4
1;400;FREE;Cordeiro;João Pedro;M;01.01.2000;STB;Sports Timing Brasil;BRA;4:59.99
1;200;MEDLEY;Domingues;Carlos Eduardo;M;01.01.1999;STB;Sports Timing Brasil;BRA;2:01.01
4;100;MEDLEY;;;F;;STB;Sports Timing Brasil;BRA;4:01.02;Cordeiro;João Pedro;M;01.01.2000;Domingues;Carlos Eduardo;M;01.01.1999;Silva;Matheus;M;01.01.2002;Oliveira;Lucas;M;01.01.2001