Prompt Macro... ese gran desconocido. Definición, Sintaxis y Definición de Parámetros

Hola de nuevo.

A petición popular (1 persona) me he animado a comenzar una serie de posts que hablaran sobre la potencia de la sentencia macro prompt y de su hermana promptmany en el entorno BI de Cognos y como utilizarlas en nuestros informes.


Para empezar de una forma académica vamos con la definición y su sintaxis

¿Que es una sentencia prompt macro?. 
Prompt, es una sentencia que solicita al usuario un valor y lo almacena en un parámetro.

¿Y la sentencia promptmany?
También tenemos la sentencia Promptmany, que solicita al usuario uno o más valores y los almacena en un parámetro, como veis es igual que prompt con multiselección.

Sintaxis
Prompt ( Nombre Prompt, Tipo de dato, Valor por Defecto, Texto, Query Item, Texto al final )

¡Se me olvidaba! , una sentencia de este tipo, que es una sentencia macro, siempre comienza y finaliza con almohadilla (#).

Ejemplo
#Prompt ('Moneda';'string';'Dolar')#

El parámetro Moneda tendrá el valor Dolar.

Parámetros
Nombre Prompt. Este es el nombre del parámetro, que almacena el contenido de nuestro prompt.

Tipo Dato. Aqui se especifica el tipo de dato que esperamos recibir a traves del prompt. Los diferentes tipos de dato son:

• boolean
• date
• datetime
• decimal
• double
• float
• int
• integer
• interval
• long
• memberuniquename -- Memberuniquename is not an actual data type. Use it in cases when the data type of the parameter is a member unique name (MUN). For example, use the syntax #prompt('Parameter', 'memberuniquename')#.
• numeric

• real
• short
• string
• time
• timeinterval
• timestamp
• token -- Token is not an actual data type. It is a way to pass SQL. A token does not pass values.
• xsddate
• xsddatetime
• xsddecimal
• xsddouble
• xsdduration
• xsdfloat
• xsdint
• xsdlong
• xsdshort
• xsdstring
• xsdtime

Como veis son multitud, aunque en mi caso personal utilizo solo dos tipos, que son los que he marcado en negrita, en el 99% de las ocasiones y ademas son los únicos que no son tipos de dato

token: Esto no es un tipo de dato, simplemente se indica que se pasa el valor que introduce el usuario a traves del teclado.

memberuniquename. Tampoco es un tipo de dato 'tradicional'. Lo uso cuando quiero utilizar un miembro de un cubo. Actualmente casi todos los informes que preparo son con origenes OLAP, por lo que lo uso mucho.


Valor por defecto: Este parámetro me permite introducir el valor por defecto que tiene el parámetro. Por ejemplo en el ejemplo que he puesto mas arriba el valor por defecto es Dolar.


Por ahora no me enrollo mas. En otro post continuaré explicando el resto de los parametros y los ilustrare con ejemplos.

Y como dice el gran David de Jorge: ' Iluminaros la vida '