BirtComp

Owned by sgarrido (Unlicensed)
Last updated: 06 Jun, 2011Version comment
7 min read

Clase BirtComp

La clase BirtComp proporciona funciones para comparar valores, por ejemplo, para probar si un valor es igual, mayor o menor que otro valor. Todas las funciones devuelven verdadero o falso.

BirtComp.anyOf

Esta función prueba si uno o más valores se encuentra en un campo.

Sintaxis

BirtComp.anyOf (fuente, objetivo1, ..., objetivoN)

Parámetros

fuente - El campo que contiene los valores a comparar.

objetivo - El valor o los valores a encontrar en la fuente.

Devoluciones

True si un valor objetivo coincide con un valor en la fuente; devuelve false en caso contrario.

Ejemplos

La prueba del siguiente ejemplo si Canadá, México o EE.UU. son los valores en el campo País. Si alguno de los países está en el campo, la función devuelve true.

BirtComp.anyOf (row ["País"], "Canadá", "México", "EE.UU.")

La prueba del siguiente ejemplo, si 15 de enero 2009 o 31 de enero 2009 son valores en el campo payDate:

BirtComp.anyOf (row ["payDate"], "15/1/2009", "31/01/2009")

La prueba del siguiente ejemplo si dos códigos de los productos específicos son los valores en el campo de código de producto. Si bien el valor aparece en el campo, la cadena de obsoletos se muestra, de lo contrario el valor ProductCode se muestra tal y como aparece en el campo.

if (BirtComp.anyOf (row ["ProductCode"], "S18_1749", "S18_2248")) {
 DisplayString = "obsoletos"
}
else {
 row ["ProductCode"]
}

BirtComp.between

Esta función prueba si un valor está entre dos valores específicos.

Sintaxis

BirtComp.between (fuente, objetivo1, objetivo2)

Parámetros

fuente - El valor que se prueba.

objetivo1 - El primer valor en el rango de valores para comparar.

objetivo2 - El segundo valor en el rango de valores para comparar.

Devoluciones

True si el valor de fuente es entre el objetivo1 y los valores objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo están dentro de un rango específico de valores:

BirtComp.between (row ["SalesTotal"], 10000, 20000)
BirtComp.between (row ["CustomerName"], "A", "M")
BirtComp.between (row ["OrderDate"], "01/01/2009", "01/31/2009")

El siguiente ejemplo calcula las fechas de envío. Si un valor de OrderDate es en diciembre de 2008 (entre el 12/01/08 y 12/31/08), añadir 5 días para el valor OrderDate. Si un valor de OrderDate es en un mes que no sea diciembre, añadir 3 días para el valor OrderDate.

if (BirtComp.between (row ["OrderDate"], "01/12/2008", "31/12/2008")) {
 fechaEnvio = BirtDateTime.addDay (row ["OrderDate"], 5)
}
else {
 ShipDate = BirtDateTime.addDay (row ["OrderDate"], 3)
}

BirtComp.compareString

Esta función prueba si un valor de cadena coincide con otro valor de la cadena, teniendo en cuenta las condiciones especificadas.

Sintaxis

BirtComp.compareString (fuente1, fuente2, ignoreCase, recorte)

Parámetros

fuente1 - El primer valor de cadena a utilizar en la comparación.

fuente2 - El segundo valor de cadena a utilizar en la comparación.

ignoreCase - Especifique true para realizar una comparación entre mayúsculas y minúsculas. Especifique false para realizar una comparación entre mayúsculas y minúsculas.

recorte - Especifique true para eliminar los espacios en blanco iniciales o finales antes de comparar los dos valores. Los espacios en blanco en medio de una cadena no se quitan. Especifique false si desea que la comparación incluya espacios en blanco iniciales o finales.

Devoluciones

True si el valor coincide con el valor fuente1 fuente2; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones comparar cadenas con diferentes condiciones especificadas:

BirtComp.compareString ("Jackson", "Jackson", false,) // devuelve true
BirtComp.compareString ("Jackson", "Jackson", false, true) // devuelve false
BirtComp.compareString ("Jackson", "Jackson", false, true) // devuelve true
BirtComp.compareString ("Jackson", "Jackson", false, true) // devuelve false
BirtComp.compareString ("Jackson", "Jackson", true, true) // devuelve true
BirtComp.equalTo

BirtComp.equalTo

Esta función prueba si un valor es igual a otro valor.

Sintaxis

BirtComp.equalTo (fuente, destino)

Parámetros

fuente - El primer valor a utilizar en la comparación.

objetivo - El segundo valor a utilizar en la comparación.

Devoluciones

True si el valor de fuente es igual al valor objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo son iguales a los valores especificados:

BirtComp.equalTo (row ["SalesTotal"], 10000)
BirtComp.equalTo (row ["País"], "Francia")
BirtComp.equalTo (row ["OrderDate"], "15/02/2009")

BirtComp.greaterOrEqual

Esta función prueba si un valor es mayor o igual a otro valor.

Sintaxis

BirtComp.greaterOrEqual (fuente, destino)

Parámetros

fuente - El primer valor a utilizar en la comparación.

objetivo - El segundo valor a utilizar en la comparación.

Devoluciones

True si el valor de fuente es mayor o igual al valor objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo son mayores o iguales a los valores especificados:

BirtComp.greaterOrEqual (row ["SalesTotal"], 10000)
BirtComp.greaterOrEqual (row ["ProductCode"], "S50_4000")
BirtComp.greaterOrEqual (row ["OrderDate"], "15/02/2009")

BirtComp.greaterThan

Esta función prueba si un valor es mayor que otro valor.

Sintaxis

BirtComp.greaterThan (fuente, destino)

Parámetros

fuente - El primer valor a utilizar en la comparación.

objetivo - El segundo valor a utilizar en la comparación.

Devoluciones

True si el valor de fuente es mayor que el valor objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo son mayores que los valores especificados:

BirtComp.greaterThan (row ["SalesTotal"], 10000)
BirtComp.greaterThan (row ["CustomerName"], "M")
BirtComp.greaterThan (row ["OrderDate"], "15/02/2009")

BirtComp.lessOrEqual

Esta función prueba si un valor es menor o igual a otro valor.

Sintaxis

BirtComp.lessOrEqual (fuente, destino)

Parámetros

fuente - El primer valor a utilizar en la comparación.

objetivo - El segundo valor a utilizar en la comparación.

Devoluciones

True si el valor de fuente es menor o igual al valor objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo son menores o iguales a los valores especificados:

BirtComp.lessOrEqual (row ["SalesTotal"], 10000)
BirtComp.lessOrEqual (row ["ProductCode"], "S18_4000")
BirtComp.lessOrEqual (row ["OrderDate"], "15/02/2009")

BirtComp.lessThan

Esta función prueba si un valor es menor que otro valor.

Sintaxis

BirtComp.lessThan (fuente, destino)

Parámetros

fuente - El primer valor a utilizar en la comparación.

objetivo - El segundo valor a utilizar en la comparación.

Devoluciones

True si el valor de fuente es menor que el valor objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo son inferiores a los valores especificados:

BirtComp.lessThan (row ["SalesTotal"], 10000)
BirtComp.lessThan (row ["CustomerName"], "M")
BirtComp.lessThan (row ["OrderDate"], "15/02/2009")

BirtComp.like

Esta función prueba si un valor de cadena coincide con un patrón. El patrón debe utilizar la sintaxis SQL de patrones.

Sintaxis

BirtComp.like (fuente, destino)

Parámetros

fuente - El valor de cadena de evaluar.

objetivo - El modelo de cadena para que coincida. Debe incluir el patrón entre comillas dobles (""). Utilice la caja correcta al escribir los caracteres que desea hacer coincidir. Usted puede utilizar el siguiente carácter especial en un patrón:

  • Un carácter de porcentaje (%) coincide con cero o más caracteres. Por ejemplo,%ace% coincide con cualquier cadena que contenga la subcadena ace, tales como Facebook y MySpace. No coincide con Ace Corporation porque esta cadena contiene la letra A en mayúscula, y no la a minúscula.
  • Un guión bajo (_) que coincide exactamente con uno de los caracteres.

Para hacer coincidir un porcentaje literal (%) o carácter guión bajo (_), se precedera a los caracteres con dos caracteres de barras invertidas ('\ \').

Por ejemplo, para que coincida con S_10, utilice el siguiente patrón:
S\ _10


Para el 50%, utilice el siguiente patrón:
50\ %

Devoluciones

True si el valor de fuente coincide con el valor objetivo; devuelve false en caso contrario.

Ejemplos

El ejemplo siguiente devuelve verdadero para los valores en el campo de código de producto que empiezan con S18:

BirtComp.like (row ["ProductCode"], "S18%")

En el siguiente ejemplo real de los valores productName que contienen la subcadena Ford precedida por un solo carácter devuelve:

BirtComp.like (row ["ProductName"], "_Ford%")

BirtComp.match

Esta función prueba si un valor de cadena coincide con un patrón. El patrón debe utilizar la sintaxis de expresiones regulares de JavaScript.

Sintaxis

BirtComp.match (fuente, destino)

Parámetros

fuente - El valor de cadena de evaluar.

objetivo - El modelo de cadena para que coincida. En la sintaxis de las expresiones regulares de JavaScript, se especifica un patrón dentro de un par de caracteres barra diagonal (/) .

Usted puede utilizar cualquier carácter especial con el apoyo de expresiones JavaScript regulares, como las siguientes:

  • Un signo de interrogación (?) Coincide con cero o una ocurrencia del carácter anterior a la misma.
  • Un asterisco (*) que coincide con cero o cualquier número de apariciones del carácter anterior a la misma.
  • Un carácter de punto (.) Coincide con cualquier carácter.
  • Un carácter de intercalación (^) especifica que la subcadena a buscar es en el principio de una cadena.
  • Un carácter que especifica una búsqueda entre mayúsculas y minúsculas.

Para hacer coincidir un carácter especial literalmente, se precedera al carácter especial con un carácter barra invertida ().

Por ejemplo, para que coincida con S * 10, utilice el siguiente patrón:
/ S \ * 10 /

Para el 50%, utilice el siguiente patrón:
/ 50 % /

Devoluciones

True si el valor de fuente coincide con el valor objetivo; devuelve false en caso contrario.

Ejemplos

El ejemplo siguiente devuelve verdadero para los valores en el campo de código de producto que empiezan con S18:

BirtComp.match (row ["ProductCode"], / S18 ^ /)

En el siguiente ejemplo real de los valores productName que contienen la subcadena Ford regresa:

BirtComp.match (row ["ProductName"], / Ford /)

BirtComp.notBetween

Esta función prueba si un valor no se encuentra entre dos valores especificados.

Sintaxis

BirtComp.notBetween (fuente, objetivo1, objetivo2)

Parámetros

fuente - El valor que se prueba.

objetivo1 - El primer valor en el rango de valores para comparar.

objetivo2 - El segundo valor en el rango de valores para comparar.

Devoluciones

True si el valor de fuente no es entre el objetivo1 y los valores objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo para ver si están fuera de un determinado rango de valores:

BirtComp.notBetween (row ["SalesTotal"], 10000, 20000)
BirtComp.notBetween (row ["CustomerName"], "A", "M")
BirtComp.notBetween (row ["OrderDate"], "01/01/2009", "01/31/2009")

El siguiente ejemplo calcula las fechas de envío. Si un valor OrderDate no es en diciembre de 2008 (no entre 12/01/08 y 12/31/08), añadir 3 días para el valor OrderDate. Si un valor de OrderDate es en diciembre, cinco días para añadir el valor OrderDate.

if (BirtComp.notBetween (row ["OrderDate"], "01/12/2008", "31/12/2008")) {
 fechaEnvio = BirtDateTime.addDay (row ["OrderDate"], 3)
}
else {
 ShipDate = BirtDateTime.addDay (row ["OrderDate"], 5)
}

BirtComp.notEqual

Esta función prueba si un valor no es igual a otro valor.

Sintaxis

BirtComp.notEqual (fuente, destino)

Parámetros

fuente - El primer valor a utilizar en la comparación.

objetivo - El segundo valor a utilizar en la comparación.

Devoluciones

True si el valor de fuente no es igual al valor objetivo; devuelve false en caso contrario.

Ejemplos

Las siguientes expresiones prueban si los valores del campo no son iguales a los valores especificados:

BirtComp.notEqual (row ["SalesTotal"], 10000)
BirtComp.notEqual (row ["País"], "Francia")
BirtComp.notEqual (row ["OrderDate"], "15/02/2009")

BirtComp.notLike

Esta función prueba si un valor de cadena coincide con un patrón. El patrón debe utilizar la sintaxis SQL de patrones.

Sintaxis

BirtComp.notLike (fuente, destino)

Parámetros

fuente - El valor de cadena de evaluar.

objetivo - El modelo de cadena para que coincida. Debe incluir el patrón entre comillas dobles (""). Utilice la caja correcta al escribir los caracteres que desea hacer coincidir. Usted puede utilizar el siguiente carácter especial en un patrón:

  • Un carácter de porcentaje (%) coincide con cero o más caracteres. Por ejemplo,%ace% coincide con cualquier cadena que contenga la subcadena ace, tales como Facebook y MySpace. No coincide con Ace Corporation porque esta cadena contiene la letra A en mayúscula, y no la a minúscula.
  • Un guión bajo (_) que coincide exactamente con uno de los caracteres.

Para hacer coincidir un porcentaje literal (%) o carácter guión bajo (_), se precedera a los caracteres con dos caracteres de barras invertidas ('\ \').

Por ejemplo, para que coincida con S_10, utilice el siguiente patrón:
S\ _10

Para el 50%, utilice el siguiente patrón:
50\ %

Devoluciones

True si el valor de fuente no coincide con el valor objetivo; devuelve false en caso contrario.

Ejemplos

El ejemplo siguiente devuelve false para los valores en el campo de código de producto que empiezan con S18:

BirtComp.notLike (row ["ProductCode"], "S18%")

El ejemplo siguiente devuelve false para los valores de productName que contienen la subcadena Ford precedidos por un solo carácter:

BirtComp.notLike (row ["ProductName"], "_Ford%")