![]() |
|
Acerca da Especificação de Filtros para Relatórios e Painéis IncorporadosPode 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 FiltrosPode especificar os parâmetros dos filtros numa das seguintes formas:
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áginaAo 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âmetrosSe 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:
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. OperadorA tabela a seguir lista os operadores que pode utilizar num filtro.
ColunaAo especificar a coluna, observe os seguintes pontos:
ValorQuando especificar o valor para um filtro, tenha em atenção os seguintes aspetos:
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. |