Filtros y criterios de selección de tablas de consulta

Los atributos utilizados en una expresión hacen referencia a los atributos de tabla de consulta. En función de la ubicación de la expresión, están disponibles distintos atributos. Para el desarrollador de cliente, los filtros de consulta pasados a la API de tabla de consulta son la única ubicación donde se pueden utilizar expresiones. Para desarrolladores de tablas de consulta compuestas, existen otras varias ubicaciones donde se pueden utilizar expresiones. En la tabla siguiente se describen los atributos disponibles en las distintas ubicaciones.

En la figura siguiente se muestran las diversas ubicaciones de filtros y criterios de selección en expresiones, y se incluyen ejemplos:

Las expresiones tienen la sintaxis siguiente:

expression  ::=  atributo op_binario valor |
                 atributo op_unario |
                 atributo op_lista lista |
                 (expresión) |
                 expresión AND expresión |
                 expresión> OR expresión

Se aplican las reglas siguientes:

• AND tiene prioridad sobre OR. Las subexpresiones se conectan utilizando AND y OR.
• Se pueden utilizar delimitadores para agrupar expresiones y deben estar equilibrados.

Ejemplos:

• STATE = STATE_READY
• NAME IS NOT NULL
• STATE IN (2, 5, STATE_FINISHED)
• ((PRIORITY=1) OR (WI.REASON=2)) AND (STATE=2)

La tabla siguiente es para una consulta que se ejecuta en la tabla de consulta TASK predefinida:

'(STATE=STATE_READY AND WI.REASON=REASON_POTENTIAL_OWNER) 
OR (WI.REASON=REASON_OWNER)'

Están disponibles los siguientes operadores binarios:

op_binario ::= = | < | > | <> | <= | >= | LIKE | NOT LIKE

Se aplican las reglas siguientes:

• El operando del lado izquierdo de un operador binario debe hacer referencia a un atributo de una tabla de consulta.
• El operando del lado derecho de un operador binario debe ser un valor literal, un valor de constante o un parámetro.
• Los operadores LIKE y NOT LIKE son los únicos válidos para atributos de tipo de atributo STRING.
• El operando del lado izquierdo y el operando del lado derecho deben ser tipos de atributo compatibles.
• Los parámetros de usuario deben ser compatibles con el tipo de atributo del atributo del lado izquierdo.

Ejemplos:

• STATE > 2
• NAME LIKE 'start%'
• STATE <> PARAM(elEstado)

Están disponibles los siguientes operadores unarios:

op_unario ::= IS NULL | IS NOT NULL

Se aplican las reglas siguientes:

• El operando del lado izquierdo de un operador binario debe hacer referencia a un atributo de una tabla de consulta. Los atributos válidos dependen de la ubicación del filtro o criterio de selección.
• Se comprueban todos los atributos para ver si tienen valores nulos, por ejemplo: CUSTOMER IS NOT NULL.

Ejemplo:

DESCRIPTION IS NOT NULL

Están disponibles los operadores de lista siguientes:

op_lista ::= IN | NOT IN

Se aplican las reglas siguientes:

• El lado derecho de un operador de lista no se debe sustituir por un parámetro de usuario.
• Se pueden utilizar parámetros de usuario dentro de la lista del operando del lado derecho.

Ejemplo:

STATE IN (STATE_READY, STATE_RUNNING, PARAM(st), 1)

Las listas se representan de la forma siguiente:

lista ::= valor [, lista]

Se aplican las reglas siguientes:

• El lado derecho de un operador de lista no se debe sustituir por un parámetro de usuario.
• Se pueden utilizar parámetros de usuario dentro de la lista del operando del lado derecho.

Ejemplos:

• (2, 5, 8)
• (STATE_READY, STATE_CLAIMED)

En expresiones, un valor es uno de los tipos siguientes:

• Constante: un valor de constante, que se define para el atributo de una tabla de consulta predefinida. Por ejemplo, STATE_READY se define para el atributo STATE de la tabla de consulta TASK.
• Literal: cualquier valor codificado por el software.
• Parámetro: se sustituye un parámetro cuando la consulta se ejecuta con un valor específico.

Ejemplos:

• STATE_READY en el atributo STATE de la tabla de consulta TASK se puede utilizar en un filtro para comprobar si la tarea se encuentra en estado preparado.
• REASON_POTENTIAL_OWNER en el atributo REASON de la tabla de consulta WORK_ITEM se puede utilizar en un filtro para comprobar si el usuario que ejecuta la consulta contra una tabla de consulta es un propietario potencial.
• El filtro de consulta STATE=STATE_READY es el mismo que STATE=2, si la consulta se ejecuta en la tabla de consulta TASK.

Ejemplos:

• STATE=1
• NAME='elNombre'
• CREATED > TS ('2008-11-26 T12:00:00')
• TKTID=ID('_TKT:801a011e.9d57c52.ab886df6.1fcc0000')

Los parámetros en las expresiones permiten la capacidad de dinamización de tablas de consulta compuestas. Existen parámetros de usuario y parámetros del sistema:

• Los parámetros de usuario se especifican utilizando PARAM (nombre). Este parámetro se debe proporcionar cuando se ejecuta la consulta. Se pasa como una instancia de la clase com.ibm.bpe.api.Parameter a la API de tabla de consulta.
• Los parámetros del sistema son parámetros que se proporcionan en tiempo de ejecución, sin que se especifiquen cuando se ejecuta la consulta. Están disponibles los parámetros del sistema $USER y $LOCALE.
  • $USER, que es una serie, contiene el valor del usuario que ejecuta la consulta.
  • $LOCALE, que es una serie, contiene el valor del entorno local que se utiliza cuando se ejecuta la consulta. Un ejemplo de valor de $LOCALE es 'en_US'.

Puede especificar un parámetro en los criterios de selección de un tabla de consulta conectada que seleccionada en un entorno local específico. Por ejemplo, si la tabla de consulta primaria es TASK en una tabla de consulta compuesta y una tabla de consulta conectada es TASK_DESC. La lista siguiente contiene ejemplos de parámetros:

• STATE=PARAM(elEstado)
• LOCALE=$LOCALE
• OWNER=$USER