Configurar um formulário para aceitar parâmetros de cadeia de caracteres de consulta personalizados

Os parâmetros de cadeia de caracteres de consulta personalizados permitem passar valores esperados para formulários de aplicativo controlados por modelo ao validar nomes de parâmetros e tipos de dados. Este artigo explica como configurar parâmetros permitidos para que você possa definir valores padrão com segurança ao criar registros.

Por padrão, aplicativos controlados por modelo permitem que um conjunto especificado de parâmetros de cadeia de caracteres de consulta seja passado para um formulário. Você usa esses parâmetros para definir valores padrão ao criar um novo registro no aplicativo. Cada parâmetro deve usar uma convenção de nomenclatura padrão que inclua uma referência ao nome lógico da coluna. Para obter mais informações, consulte Definir valores de coluna usando parâmetros passados para um formulário.

Em seus aplicativos, talvez você queira passar parâmetros de cadeia de caracteres de consulta personalizados para um formulário. Este artigo fornece informações sobre como você pode definir um conjunto de nomes de parâmetros específicos e tipos de dados que você pode aceitar para um formulário específico.

Definir parâmetros da cadeia de consulta permitidos

Há duas maneiras de especificar quais parâmetros de cadeia de caracteres de consulta o formulário aceitará:

• Editar propriedades do formulário com o editor clássico
• Editar XML de formulário

Editar propriedades do formulário

Ao editar um formulário usando o editor de formulário moderno, conforme descrito em Abrir o editor de formulário de aplicativo orientado por modelo, selecione o botão de reticências no menu e, em seguida, selecione Alternar para clássico.

1. Na guia Página Inicial , no grupo Formulário , selecione Propriedades do Formulário.

   

2. Na caixa de diálogo Propriedades do Formulário, selecione a guia Parâmetros.

   

   Use essa guia para modificar os nomes e tipos de dados que o formulário permite.

Saiba mais sobre:

• O editor de formulário clássico
• Propriedades do formulário de aplicativo baseado em modelo

Editar FormXml

Dentro do arquivo customizations.xml da solução exportada, imediatamente após o elemento de rodapé, você pode adicionar um elemento <formparameters>. <formparameters> No elemento, adicione <querystringparameter> elementos para especificar quais parâmetros são permitidos.

A tabela a seguir descreve os parâmetros do elemento name, querystringparameter e type:

name

Cada coluna de nome deve conter pelo menos um caractere de sublinhado (_), mas o nome do parâmetro de cadeia de caracteres de consulta não pode começar com um sublinhado. O nome também não pode começar com crm_. Use o prefixo de personalização do publicador da solução como convenção de nomenclatura. Não use o mesmo nome para o querystringparameter que o nome de uma coluna da tabela. Um valor de nome válido querystringparameter é myISV_contact_specialvalue.

Importante

Se um querystringparameter nome de elemento não for exclusivo, outra definição de parâmetro que usa um tipo de dados diferente poderá substituí-lo.

Type

Corresponda os valores de tipo de dados com os valores de parâmetro para que o parâmetro não passe dados inválidos. Os seguintes tipos de dados são válidos:

• Boolean
• DateTime
• Double
• EntityType
• Integer
• Long
• PositiveInteger (Inclui "0" no intervalo de valores válidos)
• SafeString
• UniqueId
• UnsignedInt

Consulte também

Definir valores de coluna usando parâmetros passados para um formulário
Abrir formulários e exibições com uma URL
Visão geral do editor de formulários clássico
Propriedades do formulário de aplicativo baseado em modelo