Strings de Formato

Usando strings de formato, você pode formatar os valores dos membros do Essbase em medidas de tipo numérico para que eles apareçam, para fins de consulta, como texto, datas ou outros tipos de valores predefinidos. Você pode definir strings de formato em todos os membros na dimensão de medidas e em membros de fórmula em outras dimensões.

O valor exibido ao usar strings de formato é o valor formatado da célula (propriedade FORMATTED_VALUE no MDX).

O valor real subjacente é numérico e esse valor não é afetado pelo valor formatado associado. As strings de formato permitem exibir valores mais significativos no lugar de valores numéricos brutos. Por exemplo, usando um valor formatado baseado em texto, você pode exibir células de dados como "Alto", "Médio" e "Baixo".

Os valores de tipo de texto e data também são suportados usando os tipos de medida de texto e data incorporados. As strings de formato adicionam mais flexibilidade à sua implementação, na medida em que você pode aplicar strings de formato a membros em várias dimensões, enquanto com medidas de texto e data, você só pode aplicar uma ou outra a uma única dimensão de medidas. Você pode aplicar strings de formato a dimensões numéricas; não é necessário digitar a dimensão como texto ou data.

As strings de formato podem ser aplicadas a bancos de dados de armazenamento agregado (ASO) ou de armazenamento em bloco (BSO).

Tópicos:

Implementar Strings de Formato

As strings de formato são suportadas para bancos de dados de armazenamento agregado (ASO) e armazenamento em blocos (BSO). Você implementa strings de formato no nível do banco de dados. Use o workflow a seguir para ativar e usar strings de formato no Essbase.

  1. Nas propriedades do outline, ative as medidas digitadas.

  2. Na dimensão Contas, crie uma medida cujos membros você deseja formatar e, em suas propriedades de membro, edite o campo Associar String de Formato para criar uma diretiva de formato MDX. Para obter a sintaxe para criar uma diretiva de formato MDX, consulte Diretiva de Formato MDX.

Limitações de Strings de Formato

As strings de formato não são suportadas nas partições.

O tamanho máximo que uma string de formato pode ter é 256 caracteres.

Membros compartilhados (incluindo compartilhamentos implícitos) não podem ter strings de formato separadas. Os membros compartilhados herdam a string de formato do membro do protótipo.

Diretiva de Formato MDX

Você define uma string de formato do Essbase usando uma expressão MDX, nos cubos ASO e BSO.

A sintaxe MDX para aplicar uma string de formato é:

format_string_expression = MdxFormat (string_value_expression)

em que string_value_expression é uma expressão de valor de string MDX válida, conforme descrito na especificação MDX (consulte Regras de Gramática MDX).

A maioria das expressões MDX pode ser usada para especificar strings de formato; no entanto, as strings de formato não podem conter referências a valores de células de dados diferentes do valor de célula atual que está sendo formatado. O valor da célula atual pode ser referenciado usando a função CellValue MDX.

O Essbase trata os membros com strings de formato inválidas como se não houvesse uma string de formato definida. Os contornos podem ser salvos com strings de formato inválidas. O Essbase gerará um aviso se uma consulta consistir em um membro com uma string de formato inválida.

Se um membro não estiver associado a uma string de formato, as regras de formato padrão serão aplicadas. As regras de formato padrão formatam uma célula com base no tipo de medida numérico, de texto ou de data. Para medidas numéricas, o valor formatado padrão é a versão de texto desse número. Para medidas de texto, o valor formatado padrão é o valor de texto com base no objeto de lista de texto associado. Para valores de data, o formato padrão é uma string de data formatada de acordo com a string de formato de data definida nas propriedades do outline.

Funções que Suportam Strings de Formato

Há algumas funções MDX que são úteis quando você tem strings de formato aplicadas a medidas do Essbase.

As strings de formato são aplicadas como expressões MDX, nos cubos ASO e BSO.

  • EnumText retorna o label da lista de texto associado ao valor numérico interno.

  • EnumValue retorna o valor numérico interno de um label de lista de texto

  • CellValue retorna o valor numérico interno da célula atual.

  • NumToStr converte um valor em uma string decimal.

A função de cálculo @ENUMVALUE pode ser útil ao gravar scripts de cálculo para um banco de dados de armazenamento em blocos que tenha medidas de texto ou strings de formato. Esta função retorna o rótulo da lista de texto associado ao valor numérico interno.

A instrução alter session set dml_output do MaxL tem uma cláusula set formatted_value on | off. Por padrão, valores formatados são exibidos em consultas, mas essa instrução pode ser usada para desativar a exibição de valores formatados.

O comando OUTFORMATTEDVALUES Report Writer retorna valores de célula formatados em um relatório.