Configuración parámetros del asistente

Jose Palomo — Thu, 30 Jun 2022 15:36:41 +0000

Los parámetros de configuración forman parte de unas expresiones que definen las peticiones de datos, controles, formato y acciones a realizar por el asistente.

Las expresiones se deben iniciar con los siguientes símbolos "" y se debe finalizar con ">", entre ambos (símbolos) se encontrarán los parámetros de configuración.

A continuación, se detallan los atributos de los parámetros de configuración para el diseño de un asistente, así como los valores que admiten:

Atributo	Tipo de dato	Descripción
Name	String	Nombre del parámetro.
Text	String	Texto de la etiqueta en el asistente.
Type	String	Tipo de dato del parámetro (String, Date, Datetime, Boolean, Decimal, Double, Single, Byte, Int16, Int32, Int64, Short, Integer y Long).
Length	Int32	Longitud del parámetro para el tipo texto (String).
Style	String	Permite indicar el estilo de control dependiendo del tipo: STRING – EMAIL: valida la información solo permitiendo e-mail. – URL: valida la información solo permitiendo direcciones url. – GPS: valida la información solo permitiendo posiciones gps. – LETTERS: valida la información solo permitiendo introducir letras y algunos símbolos. (AÁBCDEÉFGHIÍJKLMNÑOÓPQRSTUÚÜVWXYZaábcdeéfghiíjklmnñoópqrstuúüvwxyz ,;.) – ABECEDARY: sólo permite introducir las letras del abecedario. (ABCDEFGHIJKLMNÑOPQRSTUVWXYZabcdefghijklmnñopqrstuvwxyz) – ABECEDARYANDNUMBERS: sólo permite introducir los números y las letras del abecedario. (0123456789ABCDEFGHIJKLMNÑOPQRSTUVWXYZabcdefghijklmnñopqrstuvwxyz) – MASKEDIT;máscara: valida la información mediante la máscara de estilo indicada (0:número, #:número opcional, L:letra, l:letra opcional, A:alfanúmerico, a:alfanúmerico opcional) – VALIDCHARACTERS;caracteres: permite validar la información sólo permitiendo introducir los caracteres indicados. – INVALIDCHARACTERS;caracteres: permite validar la información no permitiendo introducir los caracteres indicados. – REGULAREXPRESSION;expresión: permite validar la información mediante la expresión regular indicada en el parámetro. – OPENFILE;filtros;extensión: muestra un botón que permite seleccionar un archivo utilizando el cuadro de dialogo para abrir un archivo. También se pueden incluir filtros de las extensiones y la extensión por defecto. – OPENFILESERVER;carpeta;subcarpeta;filtro: muestra un botón que permite seleccionar un archivo de una carpeta (PrintForm, PrintReports, Templates, Certificates, …) del servidor utilizando el cuadro de dialogo para abrir un archivo. También se puede incluir un filtro de los archivos a mostrar. – SAVEFILE;filtros;extensión: muestra un botón que permite seleccionar un archivo utilizando el cuadro de dialogo para guardar un archivo. También se pueden incluir filtros de las extensiones y la extensión por defecto. – FOLDERBROWSER: muestra un botón que permite seleccionar una carpeta utilizando el cuadro de dialogo de explorador de carpetas. – ACCOUNTINGACCOUNT;autocompletado: permite validar la información de una cuenta contable solamente permitiendo dígitos o un punto si se utiliza un tipo de autocompletado. Tipo de autocompletado (autocompleteType): nunca (sin valor), usando un punto (P) o autocompletar siempre (S). Nota: si establece un asterisco () delante del estilo entonces el control se convierte en un control para contraseñas. Por ejemplo: STYLE=`"`**`"` o STYLE=`"`LETTERS`"` DATE/DATETIME* – TIMESHORT: permite establecer el estilo del control en formato de hora y minuto. – TIME: permite establecer el estilo del control en formato de hora, minuto y segundo. – DATE: permite establecer el estilo del control en formato de fecha. – DATETIME: permite establecer el estilo del control en formato de fecha y hora.
Round	Int32	Decimales de redondeo del valor.
MinValue	Int32	Valor mínimo admitido para tipos numéricos.
MaxValue	Int32	Valor máximo admitido para tipos numéricos.
Width	Int32	Ancho del control en el asistente, se establecerá un ancho por defecto en caso de omisión o el valor inferior a cero.
TextWidth	Int32	Ancho de la descripción del campo.
Margin	Int32	Margen que debe dejar con el control anterior.
Default	String	Valor asignado por defecto (se admite el uso de marcadores).
Required	Boolean	Permite indicar que el valor del parámetro es requerido.
Step	Int32	Número del paso donde aparecerá el control. En el caso de no indicarse aparecerán por delante de los parámetros del paso 1.
StepText	String	Texto del paso o pantalla del asistente. Sólo es necesario indicar en el primer parámetro que haga referencia al paso.
StepCaption	String	Texto de la leyenda o título del paso en el asistente. Sólo es necesario indicar en el primer parámetro que haga referencia al paso.
Table	String	Tabla de la cual obtener el dato o tablas de la expresión, en cuyo caso los nombre de las tablas deben separarse por comas.
Field	String	Nombre del campo del cual se obtiene el dato.
FieldText	String	Nombre del campo descriptivo del parámetro
Fields	String	Campos que se mostrarán en la tabla de la lista de valores de la tabla.
Filter	String	Filtro que se empleará en la selección del dato al mostrar las filas de una tabla.
Subprocess	String	Código del subproceso correspondiente a la configuración y filtro a utilizar al mostrar la lista de selección de la tabla.
Order	String	Campo por el que se ordenará en la tabla de la lista de valores de la tabla.
List	String	Lista de texto y valores. Los valores de la lista se deben establecer de la siguiente forma: – Formato para las listas de valores: Texto1;Valor1\|Texto2;Valor2\|…\|TextoN;ValorN – Formato para listas de una tabla: Campo_Texto;Campo_Clave – Formato para campos booleanos: Valor_True\|Valor_False – Lista de los meses del año usando marcadores: {=ListMonths()}
ListMultiSelect	Boolean	Permiten indicar si se permite selección múltiple en la lista.
Rows	Int32	Filas o líneas del control en el asistente. Si el control es una lista entonces el estilo dependerá de las filas: – Si el valor es menor de 0 entonces será una lista desplegable y editable. – Si el valor es 0 (por defecto) o 1 entonces será una lista desplegable. – Si el valor es mayor de 1 entonces será un cuadro de lista.
Enabled	Boolean	Permite indicar si el control se encuentra activado. Por defecto los controles se encuentran activados.
ReadOnly	Boolean	Permite indicar si el control es de solo lectura y no admite la edición.
Tag	String	Atributo sin funcionalidad que contiene información referente al parámetro.
Bindings	String	Este atributo nos permite enlazar datos con otros parámetros. A continuación, se describen los formatos y propiedades a las que afectan: – Formato para traspasar valor a la propiedad: NombrePRM1;Propiedad\|NombrePRM2;Propiedad\|NombrePRM3,NombrePRM4;Propiedad – Formato para interactuar con las propiedades: Valor;NombrePRM1;Propiedad;Valor_Propiedad[;ValorContrario_Propiedad] \|Valor;NombrePRM2;Propiedad;Valor_Propiedad[;ValorContrario_Propiedad] \|Valor; NombrePRM3,NombrePRM4;Propiedad;Valor_Propiedad [;ValorContrario_Propiedad] Propiedades accesibles: – ENABLED – READONLY – LIST – VALUE – DEFAULT …

Configuraciones especiales para los asistentes de parámetros

Se utilizará el parámetro para establecer distintas configuraciones sobre la funcionalidad del asistente de parámetros. A continuación se detallan los distintos atributos, así como los valores que admiten:

Atributo	Tipo de dato	Descripción
Delimiter	String	Determina el separador que se utilizará para entre los distintos valores que componen el parámetro.
Warning	String	Texto descriptivo de la advertencia a mostrar.
Users	Boolean	Permite indicar si permite la configuración del parámetro por usuario (por defecto si se permite).

Ejemplo:

Diseño de asistentes de notas

Jose Palomo — Thu, 30 Jun 2022 12:40:39 +0000

El diseño del asistente de notas se debe realizar usando la opción Asistente de notas en Menú / Mantenimiento de Tablas / Configuraciones.

La pantalla de configuración de Asistente de notas se encuentra dividida en tres secciones que se detallaran a continuación:

General: contiene la información general del asistente.
Parámetros: es la parte donde se definen los parámetros que diseñan el asistente.
Expresiones: donde se definen las expresiones o sentencias que utilizando los parámetros del asistente permitirán obtener la información deseada en la nota.

Sección general

En la sección general se definirán los siguientes campos:

Nombre: especifica el nombre del asistente.
Tipo de nota exclusiva: específica en qué tipos de nota aparecerá el asistente.
Descripción: se utiliza para incluir una descripción detallada, la cual aparecerá en la primera pantalla del asistente.

Sección de parámetros

Dentro de esta sección se encuentra la configuración de los parámetros del asistente, definen mediante unas expresiones cada uno de los parámetros o peticiones de datos que realizará el asistente, y para ello se utilizarán una serie de propiedades dentro de la expresión para definir el control, formato y acciones a realizar.

Las expresiones se deben iniciar con los siguientes símbolos "" y se debe finalizar con ">", entremedias de estos símbolos se encontrarán las propiedades.

Sección de expresiones

En esta sección se encuentra la configuración de las expresiones o sentencias que utilizando los parámetros permitirán obtener la información que se desea presentar en el asistente, además permite generar una estructura de datos y parámetros para poder diseñar el asistente.

Además de las sentencias SQL que se utilizarán en el asistente se pueden utilizar los parámetros con el fin de adaptar la sentencia dependiendo de los valores elegidos por el usuario en el asistente.

Podemos incluir también comentarios en las expresiones del asistente utilizando la siguiente sintaxis ""

Para utilizar los parámetros en la definición de la sentencia SQL se debe hacer referencia al parámetro mediante la etiqueta "'nombre del parámetro'>" y finalizando con "". Entremedias de las etiquetas se definirá la parte de SQL que se incluirá en la sentencia principal en el caso de que el parámetro contenga un valor, de forma que dicho valor se sustituye en todos lugares de la expresión donde encuentre "{0}".