Consultar e editar itens numa tela em árvore

Algumas telas de cadastro organizam os itens em níveis, como um plano de contas: Natureza Receita/Despesa, Centro de Custos, Grupo de Produtos/Serviços e Projetos. Em vez de uma grade, elas mostram uma árvore à esquerda e, à direita, o painel do item que você escolheu.

A tela

O cabeçalho é o das telas de cadastro: Atualizar (F5), Exportar, o ⋯ (com Relatórios, Ações da tela, Configuração de campos e Tour da tela) e Novo registro (Insert).

Na árvore, cada item mostra o código e a descrição. Os itens analíticos, que não aceitam filhos, levam um selo com o nome do campo da própria tela: Analítica em Natureza Receita/Despesa, Analítico nas outras. No topo da árvore ficam o botão de Recolher árvore ou Expandir árvore, o campo Filtrar…, que procura pelo texto e mantém o caminho dos resultados, e o botão Filtro, com os filtros salvos. A divisória entre a árvore e o painel se arrasta, ou se move com as setas quando está em foco, para ajustar a largura.

Navegar pelo teclado

Com o foco num item da árvore:

Tecla	O que faz
↓ ↑	vai ao item de baixo ou de cima
→	abre o item; se já está aberto, desce ao primeiro filho
←	fecha o item; se já está fechado, sobe ao pai
Home End	vai ao primeiro ou ao último item visível
Enter ou Espaço	seleciona o item e mostra o painel
*	abre todos os itens do mesmo nível

Ver um item

Clique num item, ou use Enter, e o painel mostra o código, a descrição e os demais campos. Sem nenhum item escolhido, o painel diz “Selecione um item na árvore”. No alto do painel ficam Editar e os ícones Duplicar registro, Anexos e Excluir; cada um só aparece para quem tem a permissão.

Incluir um item

1. Para criar um filho, selecione o item pai. Para criar um item do primeiro nível, não deixe nenhum item selecionado.
2. Clique em Novo registro. O painel abre em branco, com o pai já preenchido.
3. Preencha o código, respeitando a máscara da hierarquia, e os demais campos.
4. Clique em Salvar.

Não se inclui filho num item analítico: o sistema avisa “Não é possível incluir filhos em um item analítico.”

Alterar e trocar o código de um item

Selecione o item e clique em Editar. O painel passa a dizer “Editando”, com o selo Não salvo assim que algo muda, e ganha Cancelar e Salvar no rodapé.

O código também se troca em Editar. A troca é gravada e o painel mostra o item com o código novo. Quando ela não é permitida, a mensagem diz o motivo:

• “Não é possível alterar a chave: o registro possui filhos na hierarquia.”;
• “Não é possível alterar a chave: registro vinculado a outro registro.”, quando o item já é usado em outro cadastro;
• “Já existe um registro com a chave informada.”;
• “Não é permitido alterar a chave primária desta tabela.”, quando a tabela não aceita troca de código.

Descartar alterações

Se você trocar de item, cancelar, atualizar ou criar outro com uma alteração pendente, o sistema pergunta “Descartar alterações?”: “As alterações deste item ainda não foram salvas.” Escolha Continuar editando ou Descartar.

Excluir um item

Só se excluem itens analíticos, e só depois de excluídos os filhos. Selecione o item, clique em Excluir e confirme. Se não puder, o sistema diz o motivo:

• “Só é possível excluir itens analíticos.”;
• “Exclua os filhos antes de excluir este item.”

Os avisos sobre a estrutura da hierarquia aparecem num cartão, Avisos da hierarquia.

Problemas comuns

O botão Editar, Excluir ou Novo registro não aparece. O seu usuário não tem a permissão dessa ação na tela.