Item de changelog

Tela-âncora do dicionário do detalhe (itens do changelog). Não aparece no menu. — este é o papel da tela "Item de changelog" dentro da plataforma.

Cada item pertence a uma versão e aparece no changelog que o cliente lê. Item sem versão publicada fica invisível para ele — é assim que se prepara a nota antes de anunciar.

Um item é UMA linha dentro de uma versão do changelog. "Tipo" classifica a natureza da linha, para a comunicação poder ser lida por categoria. "Ordem" define a sequência de exibição dentro da versão — o que importa mais vem primeiro. "Visível ao cliente" decide, item a item, o que entra na comunicação externa: uma mesma versão pode conviver com linhas internas e linhas públicas. "Título" e "Descrição" são o texto que o leitor final vê.

Aqui você vê e conserta os registros-filhos soltos, um a um. No dia a dia, porém, o certo é criá-los e editá-los dentro do formulário do cadastro pai: é lá que as regras de negócio rodam (totais recalculados, validações, numeração, histórico). Editar direto por aqui é útil para auditoria e para corrigir um caso específico — mas pode deixar o registro pai com um total desatualizado, e isso não gera erro nenhum na tela.

Ao salvar uma visão pelo botão Visões, ela guarda quatro coisas: o texto da busca, os filtros aplicados, quais colunas aparecem (e em que ordem) e por qual coluna a lista está ordenada. Aplicar a visão restaura tudo de uma vez — inclusive zerando a ordenação e a página em que você estava, para o resultado ser exatamente o que a visão descreve. Visões salvas antes desta versão continuam válidas: o que elas não guardaram simplesmente não muda ao aplicar.

Nas fichas, sair de um campo já dispara a conferência do que dá para conferir na hora: campo obrigatório deixado em branco e e-mail mal formado. O aviso aparece embaixo do campo e desaparece quando você começa a corrigir. Campo numérico não precisa de aviso: ele simplesmente não aceita letra enquanto você digita. Isso é conforto, não a validação final: ao salvar, o sistema confere tudo de novo do lado do servidor.

"Onde eu vejo item de changelog?" — quando essa pergunta aparecer, é nesta tela que ela se responde.

Porque ela é uma tela-âncora: existe para dar nome, rótulos e ajuda aos CAMPOS do item de changelog (o dicionário do detalhe), não para ser o caminho de trabalho. O fluxo normal é pelo cadastro principal de changelog — é lá que os itens de cada versão são incluídos, ordenados e editados. Se você chegou aqui por um link, nada está quebrado: use o cadastro principal para mexer no conteúdo.

Abra o registro e olhe a Linha do tempo, à direita: ela mostra cada alteração como "de um valor para outro", com a pessoa e a data. Quando há muita alteração, use os dois filtros no topo da linha do tempo — um por campo, outro por pessoa. A procura é feita no banco, então alteração antiga aparece do mesmo jeito. Você também pode perguntar ao Tenkai: "quem mudou o contrato 482?".