Fundamentos da Aprendizagem na 4ª Dimensão

Se você está vindo para o 4D (4ª Dimensão) do FileMaker Pro, um dos primeiros ajustes mentais que você precisa fazer é em relação às listas de valores. O FileMaker oferece uma caixa de diálogo amigável e independente para construí-las.

O 4D oferece algo mais poderoso, mas com menos “ajuda”: o Editor de Listas, uma ferramenta do modo de design que produz recursos de lista reutilizáveis que você então anexa a objetos de formulário. Este artigo explica como as listas de valores funcionam no 4D, como elas diferem da abordagem do FileMaker e as decisões práticas que você tomará ao longo do caminho.

Principais Conclusões

• No 4D, as listas de valores são criadas e armazenadas centralmente no Editor de Listas, não dentro de definições de campos individuais como no FileMaker.
• Uma lista 4D é um recurso nomeado; a mesma lista pode ser anexada a muitos objetos de formulário em muitos formulários, o que mantém a manutenção em um só lugar.
• Itens de lista suportam formatação por item (simples, negrito, itálico) e uma flag editável, e cada item pode conter itens filhos em profundidade arbitrária — uma estrutura hierárquica que as listas de valores planas do FileMaker não oferecem nativamente.
• Os quatro estilos de exibição do FileMaker (Lista Pop-up, Menu Pop-up, Caixas de Seleção, Botões de Opção) mapeiam-se para conceitos do 4D, mas apenas a Lista Pop-up é direta; caixas de seleção e botões de opção exigem consideravelmente mais trabalho.
• O momento certo para criar uma lista é antes de conectar o objeto de formulário que a utiliza, para que você possa referenciá-la pelo nome imediatamente.

Por que o 4D as chama de “Listas” e o FileMaker as chama de “Listas de Valores”

A terminologia é o primeiro obstáculo. A documentação e a interface do usuário do FileMaker usam Lista de Valores consistentemente. A documentação do 4D e o material de treinamento clássico da HPO Soft usam Lista, e você também verá Lista de Escolhas em referências mais antigas e postagens da comunidade. Todas descrevem a mesma ideia: uma coleção nomeada de itens dos quais um usuário escolhe ao inserir dados em um campo.

A diferença de nomenclatura reflete uma diferença arquitetural real. No FileMaker, uma lista de valores é essencialmente uma propriedade do campo ou do objeto de layout — você a define no contexto de onde ela é usada, e o FileMaker oferece três fontes:

• Uma lista personalizada de itens que você mesmo digita.
• Uma lista derivada de valores de campo — valores exclusivos extraídos de registros no arquivo atual, ou valores alcançados através de um relacionamento.
• Uma lista baseada em uma lista em outro arquivo (lista de valores de um arquivo relacionado).

O 4D suporta as mesmas três fontes conceitualmente, mas separa a definição da lista do uso da lista. Você define a lista uma vez no Editor de Listas, dá a ela um nome e, então, qualquer objeto de formulário — um pop-up, um menu suspenso, uma caixa de combinação, um controle de guia, o que for — pode apontar para esse nome. Essa separação é a coisa mais importante a ser internalizada, porque muda a forma como você planeja seu esquema e seus formulários.

Criando uma Lista no Editor de Listas do 4D

O fluxo de trabalho é curto, mas vale a pena fazer na ordem certa.

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

1. Mude para o Modo de Design. Listas são recursos de tempo de design, não dados de tempo de execução.
2. Abra o menu Ferramentas e escolha Editor de Listas. (No 4D moderno, isso fica no menu Design / Explorer dependendo da versão, mas o caminho clássico é Ferramentas $\rightarrow$ Editor de Listas.)
3. A janela do Editor de Listas abre com duas sub-janelas: Lista de Listas à esquerda e Lista Atual à direita.
4. No painel esquerdo, clique em Adicionar e digite um nome para sua nova lista. Escolha o nome com cuidado — ele se torna o identificador que você referenciará a partir de objetos de formulário, e renomear mais tarde significa atualizar todas as referências.
5. Clique no nome para selecioná-lo, depois vá para o painel direito e insira os itens para essa lista, um por linha.

Esse é todo o ciclo de criação. A parte interessante é o que você pode fazer com cada item após ele existir.

Formatação por item e editabilidade

Cada item de lista possui seus próprios atributos de exibição:

• Texto simples (o padrão)
• Negrito
• Itálico
• Negrito e itálico

Como isso se aplica por item, uma única lista pode misturar estilos — útil para sinalizar visualmente uma escolha padrão, uma opção obsoleta ou um cabeçalho de categoria dentro da lista.

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

Há também uma flag editável por item. Quando um item é marcado como editável, o usuário pode modificar essa entrada em vez de ficar preso ao texto predefinido.

Esta é uma distinção sutil, mas poderosa: permite que você forneça uma lista que é principalmente de vocabulário controlado, mas permite “válvulas de escape” de texto livre onde a empresa realmente precisa delas. Use com moderação — uma vez que os usuários possam editar itens da lista, suas garantias de consistência de dados enfraquecem e a geração de relatórios sobre esse campo torna-se mais difícil.

Itens filhos: listas hierárquicas

O recurso que mais surpreende os veteranos do FileMaker é o Adicionar Filho. Qualquer item de lista pode ter um subitem, e esse subitem pode ter seu próprio subitem, e assim por diante. Você está, efetivamente, construindo uma árvore.

Isso importa porque muitos vocabulários de negócios reais são hierárquicos:

• Categorias de produtos $\rightarrow$ subcategorias $\rightarrow$ SKUs
• Regiões $\rightarrow$ países $\rightarrow$ cidades
• Departamentos $\rightarrow$ equipes $\rightarrow$ funções
• Plano de contas $\rightarrow$ grupos de contas $\rightarrow$ contas individuais

No FileMaker, você normalmente modelaria isso com um auto-relacionamento e um portal, ou o achataria em uma única lista com convenções de nomenclatura. No 4D, você pode expressar a hierarquia diretamente no recurso de lista e deixar o objeto de formulário apresentá-la como um menu recuado. Essa é uma vantagem genuína para qualquer pessoa que esteja construindo seletores sobre dados de referência estruturados.

Como as listas são anexadas a objetos de formulário

Depois que uma lista existe, você a anexa a um objeto de formulário — mais comumente uma lista pop-up (também chamada de menu suspenso ou menu pop-up, dependendo do tipo de objeto e da versão). A mecânica:

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

• Selecione o campo ou objeto de variável no formulário no modo Design.
• Abra a lista de Propriedades do objeto.
• Encontre a propriedade Choice List / List e selecione sua lista nomeada no seletor.

Como a lista é referenciada por nome, a mesma lista pode alimentar um pop-up em um formulário de entrada, um formulário de pesquisa e um filtro de relatório — todos apontando para uma única definição. Altere a lista uma vez e todos os consumidores serão atualizados. Essa é a recompensa pela cerimônia extra no tempo de design.

Uma advertência prática: se você excluir ou renomear uma lista que objetos de formulário referenciam, esses objetos perderão sua lista silenciosamente em algumas versões. Antes de renomear, pesquise o nome antigo em seus formulários. Trate os nomes das listas como parte da interface pública do seu aplicativo.

Estilos de exibição: o que é mapeado de maneira limpa e o que não é

O FileMaker oferece quatro estilos de exibição para listas de valores. Veja como eles se traduzem para o 4D na prática.

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

Estilo de exibição do FileMaker	Equivalente 4D	Dificuldade no 4D
Popup List	Objeto de lista pop-up / suspensa	Simples — o ponto de partida recomendado
Popup Menu	Objeto de menu pop-up	Simples
Check Boxes	Objeto checkbox vinculado a uma lista	Significativamente mais complexo; normalmente requer múltiplos objetos ou um campo de lista de valores
Radio Buttons	Grupo de botões de rádio	Significativamente mais complexo; geralmente construído a partir de objetos de rádio individuais

O resumo honesto, e aquele que o material original da HPO Soft faz: apenas a Popup List é descrita aqui, porque é o caminho de menor resistência. Listas de valores de checkbox e botões de rádio são possíveis no 4D, mas são muito mais complexas do que suas contrapartes do FileMaker. Se você estiver migrando uma solução FileMaker e ela depender fortemente de listas de valores de checkbox, reserve tempo real para essa conversão — não é uma conversão direta de um para um.

Escolhendo a fonte correta da lista

Antes de abrir o Editor de Listas, decida de onde vêm os itens. Esta decisão direciona tudo a jusante.

• Lista personalizada estática — você digita os itens. Melhor para vocabulários pequenos e estáveis: códigos de status, saudações, níveis de prioridade, sim/não/desconhecido. Rápido de construir, sem custo em tempo de execução, mas cada alteração requer uma edição no modo de design e uma nova implantação.
• Lista derivada de valores de campo — os itens vêm de valores exclusivos já presentes em um campo. Melhor quando o vocabulário é orientado a dados e cresce organicamente, ex: um campo “tipo de cliente” preenchido por outras partes do sistema. A contrapartida: a lista é tão limpa quanto os seus dados, e não pode oferecer valores que ainda não existam em nenhum registro.
• Lista baseada em outro arquivo / lista relacionada — os itens vêm de uma tabela relacionada ou da lista de outro arquivo. Melhor para dados de referência compartilhados (uma tabela de pesquisa central de departamentos, moedas ou linhas de produtos) com os quais várias partes do aplicativo devem concordar. Esta é a opção mais sustentável para qualquer coisa que mude ao longo do tempo, porque você atualiza a tabela de origem, não a lista.

Uma regra prática útil: se mais de um formulário precisar da lista, ou se a lista for alterada sem a necessidade de um lançamento de código, alimente-a a partir de dados em vez de digitá-la. Listas estáticas servem para coisas que são genuinamente fixas — e coisas genuinamente fixas são mais raras do que as pessoas presumem.

Orientação prática e armadilhas comuns

Alguns hábitos conquistados a duras penas tornam o trabalho com listas no 4D muito menos doloroso:

• Nomeie listas com um prefixo e um propósito. Algo como lst_Status_Order ou lst_Region_Sales informa a um futuro mantenedor para que serve a lista e onde ela é usada. Evite nomes genéricos como List1.
• Construa a lista antes do objeto de formulário. Se você criar o pop-up primeiro, terá que editar as propriedades do objeto duas vezes.
• Mantenha listas estáticas curtas. Uma lista estática com cinquenta entradas é um passivo de manutenção; isso é uma lista orientada a dados fantasiada.
• Seja deliberado sobre itens editáveis. Cada item editável é uma brecha na validação de seus dados. Documente por que cada um existe.
• Use itens filhos para hierarquias genuínas, não para decoração. Recuos que não refletem um relacionamento real de pai e filho confundem mais os usuários do que ajudam.
• Cuidado com referências órfãs. Quando você descontinuar uma lista, use o grep em seus formulários para buscar o nome dela antes de excluí-la.

Para um contexto mais amplo sobre como o 4D se encaixa no cenário de low-code e desenvolvimento rápido de aplicações, a documentação da própria plataforma e os fóruns da comunidade são as fontes autoritativas; a documentação do desenvolvedor 4D cobre a interface atual do Editor de Listas, que evoluiu desde que o material clássico da HPO Soft foi escrito. Para informações sobre o modelo relacional que sustenta tabelas, campos e pesquisas, consulte o artigo da Wikipedia sobre o modelo relacional e, para a categoria geral de ferramentas à qual este trabalho pertence, a visão geral da Wikipedia sobre plataformas de desenvolvimento de baixo código é uma orientação útil.

Onde as listas se encaixam na construção maior

As listas de valores são a etapa seis em uma sequência que segue: criar um banco de dados → definir propriedades do banco de dados → definir tabelas → definir campos de dados → construir formulários → criar listas de valores → inserir dados de amostra. Observe que as listas vêm depois dos formulários e antes dos dados de amostra. Essa ordem é deliberada e vale a pena ser respeitada: você quer que seus objetos de formulário estejam no lugar para poder anexar listas a eles, mas quer que as listas estejam concluídas antes de começar a inserir registros de amostra, porque os dados de amostra são onde você descobrirá se suas listas realmente cobrem os casos do mundo real.

Se você pular etapas e inserir dados de amostra primeiro, verá que precisará reinserir registros toda vez que refinar uma lista. Faça as listas primeiro e depois preencha.

Perguntas Frequentes

Qual é a diferença entre uma lista de valores no FileMaker e uma lista no 4D?

O FileMaker define listas de valores no contexto do campo ou objeto de layout que as utiliza e oferece três fontes: itens personalizados, valores de registros ou de um relacionamento, e uma lista de outro arquivo. O 4D separa a definição do uso: você cria uma lista nomeada uma vez no Editor de Listas e depois anexa esse nome a qualquer número de objetos de formulário. A abordagem do 4D dá mais trabalho inicialmente, mas é muito mais fácil de manter quando muitos formulários compartilham o mesmo vocabulário.

O 4D pode criar listas de valores de caixas de seleção e botões de opção como o FileMaker?

Sim, mas é consideravelmente mais complexo do que no FileMaker. O FileMaker permite escolher “Caixas de Seleção” ou “Botões de Opção” como estilo de exibição diretamente em uma lista de valores.

No 4D, alcançar o mesmo comportamento normalmente requer múltiplos objetos de formulário ou um campo de lista de valores, e o material de treinamento original da HPO Soft cobre deliberadamente apenas a Lista Popup por esta razão. Planeje um tempo extra se estiver migrando uma solução FileMaker que dependa de listas de caixas de seleção.

O que são itens filhos em uma lista 4D e quando devo utilizá-los?

Um item filho é um subitem aninhado sob um item de lista pai, e o aninhamento pode continuar em qualquer profundidade. Use-os quando seu vocabulário for genuinamente hierárquico — categorias e subcategorias de produtos, regiões e cidades, departamentos e equipes. Não os use apenas para agrupamento visual, porque o recuo implica um relacionamento pai-filho que os usuários esperarão que signifique algo.

Devo usar uma lista estática ou uma lista baseada em dados?

Use uma lista personalizada estática para vocabulários pequenos e estáveis que raramente mudam, como códigos de status ou níveis de prioridade. Use uma lista derivada de valores de campo ou de um arquivo relacionado quando o vocabulário crescer com o tempo ou for compartilhado entre vários formulários. Uma boa regra: se a lista for mudar sem a necessidade de um lançamento de código, ou se mais de um formulário precisar dela, baseie-a em dados em vez de digitar os itens manualmente.

O que a opção “editável” em um item de lista faz?

Marcar um item de lista como editável permite que o usuário modifique essa entrada em vez de ficar restrito ao texto predefinido. É útil quando você deseja um vocabulário majoritariamente controlado, mas com algumas “válvulas de escape” de texto livre. Use com moderação, pois itens editáveis enfraquecem as garantias de consistência de dados e tornam a geração de relatórios desse campo menos previsível.

Em que momento do processo de construção devo criar minhas listas de valores?

Crie as listas depois que seus formulários existirem, mas antes de inserir dados de amostra. Você precisa dos objetos de formulário no lugar para poder anexar listas a eles por nome, e quer as listas concluídas antes da inserção de amostras para não ter que reinserir registros toda vez que refinar uma lista. Seguir a sequência — tabelas, campos, formulários, listas e, então, dados de amostra — evita retrabalho real.