Partilhar via


Tipo de conexão XML (SSRS)

Para incluir dados de uma fonte de dados XML no relatório, é necessário ter um conjunto de dados baseado em uma fonte de dados de relatório de tipo XML. Esse tipo interno de fonte de dados é baseado na extensão de dados XML. Use esse tipo de fonte de dados para se conectar e recuperar dados de documentos XML, serviços Web ou XML incorporados na consulta.

Essa extensão de dados oferece suporte a parâmetros e a credenciais gerenciados separadamente na cadeia de conexão.

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

Comentários

Tópicos de instruções

Seções relacionadas

Cadeia de conexão

A cadeia de conexão deve ser uma URL que aponta para o serviço Web, aplicativo com base na Web ou documento XML disponível no HTTP. Os documentos XML deve ter a extensão XML. Você também pode usar uma cadeia de conexão em banco para dados XML incorporados na consulta do conjunto de dados.

Os exemplos a seguir ilustram a sintaxe de cadeia de conexão para um serviço Web e documento XML, respectivamente. Não há suporte para o protocolo file://.

Tipo de documento XML

Exemplo de cadeia de conexão

Serviço Web

http://adventure-works.com/results.aspx

Documento XML

https://localhost/XML/Customers.xml

Documento XML incorporado

Vazio

Para obter mais 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.

Credenciais

As credenciais são necessárias para executar consultas, visualizar o relatório localmente e visualizá-lo no servidor de relatório.

Após a publicação do relatório, convém alterar as credenciais da fonte de dados. Assim, quando o relatório for executado no servidor de relatório, as permissões para recuperar os dados serão válidas.

A partir de um cliente de criação de relatório, as seguintes opções estão disponíveis para especificar credenciais:

  • Usuário atual do Windows (também conhecido como segurança integrada).

  • Nenhuma credencial é necessária. Se você não selecionar nenhuma credencial, o acesso Anônimo será usado. Verifique se você definiu a conta de execução autônoma do servidor de relatório para se conectar a uma fonte de dados externa. A extensão de processamento de dados XML não passa credenciais para a URL de destino nem para o serviço Web; a conexão não será bem-sucedida a menos que você tenha definido a conta de execução autônoma. Para obter mais informações, consulte Configurando a conta de execução autônoma na documentação do Reporting Services nos Manuais Online do SQL Server no msdn.microsoft.com.

Não há suporte para credenciais armazenadas nem solicitadas. Lembre-se de que, se você desabilitar a segurança integrada do Windows, não poderá usá-la para recuperar dados. Se você especificar credenciais armazenadas ou solicitadas, ocorrerá um erro em tempo de execução.

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

Uma consulta especifica os dados a serem recuperados de um conjunto de dados de relatório. As colunas no conjunto de resultados para uma consulta populam a coleção de campos para um conjunto de dados. Um relatório só processa o primeiro conjunto de resultados recuperados por uma consulta.

Você deve usar o designer de consulta com base em texto para criar a consulta. A consulta deve retornar os dados XML.

Para obter mais informações sobre o designer de consulta com base em texto, consulte Interface de usuário do Designer de Consulta com base em texto (Construtor de Relatórios 3.0).

Os valores possíveis para uma consulta de conjunto de dados de uma fonte de dados do tipo XML são mostrados na tabela a seguir.

Consulta do conjunto de dados

Descrição

Vazio

Use uma consulta em branco para criar um conjunto de resultados padrão. A consulta padrão é criada lendo a fonte de dados e desviando a hierarquia do nó XML para a primeira coleção de folhas. O conjunto de resultados inclui todos os nós com valores de texto e todos os atributos de nó ao longo desse caminho. As colunas no conjunto de resultados são mapeadas para os campos no conjunto de dados.

Um caminho do elemento

Especifica a sequência dos nós a ser usada ao recuperar dados XML da fonte de dados.

Um elemento Query XML

Uma especificação de consulta XML com os elementos opcionais a seguir.

Fonte de dados XMLElementos XML obrigatóriosElementos XML opcionais
Para um serviço Web <Method Namespace= "namespace" Name="MethodName" /> -- or -- <SoapAction> ação SOAP </SoapAction> <ElementPath> caminho do elemento </ElementPath> <Method Namespace= "namespace" Name="MethodName" /> -- or -- <SoapAction> ação SOAP </SoapAction>
Para um documento XML <ElementPath> caminho do elemento </ElementPath>
Para um documento XML incorporado <XmlData> XML interno </XmlData> <ElementPath> caminho do elemento </ElementPath> -- or -- <ElementPath IgnoreNamespaces="true"> caminho do elemento </ElementPath>

Para obter mais informações sobre sintaxe de consulta, consulte Sintaxe de consulta XML para especificar dados de relatório XML (SSRS) na documentação do Reporting Services nos Manuais Online do SQL Server no msdn.microsoft.com.

Para obter exemplos, consulte Reporting Services: usando fontes de dados XML e de serviço Web.

Requisitos para recuperar os dados do serviço Web XML

A extensão de processamento de dados XML não detecta o esquema para você. Portanto, você deve ter alguma maneira de descobrir quais métodos SOAP recuperarão os dados desejados. Você também deve entender o namespace ou esquema de endereçamento que o serviço Web usa para seus dados.

Para um serviço Web, você pode fornecer um elemento <Query> que especifica um método a ser chamado ou ação SOAP. Você pode deixar a consulta em branco e usar a consulta padrão se os dados XML tiverem uma estrutura hierárquica que gera os dados que você deseja usar em seu relatório. Os atributos e valores de nó do elemento XML recuperados quando a consulta é executada são mapeados para os campos do conjunto de dados usados no seu relatório.

Requisitos para recuperar os dados de documento XML

Usando o protocolo http, o servidor deve retornar dados XML ou os dados XML devem ser incorporados no elemento XML Query. Se você se referir a um documento XML diretamente usando o protocolo http, a extensão deverá ser .xml.

Você deve saber como criar uma consulta XML que recupere todos os dados necessários. Se você não especificara um caminho de elemento, o comportamento padrão para analisar um documento XML é selecionar o primeiro caminho disponível para uma coleção de nós folha no documento XML. Se o documento XML incluir caminhos adicionais para outras coleções de nós folha irmãs, esses nós serão ignorados a menos que você especifique um caminho em sua consulta.

Você pode fornecer um caminho de elemento usando a sintaxe XML semelhante a XQuery.

Para obter mais informações, consulte Sintaxe do caminho do elemento para especificar dados de relatório XML (SSRS) na documentação do Reporting Services nos Manuais Online do SQL Server no msdn.microsoft.com.

Parâmetros

A consulta não é analisada para identificar parâmetros.

Para adicionar parâmetros, você deve criá-los manualmente na página Parâmetro da caixa de diálogo Propriedades do Conjunto de Dados.

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

Comentários

A extensão de dados XML oferece suporte a relatórios de dados XML tabulares e não hierárquicos. Para obter mais informações, consulte Adicionando dados de fontes de dados externas (SSRS).

Não há suporte interno para recuperar documentos XML de um banco de dados SQL Server.

Í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