Configuración de un formulario para aceptar parámetros de cadena de consulta personalizados

Los parámetros de cadena de consulta personalizados permiten pasar valores esperados a formularios de aplicación controlados por modelos al validar los nombres de parámetros y los tipos de datos. En este artículo se explica cómo configurar parámetros permitidos para que pueda establecer valores predeterminados de forma segura al crear registros.

De forma predeterminada, las aplicaciones basadas en modelos permiten que un conjunto de parámetros de cadena de consulta especificado pase a un formulario. Use estos parámetros para definir los valores predeterminados al crear un nuevo registro en la aplicación. Cada parámetro debe usar una convención de nomenclatura estándar que incluye una referencia al nombre lógico de la columna. Para obtener más información, consulte Establecer los valores de columna mediante parámetros que se pasan a un formulario.

En sus aplicaciones, puede que quiera pasar parámetros personalizados de la cadena de consulta a un formulario. En este artículo se proporciona información sobre cómo definir un conjunto de nombres de parámetros y tipos de datos específicos que puede aceptar para un formulario específico.

Definir parámetros de cadena de consulta permitidos

Hay dos maneras de especificar qué parámetros de cadena de consulta aceptará el formulario:

• Editar propiedades del formulario con el editor clásico
• Editar XML de formulario

Edición de propiedades de formularios

Al editar un formulario con el editor de formularios moderno, como se describe en Abrir el editor de formularios de aplicaciones basadas en modelos, seleccione los puntos suspensivos del menú y, a continuación, seleccione Cambiar a clásico.

1. En la pestaña Inicio , en el grupo Formulario , seleccione Propiedades del formulario.

   

2. En el cuadro de diálogo Propiedades del formulario, seleccione la pestaña Parámetros.

   

   Use esta pestaña para modificar los nombres y los tipos de datos que permite el formulario.

Obtenga más información sobre:

• Editor de formularios clásico
• Propiedades del formulario de aplicación controlada por modelos

Editar FormXml

En el archivo exportado de la solución customizations.xml, inmediatamente después del elemento de pie de página, puede agregar un elemento de <formparameters>. En el <formparameters> elemento , agregue <querystringparameter> elementos para especificar qué parámetros se permiten.

En la tabla siguiente se describen los parámetros del elemento name, querystringparameter y type:

name

Cada columna de nombre debe contener al menos un carácter de subrayado (_), pero el nombre del parámetro de cadena de consulta no puede comenzar con un carácter de subrayado. El nombre tampoco puede empezar por crm_. Use el prefijo de personalización del publicador de soluciones como convención de nomenclatura. No use el mismo nombre para querystringparameter que el de una columna de la tabla. Un valor de nombre válido querystringparameter es myISV_contact_specialvalue.

Type

Haga coincidir los valores del tipo de datos con los valores del parámetro para evitar que el parámetro admita datos no válidos. Los siguientes tipos de datos son válidos:

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

Consultar también

Establecer valores de columna usando parámetros pasados a un formulario
Abrir formularios y vistas con una dirección URL
Introducción al editor de formularios clásico
Propiedades del formulario de aplicación controlada por modelos