Noções Básicas de Aprendizagem da 4ª Dimensão

O menu Arquivo é a primeira coisa que um usuário toca em qualquer aplicação 4D personalizada, e também é o menu com maior probabilidade de ser deixado em seu estado padrão por desenvolvedores que estão ansiosos para passar aos formulários e métodos. Isso é um erro.

O menu Arquivo é onde seu aplicativo declara para que serve — seja uma ferramenta de entrada de dados, uma ferramenta de relatórios ou um aplicativo de negócios de uso geral. Acertar isso cedo evita retrabalho mais tarde, porque os itens de menu estão ligados a métodos, e os métodos estão ligados à estrutura da sua tabela.

Esta seção percorre o menu Arquivo recomendado para uma barra de menu 4D personalizada, como construí-la no Editor da Barra de Menu e as restrições práticas que você encontrará ao longo do caminho.

Principais conclusões

• Um menu Arquivo personalizado bem projetado normalmente contém quatro grupos lógicos: movimentação de dados (Importar/Exportar), impressão (Configuração de Página, Imprimir Registro, Imprimir Conjunto Encontrado), identidade do aplicativo (Sobre) e sair (Sair).
• As barras de menu em 4D são permanentemente denominadas Menu Bar #1, Menu Bar #2, e assim por diante — você não pode renomeá-las, então documente qual barra serve para qual propósito.
• As linhas divisórias são criadas como itens de menu usando a opção Linha; elas não são uma propriedade separada.
• Os nomes dos itens de menu são fixos depois de criados. Você pode excluir e recriar um item, mas não pode editar seu rótulo no local.
• A reordenação é assimétrica: você pode arrastar itens para cima livremente, mas para mover um item para baixo, você deve arrastar outros itens acima dele.
• Atalhos de teclado e métodos anexados são configurados por item de menu, e os métodos são a ponte entre o menu e a lógica do seu aplicativo.

Por que o menu Arquivo merece um design deliberado

No FileMaker Pro, o menu Arquivo é amplamente fixo — você obtém o que a plataforma oferece, e a personalização acontece no nível de scripts e botões, e não na própria barra de menu. O 4D inverte essa relação. A barra de menu é um objeto de design de primeira classe, editado no Modo Design por meio do Editor da Barra de Menu, e cada item nela pode ter seu próprio atalho de teclado e seu próprio método.

Esse poder vem com responsabilidade. Um menu Arquivo personalizado que espelhe o layout do FileMaker por hábito parecerá errado para os usuários de 4D, enquanto um menu Arquivo que omita totalmente a impressão frustrará qualquer um que espere um comportamento padrão de desktop. O objetivo é um menu que seja reconhecível — que faça o que se espera que um menu Arquivo faça — enquanto seja específico para o fluxo de trabalho do seu aplicativo.

A estrutura recomendada para esta série é deliberadamente pequena:

Relacionado: Airtable — Uma interface simples de planilha baseada em um banco de dados relacional real, com automações, visualizações e interfaces compartilháveis..

Arquivo
  Importar Dados
  Exportar Dados

Configuração de Página
  Imprimir Registro
  Imprimir Conjunto Encontrado

Sobre A

Sair        Q

Cada grupo responde a uma pergunta diferente do usuário. O primeiro grupo responde “como faço para inserir e retirar dados?”. O segundo responde “como faço para colocar isso no papel?”. O terceiro responde “o que estou executando?”. O quarto responde “como faço para sair?”. Esse é um modelo mental coerente, e os usuários navegam por ele sem instrução.

Construindo o Menu Arquivo no Editor da Barra de Menu

A mecânica é simples, mas cheia de pequenas armadilhas. No Modo Design, abra o menu Ferramentas e escolha Editor da Barra de Menu. Você verá uma janela “Lista de Barras de Menu” à esquerda e uma janela “Barra de Menu Atual” à direita.

1. Na janela “Lista de Barras de Menu”, clique em Menu Bar #1. Observe que os nomes das barras de menu não são editáveis — eles são sempre Menu Bar #1, Menu Bar #2 e assim por diante. Se você mantiver diversas barras (por exemplo, uma para entrada de dados e outra para relatórios), mantenha uma nota separada mapeando cada barra numerada à sua finalidade. Este é um dos poucos lugares no 4D onde você deve manter documentação externa para manter a sanidade.
2. Na janela “Barra de Menu Atual”, clique no menu Arquivo para selecioná-lo como destino.
3. Clique em Adicionar Item para anexar uma nova entrada e digite seu nome.
4. Para inserir uma divisória, adicione outro item e escolha a opção Linha em vez de digitar um nome.
5. Repita até que o menu corresponda à estrutura pretendida.

As restrições que você realmente encontrará

• Os nomes são imutáveis. Depois que um item de menu é criado, você não pode renomeá-lo. Se você digitar “Exportar Dados” como “Exprot Dados”, sua única solução é excluir o item e criar um novo — o que também significa reconectar qualquer método e atalho que você já tenha configurado. Digite com cuidado na primeira vez.
• O arraste é unidirecional na prática. Você pode arrastar itens para cima livremente. Para mover um item para baixo, você deve arrastar os itens acima dele para cima, passando por ele. Planeje sua ordem antes de começar a adicionar, ou aceite algumas reorganizações.
• Divisórias contam como itens. Uma divisória ocupa um espaço na ordenação, portanto participa das mesmas regras de arraste que um item nomeado. Insira as divisórias depois de ter os itens nomeados aproximadamente na ordem correta.

A Figura 8 no passo a passo original mostra o fluxo de trabalho “Adicionar Item” no menu Arquivo, e a Figura 9 mostra o menu Arquivo personalizado resultante como o usuário o verá em tempo de execução. Vale a pena visualizar o menu após cada grupo de adições, em vez de construir tudo às cegas.

Se você estiver comprando: Zoho Creator — Um construtor de aplicativos de baixo código que se conecta ao conjunto Zoho mais amplo e tem preços por usuário, e não por aplicativo..

Escolhendo o que pertence — e o que não pertence

A tentação com uma barra de menu personalizável é expor tudo. Resista. Cada item que você adiciona é uma promessa de que o recurso funciona, é descoberto e possui um atalho de teclado sensato. Um menu Arquivo curto que esteja totalmente conectado supera um longo com entradas mortas.

Uma estrutura de decisão útil:

Item candidato	Incluir quando…	Considere omitir quando…
Importar Dados	Os usuários trazem regularmente arquivos externos (CSV, delimitado por tabulações, exportações de planilhas)	Os dados chegam apenas através de seus próprios formulários ou de uma sincronização automatizada
Exportar Dados	Os usuários precisam entregar dados para o Excel, outro sistema ou um colega	Os relatórios são totalmente gerenciados por saída impressa ou listas na tela
Configuração de Página	Qualquer impressão ocorra
Imprimir Registro	Usuários imprimem o registro atualmente na tela	A impressão é sempre um conjunto encontrado ou um relatório
Imprimir Conjunto Encontrado	Os usuários trabalham com resultados de consultas e precisam deles no papel	A impressão é sempre de registro único
Sobre	Você deseja que as informações de versão e suporte sejam acessíveis com um clique	A aplicação é interna e o versionamento é tratado em outro lugar
Sair	Sempre — os usuários precisam de uma saída limpa que possa executar o código de limpeza	Nunca omita isso; a ausência do Sair força o fechamento da janela no nível do SO

O item Sair merece menção especial. No 4D, o Sair pode ser anexado a um método que realiza um desligamento ordenado — fechando janelas, confirmando ou cancelando transações, liberando bloqueios, escrevendo um log de sessão. Se você omitir o Sair do menu, os usuários fecharão a janela do aplicativo em vez disso, e seu método de limpeza nunca será executado. Isso é um risco de integridade de dados, não um risco cosmético.

Da mesma forma, Sobre é mais do que vaidade. Um item Sobre bem construído pode exibir a versão da aplicação, a versão do motor 4D, o caminho atual do arquivo de dados e um contato de suporte. Quando um usuário pede ajuda, “clique em Sobre e leia para mim as três primeiras linhas” resolve um número surpreendente de tickets de suporte antes que eles escalem.

Atalhos de Teclado e a Conexão do Método

Duas propriedades se anexam a cada item de menu além de seu nome: um atalho de teclado e um método.

Atalhos de teclado seguem as convenções de desktop com precisão suficiente para que os usuários os adivinhem. Os pares convencionais são Command-Q (macOS) ou o acelerador de plataforma equivalente para Sair, e Command-P para impressão. Ao atribuir atalhos, verifique se há colisões — dois itens de menu compartilhando um acelerador significa que um deles silenciosamente nunca é acionado, e o usuário reportará isso como “o item de menu não faz nada”.

Relacionado: Knack — Um construtor de banco de dados sem código voltado para portais, diretórios e ferramentas internas — com preços fixos em vez de taxas por usuário..

Métodos são o equivalente 4D dos scripts do FileMaker, e são eles que fazem um item de menu fazer alguma coisa. Um item de menu sem método é inerte: ele aparece, é destacado, e clicar nele não realiza nada. Este é o defeito mais comum em uma primeira barra de menu personalizada. Antes de considerar o menu Arquivo concluído, percorra cada item e confirme se ele possui um método anexado ou um motivo deliberado para ser decorativo.

A divisão de trabalho vale a pena ser declarada claramente:

• Itens de menu lidam com a descoberta e a invocação.
• Métodos lidam com a lógica, validação, tratamento de erros e feedback do usuário.
• Formulários e caixas de listagem lidam com a apresentação real dos dados.

Manter essas camadas separadas é o que torna uma aplicação 4D sustentável. Um item de menu cujo método é uma única linha chamando um método de projeto bem nomeado é muito mais fácil de depurar do que aquele cujo método contém cinquenta linhas de lógica inline.

Nossa escolha: Claris FileMaker Pro — A plataforma de banco de dados relacional de longa duração para equipes que precisam de aplicativos personalizados em desktop, web e dispositivos móveis a partir de um único arquivo..

Métodos são abordados em uma parte posterior desta série; por enquanto, o importante é deixar o gancho no lugar. Adicionar o item de menu e anexar um método stub antecipadamente significa que você pode conectar a lógica real mais tarde sem revisitar o Editor da Barra de Menu.

Erros Comuns e Como Evitá-los

• Construir o menu antes do modelo de dados. Itens de menu implicam capacidades. Se você adicionar “Exportar Dados” antes de decidir quais tabelas e campos são exportáveis, você entregará uma exportação que funciona parcialmente ou reescreverá o menu mais tarde.
• Esquecer os itens divisores. Sem divisores, um menu Arquivo com oito entradas é lido como uma lista indiferenciada. O agrupamento visual é o que torna a estrutura legível.
• Presumir que poderá renomear mais tarde. Você não pode. Decida os rótulos — incluindo capitalização e pluralização — antes de clicar em Adicionar Item.
• Deixar o Sair sem conexão. Como observado, isso empurra os usuários para o fechamento da janela e ignora sua lógica de limpeza.
• Duplicar as convenções do FileMaker integralmente. A barra de menu do 4D é mais flexível que a do FileMaker, portanto copiar exatamente o menu Arquivo do FileMaker desperdiça a vantagem da plataforma. Projete para seus usuários, não para um produto diferente.

Onde Isso se Encaixa na Série

Esta seção cobre especificamente o menu Arquivo. As partes adjacentes da série abordam como os menus 4D se comparam aos menus do FileMaker, como construir uma barra de menu personalizada do zero e como lidar com o menu Registros — que é onde residem os conjuntos encontrados, a navegação de registros e a exclusão. Juntos, eles formam uma imagem completa da camada de menu.

Se você está construindo sua primeira aplicação 4D, uma ordem razoável de operações é: defina suas tabelas, construa seus formulários e, por último, projete a barra de menu, assim que souber quais operações os usuários realmente precisam. O menu é o mapa; ele deve ser desenhado depois que você conhecer o território.

Perguntas Frequentes

Por que não posso renomear uma barra de menu ou um item de menu no 4D?

As barras de menu são permanentemente denominadas Menu Bar #1, Menu Bar #2 e assim por diante, e os rótulos dos itens de menu são fixados no momento da criação. Esta é uma restrição deliberada no Editor da Barra de Menus, e não um bug. A solução prática é manter seu próprio documento de mapeamento — uma lista simples que associa cada barra de menu numerada à sua finalidade — e revisar os nomes dos itens antes de clicar em Add Item, já que o único caminho de correção é excluir e recriar.

Preciso de um método anexado a cada item de menu?

Funcionalmente, sim, se você quiser que o item faça alguma coisa. Um item de menu sem método aparece no menu e pode ser selecionado, mas nada acontece. A exceção são as linhas divisórias, que são estruturais e não acionáveis. Para itens cuja lógica ainda não foi escrita, anexe um método stub que exiba uma mensagem de espaço reservado, para que o item seja pelo menos honesto sobre seu estado.

O menu Arquivo deve incluir Importação e Exportação em todos os aplicativos?

Não. Inclua-os quando os usuários realmente moverem dados para dentro e para fora do sistema — por exemplo, recebendo exportações de planilhas de um parceiro ou entregando resultados de consultas a um analista. Se todos os dados entram através de seus próprios formulários e toda a saída é impressa ou visualizada na tela, Importar e Exportar adicionam área de superfície sem agregar valor. Decida com base no fluxo de trabalho observado, e não no que outros aplicativos fazem.

Como movo um item de menu para baixo na lista?

Você não pode arrastar um item diretamente para baixo. O Editor da Barra de Menu permite apenas arrastar itens para cima. Para mover um item para baixo, arraste os itens acima dele para cima, passando por ele, o que efetivamente o desloca para baixo. Como as divisórias também são itens, elas seguem a mesma regra. Isso é mais fácil de gerenciar se você adicionar os itens na ordem final pretendida e fizer apenas pequenas correções depois.

Qual é a diferença entre “Print Record” e “Print Found Set”?

“Print Record” imprime o único registro exibido atualmente, o que se adapta a saídas em estilo de formulário, como uma fatura ou um perfil de cliente. “Print Found Set” imprime todos os registros da seleção atual, o que se adapta a saídas em estilo de lista, como um relatório filtrado. Muitos aplicativos incluem ambos, porque os usuários alternam entre os dois modos dependendo se estão revisando um único item ou um lote.

Um item de menu pode executar código de limpeza quando o usuário sai?

Sim — este é um dos motivos mais fortes para incluir um item Quit em vez de depender de que os usuários fechem a janela do aplicativo. Anexe um método ao Quit que confirme ou cancele transações abertas, libere bloqueios de registros, feche janelas em ordem e, opcionalmente, grave um log de sessão. Se o Quit estiver ausente do menu, esse método nunca será executado, e o aplicativo será encerrado em qualquer estado em que o usuário o tenha deixado.