Construtor de Interface

O construtor permite reestruturar a tabela de acordo com suas necessidades: ocultar colunas desnecessárias, alterar sua ordem, renomear cabeçalhos, adicionar uma coluna com um valor que não está inicialmente na tabela. A configuração da tabela pode ser feita com cliques ou descrita em palavras — a solicitação será processada por um modelo de IA. Nas páginas de edição de registros e nas abas das seções, o construtor oculta e reorganiza abas, blocos e campos do conjunto de atributos.

A configuração está vinculada a uma tela específica e não afeta as demais. A configuração finalizada pode ser salva como preset — assim, todos os administradores do projeto poderão vê-la, e um administrador com permissão de atribuição poderá torná-la a visualização padrão para os colegas (veja Atribuição de configurações a outros administradores).

É necessário pelo menos um agente de IA

A solicitação em palavras é executada pelo modelo, e o modelo é retirado das contas na aba Configurações → Agentes de IA. No painel do construtor, ele é selecionado pelos campos Conta de IA e Modelo de IA. Se não houver nenhuma conta, não será possível enviar a solicitação — restará apenas a montagem manual com cliques.

Direitos de Acesso

O construtor é gerenciado por dois direitos do grupo de administradores na aba Configuração de direitos para módulos do cartão do administrador (veja Edição de administrador):

Direito	O que oferece
uiComponentConfigs.edit — configuração de telas para si mesmo	engrenagem das colunas, painel do construtor, presets, configuração de páginas de registros e abas de seções
uiComponentConfigs.assign — atribuição de configurações de telas a outros	aba de atribuição de configurações no cartão do administrador, alteração e exclusão de presets salvos por outros administradores

Sem o direito uiComponentConfigs.edit, o construtor não mostra nada nas telas — nem engrenagens, nem botões, nem painel, mesmo com o modo ativado. Os mesmos direitos são verificados pelo servidor: a interface apenas oculta o que não está disponível.

Como Ativar

O modo construtor é ativado pelo botão com o ícone de equalizador no cabeçalho do aplicativo. É um interruptor: com o modo ativado, o ícone fica iluminado. O modo é necessário para o painel do construtor, presets e configuração de páginas de registros. A engrenagem das colunas acima das tabelas é visível mesmo com o modo desativado — veja Engrenagem das colunas.

Após a ativação, aparecem botões acima da tabela:

Botão	Função
Engrenagem	seleção das colunas da tabela — a mesma que fora do modo
Construtor	abre o painel de configuração desta tabela
Presets	lista de configurações salvas da tela
Ícone de desfazer	desfaz a última alteração na configuração; aparece quando há algo a desfazer
Ícone de redefinir	retorna a tabela à aparência padrão

O construtor está conectado a tabelas e formulários em todas as seções do aplicativo. Como ele aparece nas páginas de edição de registros — na seção Páginas de registros e abas de seções.

Engrenagem das Colunas

Acima de cada tabela à qual o construtor está conectado, há um botão com o ícone de engrenagem. Ele é visível para o administrador com o direito uiComponentConfigs.edit sempre, mesmo quando o modo construtor está desativado: para mostrar ou ocultar uma coluna, o painel com o modelo de IA não é necessário.

A engrenagem abre uma lista de colunas da tabela com três grupos de caixas de seleção:

Grupo	O que contém	O que faz a caixa de seleção
colunas padrão	colunas próprias da tabela	caixa desmarcada oculta a coluna
campos adicionais	campos embutidos de registros que a tabela não mostra por padrão	caixa marcada adiciona uma coluna com esse campo
atributos	atributos de conjuntos que podem estar nos registros desta tela	caixa marcada adiciona uma coluna com o valor do atributo

Um atributo que não está presente em nenhum registro na tela é exibido em um tom claro com uma dica: sua coluna ficará vazia. Um campo que já foi exibido em uma das colunas padrão pode aparecer também entre os campos adicionais — se marcado, a tabela terá uma segunda coluna com os mesmos dados.

Ocultar uma coluna não remove os controles das linhas: arrastar, caixa de seleção de linha e botões de expansão se movem para a primeira coluna visível.

Valores longos de atributos em uma célula são mostrados de forma abreviada: texto HTML — o início do texto sem formatação, JSON — em uma linha, imagens — em miniaturas. Ao lado de tal valor, há um ícone de olho: clicar no valor o abre completamente em uma nova janela — texto HTML renderizado, JSON no visualizador, imagens em tamanho real.

Na parte inferior da lista, há um botão de redefinição das configurações da tabela. Ele remove toda a configuração desta tabela no seu navegador, incluindo alterações feitas através do painel do construtor. A engrenagem e o painel escrevem na mesma configuração: uma coluna adicionada por solicitação e uma coluna marcada com a caixa de seleção coexistem.

Páginas de Registros e Abas de Seções

Com o modo ativado, o construtor também funciona nas páginas de edição de registros: administrador, página de conteúdo, produto, coleção, modelo, bloco, slide de bloco, formulário, evento, desconto, armazenamento de pedidos, usuário, grupo de usuários, provedor de autorização e permissões de usuários. As abas que são mostradas nas seções do menu também são configuradas.

O que pode ser configurado:

• abas — cada aba recebe um ícone de olho (ocultar ou mostrar) e pode ser arrastada para outro lugar. A última aba visível não pode ser ocultada;
• blocos da página de edição — ícone de olho e arraste, onde os blocos estão conectados ao construtor;
• campos do conjunto de atributos — ícone de olho e arraste para cada campo.

Elementos ocultos no modo construtor permanecem na tela atenuados, para que possam ser recuperados; após desativar o modo, eles desaparecem. A configuração altera apenas a aparência: um campo oculto ainda participa das verificações do formulário.

Abas e blocos são configurados para toda a tela, enquanto os campos são configurados separadamente para cada conjunto de atributos: não se sabe de antemão qual conjunto estará no registro aberto. Portanto, cada área tem seu próprio painel de ferramentas — acima das abas e acima dos campos do conjunto:

Botão	Função
configurações	lista de configurações salvas desta área (na interface em português — "Configurações")
salvar configuração atual	salva a configuração da área sob o nome especificado (na interface em português — "Salvar atual")
Ícone de desfazer	desfaz a última alteração nesta área
Ícone de redefinir	retorna abas e blocos ou campos do conjunto à aparência padrão

O botão Construtor não está presente nas páginas de registros — abas, blocos e campos são configurados apenas com o ícone de olho e arraste.

Painel do Construtor

O painel é aberto pelo botão Construtor e intitulado Construtor de Tabelas.

Seleção de modelo. Os campos Conta de IA e Modelo de IA determinam qual conta e qual modelo processarão a solicitação. A seleção é comum para todo o construtor, e não para uma tabela específica — não é necessário defini-la em cada tela novamente.

Solicitação em palavras. No campo O que mudar?, descreve-se o resultado desejado em linguagem comum, por exemplo, "remova a coluna URL e mostre a quantidade de produtos". Abaixo, sob o título Ou comece com um pronto, há exemplos prontos — eles são inseridos com um clique: ocultar coluna, linhas compactas, seu texto de estado vazio, quantidade de produtos na categoria e outros. A solicitação é enviada pelo botão Aplicar.

Pré-visualização. A resposta do modelo é mostrada como uma lista de alterações compreensíveis, e a configuração é aplicada apenas após confirmação — enquanto você não concordar, a tabela não muda.

Atualmente configurado. A seção mostra o que está configurado agora: "alterações desta tabela, cada uma pode ser removida separadamente". Aqui também está o bloco Visibilidade da coluna — clicar no ícone de olho oculta a coluna ou a retorna.

Compilar manualmente. Montagem manual sem modelo: passo a passo, escolhe-se o que mostrar, a fonte do valor e o campo necessário. Conveniente quando é mais fácil escolher da lista do que formular em palavras.

O que mais pode ser configurado. Ajuda compacta sobre o que mais o construtor pode fazer nesta tela — útil quando não está claro como formular a solicitação.

Colunas Calculadas e Fontes de Dados

Uma coluna pode mostrar um valor que não está na linha — por exemplo, a quantidade de produtos em uma categoria. De onde obtê-lo é descrito pela fonte: um caminho pré-definido para a API com parâmetros. Endereços arbitrários não são aceitos, apenas registros do catálogo de fontes.

O catálogo consiste em fontes embutidas e criadas por administradores. Se não houver uma adequada, o construtor sugerirá procurar na API: o agente encontrará candidatos, fará uma solicitação de teste em uma linha real e mostrará os valores recebidos — o campo é escolhido com base nos dados reais, e não na descrição.

O agente também pode montar uma fonte sob solicitação. Tal fonte inicialmente não está salva: a coluna com ela já mostra dados ao vivo — isso é a verificação, e acima da pré-visualização aparece um cartão da nova fonte. Nele, são nomeados a fonte, a operação da API chamada e os campos da resposta, de onde os valores são retirados. Um botão do cartão salva a fonte no catálogo, outro a descarta — então, todas as colunas que a referenciam são removidas da configuração e da proposta ainda não aplicada. A fonte não salva vive apenas até a recarga da página; ao salvar um preset, as fontes usadas pela coluna são salvas automaticamente.

nota

A busca por fontes leva mais tempo do que as outras operações.

Salvamento e Reutilização

Enquanto a configuração não estiver salva, ela é armazenada apenas no seu navegador. O salvamento a envia para o servidor sob o nome especificado — após isso, o preset está disponível para todos os administradores do projeto na lista Presets (nas páginas de registros — na lista de configurações de sua área), de onde pode ser aplicado.

O autor pode excluir ou alterar seu próprio preset. Um preset salvo por outro administrador não pode ser alterado ou excluído sem o direito uiComponentConfigs.assign. Um preset atribuído a pelo menos um administrador não pode ser excluído por ninguém: o servidor recusará e informará a quantos administradores ele foi atribuído — primeiro, remova a atribuição.

O botão de redefinição remove a configuração que está armazenada no seu navegador e retorna a tabela à aparência original. Presets salvos permanecem.

Atribuição de Configurações a Outros Administradores

Um administrador com o direito uiComponentConfigs.assign pode definir como as telas aparecem para os colegas por padrão. Para isso, no cartão do administrador (seção Administradores) há uma aba separada para atribuição de configurações de telas (na interface em português — "Configurações de telas"). Sem esse direito, a aba não está disponível.

Na aba, são listadas apenas as telas para as quais há presets salvos, em três grupos:

• páginas de registros — uma linha por tela: uma linha separada para abas e blocos e uma linha para cada conjunto de atributos para o qual há presets, com um contador de linhas atribuídas;
• abas de seções — quais abas são visíveis na própria seção do menu e em que ordem;
• tabelas e formulários — uma linha por tela.

Em cada linha, um preset é selecionado a partir de um menu suspenso; limpar a lista remove a atribuição. Uma notificação informa sobre o sucesso ou erro.

A visualização atribuída é aplicada na próxima entrada do administrador no painel — se a atribuição for mais recente do que a que já foi aplicada em seu navegador. A atribuição feita após as próprias edições do administrador substitui-as; uma simples recarga da página não altera sua própria visualização. Depois, o administrador pode mudar a visualização para si — até a próxima atribuição. Se a atribuição for removida, a tela retorna à visualização padrão, a menos que o administrador tenha conseguido alterá-la.