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

Principais conclusões

• A Barra de Ferramentas 4D é uma camada de conveniência, não um requisito — escondê-la é um primeiro passo legítimo para muitos desenvolvedores porque os ícones não são óbvios e a barra de menu expõe os mesmos comandos.
• É melhor deixar as Propriedades do Banco de Dados em seus padrões enquanto você estiver aprendendo; alterá-las prematuramente pode mascarar o comportamento que você está tentando entender.
• As propriedades são armazenadas com a estrutura do banco de dados, portanto, elas viajam com o projeto e afetam todos os desenvolvedores e todos os clientes implantados — trate-as como decisões em nível de equipe, não como preferências pessoais.
• A distinção entre propriedades do banco de dados e configurações de aplicação/preferência é importante: uma altera o produto que você entrega, a outra altera apenas o seu ambiente de trabalho.
• Uma ordem de configuração disciplinada — criar banco de dados, revisar propriedades, definir tabelas, definir campos, construir formulários, conectar listas de valores, inserir dados de amostra — evita retrabalho posterior.

Por que a Barra de Ferramentas é a primeira coisa que você deve decidir

A Barra de Ferramentas 4D fica na parte superior do ambiente de Design e oferece acesso rápido a ações comuns: abrir o editor de Estrutura, o editor de Formulário, o editor de Método, executar o banco de dados e assim por diante. Em princípio, isso parece útil.

Na prática, muitos desenvolvedores — incluindo o autor das notas originais nas quais este artigo se baseia — acham isso ativamente perturbador. Os ícones não são autoexplicativos, e passar o mouse para descobrir o que cada um faz interrompe o fluxo mental de projetar uma tabela ou um formulário.

Se isso descreve você, você pode desligá-la. Abra a caixa de diálogo Propriedades do Banco de Dados no menu Design (no 4D clássico, isso é acessado através da área Propriedades/Preferências), localize a caixa de seleção Mostrar Barra de Ferramentas e desmarque-a. A barra de ferramentas desaparece do ambiente de Design e, em vez disso, você navega pela barra de menus — Estrutura, Formulário, Método, Executar e assim por diante.

Esta é uma decisão pequena, mas ilustra um princípio maior que vale a pena internalizar cedo: o 4D oferece muita área de superfície, e nem tudo é útil para você no primeiro dia. Seu trabalho como iniciante é reduzir o ruído para que você possa ver o modelo subjacente — tabelas, campos, formulários e as relações entre eles.

Algumas observações práticas sobre a decisão da barra de ferramentas:

• Escondê-la é reversível. Nada em desmarcar a caixa é destrutivo. Se mais tarde você a quiser de volta, reabra a mesma caixa de diálogo e marque-a novamente.
• A barra de menu é a fonte da verdade. Cada botão da barra de ferramentas corresponde a um comando de menu. Aprender o caminho do menu é um conhecimento mais duradouro do que aprender a posição de um ícone.
• Atalhos de teclado superam ambos. Depois de conhecer os comandos do menu, aprender seus atalhos (por exemplo, o atalho para executar o banco de dados ou para abrir o editor de Estrutura) é mais rápido do que a barra de ferramentas ou os menus.
• Sua preferência pode ser diferente da de seu colega de equipe. Como essa configuração reside nas propriedades do banco de dados, ela é compartilhada. Se trabalhar em equipe, concordem com uma convenção em vez de alterá-la repetidamente.

Propriedades do Banco de Dados: o que são e por que são importantes

A caixa de diálogo Propriedades do Banco de Dados é onde você configura as definições que se aplicam ao banco de dados como um todo, em vez de a uma única tabela, campo ou formulário. É uma das primeiras caixas de diálogo que você encontrará após criar um novo banco de dados, e é fácil ignorá-la completamente ou configurá-la excessivamente.

Relacionado: 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..

A principal coisa a entender é o escopo dessas configurações. As propriedades do banco de dados são armazenadas dentro do arquivo de estrutura do banco de dados. Isso significa que:

• Elas são compartilhadas — cada desenvolvedor que abre a estrutura vê os mesmos valores de propriedade.
• Elas são entregues — quando você cria um aplicativo compilado ou implanta o banco de dados interpretado, as propriedades vão com ele.
• Elas são persistentes — elas sobrevivem a reinicializações, reconstruções e (na maioria dos casos) atualizações de estrutura.

Contraste isso com as configurações que residem no próprio aplicativo 4D ou em um arquivo de preferências por usuário. Estas afetam apenas a sua máquina e a sua sessão. A distinção é importante porque uma mudança que parece ser “apenas minha preferência” pode, na verdade, alterar o comportamento para todos.

Uma regra prática para iniciantes

A orientação original aqui é sólida e vale a pena repetir com ênfase: deixe as outras propriedades em seus valores padrão por enquanto. Há muitas opções nessa caixa de diálogo, e a maioria delas aborda cenários que você ainda não encontrou. Alterar uma propriedade que você não entende é uma maneira confiável de criar um bug que parece um problema de código, mas é, na verdade, um problema de configuração — o tipo mais difícil de diagnosticar.

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

À medida que você se tornar mais familiarizado com o 4D, começará a reconhecer quando uma propriedade é relevante. Esse é o momento certo para alterá-la. A experimentação é incentivada, mas faça-a deliberadamente: altere uma propriedade, observe o efeito e anote o que aconteceu.

Como decidir se deve alterar uma propriedade

Quando você for tentado a modificar algo na caixa de diálogo Propriedades do Banco de Dados, passe-o por estas perguntas:

1. Eu entendo o que esta configuração controla? Se não, deixe como está. Pesquise primeiro.
2. Esta é uma decisão de todo o projeto ou pessoal? Se for pessoal, provavelmente não pertence aqui.
3. Isso afetará os clientes implantados? Em caso afirmativo, precisa ser uma escolha consciente e documentada.
4. Posso desfazer isso facilmente? A maioria das propriedades é reversível, mas algumas interagem entre si de maneiras que não são óbvias.
5. Eu testei em uma cópia do banco de dados? Para qualquer coisa não trivial, teste em uma estrutura duplicada antes de confirmar.

A Sequência de Configuração e Onde as Propriedades se Encaixam

Ajudaria ver a etapa de propriedades no contexto. O caminho de aprendizagem apresentado nesta série é:

1. Criar um banco de dados — iniciar um novo arquivo de estrutura.
2. Propriedades do Banco de Dados — revisar as configurações de todo o projeto e, por enquanto, aceitar os padrões.
3. Tabelas — definir as entidades que seu aplicativo armazenará (clientes, faturas, produtos e assim por diante).
4. Campos de dados — definir os atributos de cada tabela, escolhendo os tipos de campo apropriados.
5. Formulários — projetar as telas de entrada e exibição com as quais os usuários realmente trabalharão.
6. Listas de valores (listas de escolha) — fornecer vocabulários controlados para que os usuários escolham opções válidas em vez de digitar texto livre.
7. Inserir dados de amostra — preencher o banco de dados para poder testar formulários e listas com conteúdo realista.

As propriedades vêm em segundo lugar porque enquadram tudo o que se segue, mas deliberadamente não são o lugar para gastar sua energia inicial. O trabalho intelectual do 4D está nos passos 3 a 6: acertar o modelo de dados e, depois, torná-lo utilizável.

Por que a ordem importa

• Tabelas antes dos campos. Você não pode definir um campo de maneira sensata até saber a qual tabela ele pertence e o que essa tabela representa.
• Campos antes dos formulários. Um formulário é uma visualização dos campos. Projetar formulários primeiro leva a campos que existem apenas para servir a um layout.
• Formulários antes das listas de valores (na prática). Você frequentemente descobre quais campos precisam de uma lista de escolha ao construir o formulário que os utiliza.
• Dados de amostra por último, mas não menos importante. Formulários vazios escondem problemas. Um formulário que parece bom com zero registros pode falhar com nomes reais, endereços longos e valores extremos.

Propriedades do Banco de Dados vs. Preferências do Aplicativo: Uma Comparação

Iniciantes frequentemente confundem essas duas categorias. Elas são configuradas em locais diferentes, têm escopos diferentes e devem ser tratadas de forma diferente.

Aspecto	Propriedades do Banco de Dados	Preferências do Aplicativo / Usuário
Escopo	A estrutura do banco de dados e tudo o que é construído a partir dela	Seu aplicativo 4D e sua sessão de trabalho
Quem afeta	Todos os desenvolvedores e todos os clientes implantados	Tipicamente apenas você
Onde reside	Dentro do arquivo de estrutura	No aplicativo 4D ou em um local de configurações por usuário
Viaja com o projeto?	Sim	Não
Exemplos típicos	Visibilidade da barra de ferramentas, comportamento de inicialização, opções de toda a estrutura	Posições de janelas, fonte do editor, listas de arquivos recentes
Conselho para iniciantes	Aceite os padrões; altere deliberadamente e documente	Ajuste livremente para seu conforto

A configuração da barra de ferramentas é um caso um pouco incomum: parece uma preferência pessoal, mas é exposta como uma propriedade do banco de dados. É exatamente por isso que vale a pena fazer uma pausa. Quando a localização de uma configuração e seu escopo aparente discordam, diminua o ritmo e pense em quem mais será afetado.

Relacionado: Microsoft Power Apps — Desenvolvimento de aplicativos low-code de nível empresarial conectados ao Microsoft 365, Dataverse e Power Automate..

Orientação Prática para Sua Primeira Sessão

Se você está utilizando o 4D pela primeira vez, aqui está uma maneira concreta de passar a primeira hora de forma produtiva.

• Crie o banco de dados com um nome claro e descritivo. Evite espaços e caracteres especiais no nome do arquivo de estrutura se planeja movê-lo entre máquinas ou referenciá-lo a partir de scripts.
• Abra as Propriedades do Banco de Dados e leia as opções sem alterá-las. Ler é gratuito; isso constrói um mapa mental do que é configurável.
• Desmarque “Mostrar Barra de Ferramentas” se achar que isso o distrai. Esta é a única alteração que a orientação original endossa, e é segura.
• Feche a caixa de diálogo e siga para Tabelas. Resista à tentação de explorar cada guia.
• Mantenha um arquivo de notas curto registrando qualquer propriedade que você realmente altere e o porquê. O seu “eu do futuro” e seus colegas de equipe agradecerão.

Erros comuns de iniciantes nesta fase

• Configurar excessivamente antes da modelagem. Passar uma hora na caixa de diálogo de propriedades e dez minutos no modelo de dados é o caminho inverso.
• Presumir que uma configuração é pessoal quando ela é compartilhada. Veja a tabela de comparação acima.
• Alterar várias propriedades de uma vez. Se algo quebrar, você não saberá qual alteração causou o problema.
• Ignorar totalmente a caixa de diálogo. Os padrões geralmente estão corretos, mas “geralmente” não é “sempre” — saiba o que está lá.

Onde se Aprofundar

A plataforma 4D tem uma longa história e um corpo substancial de documentação. O site oficial de documentação do 4D, mantido pela 4D SAS, é a referência autoritativa para cada propriedade, comando e editor do produto, e vale a pena salvá-lo nos favoritos desde cedo. Para um contexto geral sobre o produto e sua linhagem, o artigo da Wikipédia sobre 4D (programming language) fornece informações úteis sobre como a plataforma evoluiu de um banco de dados relacional para um ambiente completo de desenvolvimento de aplicativos.

Se você vem de um contexto SQL, a visão geral da Wikipedia sobre o modelo relacional é uma recapitulação útil dos conceitos que o 4D implementa em seu próprio idioma — tabelas, registros, campos e relações — mesmo que a terminologia e as ferramentas do 4D difiram de um servidor SQL típico. E como os aplicativos 4D são frequentemente implantados junto com softwares comerciais de uso geral, os sites de documentação Microsoft Learn e Apple Developer são referências úteis quando você precisa entender as convenções do sistema operacional host para janelas, arquivos e comportamento da interface do usuário.

Favorito do leitor: 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..

Nada disso substitui o tempo prático no editor de Estrutura. A maneira mais rápida de aprender 4D é construir um banco de dados pequeno e real — algo que você realmente queira rastrear — e deixar a caixa de diálogo de propriedades quieta em segundo plano até que você tenha um motivo para abri-la.

Perguntas Frequentes

Devo ocultar a Barra de Ferramentas do 4D?

É inteiramente uma questão de estilo de trabalho pessoal. Muitos desenvolvedores a ocultam porque os ícones não são intuitivos e a barra de menu expõe os mesmos comandos, enquanto outros preferem o acesso com um clique. A configuração é reversível, então tente das duas formas e mantenha a que ajudar você a manter o foco.

As propriedades do banco de dados são as mesmas que as minhas preferências pessoais?

Não. As propriedades do banco de dados são armazenadas com o arquivo de estrutura e, portanto, aplicam-se a cada desenvolvedor e a cada cliente implantado. As preferências pessoais afetam apenas a sua própria máquina e sessão. Quando uma configuração parecer pessoal, mas estiver na caixa de diálogo de propriedades do banco de dados, trate-a como uma decisão compartilhada.

Por que devo deixar os valores de propriedade padrão intocados no início?

Porque a maioria das opções aborda situações que você ainda não encontrou, e alterar uma configuração que você não entende pode produzir um comportamento que parece um bug de código, mas é, na verdade, um problema de configuração. Os padrões são um ponto de partida razoável; reveja-os assim que souber o que cada um faz.

Qual é a ordem correta para configurar um novo banco de dados 4D?

Crie o banco de dados, revise as propriedades, defina suas tabelas, defina os campos dentro de cada tabela, projete os formulários, configure listas de valores para campos controlados e, então, insira dados de amostra. Essa ordem mantém cada decisão fundamentada na anterior e evita retrabalho.

Preciso configurar as propriedades antes de construir tabelas e formulários?

Não. A caixa de diálogo de propriedades enquadra o projeto, mas o trabalho substantivo acontece nos editores de Estrutura e Formulário. Você pode construir um banco de dados completo e funcional sem tocar na maioria das propriedades, e pode retornar a elas mais tarde, quando surgir uma necessidade específica.

Como sei quando é hora de alterar uma propriedade do banco de dados?

Quando você puder declarar claramente o que a configuração controla, quem ela afeta e o que você espera que mude como resultado — e, idealmente, após testá-la em uma cópia da estrutura. Se você ainda não conseguir responder a essas perguntas, deixe no padrão e continue construindo.