Compartilhar via

Assinaturas e entrega (Reporting Services)

  • Artigo

Uma assinatura do Reporting Services é uma configuração que fornece um relatório em um momento específico ou em resposta a um evento, em um formato de arquivo que você especificar. Por exemplo, toda quarta-feira, salvar o relatório MonthlySales.rdl como um documento do Microsoft Word em um compartilhamento de arquivo. As assinaturas podem ser usadas para agendar e automatizar a entrega de um relatório e com um conjunto específico de valores de parâmetros do relatório.

Você pode criar várias assinaturas para um único relatório e variar as opções de assinatura. Por exemplo, você pode especificar valores de parâmetros diferentes para produzir três versões de um relatório, como um relatório de vendas da região Ocidental, da região Oriental e de todas as vendas.

fluxo de assinatura do ssrs de exemplo

As assinaturas não estão disponíveis em todas as edições do SQL Server. Para obter uma lista dos recursos compatíveis com as edições do SQL Server, consulte Recursos compatíveis com as edições do SQL Server 2014.

Observação

A partir do SQL Server 2008 R2Reporting Services, você pode transferir a propriedade de uma assinatura programaticamente. Não há nenhuma interface do usuário que você possa usar para transferir propriedade de assinaturas. Para obter mais informações, consulte ChangeSubscriptionOwnere Usar o PowerShell para alterar e listar Reporting Services proprietários de assinatura e executar uma assinatura.

Neste tópico:

Tópicos nesta seção:

Cenários de assinatura e de entrega

Para cada assinatura, você pode configurar opções de entrega, e as opções disponíveis são determinadas pela extensão de entrega escolhida. Uma extensão de entrega é um módulo que dá suporte a alguma maneira de distribuição. Reporting Services inclui várias extensões de entrega. Também a extensão de entrega que pode estar disponível por outros fornecedores.

Se você for um desenvolvedor, poderá criar extensões de entrega personalizadas para oferecer suporte a mais cenários. Para obter mais informações, consulte Implementing a Delivery Extension.

A tabela a seguir descreve os cenários comuns de assinatura do Reporting Services .

Cenário Descrição
Relatórios de email Relatórios de email a usuários individuais e grupos. Crie uma assinatura e especifique um alias de grupo ou de email para receber um relatório que queira distribuir. Você pode fazer com que o Reporting Services determine os dados da assinatura em tempo de execução. Se você quiser enviar o mesmo relatório a um grupo que tenha uma lista mutante de membros, poderá usar uma consulta para derivar a lista de assinaturas em tempo de execução.
Exibir os relatórios offline Os relatórios que você deseja arquivar podem ser enviados diretamente a uma pasta compartilhada cujo backup é feito em uma agenda noturna. Relatórios grandes cujo carregamento é muito demorado em um navegador podem ser enviados a uma pasta compartilhada em um formato que pode ser exibido em um aplicativo de área de trabalho. Você pode selecionar um dos seguintes formatos para a saída de assinatura:

Arquivo XML com dados de relatório

CSV (delimitado por vírgulas)

PDF

MHTML (arquivo da Web)

Microsoft Excel

Arquivo TIFF

Microsoft Word
Cache pré-carregado Se você tiver várias instâncias de um relatório com parâmetros ou um grande número de usuários de relatório que veem relatórios, será possível pré-carregar os relatórios no cache para reduzir o tempo de processamento necessário para exibição dos mesmos.
Relatórios voltados para dados Use assinaturas controladas por dados para personalizar a saída do relatório, as opções de entrega e as configurações de parâmetro de relatório em tempo de execução. A assinatura usa uma consulta para obter valores de entrada de uma fonte de dados em tempo de execução. Você pode usar assinaturas controladas por dados para executar uma operação de mesclagem de email que envia um relatório para uma lista de assinantes determinada no momento em que a assinatura é processada.

Assinaturas padrão e assinaturas controladas por dados

Reporting Services dá suporte a dois tipos de assinatura: padrão e controlada por dados. Assinaturas padrão são criadas e gerenciadas por usuários individuais. Uma assinatura padrão consiste em valores estáticos que não podem ser variados durante o processamento da assinatura. Para cada assinatura padrão há exatamente um conjunto de opções de apresentação de relatório, opções de entrega e parâmetros de relatório.

Assinaturas controladas por dados obtêm informações de assinatura em tempo de execução consultando a fonte de dados externa que fornece valores usados para especificar um destinatário, parâmetros de relatório ou um formato do aplicativo. Você pode usar assinaturas controladas por dados se tiver uma lista de destinatários muito grande ou desejar variar a saída de relatório para cada destinatário. Para usar assinaturas controladas por dados, é necessário ter conhecimento especializado na criação de consultas e entender como os parâmetros são usados. Administradores de servidor de relatório geralmente criam e administram essas assinaturas. Para saber mais, consulte o seguinte:

Requisitos de assinatura

Antes de criar uma assinatura para um relatório, os seguintes pré-requisitos devem ser cumpridos:

Requisito Descrição
Permissões Você deve ter acesso ao relatório. Antes de assinar um relatório, você deve ter permissão para exibi-lo.

Sua atribuição de função devem incluir a tarefa “Gerenciar assinaturas individuais”.
Credenciais armazenadas Para criar uma assinatura, o relatório deve usar credenciais armazenadas ou nenhuma credencial para recuperar dados em tempo de execução. Você não pode assinar um relatório que é configurado para usar as credenciais representadas ou delegadas do usuário atual para conectar-se a uma fonte de dados externa. As credenciais armazenadas podem ser uma conta do Windows ou uma conta de usuário de banco de dados. Para obter mais informações, consulte Especificar informações de credenciais e de conexão para fontes de dados de relatório

É necessário ter permissão para exibir o relatório e criar assinaturas individuais. É necessário habilitarEventos Agendados e Entrega de Relatórios no servidor de relatórios. Para saber mais, consulte Crie e gerencie assinaturas de servidores de relatório no modo Nativo.
Valores dependentes do usuário em um relatório Somente para assinaturas padrão, você pode criar assinaturas para relatórios que incorporam informações da conta de usuário em um filtro ou como texto que aparece no relatório. No relatório, o nome da conta de usuário é especificado por uma expressão User!UserID resolvida no usuário atual. Ao criar uma assinatura, o usuário que cria a assinatura é considerado o usuário atual.
Nenhuma segurança do item de modelo Não é possível assinar um relatório do Construtor de Relatórios que use um modelo como uma fonte de dados se o modelo contiver configurações de segurança do item de modelo. Somente relatórios que usam a segurança do item de modelo são incluídos nesta restrição.
Valores de parâmetro Se o relatório usar parâmetros, um valor de parâmetro deverá ser especificado com o próprio relatório ou na assinatura definida. Se valores padrão forem definidos no relatório, você poderá definir o valor de parâmetro a ser usado como o padrão.

Extensões de Entrega

As assinaturas são processadas no servidor de relatórios e são distribuídas através de extensões de entrega implantadas no servidor. Por padrão, é possível criar assinaturas que enviam relatórios para uma pasta compartilhada ou um endereço de email. Se o servidor de relatório for configurado para o modo integrado do SharePoint, também será possível enviar um relatório para uma biblioteca do SharePoint.

Quando cria uma assinatura, o usuário pode escolher uma das extensões de entrega disponíveis para determinar como o relatório será entregue. Reporting Services inclui as seguintes extensões de entrega.

Extensão de entrega Descrição
Compartilhamento de Arquivos do Windows Entrega um relatório como um arquivo de aplicativo estático para uma pasta compartilhada que pode ser acessada na rede.
Email Entrega uma notificação ou um relatório como um anexo de email ou link de URL.
Biblioteca do SharePoint Entrega um relatório como um arquivo de aplicativo estático para uma biblioteca do SharePoint que pode ser acessada a partir de um site do SharePoint. O site deve estar integrado a um servidor de relatório executado no modo integrado do SharePoint.
Nulo O provedor de entrega nulo é uma extensão de entrega altamente especializada usada para pré-carregar um cache com relatórios com parâmetros e prontos para exibição. Esse método não está disponível para usuário em assinaturas individuais. Entrega nula é usada por administradores em assinaturas controladas por dados para melhorar o desempenho do servidor de relatórios através do pré-carregamento do cache.

Observação

Entrega de relatório é uma parte extensível da arquitetura do Reporting Services . Fornecedores de terceiros podem criar extensões de entrega personalizadas para rotear relatórios a locais ou dispositivos diferentes. Para obter mais informações sobre extensões de entrega personalizadas, consulte Implementing a Delivery Extension.

Partes de uma assinatura

Uma definição de assinatura consiste nas seguintes partes:

  • Um ponteiro para um relatório que pode ser executado de modo autônomo (isto é, um relatório que usa credenciais armazenadas ou nenhuma credencial).

  • Um método de entrega (por exemplo, email) e configurações para o modo de entrega (como um endereço de email).

  • Uma extensão de renderização para apresentar o relatório em um formato específico.

  • Condições para processar a assinatura, que são expressas como um evento.

    Normalmente, as condições para executar um relatório baseiam-se na hora. Por exemplo, você executar um relatório específico todas as terças-feiras às 15h00 UTC. No entanto, se o relatório for executado como um instantâneo, você pode especificar que a assinatura seja executada sempre que o instantâneo for atualizado.

  • Parâmetros usados ao executar o relatório.

    Os parâmetros são opcionais e especificados somente para relatórios que aceitam valores de parâmetro. Como uma assinatura normalmente é de propriedade do usuário, os valores de parâmetro especificados variam conforme a assinatura. Por exemplo, gerentes de vendas de divisões diferentes usarão parâmetros que retornam dados para sua divisão. Todos os parâmetros devem ter um valor explicitamente definido ou um valor padrão válido.

As informações de assinatura são armazenadas com relatórios individuais em um banco de dados do servidor de relatório. Você não pode gerenciar assinaturas separadamente do relatório com o qual estão associadas. Observe que as assinaturas não podem ser estendidas para incluir descrições, outros textos personalizados ou outros elementos. As assinaturas podem conter somente os itens listados anteriormente.

Como as assinaturas são processadas

Reporting Services inclui um processador de agendamento e entrega, que fornece funcionalidade para o agendamento de relatórios e suas entregas aos usuários. O servidor de relatório responde a eventos monitorados continuamente. Quando o evento que corresponde às condições definidas para uma assinatura ocorre, o servidor de relatório lê a assinatura para determinar como processar e entregar o relatório. O servidor de relatório solicita a extensão de entrega que é especificada na assinatura. Após a execução da extensão de entrega, o servidor de relatório extrai informações de entrega da assinatura e as transmite à extensão de entrega para processamento.

A extensão de entrega renderiza o relatório no formato definido na assinatura e, em seguida, entrega o relatório ou a notificação ao destino especificado. Se não for possível entregar um relatório, uma entrada será registrada no arquivo de log do servidor de relatório. Se desejar oferecer suporte para operações de repetição, configure o servidor de relatório para tentar entregar novamente caso a primeira tentativa falhe.

Processando uma assinatura padrão

As assinaturas padrão produzem uma instância de um relatório. O relatório é entregue em uma única pasta compartilhada ou nos endereços de email especificados na assinatura. O layout e os dados do relatório não variam. Se o relatório usar parâmetros, uma assinatura padrão será processada com um único valor para cada parâmetro do relatório.

Processando uma assinatura controlada por dados

As assinaturas controladas por dados podem produzir muitas instâncias de relatório que são entregues a vários destinos. O layout do relatório não varia, mas os dados podem variar se os valores de parâmetro forem transmitidos a partir de um conjunto de resultados de assinante. As opções de entrega que afetam a renderização do relatório e a anexação ou o vínculo do relatório ao email também podem variar dependendo do assinante quando os valores são transmitidos a partir do conjunto de linhas.

As assinaturas controladas por dados podem produzir um grande número de entregas. O servidor de relatório cria um envio para cada linha do conjunto que é retornado da consulta de assinatura.

Características de entrega de relatório

Os relatórios que são entregues por meio de assinaturas padrão normalmente são renderizados como relatórios estáticos. Esses relatórios são baseados no instantâneo de execução de relatório mais recente ou são gerados como um relatório estático para concluir uma entrega. Se a opção Incluir Link for selecionada em uma assinatura para um relatório executado sob demanda, o servidor de relatório executará o relatório quando você clicar no hiperlink.

Observação

Os relatórios que são entregues por uma URL permanecem conectados ao servidor de relatório e podem ser atualizados ou excluídos entre as exibições. As opções de entrega escolhidas para a assinatura determinam se o relatório será entregue como uma URL, inserido no corpo de uma mensagem de email ou enviado como anexo.

Os relatórios que são entregues por uma assinatura controlada por dados podem ser gerados novamente enquanto a assinatura está sendo processada. O servidor de relatório não observa uma instância específica de um relatório ou seu conjunto de dados para concluir uma assinatura controlada por dados. Se a assinatura usar valores de parâmetro diferentes para assinantes diferentes, o servidor de relatório gerará o relatório novamente para produzir o resultado necessário. Se os dados subjacentes forem atualizados após a primeira cópia do relatório ser criada e entregue, os usuários que obtiverem relatórios posteriormente no processo poderão ver dados baseados em um conjunto de dados diferente. Você pode usar o relatório executado como um instantâneo para verificar se a mesma instância do relatório é entregue a todos os assinantes. No entanto, se uma atualização agendada do instantâneo ocorrer durante o processamento da assinatura, os usuários ainda poderão obter dados diferentes em seus relatórios.

Acionando o processamento de assinaturas

O servidor de relatório usa dois tipos de eventos para acionar o processamento de assinaturas: um evento controlado por tempo que é especificado em uma agenda ou um evento de atualização de instantâneo.

Um gatilho controlado por tempo usa uma agenda específica do relatório ou uma agenda compartilhada para especificar quando uma assinatura deve ser executada. Para relatórios sob demanda e em cache, as agendas são a única opção de gatilho.

Um evento de atualização de instantâneo usa a atualização agendada de um instantâneo de relatório para acionar uma assinatura. Você pode definir uma assinatura que é acionada sempre que o relatório é atualizado com novos dados, com base nas propriedades de execução definidas no relatório.

Consulte Também

Criar uma assinatura de Data-Driven (Tutorial do SSRS)AgendasReporting Services Servidor de Relatório (Modo Nativo)Criar e gerenciar assinaturas para servidores de relatório de modo nativomonitorar assinaturas Reporting Services