Divulgação de Resultado das Eleições Instruções para download dos arquivos da Divulgação de resultado das Eleições 2016

Transcrição

1 Instruções para download dos arquivos da Divulgação de resultado das Eleições

2 Sumário 1. Apresentação Métodos de download dos arquivos Organização dos arquivos e pastas Procedimento para Download Padronização dos nomes dos arquivos

3 Divulgação dos Resultados das Eleições 2016 Instruções para download dos arquivos 1. Apresentação O acordo de parceria entre a Justiça Eleitoral e as empresas de comunicação é regido pela Resolução nº /TSE, e tem a função de dar transparência e agilidade a divulgação dos resultados eleitorais, coletados a partir do pleito. Em resumo, o acordo permite às empresas receberem os resultados, assim que computados pela Justiça Eleitoral, e as compromete difundir essas informações para a sociedade. Este guia visa instruir as empresas parceiras sobre as regras para baixar arquivos do Data Center através de aplicações próprias, para que não haja queda de performance e indisponibilidade no atendimento feito pelos servidores de aplicação disponíveis no TSE. 2. Métodos de download dos arquivos Para realização do download dos arquivos, deve-se utilizar o método: Desenvolvimento de solução própria; A solução própria deve ser desenvolvida obedecendo às regras definidas ao longo desse documento. 3

4 3. Organização dos arquivos e pastas Os arquivos com os resultados das eleições obedecem a uma nomenclatura específica e estão organizados em pastas dentro do servidor HTTP (Data Center do TSE). Abaixo está representada a estrutura de pastas do servidor. A raiz dessa estrutura é o próprio o servidor HTTP do TSE, aqui identificado por ID da Nome da Pasta pasta 1 [ano] 2 divulgacao" 3 [ambiente] 4 [eleicao] 5 config 6 { br" [uf]} 7 distribuicao 8 { br" [uf]} 9 comum 10 divulgacao" 11 [ambiente] 12 config Abaixo está a descrição de cada uma das pastas. ID da Nome da pasta Descrição da pasta pasta 1 [ano] O nome dessa pasta é um número de 4 dígitos indicando o ano em que a eleição ocorre. Todos os arquivos abaixo dessa pasta são referentes a eleições que ocorrem no mesmo ano. Para as eleições gerais de 2016, essa pasta terá o nome divulgacao" Pasta com o objetivo meramente de organizar os arquivos da divulgação sob a mesma estrutura, evitando que se misturem com arquivos de outros sistemas, caso compartilhem o mesmo repositório. 3 [ambiente] O nome dessa pasta é o nome do ambiente ao qual os arquivos pertencem. Por ambiente entende-se o contexto a que pertencem os dados dos arquivos da divulgação. Por exemplo, se os dados foram gerados em ambiente oficial, então o nome dessa pasta será oficial, bem como os dados dos arquivos serão dados oficiais. Porém, se os dados forem referentes a um simulado, essa pasta poderá se chamar simulado e todos os arquivos abaixo dessa pasta conteriam dados de simulado. O nome dessa pasta para os testes será divulgado oportunamente. 4 [eleicao] O nome dessa pasta é um número que identifica unicamente uma determinada eleição. Todos os arquivos constantes nessa pasta e suas subpastas devem pertencer à eleição identificada pelo número que dá nome à pasta, de forma que arquivos de eleições distintas não se misturem. O número das eleições será divulgado oportunamente. Entretanto, vale ressaltar que haverá um número para a eleição de 1º turno e 4

5 outro número para a eleição de 2º turno. Caso haja algum plebiscito ou referendo, estes terão números distintos aos da eleição geral. 5 config Essa pasta contém uma subpasta para cada abrangência, onde há arquivos de configuração. Uma abrangência pode ser uma UF, ou Brasil. 6 { br" [uf]} O nome dessa pasta é a sigla da Unidade da Federação uf em minúsculo, ou a sigla br" em minúsculo. Trata-se de uma pasta folha, ou seja, não há subpastas abaixo dela. Os arquivos estarão diretamente armazenados nessa pasta. Contém os arquivos configuração de municípios, de índice e de certificado referentes à abrangência, eleição e ambiente conforme estrutura das pastas superiores. 7 distribuicao" Essa pasta contém uma subpasta para cada abrangência de onde há arquivos de resultado. Uma abrangência pode ser uma UF, ou Brasil. 8 { br" [uf]} O nome dessa pasta é a sigla da Unidade da Federação uf em minúsculo, ou a sigla br" em minúsculo. Trata-se de uma pasta folha, ou seja, não há subpastas abaixo dela. Os arquivos estarão diretamente armazenados nessa pasta. Contém os arquivos de resultado referentes à abrangência, eleição e ambiente conforme estrutura das pastas superiores. 9 comum Os arquivos abaixo dessa pasta são referentes a todas as eleições disponíveis para divulgação. 10 divulgacao Tem a mesma funcionalidade da pasta já especificada anteriormente no item [ambiente] Tem a mesma funcionalidade da pasta já especificada anteriormente no item config Trata-se de uma pasta folha, ou seja, não há subpastas abaixo dela. Os arquivos estarão diretamente armazenados nessa pasta. Contém os arquivos configuração de eleições. 5

6 Como é possível observar, nem todas as pastas possuem arquivos diretamente abaixo delas. A maioria é utilizada para organizar a estrutura. As pastas que possuem arquivos estão detalhadas abaixo: ID da Nome da Pasta Pasta 6 { br" [uf]} Arquivos contidos na Pasta <br uf>-e<eleica>-a.cer <br uf>-e<eleica>-m.zip Certificado digital utilizado para validação da assinatura dos arquivos gerados para uma eleição. Arquivo de configuração de municípios. Ver documento EA07 - Arquivo de configuração de municípios para mais detalhes. <br uf>-e<eleica>-i.xml 8 { br" [uf]} br-c<cccc>-e<eleica>- <VER>-f.zip br-e<eleica>-<ver>-f.zip Arquivo de índice. Ver documento EA09 - Arquivo de índice para mais detalhes. Arquivo BR. Arquivo BR Acompanhamento. Arquivo Município. <uf>-e<eleica>-<ver>-f.zip <uf><munic>-c<cccc>e<eleica>-<ver>-f.zip <uf>-c<cccc>-e<eleica>- <VER>-f.zip br-c<cccc>-e<eleica>-v.zip br-e<eleica>-v.zip <uf><munic>-c<cccc>e<eleica>-v.zip <uf>-e<eleica>-v.zip <uf>-c<cccc>-e<eleica>v.zip <br uf>-c<cccc>-e<eleica>e.zip Arquivo UF Acompanhamento. Arquivo UF. Ver documento EA01 - Arquivo de resultado de dados fixos para mais detalhes. Arquivo BR. Arquivo BR Acompanhamento. Arquivo Município. Arquivo UF Acompanhamento. Arquivo UF. Ver documento EA02 - Arquivo de resultado de dados variáveis para mais detalhes. Arquivo Eleitos UF ou BR. Ver documento EA10 - Arquivo de resultado de eleitos para mais detalhes. 12 config <br uf>-c.zip Arquivo de configuração de eleições. Ver documento EA05 - Arquivo de configuração de eleições para mais detalhes. 6

7 4. Procedimento para Download O processo utilizado para baixar os arquivos de dados da Divulgação deve seguir as seguintes etapas: I) Conectar ao servidor HTTP (Data Center do TSE), onde estão os arquivos de resultado das eleições; II) Baixar o arquivo de índice correspondente à(s) UF(s) e Eleição (ões) em que se tem interesse. Note que há um arquivo de índice por Eleição e por UF. Dessa forma, para a eleição de primeiro turno, haverá 27 arquivos de índice, um por UF mais o arquivo de índice Brasil. III) Para cada arquivo de índice, abri-lo e ler a informação do nome do arquivo que se quer baixar e a data e hora da última atualização do arquivo. IV) Para cada entrada do arquivo de índice, verificar se a data constante no arquivo é diferente da data do último arquivo baixado. V) Se a data for diferente, baixar o arquivo e atualizar a data do arquivo recém baixado. Recomendase usar algum sistema de armazenamento para guardar as datas de atualização dos arquivos baixados. A data de atualização do arquivo no sistema operacional não poderá ser utilizada para esse fim. VI) Todo o procedimento deve ser executado repetidamente a cada intervalo de tempo. Recomendase que esse intervalo não seja inferior a 60 segundos, evitando onerar o servidor HTTP. 7

8 Abaixo segue um esquema detalhando o processo descrito anteriormente. TSE Parceiro Índice Baixar os arquivos de índice Índice Arquivo Data X 17:20 Y 17:10 Z 17:25 Arquivo Data X 17:20 Y 17:10 Z 17:25 Registro Parceiro Atualizar o registro da data de atualização do arquivo Comparar a data no índice com a data local X e Z estão desatualizados Arquivo Data X 17:05 Y 17:10 Z 17:15 Baixar os arquivos cujas datas estejam diferentes Registro Parceiro TSE Parceiro Arq. X Arq. Z 8

9 5. Padronização dos nomes dos arquivos O nome dos arquivos envolvidos no processo de divulgação dos resultados segue um padrão prédeterminado. Esse padrão descreve que o nome de um arquivo é composto por uma ou mais variáveis separadas por um traço. Por exemplo, o arquivo variável de acompanhamento do Estado de São Paulo tem o seguinte nome: sp-e v.zip. Note que temos 3 variáveis: sp (identificador da UF), e (identificador da eleição), v (identificador de arquivo variável). Para mais detalhes sobre a nomenclatura de cada arquivo, recomenda-se a leitura da respectiva especificação. Entretanto, faz-se necessário o esclarecimento inicial de algumas variáveis. Variável Descrição <UF> Sigla da Unidade da Federação a que ser refere o arquivo. São sempre duas letras em minúsculo. Exemplo: ac, am, df, mg, sp, to. <MUNIC> Código numérico do município a que se refere o arquivo. Quando presente, esse código sempre vem antecedido da variável <UF>, sem traço. Trata-se de um número de 5 dígitos, preenchido com zeros à esquerda, em conformidade com a base de dados de municípios da Justiça Eleitoral. Para se conhecer o código de cada município, consultar o arquivo <uf>-e<eleica>-m.zip. Exemplos: am02550 : município Manaus/AM ba38490 : município Salvador/BA rj60011 : município Rio de Janeiro/RJ <CCCC> Código numérico de 4 dígitos, preenchido com zeros à esquerda, do cargo a que ser refere o arquivo. Segue o código de cada cargo: Presidente: 0001 Governador: 0003 Senador: 0005 Deputado Federal: 0006 Deputado Estadual: 0007 Deputado Distrital: 0008 Prefeito: 0011 Vereador: 0013 <ELEICA> Trata-se de um número de 6 dígitos, preenchidos com zeros à esquerda, composto pelo código da eleição. Como foi explanado anteriormente, cada eleição possui um número que a identifica univocamente. Exemplo: Para uma eleição com código 1234 : sp-e v.zip 9