Propriedades de formulários de aplicativos controlados por modelos

Importante

A partir de outubro de 2023, os designers clássicos de aplicativos, formulários e exibições serão preteridos e todos os aplicativos baseados em modelo, formulários e exibições serão abertos somente nos designers modernos. Por padrão, o comando Alternar para clássico para reverter do designer moderno para o designer clássico não estará mais disponível. Mais informações: Os designers clássicos de aplicativos, formulários e exibições serão preteridos

Recomendamos que você faça a transição para usar os designers modernos para criar e editar seus aplicativos baseados em modelo e componentes.

Este artigo descreve o gerenciador de soluções clássico. Recomendamos que você use o designer de formulários moderno para editar propriedades para seus formulários de aplicativos baseados em modelo. Mais informações: Configurar um formulário e Configurar manipuladores de eventos de formulário de aplicativo baseados em modelo

Você pode acessar as Propriedades do formulário no gerenciador de soluções. Em Componentes, expanda Tabelas, expanda a tabela desejada e, em seguida, selecione Formulários. Na lista de formulários, abra o formulário do tipo Principal. Em seguida, na guia Início, selecione Propriedades do Formulário.

Propriedades do formulário.

A seguinte tabela lista as propriedades do formulário:

Guia Propriedade Descrição
Eventos Bibliotecas de formulários Gerencie quais recursos JavaScript da Web estão disponíveis no formulário e a ordem em que serão carregados.
Manipuladores de eventos Configure quais funções JavaScript das Bibliotecas de Formulários serão executadas para os eventos de formulário OnLoad e OnSave e a ordem em que serão executadas.
Tela Nome do Formulário Digite um nome que faça sentido para as pessoas. Esse nome será exibido quando os usuários utilizarem o formulário. Se eles puderem usar vários formulários configurados para a tabela, usarão esse nome para distinguir os formulários disponíveis.
Descrição Insira uma descrição que explica como esse formulário é diferente de outros formulários principais. Essa descrição será exibida apenas na lista de formulários para uma tabela no gerenciador de soluções.
Assistente de Formulário Marque a caixa de seleção se quiser habilitar o assistente de formulário ou para exibir o formulário como expandido por padrão.
Navegação de Página Você pode optar por não mostrar itens de navegação.

Em formulários de tabelas atualizáveis, isso significa que o valor do nome primário da linha visualizada no momento não aparecerá na barra de navegação, para permitir a navegação para exibições associadas.

Em formulários usando a apresentação clássica, as opções de navegação para selecionar exibições associadas no lado esquerdo do formulário não serão mostradas.
Image Quando uma tabela tem uma coluna de imagem e a opção Imagem Primária das entidades é definida, essa configuração permite mostrar a coluna de imagem no cabeçalho desse formulário.

Consulte Habilitar ou desabilitar opções de tabela para obter mais informações sobre opções de tabela.
Tela Definir a largura máxima (em pixels) para limitar a largura do formulário. O valor padrão é 1900.
Tela Especifique a largura máxima em pixels que deseja para o formulário aqui.
Parâmetros Parâmetros Cada formulário pode ser aberto com código usando uma URL. A URL também pode conter dados que podem ser passados ao formulário usando uma query string que é anexada à URL. As strings de consulta se parecem com este exemplo:
?p_firstName=Jim&p_lastName=Daly

Como uma medida segurança, os formulários não aceitarão qualquer parâmetro da cadeia de caracteres de consulta desconhecido. Use esta lista de parâmetros para especificar parâmetros que esse formulário deve aceitar para apoiar o código que irá transmitir os dados para os formulários usando uma cadeia de caracteres de consulta.

O nome e o tipo de dados serão verificados e o formulário não será aberto se os parâmetros de cadeia de caracteres de consulta inválidos forem passados para ele.

Observação: o nome não pode começar com um sublinhado (_) ou crm. Ele deve iniciar com caracteres alfanuméricos seguidos de um sublinhado (_). Por exemplo, parameter_1 ou 1_parameter. O nome não pode conter hífen (-), dois pontos (:), ponto e vírgula (;), vírgula (,) ou ponto (.).

Você também pode definir esses dados editando o FormXml
Dependências Fora do Evento Colunas Dependentes Cada manipulador de eventos tem uma propriedade Colunas Dependentes semelhantes para que qualquer coluna necessária pelo script possa ser registrado. Qualquer pessoa que tentar remover as colunas dependentes não conseguirá.

Alguns scripts funcionam no formulário, mas não estão configurados em um manipulador de eventos. Os scripts iniciados na barra de comandos não têm um local onde as colunas dependentes possam ser registradas. Esta propriedade do formulário disponibiliza um local onde as colunas dependentes para esses scripts podem ser registradas.

Próximas etapas

Usar o formulário principal e seus componentes