Preenchimento — número de transbordos
Verifica o preenchimento de transfers em fare_attributes.txt.
Propriedades da regra
| Propriedade | Valor |
|---|---|
| Rule ID | fare_attributes_transfers_field |
| Ficheiro | fare_attributes.txt |
| Campo | transfers |
| Tipo | Valor enumerado |
| Severidade | Obrigatório |
Descrição do campo: número de transbordos permitidos pela tarifa. O valor 0 não permite transbordos, 1 permite um e 2 permite dois. Na descrição do campo, o valor vazio corresponde a transbordos ilimitados.
Mais informação em fare_attributes.txt.
Como funciona
O resultado depende da severidade definida na configuração da regra: obrigatório (error) reprova; recomendado (warning) passa com aviso; informativo (info) passa com informação. O aviso antecipa uma futura exigência, mas só reprova quando a configuração passar a obrigatório. Nos casos sem severidade explícita abaixo, a indicação de reprovação pressupõe a configuração obrigatória.
A regra verifica se o campo tem algum texto, quando a configuração da regra assinala a sua ausência. Não verifica o formato, a unicidade ou a coerência com outros campos.
A regra avalia cada linha do fare_attributes.txt, seguindo os passos abaixo por ordem, até um deles dar o resultado.
| # | Pergunta | Se sim | Se não |
|---|---|---|---|
| 1 | O campo está vazio? | Segue para o passo 2 | ✅ Passa |
| 2 | A configuração da regra ignora esta verificação? | Termina sem reportar a ausência | Reporta o problema de campo em falta, de acordo com a configuração da regra |
Uma coluna ausente é tratada como um campo vazio. Os espaços não são removidos: um valor só com espaços conta como preenchido. A configuração de campo proibido também assinala a ausência, com a mensagem informativa; não rejeita valores preenchidos. Apesar do significado de transbordos ilimitados na descrição do campo, esta regra assinala um valor vazio quando a configuração está ativa.
Exemplos
| Valor | Resultado | Porquê |
|---|---|---|
2 | ✅ Passa | Campo preenchido |
| Vazio (configuração exige o campo) | ❌ Reprova | Campo obrigatório em falta |
| Coluna ausente (configuração recomenda o campo) | ✅ Passa com aviso | Campo recomendado em falta |
Como corrigir
| Problema | Causa provável | O que fazer |
|---|---|---|
| Campo obrigatório em falta | A configuração da regra exige o campo | Preencher transfers em fare_attributes.txt com o número de transbordos permitido. Se forem ilimitados, pedir a revisão da aplicação desta regra antes de alterar o valor vazio. |
| Campo recomendado em falta | A configuração da regra recomenda o campo | Preencher transfers em fare_attributes.txt com o número de transbordos permitido. Se forem ilimitados, pedir a revisão da aplicação desta regra antes de alterar o valor vazio. |
| Campo informativo em falta | A configuração da regra assinala a ausência como informação ou está definida como campo proibido | Preencher transfers em fare_attributes.txt com o número de transbordos permitido. Se forem ilimitados, pedir a revisão da aplicação desta regra antes de alterar o valor vazio. |