Tipo de conexão do Hyperion Essbase (SSRS)

Para incluir dados de uma fonte de dados externa do Hyperion Essbase no relatório, você deve ter um conjunto de dados baseado em uma fonte de dados do relatório do tipo Hyperion Essbase. Esse tipo de fonte de dados interna é baseado na extensão de dados do Hyperion Essbase, que permite recuperar dados multidimensionais de uma fonte de dados externa do Hyperion Essbase.

Use as informações deste tópico para criar uma fonte de dados. Para obter instruções passo a passo, consulte Como adicionar e verificar uma conexão de dados ou uma fonte de dados (Construtor de Relatórios 3.0 e SSRS).

Neste artigo

Cadeia de conexão

Credenciais

Consultas

Parâmetros

Propriedades de campo estendidas

Comentários

Tópicos de instruções

Seções relacionadas

Cadeia de conexão

O exemplo de cadeia de conexão a seguir especifica uma fonte de dados do Hyperion Essbase em um servidor que usa porta 13080 e XML no Analysis Services (XMLA) para Internet usando SOAP, conectando-se a um catálogo de exemplo:

Data Source=https://localhost:13080/aps/XMLA; Initial Catalog=Sample

Para obter mais informações sobre exemplos de cadeias de conexão, consulte Conexões de dados, fontes de dados e cadeias de conexão no Construtor de Relatórios 3.0.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Credenciais

As credenciais são necessárias à execução de consultas, à visualização local do relatório e à visualização no servidor de relatório.

Após a publicação do relatório, pode ser necessário alterar as credenciais da fonte de dados para que, quando o relatório for executado no servidor de relatório, as permissões para recuperação dos dados sejam válidas.

Para obter mais informações, consulte Conexões de dados, fontes de dados e cadeias de conexão (SSRS) ou Especificando credenciais no Construtor de Relatórios 3.0.

Ícone de seta usado com o link Voltar ao InícioVoltar ao início

Consultas

Você pode especificar uma consulta das seguintes formas:

  • Crie uma consulta interativamente. Use o designer de consulta gráfico no modo de Design ou de Consulta para procurar os metadados na fonte de dados externa e gerar uma consulta em sintaxe de expressão MDX.

    • **Modo de Design   **Arraste as dimensões, os membros, as propriedades de membros, as medidas e os KPIs do navegador de metadados para o painel Dados para criar uma consulta MDX. Arraste os membros calculados do painel MembrosCalculados até o painel Dados para definir campos adicionais para o conjunto de dados.

    • **Modo de Consulta   **Arraste as dimensões, os membros, as propriedades de membros, as medidas e os KPIs do navegador de metadados para o painel Consulta para criar uma consulta MDX. Você pode editar o texto MDX diretamente no painel Consulta. Arraste os membros calculados do painel MembrosCalculados até o painel Consulta para definir campos adicionais para o conjunto de dados.

    Para obter mais informações, consulte Interface de usuário do Designer de Consulta do Hyperion Essbase (Construtor de Relatórios 3.0).

  • Importe uma consulta MDX existente de um relatório. Use o botão de consulta Importar para ir para um arquivo .rdl e importe uma consulta. Você pode importar uma consulta de um relatório que contém um conjunto de dados inserido baseado em uma fonte de dados do Hyperion Essbase. Não há suporte para a importação de uma consulta MDX diretamente a partir de um arquivo .mdx. 

No momento do design, execute a consulta para exibir um conjunto de resultados. Depois que você criar uma consulta, visualize a coleta de campos do conjunto de dados gerada a partir dos metadados no painel Dados do Relatório. Quando o relatório é executado, os dados reais são retornados da fonte de dados externa.

A extensão de processamento de dados do Hyperion Essbase oferece suporte às propriedades estendidas de campo do conjunto de dados. Estes são valores que estão disponíveis a partir da fonte de dados externa, mas que não são exibidos no painel Dados do Relatório. Para obter mais informações, consulte Propriedades de campo estendidas posteriormente neste tópico.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Parâmetros

Para incluir parâmetros de consulta, crie um filtro na área de filtros no designer de consultas e marque o filtro como um parâmetro. Para cada filtro, um conjunto de dados é criado automaticamente para fornecer os valores disponíveis. Por padrão, esses conjuntos de dados não são exibidos no painel Dados do Relatório. Para obter mais informações, consulte Como mostrar conjuntos de dados ocultos para obter valores de parâmetros para dados multidimensionais (Construtor de Relatórios 3.0 e SSRS).

Por padrão, cada parâmetro de relatório tem o tipo de dados Text. Depois que os parâmetros de relatório forem criados, talvez seja necessário alterar os valores padrão. Para obter mais informações, consulte Parâmetros (Report Builder 3.0 e SSRS).

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Propriedades de campo estendidas

A extensão de processamento de dados do Hyperion Essbase oferece suporte às propriedades de campo estendidas. As propriedades de campo estendidas são propriedades adicionais a Value e IsMissing definidas para um campo de conjunto de dados pela extensão de processamento de dados. As propriedades estendidas incluem propriedades predefinidas e propriedades personalizadas. As propriedades predefinidas são propriedades comuns para várias fontes de dados. As propriedades personalizadas são exclusivas para cada fonte de dados.

As propriedades de campo estendidas não são exibidas no painel Dados do Relatório como itens que você pode arrastar em seu layout de relatório. Em vez disso, você arrasta o campo pai da propriedade para o relatório e altera a propriedade padrão de Value para a propriedade que você deseja usar.

O nome de uma propriedade de campo estendida aparece na Dica de Ferramenta quando você para o mouse sobre um campo no painel Metadados no designer de consulta. Para obter mais informações sobre o designer de consulta que pode ser usado para explorar os dados subjacentes, consulte Interface de usuário do Designer de Consulta do Hyperion Essbase.

ObservaçãoObservação

Os valores para essas propriedades de campo estendidas passarão a existir somente se eles forem incluídos na expressão MDX e a fonte de dados fornecer esses valores quando você executar e recuperar os dados de seus conjuntos de dados. Dessa forma, você poderá consultar esses valores da propriedade Field a partir de qualquer expressão usando a sintaxe descrita na seção seguinte. Entretanto, como esses campos são específicos para esse provedor de dados e não faz parte da linguagem de definição de relatório, as alterações que forem feitas nesse valor não serão salvas com a definição de relatório.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Propriedades de campo predefinidas

Propriedades de campo predefinidas para as quais normalmente existe suporte de vários provedores de dados e que aparecem na consulta MDX subjacente a um conjunto de dados de relatório. Por exemplo, a propriedade de dimensão MDX MEMBER_UNIQUE_NAME é mapeada para a propriedade de campo predefinida do conjunto de dados de relatório UniqueName. Para incluir o valor de nome exclusivo em uma caixa de texto, use a expressão =Fields!<FieldName>.UniqueName.

A tabela a seguir fornece uma lista das propriedades de campo predefinidas que você pode usar para a fonte de dados do Hyperion Essbase.

Propriedade

Tipo

Descrição ou valor esperado

Value

Object

Especifica o valor de dados do campo.

Em uma propriedade de dimensão, é mapeada para MEMBER_CAPTION. Em uma medida, é mapeada para um valor de dados.

IsMissing

Boolean

Indica se o campo foi encontrado no conjunto de dados resultante.

FormattedValue

String

Retorna um valor formatado para o número chave.

Mapeada a partir de FORMATTED_VALUE na expressão MDX.

BackgroundColor

String

Retorna a cor do segundo plano definida no banco de dados para o campo.

Mapeada a partir de BACK_COLOR na expressão MDX.

Color

String

Retorna a cor do primeiro plano definida no banco de dados para o item.

Mapeada a partir de FORE_COLOR na expressão MDX.

UniqueName

String

Retorna o nome totalmente qualificado de um nível.

Mapeada a partir de MEMBER_UNIQUE_NAME na expressão MDX.

Para obter mais informações sobre como usar os campos e as propriedades de campo em uma expressão, consulte Usando coleções internas em expressões (Construtor de Relatórios 3.0 e SSRS).

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Propriedades personalizadas

Propriedades de campo personalizadas para as quais existe suporte de um provedor de dados e que aparecem na consulta MDX subjacente a um conjunto de dados de relatório, mas não aparecem no painel Conjuntos de Dados de relatório como campos daquele conjunto de dados. Por exemplo, Nomes Longos é uma propriedade do membro definida para um nível de dimensão. Para incluir o valor em uma caixa de texto, use a expressão =Fields!<FieldName>("Long Names"). Os nomes de campo na expressão fazem distinção de maiúsculas e minúsculas.

Use a sintaxe a seguir para consultar as propriedades estendidas personalizadas em uma expressão:

  • Fields!FieldName("PropertyName")

A tabela a seguir mostra a propriedade de campo personalizada que você pode usar para uma fonte de dados do Hyperion Essbase.

Propriedade

Tipo

Descrição ou valor esperado

FORMAT_STRING

String

Definida em uma medida, FormattedValue está disponível como um tipo Cadeia de Caracteres.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Comentários

Nem todos os modos de entrega de relatório são suportados por esse provedor de dados. Não há suporte para a entrega de relatórios através de assinaturas controladas por dados para essa extensão de processamento de dados. Para obter mais informações, consulte Usando uma fonte de dados externa para obter dados de assinante na documentação do Reporting Services nos SQL ServerManuais Online.

Para obter mais informações, consulte Using SQL Server 2005 Reporting Services with Hyperion Essbase.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início

Seções relacionadas

Estas seções da documentação fornecem informações conceituais detalhadas sobre dados de relatório, bem como informações de procedimentos sobre como definir, personalizar e usar partes de um relatório relacionadas aos dados.

Ícone de seta usado com o link Voltar ao InícioVoltar ao Início