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

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

A capacidade de passar valores a uma página da Web usando cadeias de caracteres da consulta representa um interesse de segurança.Microsoft Dynamics 365 aplicas as práticas recomendadas sempre comparando parâmetros no passado como uma cadeia de caracteres da consulta de uma lista de nomes e de tipos de dados esperados de parâmetros.

Por padrão, o Microsoft Dynamics 365 permite 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 os 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 do atributo. Para obter mais informações, consulte Definir valores de campo usando parâmetros transmitidos a um formulário.

Nos aplicativos, convém passar parâmetros personalizados de cadeia de caracteres de consulta a um formulário de entidade. Este tópico descreve informações sobre como é possível definir um conjunto de nomes de parâmetro e tipos de dados específicos que podem ser aceitos para um formulário de entidade específico.

Definir parâmetros de cadeia de caracteres de consulta permitidos

Há duas maneiras de especificar quais parâmetros de cadeia de caracteres de consulta serão aceitos pelo formulário:

• Editar propriedades de formulário

• Editar XML do formulário

Editar propriedades de formulário

Ao editar um formulário de entidade na guia Início, no grupo Formulário, clique em Propriedades do formulário. Na caixa de diálogo Propriedades do formulário, selecione a guia Parâmetros.

Use essa guia para alterar os nomes e os tipos de dados permitidos pelo formulário.

Editar FormXml

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

A seguir, há uma descrição dos atributos de elemento de querystringparameter: name and type:

• name. Cada atributo de nome precisa ter pelo menos um caractere sublinhado ('_'), mas o nome do parâmetro da cadeia de caracteres de consulta não pode começar com sublinhado. O nome também não pode começar com “crm_”. É altamente recomendável usar o prefixo de personalização do fornecedor de soluções como a convenção de nomenclatura. Um valor válido para valor de atributo de nome querystringparameter é “myISV_contact_specialvalue”.

  Importante

  Se um nome de elemento querystringparameter não for exclusivo, ele pode ser substituído por outra definição de parâmetro usando um tipo de dados diferente.

• Tipo. Corresponda os valores do tipo de dados com os valores de parâmetro de modo que os dados inválidos não sejam passados com o parâmetro. Os seguintes tipos de dados são válidos:

  • Boolean

  • DateTime

  • Double

  • EntityType

  • Integer

  • Long

  • PositiveInteger

    Observação

    PositiveInteger inclui “0” no intervalo de valores válidos.

  • SafeString

  • UniqueId

  • UnsignedInt

Confira Também

Definir valores de campo usando parâmetros transmitidos a um formulário
Abrir formulários, exibições, caixas de diálogo e relatórios com uma URL

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais