Criterios de parámetros de texto

Cuando una consulta depende de muchos parámetros, la consulta se detendrá hasta que cada uno de sus parámetros se haya resuelto. A veces un parámetro puede tener una consulta simple que concatena una cadena o realiza una evaluación condicional. Estas consultas todavía hacen llamadas de red a los servicios que realizan estas operaciones básicas, y ese proceso aumenta el tiempo que tarda un parámetro en resolver un valor. Esto genera largos tiempos de carga para libros complejos.

Al usar los parámetros de los criterios, puede definir un conjunto de criterios basados en parámetros previamente especificados que se evaluarán para proporcionar un valor dinámico. La principal ventaja de usar parámetros de criterios es que los parámetros de criterios pueden resolver los valores de los parámetros previamente especificados y realizar operaciones condicionales simples sin hacer ninguna llamada a la red. El ejemplo siguiente es un caso de uso de parámetros de criterios.

Ejemplo

Tenga en cuenta la siguiente consulta condicional:

let metric = dynamic({Counter});
print tostring((metric.object == 'Network Adapter' and (metric.counter == 'Bytes Received/sec' or metric.counter == 'Bytes Sent/sec')) or (metric.object == 'Network' and (metric.counter == 'Total Bytes Received' or metric.counter == 'Total Bytes Transmitted')))

Si se centra en el objeto metric.counter, el valor del parámetro isNetworkCounter debe ser true si el parámetro Counter tiene Bytes Received/sec, Bytes Sent/sec, Total Bytes Received o Total Bytes Transmitted.

Esto se puede traducir a un parámetro de texto de criterios:

En la captura de pantalla anterior, las condiciones se evaluarán de arriba a abajo y el valor del parámetro isNetworkCounter tomará el valor de la que la condición ever se evalúa como true primero. Todas las condiciones excepto la condición predeterminada (la condición "else") se pueden reordenar para obtener el resultado deseado.

Configuración de criterios

1. Comience con un libro con al menos un parámetro existente en modo de edición.

   1. Seleccione Agregar parámetros>Agregar parámetro.
   2. En el panel de nuevo parámetro que se abre, escriba:
      • Nombre del parámetro: rand
      • Tipo de parámetro: Text
      • Obligatorio: checked
      • Obtener datos de: Query
      • Escriba print rand(0-1) en el editor de consultas. Este parámetro generará un valor entre 0 y 1.
   3. Seleccione Guardar para crear el parámetro.

   Nota

   El primer parámetro del libro no mostrará la pestaña Criterios.

   

2. En la tabla con el parámetro rand, seleccione Agregar parámetro.

3. En el panel de nuevo parámetro que se abre, escriba:

   • Nombre del parámetro: randCriteria
   • Tipo de parámetro: Text
   • Obligatorio: checked
   • Obtener datos de: Criteria

4. Aparece una cuadrícula. Seleccione Editar junto al cuadro de texto en blanco para abrir el formulario Configuración de criterios. Para consultar una descripción de cada campo, vea el formulario de configuración de criterios.

   

5. Escriba los datos siguientes para rellenar los primeros criterios y, a continuación, seleccione Aceptar:

   • Primer operando: rand
   • Operador: >
   • Valor de: Static Value
   • Segundo operando: 0.25
   • Valor de: Static Value
   • El resultado es: is over 0.25

   

6. Seleccione Editar junto a la condición Click edit to specify a result for the default condition para editar la configuración predeterminada.

   Nota

   Para la condición predeterminada, debe deshabilitarse todo excepto para los últimos campos Value from y Result is.

7. Escriba los datos siguientes para rellenar la condición predeterminada y, a continuación, seleccione Aceptar:

   • Valor de: valor estático
   • El resultado es: es 0,25 o inferior

   

8. Guarde el parámetro.

9. Actualice el libro para ver el parámetro randCriteria en acción. Su valor se basará en el valor de rand.

Formulario de configuración de criterios

Campos de formulario	Descripción
Primer operando	Esta lista desplegable consta de nombres de parámetros que ya se han creado. El valor del parámetro se usará en el lado izquierdo de la comparación.
Operador	El operador que se usa para comparar el primer y el segundo operando. Puede ser una evaluación numérica o de cadena. El operador is empty deshabilitará Second operand ya que solo se requiere First operand.
Valor de	Si se establece como Parameter, aparece una lista desplegable que consta de parámetros que ya se han creado. El valor de ese parámetro se usará en el lado derecho de la comparación. Si se establece en Static Value, aparece un cuadro de texto donde puede escribir un valor para el lado derecho de la comparación.
Segundo operando	Será un menú desplegable que consta de parámetros creados o un cuadro de texto en función de la selección anterior Value from.
Valor de	Si se establece como Parameter, aparece una lista desplegable que consta de parámetros que ya se han creado. El valor de ese parámetro se usará para el valor devuelto del parámetro actual. Si se establece en Static Value: - Aparece un cuadro de texto donde puede escribir un valor para el resultado. - También puede desreferenciar otros parámetros mediante llaves alrededor del nombre del parámetro. - Es posible concatenar varios parámetros y crear una cadena personalizada, por ejemplo, "{paramA}, {paramB} y alguna cadena". Si se establece en Expression: - Aparece un cuadro de texto donde puede escribir una expresión matemática que se evaluará como resultado. - Al igual que en el caso Static Value, se pueden desreferenciar varios parámetros en este cuadro de texto. - Si el valor del parámetro referenciado en el cuadro de texto no es un número, se tratará como el valor 0.
El resultado es	Será un menú desplegable que consta de parámetros creados o un cuadro de texto en función de la selección anterior Value from. El cuadro de texto se evaluará como el resultado final de este formulario de Configuración de criterios.