Compartilhar via


Usando referências a coleções de DataSources e DataSets em expressões (Construtor de Relatórios 2.0)

A coleção de DataSources representa todas as fontes de dados usadas em um relatório. De maneira semelhante, a coleção de DataSets representa todos os conjuntos de dados para todas as fontes de dados em um relatório. Use o painel Dados do Relatório para obter uma exibição hierárquica dos conjuntos de dados do relatório organizados sob a fonte de dados a qual eles fazem referência. Se você incluir referências nessas coleções, não poderá ver os valores ao visualizar o relatório. Essas coleções estão disponíveis apenas após o relatório ter sido publicado em um servidor de relatório.

DataSources

A coleção de DataSources representa as fontes de dados referenciadas em uma definição de relatório publicada. É possível optar por incluir essas informações no relatório para documentar a origem dos dados do relatório. Essa coleção não está disponível no modo de Visualização. A tabela a seguir descreve as variáveis dentro da coleção de DataSources.

Variável

Tipo

Descrição

DataSourceReference

String

O caminho completo da definição da fonte de dados no servidor de relatório. Por exemplo, você pode incluir uma lista de todas as fontes de dados que um relatório usou como parte de um histórico de relatório. O exemplo a seguir mostra o caminho completo da fonte de dados denominada AdventureWorks:

/DataSources/AdventureWorks.

Type

String

O tipo de provedor de dados para a fonte de dados. Por exemplo, SQL.

DataSets

A coleção de DataSets representa os conjuntos de dados referenciados em uma definição de relatório. É possível optar por incluir a consulta no relatório em uma caixa de texto, de modo que um usuário interessado exatamente nos dados que estão no relatório possa ver o texto do comando original. Essa coleção não está disponível no modo de Visualização. A tabela a seguir descreve os membros da coleção de DataSets.

Membro

Tipo

Descrição

CommandText

String

Para fontes de dados do banco de dados, esta é a consulta usada para recuperar dados da fonte de dados. Se a consulta for uma expressão, essa será a expressão avaliada.

RewrittenCommandText

String

O valor de CommandText expandido do provedor de dados. Geralmente isso é usado para relatórios com parâmetros de consulta mapeados para parâmetros de relatório. O provedor de dados define essa propriedade ao expandir as referências do parâmetro do texto do comando nos valores constantes selecionados para os parâmetros de relatório mapeados.

Usando expressões de consulta

É possível usar expressões para definir a consulta contida em um conjunto de dados. É possível usar esse recurso para projetar relatórios em que a consulta é alterada com base na entrada do usuário, dos dados em outros conjuntos de dados ou outras variáveis. Para obter mais informações sobre consultas, consulte Criando um conjunto de dados de relatório (Construtor de Relatórios 2.0).