Usar uma fonte de dados externa para dados do assinante ( assinaturaData-Driven)

Em uma assinatura controlada por dados, os dados de assinatura dinâmicos são fornecidos por uma consulta ou um comando que recupera dados de uma fonte de dados externa. Os dados de assinatura podem ser recuperados de qualquer fonte de dados com suporte que satisfaça os requisitos para o processamento de assinaturas controladas por dados. A sintaxe da consulta ou do comando deve ser válida para uma extensão de processamento de dados instalada com seu servidor de relatório.

Requisitos de processamento de dados

O Reporting Services usa extensões de processamento de dados para recuperar dados de assinatura. Os tipos de fonte de dados recomendados incluem o seguinte:

• Bancos de dados relacionais do SQL Server

• Bancos de dados Oracle

• Fontes de dados multidimensionais e de mineração de dados do Analysis Services

• Fontes de dados XML

  Ao usar a extensão de processamento de dados XML para dados do assinante, certifique-se de aumentar as configurações de tempo limite da consulta na assinatura. A extensão de processamento de dados XML usa milissegundos em vez de segundos para os valores de tempo limite de consulta. Se você não aumentar o valor do tempo limite, a assinatura poderá falhar devido ao tempo de processamento insuficiente.

  Evite usar a opção Credenciais não são necessárias ao configurar a conexão com a fonte de dados do assinante. As credenciais armazenadas são recomendadas ao usar a extensão de processamento de dados XML para recuperar dados de assinatura em tempo de execução.

Outros tipos de fontes de dados com suporte podem ser usados, embora não haja garantia de que funcionem. Por exemplo, os seguintes tipos de fonte de dados não podem ser usados para dados do assinante:

• Bancos de dados SAP Netweaver BI

• modelos de relatório

Se você tiver uma extensão de processamento de dados personalizada que deseja usar nas assinaturas controladas por dados, implemente as interfaces IDbCommand e IDataReader . A extensão de processamento de dados deve oferecer suporte para execuções de consulta somente de esquema. Essa consulta é usada para recuperar metadados de coluna em tempo de design, para que os usuários possam mapear colunas para opções de entrega e parâmetros de relatório na definição de assinatura. A execução de consulta somente de esquema ocorre em uma fase inicial, quando o usuário está definindo a assinatura.

Requisitos de consulta

Ao criar uma consulta que recupera dados de assinatura, considere o seguinte:

• Você pode criar só uma consulta para a assinatura.

• A consulta deve retornar todos os valores que você deseja usar para opções de entrega e para especificar parâmetros de relatório.

• O servidor de relatório criará uma entrega de relatório para cada linha no conjunto de resultados. Se o conjunto de resultados consistir em 300 linhas, o servidor de relatório tentará entregar 300 relatórios.

Definindo opções de entrega usando dados variáveis de um banco de dados do assinante

Você pode usar dados no banco de dados de assinantes para personalizar opções de entrega para cada destinatário. O tipo de extensão de entrega que você está usando determina quais opções estão disponíveis. Se você estiver usando a extensão de entrega de email do servidor de relatório, a consulta deverá conter um alias de email para cada assinante. Se você estiver usando a entrega de compartilhamento de arquivos, os dados do assinante deverão incluir valores que podem ser usados para criar arquivos de relatório específicos do assinante ou para fornecer um destino para a entrega. Para obter mais informações, consulte Entrega de Compartilhamento de Arquivos no Reporting Services e Entrega de Email no Reporting Services.

Passando valores de parâmetro do banco de dados do assinante para o relatório

Se você estiver criando uma assinatura controlada por dados para um relatório parametrizado, poderá usar valores de parâmetro variável para personalizar a saída de cada relatório. Por exemplo, o banco de dados de assinantes pode conter números de identificação de funcionários, datas de contratação, cargos e informações sobre a localização de escritórios que podem ser usados para filtrar dados de relatório. Se o relatório aceitar os parâmetros baseados nesses dados ou em outros dados de coluna disponíveis, você pode mapear o parâmetro para a coluna adequada.

Ao mapear campos de assinante para parâmetros de relatório, verifique se os tipos de dados e os comprimentos de coluna são compatíveis. Se houver uma incompatibilidade de tipo de dados, ocorrerá um erro durante o processamento da assinatura. Para saber mais sobre como usar dados de assinante em um relatório parametrizado, consulte Criar uma assinatura de Data-Driven (Tutorial do SSRS).

Modificando a fonte de dados do assinante

As modificações a seguir feitas na fonte de dados de assinante podem impedir a execução da assinatura:

• Remoção de colunas mencionadas na assinatura.

• Modificação da estrutura de tabela da fonte de dados.

• Alteração do tipo de dados e de outras propriedades de coluna.

Se fizer alguma dessas alterações, você deverá atualizar a assinatura.

Consulte Também

Criar, modificar e excluir uma assinatura de Data-Driven
Assinaturas doData-Driven
Assinaturas e entrega (Reporting Services)