Imprimir      Abrir versão PDF da ajuda online


Previous Topic

Next Topic

Acerca da Especificação de Filtros para Relatórios e Painéis Incorporados

Pode incorporar relatórios e dashboards numa applet da Internet customizada e separadores da Internet. Também pode configurar os campos da ligação Web para abrir relatórios e dashboards.

Quando cria uma applet da Internet customizada, um separador da Internet ou uma ligação Web do tipo Relatório ou Painel, pode especificar os filtros que serão aplicados no tempo de execução. Para um painel, os filtros que especifica aplicam-se a todos os relatórios no painel.

Cada uma das colunas que especificar nos filtros deverá também ter um filtro configurado para a coluna no relatório que pretende incorporar e se estiver a incorporar um painel, a coluna deverá ter um filtro configurado para a coluna em cada um dos relatórios no painel. O filtro do relatório pode ser definido para "é solicitado" ou configurado com um operador e um valor. Se um filtro não estiver configurado para uma coluna no relatório, então qualquer filtro que especificar para essa coluna na applet da Web, no separador da Web ou na ligação Web não será aplicado quando o relatório for executado. Para obter informações sobre como acrescentar filtros a colunas nos relatórios, consulte Acrescentar Filtros a Colunas no Analytics.

NOTA: Quando criar uma applet da Web, separador Web ou ligação Web customizados do tipo Relatório, pode especificar opcionalmente que quaisquer parâmetros que estejam definidos para o relatório incorporado sejam apresentados em runtime, selecionando a caixa de seleção Apresentar Parâmetros do Relatório. A apresentação de parâmetros em runtime permite aos utilizadores filtrar o relatório. No entanto, a definição na caixa de seleção Apresentar Parâmetros do Relatório tem precedência sobre quaisquer filtros que estejam definidos no campo Parâmetros para o relatório ou o painel incorporados. Assim, se marcar a caixa de seleção Apresentar Parâmetros do Relatório para uma applet da Web, separador Web ou ligação Web customizados, quaisquer filtros que estejam definidos no campo Parâmetros conforme descrito neste tópico são ignorados, mesmo que não estejam definidos quaisquer parâmetros para o relatório incorporado.

Sintaxe para Especificar Filtros

Pode especificar os parâmetros dos filtros numa das seguintes formas:

  • Utilizar os parâmetros Pn, também referido de sintaxe Pn.
  • Utilizar grupos dos parâmetros opn, coln e valn, também referidos de sintaxe opn.

Não pode utilizar uma mistura dos dois tipos de sintaxe.

Se utilizar a sintaxe Pn, pode especificar um máximo de seis filtros. No parâmetro P0, pode especificar o número de filtros que pretende configurar. Os valores válidos para o parâmetro P0 são números inteiros de 1 a 6. O parâmetro P0 pode ser utilizado só uma vez na cadeia de parâmetros. Cada filtro utiliza três parâmetros para conter o operador, a coluna e o valor. Pode especificar o primeiro parâmetro nos parâmetros P1-P3. P1 deve especificar o operador, P2 deve especificar a coluna e P3 deve especificar o valor. Especifica o primeiro filtro nos filtros subsequentes em conjuntos de três parâmetros, nomeadamente P4-P6, P7-P9, P10-P12, P13-P15 e P16-P18. Deve utilizar um 'E' comercial (&) para separar os parâmetros. Cada parâmetro pode ser utilizado só uma vez na cadeia de parâmetros.

No caso de um filtro simples, a sintaxe é a que se segue, apesar de os parâmetros poderem ser colocados por qualquer ordem na cadeia de parâmetros:

P0=1&P1=operador&P2=table.column&P3=valor

Para especificar filtros adicionais, acrescenta os parâmetros P4-P6, P7-P9, e assim por diante, e aumenta o valor do parâmetro P0 para corresponder ao número de filtros que acrescenta. Então, para dois filtros, a sintaxe é a seguinte:

P0=2&P1=operador&P2=tabela.coluna&P3=valor&P4=operador&P5=tabela.coluna&P6=valor

Se utilizar a sintaxe opn, não existe limite para o número de filtros que pode especificar. Cada filtro utiliza um grupo de três parâmetros: o parâmetro opn especifica o operador, o parâmetro coln especifica a coluna e o parâmetro valn especifica o valor. Deve utilizar um 'E' comercial (&) para separar os parâmetros. É necessário numerar cada parâmetro de um grupo de filtro com o mesmo número, que deve ser um número inteiro maior do que 0 (zero), e deve numerar os grupos de parâmetros sequencialmente. No caso de um filtro simples, a sintaxe é a que se segue, apesar de os parâmetros poderem ser colocados por qualquer ordem na cadeia de parâmetros:

op1=operador&col1=tabela.coluna&val1=valor

Na mesma medida, para dois filtros, a sintaxe é a seguinte:

op1=operador&col1=tabela.coluna&val1=valor&op2=operador&col2=tabela.coluna&val2=valor

NOTA: No parâmetro da coluna, se o nome da tabela ou da coluna contiverem um espaço, deve incluir esse nome entre aspas duplas. Se o nome da tabela ou da coluna não contiver um espaço, não deve incluir o nome entre aspas duplas, no entanto, pode fazê-lo, caso pretenda. Isto aplica-se para ambos os tipos de sintaxe.

Parâmetro Página

Ao incorporar um painel, também pode utilizar o parâmetro Página para especificar a página do painel que abre quando o painel é apresentado. A sintaxe do parâmetro Página é:

Page=nome da página

em que nome da página é o nome da página apresentada no painel. Não inclua o nome da página entre aspas duplas mesmo que o nome contenha um ou mais espaços. Pode especificar o parâmetro Página individualmente ou com outros parâmetros. Pode colocar o parâmetro Página em qualquer localização na cadeia de parâmetros, mas é necessário utilizar um "E" comercial (&) para separar o parâmetro Página de qualquer outro parâmetro que o preceda ou suceda.

O parâmetro Página não é validado ao gravar os parâmetros. Se não incluir o parâmetro Página ou se o incluir mas deixar o valor do parâmetro em branco, então é aberta a primeira página do painel quando este é apresentado. Se especificar um valor que não o nome do valor válido de uma página no painel selecionado, é apresentado um erro no runtime.

Acerca de Caracteres Especiais nos Parâmetros

Se o nome da tabela, o nome da coluna, o valor ou o nome da página do painel que especificar num parâmetro incluir algum dos seguintes caracteres, o carácter deve ser codificado da forma que se segue:

  • % (símbolo de percentagem). Codificar como %25.
  • & ("E" comercial). Codificar como %26.
  • [ (parêntese reto à esquerda). Codificar como %5B.
  • ] (parêntese reto à direita). Codificar como %5D.
  • + (sinal de adição). Codificar como %2B.

Se estes caracteres não forem codificados, o erro poderá retornar ao tentar gravar os parâmetros ou os resultados poderão estar incorretos no runtime.

Validação de Parâmetros

À exceção do parâmetro Página, os parâmetros que especifica são validados quando tenta gravar as suas alterações. Se forem detetados erros, terá de corrigi-los para poder gravar as suas alterações.

NOTA: Nas releases anteriores à Release 40, os parâmetros de filtro não eram validados antes de serem gravados. Como tal, o parâmetro do filtro que foi especificado para um relatório ou painel incorporado numa release anterior à Release 40 pode conter um erro. Se forem detetados quaisquer erros na sintaxe de um filtro quando um relatório ou painel incorporado for apresentado, é apresentada uma mensagem de erro. Além disso, se editar uma applet da Web, um separador da Web ou um campo de ligação Web do tipo Relatório ou Painel e efetuar alguma alteração num campo, quando tentar gravar as suas alterações, todos os campos incluindo o campo Parâmetros são validados. Se forem detetados erros, terá de corrigi-los.

As secções a seguir descrevem os parâmetros que compõem um filtro.

Operador

A tabela a seguir lista os operadores que pode utilizar num filtro.

Operador

Descrição

eq

Igual a ou em

neq

Diferente de ou não em

lt

Menor que

gt

Maior que

ge

Maior ou igual a

le

Menor ou igual a

bwith

Começa com

ewith

Ends with

cany

Contém qualquer. O parâmetro de valor pode ter vários valores, cada um separado por um sinal de adição (+). Se utilizar a sintaxe Pn, deverá especificar o número de valores no início da lista de valores. Se utilizar a sintaxe opn, não especifique o número de valores, caso contrário, Oracle CRM On Demand assumirá que o número especificado é outro valor.

Por exemplo, para encontrar as regiões de conta Oriente, Ocidente e Central (ou seja, três regiões):

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

ou:

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

call

Contém todos. O parâmetro de valor pode ter vários valores, cada um separado por um sinal de adição (+). Se utilizar a sintaxe Pn, deverá especificar o número de valores no início da lista de valores. Se utilizar a sintaxe opn, não especifique o número de valores, caso contrário, Oracle CRM On Demand assumirá que o número especificado é outro valor.

like

Like. O parâmetro do valor deve conter um valor. A cadeia de valores deve terminar com o carácter de substituição % (símbolo de percentagem), caso contrário, o operador LIKE devolverá apenas as correspondências exatas da cadeia. O símbolo de percentagem deve ser codificado como %25.

Por exemplo, para encontrar nomes de contas que são como Acme:

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

ou:

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

superior

n itens superiores. Por exemplo, para encontrar as 6 receitas de vendas superiores:

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

ou:

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

inferior

n itens inferiores. Por exemplo, para encontrar as 4 receitas de vendas inferiores:

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

ou:

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

bet

Entre. O parâmetro de valor deve ter dois valores separados por um sinal de adição (+). Se utilizar a sintaxe Pn , deverá especificar o número de valores (2) no início da lista de valores. Se utilizar a sintaxe opn, não especifique o número de valores, caso contrário, Oracle CRM On Demand assumirá que o número especificado é outro valor.

Por exemplo, para aplicar um filtro sobre receitas da conta entre 100.000 e 500.000:

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

ou:

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

nulo

É nulo. O parâmetro do valor deve ser 0 (zero) e não pode ser omitido.

nnull

Não é nulo. O parâmetro do valor deve ser 0 (zero) e não pode ser omitido.

Coluna

Ao especificar a coluna, observe os seguintes pontos:

  • Deve especificar o nome da tabela e o nome da coluna, separados por um ponto final (.).
  • Se um nome da tabela ou da coluna contiverem um espaço, deve incluir o nome entre aspas duplas. Se o nome da tabela ou da coluna não contiver um espaço, não deve incluir o nome entre aspas duplas, no entanto, pode fazê-lo, caso pretenda. Isto aplica-se para ambos os tipos de sintaxe. Por exemplo, o que se segue é válido:

    "Account"."Account Name"

    "Service Request".Area

    Account."Account Name"

  • Deve utilizar os nomes das colunas originais e não os nomes de apresentação.

Valor

Quando especificar o valor para um filtro, tenha em atenção os seguintes aspetos:

  • Pode especificar um valor diretamente ou pode especificar um campo como um parâmetro.
  • Se utilizar a sintaxe opn e especificar diretamente um valor que contenha um espaço, esse valor deve ser incluído entre aspas duplas. Se for especificado mais de um valor, e um desses valores contiver um espaço, cada um dos valores especificados deve ser incluído entre aspas duplas, por exemplo:

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

    Se utilizar a sintaxe Pn, não necessita de incluir um valor que contém um espaço dentro de aspas duplas.

  • Para incluir um campo do utilizador ou do sistema num parâmetro de filtro, coloque o cursor no campo Parâmetros na posição em que pretende acrescentar o parâmetro e, em seguida, selecione o campo que pretende incluir a partir da lista Campos do Utilizador e Sistema.

    Para obter informações sobre os campos do utilizador e do sistema que pode utilizar nos parâmetros, consulte Campos do Utilizador e Sistema.

  • (Applets da Internet só para as páginas Detalhe do tipo de registo e ligações da Internet) Para incluir um campo do tipo de registo num parâmetro de filtro, coloque o cursor no campo Parâmetros na posição em que pretende acrescentar o campo e, em seguida, selecione o campo a partir da lista Campos de tipo de registo, em que tipo de registo é o nome do tipo de registo para o qual está a criar a applet.

    Por exemplo, se selecionar o campo ID da Linha da lista de Campos do tipo de registo, é inserido %%%Row_Id%%%. No tempo de execução, %%%Row_Id%%% é substituído pelo ID da linha do registo atual.

NOTA: O URL para um relatório ou painel é gerado no tempo de execução. O comprimento do URL para o relatório ou painel varia, dependendo dos valores que são transmitidos ao URL para os filtros de relatório no runtime. Cada navegador tem um comprimento de URL máximo. Se o URL de um relatório ou painel exceder este comprimento, os utilizadores podem ver um comportamento indeterminado no browser quando tentam visualizar esse relatório ou painel.

NOTA: Pode especificar parâmetros para um relatório, um painel ou uma página do painel numa ação Enviar Mensagem de Correio Eletrónico num evento agendado para Análise da mesma forma que especifica os parâmetros para um relatório ou painel incorporado numa applet da Web, num separador da Web ou numa ligação Web. No entanto, não pode selecionar campos para especificar como valores de parâmetro numa ação Enviar Mensagem de Correio Eletrónico. Para obter informações sobre como configurar eventos agendados para o Analytics, consulte Criar Eventos Agendados para o Analytics.


Publicado em Agosto 2021 Copyright © 2005, 2021, Oracle e/ou respetivas associadas. Legal Notices.