Você pode fazer referência a variáveis em análises, painéis de controle, KPIs e agentes. Como você faz referência a uma variável dependem da tarefa que você está executando.
Para tarefas em que é exibida em uma caixa de diálogo com campos, você deverá especificar só o tipo e o nome da variável (não a sintaxe inteira), por exemplo, fazendo referência a uma variável em uma definição de filtro.
Para outras tarefas, como fazer referência a uma variável em uma view de título, você especifica a sintaxe da variável. A sintaxe que você usa depende do tipo de variável descrito na tabela.
Nota:
Na sintaxe, se o sinal "arroba" (@) não for seguido por uma chave ({), em seguida, ele será tratada como uma "arroba".Tipo de Variável | Sintaxe | Exemplo |
---|---|---|
Sessão |
@{biServer.variables['NQ_SESSION.variablename']} onde variablename é o nome da variável de sessão, por exemplo, DISPLAYNAME. Para obter uma lista de variáveis de sessão do sistema que você pode usar, consulte Sobre Variáveis de Sessão do Sistema no Guia do Criador de Repositório de Metadados para o Oracle Business Intelligence Enterprise Edition. |
@{biServer.variables['NQ_SESSION.USER']} |
Repositório |
@{biServer.variables.variablename} ou @{biServer.variables['variablename']} onde variablename é o nome da variável de repositório, por exemplo, prime_begin. |
@{biServer.variables.prime_begin} ou @{biServer.variables['prime_begin']} |
Apresentação ou solicitação |
@{variables.variablename}[format]{defaultvalue} ou @{scope.variables['variablename']} onde:
Observação: ao usar um prompt do painel de controle com uma variável de apresentação que pode ter vários valores, a sintaxe difere, dependendo do tipo de coluna. Vários valores são formatados em valores separados por vírgulas e, portanto, todas as cláusulas de formato são aplicadas a cada valor antes de serem unidos por vírgulas. |
@{variables.MyFavoriteRegion}{EASTERN REGION} ou @{MyFavoriteRegion} ou @{dashboard.variables['MyFavoriteRegion']} ou (@{myNumVar}[#,##0]{1000}) ou (@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{) ou (@{myTextVar}{A, B, C}) |
Global |
@{global.variables.variablename} onde variablename é o nome da variável global, por exemplo, gv_region. Ao fazer referência a uma variável global, use o nome totalmente qualificado conforme indicado no exemplo. Observação: a convenção de nomenclatura para variáveis globais deverá estar em conformidade com as especificações de linguagem de Script EMCA para JavaScript. O nome não deve exceder 200 caracteres nem pode conter espaços embutidos, palavras reservadas e caracteres especiais. Se você não estiver familiarizado com os requisitos da linguagem JavaScript, consulte uma referência especializada. |
@{global.variables.gv_date_n_time} |
Você também pode fazer referência a variáveis nas expressões. As diretrizes para mencionar variáveis em expressões são descritas na tabela a seguir.
Tipo de Variável | Diretrizes | Exemplo |
---|---|---|
Sessão |
|
"Market"."Region"=VALUEOF(NQ_SESSION."SalesRegion") |
Repositório |
|
CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END |
Apresentação |
Observação: se o sinal de @ não for seguido por uma {, então ele será tratado como um sinal de @. Durante a utilização de uma variável de apresentação que pode ter vários valores, a sintaxe diferirá, dependendo do tipo de coluna. Use a seguinte sintaxe em SQL para o tipo de coluna especificado a fim de gerar instruções SQL válidas:
|
"Market"."Region"=@{MyFavoriteRegion}{EASTERN REGION} ou "Products"."P4 Brand"=(@{myTextVar}['@']{BizTech}) ou "Products"."PO Product Number"=(@{myNumVar}{1000}) ou "Sales Person"."E7 Hire Date"=(@{myDateTimeVar}{timestamp '2013-05-16 00:00:01'}) ou "Time"."Total Fiscal Time"=(@{myDateVar}{date '2013-05-16'}) ou "Time"."Time Right Now"=(@{myTimeVar}{time '00:00:01'}) Para vários valores (em tipos de dados especificados) ao usar SQL:
ou
ou
|
Para áreas específicas nas quais você pode mencionar variáveis, consulte Onde Posso Fazer Referência a Variáveis?