Compartilhar via


Referências de coleções DataSources e DataSets (Construtor de Relatórios e SSRS)

A coleção 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.

ObservaçãoObservação

Você pode criar e modificar definições de relatório (.rdl) no Construtor de Relatórios e no Designer de Relatórios no SQL Server Data Tools. Cada ambiente de criação fornece modos diferentes para criar, abrir e salvar relatórios e itens relacionados. Para obter mais informações, consulte Partes de Relatório (Construtor de Relatórios e SSRS) e Partes de Relatório no Designer de Relatórios (SSRS) na Web em microsoft.com.

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 AdventureWorks2012:

/DataSources/AdventureWorks2012.

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 Conjuntos de dados inseridos e compartilhados de relatório (Construtor de Relatórios e SSRS).

Consulte também

Referência

Exemplos de expressões (Construtor de Relatórios e SSRS)

Conceitos

Expressões (Construtor de Relatórios e SSRS)