====== Especificação funcional: Importar itens na disciplina ====== ===== Resumo ===== A importação de itens na disciplina salva os dados dos itens de disciplinas do arquivo no banco de dados do sistema. ===== Descrição ===== Para facilitar a inclusão dos itens de disciplinas, em todas as disciplinas de todas as séries em um mesmo município, a importação de itens na disciplina se faz necessária. A equipe de suporte técnico deve criar um arquivo de itens de disciplinas, que deve estar de acordo com o layout predefinido, contendo as informações dos itens das disciplinas. Após a criação desse arquivo, o suporte ou o usuário deverá abrir o arquivo de itens de disciplinas, através da funcionalidade de importação de itens na disciplina, que processará os dados contidos no arquivo. O sistema deve, então, realizar a importação dos dados, fazendo com que os itens sejam cadastrados no sistema, para as respectivas disciplinas. ==== Estrutura do arquivo de itens da disciplina ==== O arquivo de itens da disciplina deve ser escrito no formato txt, conforme o seguinte layout predefinido, separados pelo caracter "|" (pipeline): === Layout do arquivo === |< 100% 5% 10% 10% 10% 65%>| ^Ordem ^Tipo ^Campo ^Tamanho ^Origem ^ |1 |Inteiro |Ordem | - |Campo Ordem da tabela TabSubDisciplina. | |2 |Texto |Identificador | 50 |Campo Identificador da tabela TabSubDisciplina. | |3 |Texto |Nome | 600 |Campo Nome da tabela TabSubDisciplina. | |4 |Texto |Grupo | 80 |Campo Grupo da tabela TabSubDisciplina. | |5 |Texto |Tipo | 50 |Campo Tipo da tabela TabSubDisciplina. | |6 |Inteiro |Peso | - |Campo Peso da tabela TabSubDisciplina. | ==== Validações realizadas antes da importação ==== Para garantir que a importação ocorra da maneira correta, algumas verificações devem ser realizadas pelo sistema antes de processar o arquivo: - Verificar se o arquivo possui a extensão correta (txt); - Verificar se o campo Ordem possui os valores corretos (apenas números), pois é através desse campo que o sistema realiza a importação de cada item na disciplina; - Verificar se o campo Peso possui os valores entre 0 e 99 (valores aceitos para o campo no sistema); Caso alguma das validações falhe, o sistema não deverá processar o arquivo e o suporte/usuário deverá ser informado para que possa providenciar um arquivo de itens de disciplinas válido. ===== Pontos de verificação ===== * O sistema deve processar apenas arquivos de itens de disciplinas válidos, de acordo com o layout definido para arquivos de itens de disciplinas; * O sistema deve atualizar os dados dos itens da disciplina no sistema, de acordo com o valor do campo Ordem do arquivo; * O sistema deve incluir os itens na disciplina no sistema, quando o valor do campo Ordem do arquivo ainda não existir no banco de dados; * Caso os valores nos campos (de texto) do arquivo, venham maiores que o limite máximo configurado para cada um no banco de dados, o sistema deve salvar apenas a parte do texto que couber em cada campo respectivo; * O sistema não deve realizar a importação dos itens, caso o "Tipo de ficha" da disciplina seja igual a "Descritiva (Textos)" e existam itens do tipo "Conceito" no arquivo. Nesse caso, o sistema deve exibir uma mensagem ao usuário informando; * O sistema NÃO deve excluir itens na disciplina no sistema; * O sistema deve atualizar a lista de itens da disciplina após a importação; * O sistema não deve corromper o arquivo de itens da disciplina após a importação; * O sistema não deve apagar o arquivo de itens da disciplina após o processo. ===== Observações ===== Nenhuma.