Imprimir      Abrir versión PDF de ayuda en línea


Previous Topic

Next Topic

Acerca de la especificación de filtros para informes y cuadros de mandos incrustados

También puede incrustar informes y cuadros de mandos en fichas web y applets web personalizados. También puede configurar campos de enlace web para abrir informes y cuadros de mandos.

Al crear un applet web personalizado, una ficha web o un enlace web del tipo Informe o Cuadro de mandos, puede especificar los filtros que se aplicarán en tiempo de ejecución. Para un cuadro de mandos, los filtros que especifique se aplican a todos los informes en el cuadro de mandos.

Cada una de las columnas que especifique en los filtros también debe tener un filtro configurado en el informe que desea incrustar, y si está incrustando un cuadro de mandos, la columna debe tener un filtro configurado en cada uno de los informes del cuadro de mandos. El filtro del informe se puede establecer como "se solicita" o configurarse con un operador y un valor. Si no se ha configurado un filtro para una columna en el informe, cualquier filtro que especifique para esa columna en el applet web, la ficha web o el enlace web no se aplicará cuando se ejecute el informe. Para obtener información sobre cómo agregar filtros a columnas de informes, consulte Adición de filtros a columnas en análisis.

NOTA: Cuando cree un applet web personalizado, una ficha web o un enlace web del tipo Informe, también puede especificar que las solicitudes definidas para el informe incrustado deben mostrarse en tiempo de ejecución, seleccionando la casilla de verificación Mostrar peticiones de informe. Mostrar las solicitudes en tiempo de ejecución permite a los usuarios filtrar el informe. Sin embargo, la configuración de la casilla de verificación Mostrar peticiones de informe tiene prioridad sobre los filtros definidos en el campo Parámetros del informe o cuadro de mandos incrustado. Por tanto, si selecciona la casilla de verificación Mostrar peticiones de informe para un applet web personalizado, una ficha web o un enlace web, se ignorarán todos los filtros que se hayan definido en el campo Parámetros como se describe en este tema, incluso si no se han definido solicitudes para el informe incrustado.

Sintaxis para especificar filtros

Puede especificar los parámetros para filtros de las siguientes formas:

  • Con los parámetros Pn, lo que se conoce como sintaxis Pn.
  • Con grupos de valores opn, coln y valn, lo que se conoce como sintaxis opn.

No puede usar una combinación de los dos tipos de sintaxis.

Con la sintaxis Pn, puede especificar un máximo de seis filtros. En el parámetro P0, se especifica el número de filtros que desea configurar. Los valores válidos para el parámetro P0 oscilan entre los enteros del 1 al 6. El parámetro P0 se puede usar solo una vez en la cadena de parámetros. Cada filtro utiliza tres parámetros para incluir el operador, la columna y el valor. El primer parámetro se especifica en los parámetros P1-P3. En P1 se debe especificar el operador, en P2 la columna y en P3 el valor. Especifique los siguientes filtros en conjuntos de tres parámetros, como P4-P6, P7-P9, P10-P12, P13-P15 y P16-P18. Debe utilizar el ampersand (&) para separar los parámetros. Cada parámetro se puede usar solo una vez en la cadena de parámetros.

Para un solo filtro, la sintaxis es la siguiente, si bien lo parámetros se pueden colocar en cualquier orden en la cadena de parámetros:

P0=1&P1=operator&P2=table.column&P3=value

Para especificar más filtros, puede agregar los parámetros P4-P6, P7-P9, y así sucesivamente, y aumentar el valor del parámetro P0 para que coincida con el número de filtros que agregue. Por tanto, para dos filtros, la sintaxis es la siguiente:

P0=2&P1=operator&P2=table.column&P3=value&P4=operator&P5=table.column&P6=value

Con la sintaxis opn, no existe límite en el número de filtros que puede especificar. En cada filtro se usa un grupo de tres parámetros: el parámetro opn especifica el operador, el parámetro coln especifica la columna y el parámetro valn especifica el valor. Debe utilizar el ampersand (&) para separar los parámetros. Debe numerar cada uno de los parámetros de un grupo de filtros con el mismo número, que debe ser un entero mayor que 0 (cero), así como numerar los grupos de parámetros en orden secuencial. Para un solo filtro, la sintaxis es la siguiente, si bien lo parámetros se pueden colocar en cualquier orden en la cadena de parámetros:

op1=operator&col1=table.column&val1=value

Del mismo modo, para dos filtros, la sintaxis es la siguiente:

op1=operator&col1=table.column&val1=value&op2=operator&col2=table.column&val2=value

NOTA: En el parámetro column, si un nombre de tabla o un nombre de columna contienen un espacio, debe incluir el nombre entre comillas dobles. Si un nombre de tabla o de columna no contiene un espacio, no es necesario que incluya el nombre entre comillas dobles, pero puede hacerlo si lo desea. Esto se aplica a ambos tipos de sintaxis.

Parámetro de página

Al incrustar un cuadro de mandos, también puede usar el parámetro Page para especificar qué página del cuadro de mandos se abre cuando se visualiza el cuadro de mandos. La sintaxis del parámetro Page es:

Page=page name

donde page name es el nombre de la página tal y como aparece en el cuadro de mandos. No incluya el nombre de la página entre comillas dobles, incluso aunque el nombre contenga uno o más espacios. Puede especificar el parámetro Page solo o con otros parámetros. Puede colocar el parámetro Page en cualquier ubicación en la cadena de parámetros, pero debe usar un ampersand (&) para separar el parámetro Page de cualquier otro parámetro que lo preceda o vaya después de él.

El parámetro Page no se valida cuando guarde los parámetros. Si no incluye el parámetro Page, o si lo incluye, pero deja el valor del mismo en blanco, la primera página del cuadro de mandos se abre cuando se presenta el cuadro de mandos. Si especifica cualquier valor distinto del nombre válido de una página en el cuadro de mandos seleccionado, se muestra un error en tiempo de ejecución.

Acerca de los caracteres especiales en los parámetros

Si un nombre de tabla, un nombre de columna, un valor o un nombre de página de cuadro de mandos que especifique en el parámetro incluye cualquiera de los siguientes caracteres, se debe codificar el carácter, de la siguiente forma:

  • % (signo de porcentaje). Se codifica como %25.
  • & (ampersand). Se codifica como %26.
  • [ (corchete izquierdo). Se codifica como %5B.
  • ] (corchete derecho). Se codifica como %5D.
  • + (signo más). Se codifica como %2B.

Si estos caracteres no se codifican, podría aparecer un error cuando intente guardar los parámetros, o bien los resultados podrían no ser correctos en tiempo de ejecución.

Validación de parámetros

Con la excepción del parámetro Page, los parámetros que especifique se validan al intentar guardar los cambios. Si se detectan errores, debe corregir los errores antes de guardar los cambios.

NOTA: En las versiones anteriores a la 40, los parámetros de filtro no se validaban antes de guardarse. Por tanto, un parámetro de filtro que se especificara para un informe o cuadro de mando incrustados en una versión anterior a la versión 40 podría contener un error. Si se ha detectado algún error en la sintaxis de un filtro al visualizar un informe o cuadro de mandos incrustados, se muestra un mensaje de error. Asimismo, si edita un applet web, una ficha web o un campo de enlace web existentes del tipo Informe o Cuadro de mandos, y si realiza un cambio en cualquier campo, al intentar guardar los cambios, se validan todos los campos, incluido el campo Parámetros. Si se detectan errores, deberá corregirlos.

En las siguientes secciones se describen los parámetros que constituyen un filtro.

Operador

En la siguiente tabla se enumeran los operadores que puede utilizar en un filtro.

Operador

Descripción

eq

Igual a o dentro de

neq

No es igual a o no está dentro de

lt

Menor que

gt

Mayor que

ge

Mayor que o igual a

le

Menor que o igual a

bwith

Empieza por

ewith

Finaliza con

cany

Contiene cualquiera. El parámetro value puede tener varios valores, separados por un signo más (+). Si usa la sintaxis Pn, debe especificar el número de valores al principio de la lista de valores. Si usa la sintaxis opn, no especifique el número de valores ya que, de lo contrario, Oracle CRM On Demand asumirá que el número especificado es otro valor.

Por ejemplo, para encontrar las regiones de cuenta Este, Oeste y Central (es decir, tres regiones):

P0=1&P1=cany&P2="Account"."Account Region"&P3=3+East+West+Central

o:

op1=cany&col1="Account"."Account Region"&val1=East+West+Central

call

Contiene todo. El parámetro value puede tener varios valores, separados por un signo más (+). Si usa la sintaxis Pn, debe especificar el número de valores al principio de la lista de valores. Si usa la sintaxis opn, no especifique el número de valores ya que, de lo contrario, Oracle CRM On Demand asumirá que el número especificado es otro valor.

like

Igual. El parámetro value debe contener algún valor. La cadena value debe finalizar con un comodín % (signo de porcentaje); de lo contrario, el operador like solo devolverá coincidencias exactas para la cadena. El signo de porcentaje se debe codificar como %25.

Por ejemplo, para buscar los nombres de las cuentas similares a Acme:

P0=1&P1=like&P2="Account"."Account Name"&P3=Acme%25

o:

op1=like&col1="Account"."Account Name"&val1=Acme%25

top

n mejores ítems. Por ejemplo, para buscar los 6 mejores ingresos por ventas:

P0=1&P1=top&P2="Account"."Account Revenue"&P3=6

o:

op1=top&col1="Account"."Account Revenue"&val1=6

bottom

n peores ítems. Por ejemplo, para buscar los 4 peores ingresos por ventas:

P0=1&P1=bottom&P2="Account"."Account Revenue"&P3=4

o:

op1=bottom&col1="Account"."Account Revenue"&val1=4

bet

Entre. El parámetro value debe tener dos valores, separados por un signo más (+). Si usa la sintaxis Pn, debe especificar el número de valores (2) al principio de la lista de valores. Si usa la sintaxis opn, no especifique el número de valores ya que, de lo contrario, Oracle CRM On Demand asumirá que el número especificado es otro valor.

Por ejemplo, para filtrar los ingresos de una cuenta entre 100.000 y 500.000:

P0=1&P1=bet&P2="Account"."Account Revenue"&P3=2+100000+500000

o:

op1=bet&col1="Account"."Account Revenue"&val1=100000+500000

null

Es nulo. El parámetro value debe ser 0 (cero) y no se puede omitir.

nnull

No es nulo. El parámetro value debe ser 0 (cero) y no se puede omitir.

Columna

Al especificar la columna, tenga en cuenta los siguientes puntos:

  • Debe especificar tanto el nombre de la tabla como el de columna, separados por un punto (.).
  • Si un nombre de tabla o un nombre de columna contienen un espacio, debe incluir el nombre entre comillas dobles. Si un nombre de tabla o de columna no contiene un espacio, no es necesario que incluya el nombre entre comillas dobles, pero puede hacerlo si lo desea. Esto se aplica a ambos tipos de sintaxis. Por ejemplo, todo lo que se indica a continuación es válido:

    "Account"."Account Name"

    "Service Request".Area

    Account."Account Name"

  • Debe utilizar los nombres de columnas originales y no los nombres visibles.

Valor

Cuando especifique el valor para un filtro, tenga en cuenta lo siguiente:

  • Puede especificar un valor directamente, o bien un campo como un parámetro.
  • Si usa la sintaxis opn y especifica directamente un valor que contenga un espacio, el valor debe ir entre comillas dobles. Si se especifica más de un valor, y si alguno de los valores contiene un espacio, cada uno de los valores especificados debe ir entre comillas dobles, por ejemplo:

    val1="New York"+"Alabama"+"California"

    Si usa la sintaxis Pn, no necesita incluir un valor que contenga un espacio entre comillas dobles.

  • Para incluir un campo de usuario o del sistema en un parámetro de filtro, sitúe el cursor en el campo Parámetros en la posición donde desee agregar el parámetro y, a continuación, seleccione el campo que desea incluir en la lista Campos de usuario y sistema.

    Para obtener información sobre los campos de usuario y del sistema que puede utilizar en los parámetros, consulte Campos de usuario y sistema.

  • (Applets web solo para las páginas Detalle de tipo de registro y enlaces web) Para incluir un campo del tipo de registro en un parámetro de filtro, sitúe el cursor en el campo Parámetros en la posición en la que desea agregar el campo y, a continuación, seleccione el campo en la lista Campos del tipo de registro, donde tipo de registro es el nombre del tipo de registro para el que se va a crear el applet.

    Por ejemplo, si selecciona el campo ID de fila en la lista Campos de tipo de registro, se inserta %%%Row_Id%%%. %%%Row_Id%%% se sustituye en tiempo de ejecución por el ID de fila del registro actual.

NOTA: La dirección URL de un informe o un cuadro de mandos se genera en tiempo de ejecución. La longitud de la dirección URL para el informe o cuadro de mandos varía, dependiendo de los valores que se transfieren a la dirección URL de los filtros en tiempo de ejecución. Cada explorador tiene una longitud máxima de dirección URL. Si la dirección URL de un informe o un cuadro de mandos sobrepasa esa longitud, los usuarios podrían ver un comportamiento indeterminado en el explorador cuando intentan ver ese informe o un cuadro de mandos.

NOTA: Puede especificar parámetros para un informe, un cuadro de mandos o una página de cuadro de mandos en una acción Enviar correo electrónico en un evento programado para Datos analíticos de la misma forma que especifica los parámetros para un informe o cuadro de mandos incrustados en el applet web, la ficha o el enlace. Sin embargo, no puede seleccionar campos para especificar como valores de parámetros en una acción Enviar correo electrónico. Para obtener información sobre la configuración de eventos programados para Datos analíticos, consulte Creación de eventos programados para datos analíticos.


Publicado en agosto 2021 Copyright © 2005, 2021, Oracle y/o sus subsidiarias. Legal Notices.