EuroBillTracker

Code: Select all

CP3  633
CP4  225 (ou 255)
CP7 1477

Code: Select all

CP3  604
CP4  230
CP7 1271

Code: Select all

########################################################################
# Validação da informação da nota, na nacionalidade e do código postal #
########################################################################
# A validação do código postal, bem como as acções a tomar em função 
# do resultado obtido, é efectuada numa série de etapas sucessivas,
# como se descreve de seguida.
#
# Se faltar algum dos parâmetros da nota necessários à execução do 
# programa, interrompe-se a execução e alerta-se para a possibilidade 
# de se estar a usar um ficheiro de notas censurado ou de o ficheiro
# ter sido alterado após ter sido descarregado do site do EBT. 
# 
# Verifica-se a existência de informação nas seguintes colunas de 
# cada linha do ficheiro:
#  - valor, nserie, data_hora, pais, cpostal, ccurto, ebt_id
########################################################################
# Começa-se por verificar se a nota é portuguesa, caso em que o campo 
# do país deverá conter 'Portugal'.  Não é necessário considerar as
# variações do nome de Portugal, porque o ficheiro csv contém sempre 
# a versão inglesa e o nome do país é controlado no momento do registo. 
#
# Sendo uma nota portuguesa passa-se à validação do código postal, 
# começando-se por retirar todos os espaços em branco, tabs e 
# caracteres equivalentes do final do código postal.
# 
# TESTE: CP7 + designação postal
# Primeiro procura-se um CP7 com algum texto adicional, que pode ser a 
# designação postal ou algum texto inserido por engano no campo do 
# código postal, ao registar a nota.  Para que esta possibilidade seja
# validada o código postal terá de ter o seguinte formato:
#  - quatro algarismos iniciais, não começados por 0, correspondentes 
#    ao CP4 (aceita-se qualquer combinação)
#  - qualquer combinação dos seguintes separadores: '-', '–', '—', '_', 
#    espaço, tab, '.', '+', ':', '/'
#  - três algarismos, correspondentes ao CP3 (qualquer combinação)
#  - poderá ter ou não qualquer combinação dos separadores anteriores, 
#    seguidos ou não de um texto arbitrário sem algarismos; a não 
#    existência de algarismos após os separadores é importante, para 
#    que códigos postais do tipo '9234.5679Coimbra', rejeitados por 
#    este teste, não sejam validados posteriormente pelo teste de 
#    CP4 (9234) com designação postal (.5679Coimbra).
# Em caso de validação aceita-se o CP3, o CP4 e o CP7.  Se o separador 
# entre o CP4 e o CP3 não for apenas o sinal de subtracção gera uma 
# mensagem de erro 'CP7_Separador'.  Se houver qualquer tipo de 
# separador ou de texto após o CP7 gera mensagem de erro 'CP7_Texto'. 
#
# TESTE: CP4 + designação postal
# Se o código postal não for validado no teste anterior procura-se 
# agora um CP4 com algum texto adicional, que pode ser a designação 
# postal ou algum texto inserido por engano no campo do código postal, 
# ao registar a nota.  Para que esta possibilidade seja validada o 
# código postal terá de ter o seguinte formato:
#  - quatro algarismos iniciais, não começados por 0, correspondentes 
#    ao CP4 (aceita-se qualquer combinação)
#  - poderá ter ou não qualquer combinação dos seguintes separadores 
#    ('-', '–', '—', '_', espaço, tab, '.', '+', ':', '/'), seguidos 
#    ou não de um texto arbitrário sem algarismos; a não existência 
#    de algarismos após os separadores é importante, para que códigos 
#    postais do tipo '9234.5679Coimbra', rejeitados pelo teste anterior,
#    não sejam agora validados como um CP4 (9234) com designação postal 
#    ou texto adicional (.5679Coimbra).
# Em caso de validação aceita-se o CP4.  Se houver qualquer tipo de 
# separador ou de texto após o CP4 gera mensagem de erro 'CP4_Texto'.
#
# Se o código postal não for validado em nenhum dos testes anteriores, 
# considera-se que não contém um código postal válido.  Neste caso é 
# apenas gerada uma mensagem de erro 'CP_Invalido'.
########################################################################
# Mensagens de erro geradas durante a leitura do ficheiro csv:
# CSV_Leitura   : interrompe a leitura do ficheiro e avisa que se está 
#                 a usar um ficheiro de notas censurado, ou que o mesmo 
#                 foi alterado depois de ter sido descarregado do EBT
#
# Mensagens de erro/aviso geradas durante a validação do código postal:
# CP7_Separador : o código postal é validado, mas informa-se que o 
#                 separador entre o CP4 e o CP3 deve ser apenas o 
#                 sinal de subtracção
# CP7_Texto     : o código postal é validado, mas informa-se que não 
#                 se deve inserir nenhum texto após o CP7
# CP4_Texto     : o código postal é validado, mas informa-se que não 
#                 se deve inserir nenhum texto após o CP4
# CP3_NaoExiste : informa-se que o CP3 não existe
# CP_Invalido   : informa-se que o código postal não é válido
#
# No início do ficheiro com a listagem dos erros e avisos encontrados 
# durante a leitura do ficheiro csv, deve ser apresentado um resumo 
# com o número total de erros e avisos encontrados durante a análise 
# do ficheiro das notas, e deve ser explicado o significado de cada 
# tipo de erro e aviso.  Segue-se uma listagem de todos os erros e 
# avisos encontrados, durante a análise, ordenada por tipo de erro 
# ou aviso, começando pelos mais graves.
########################################################################