Assinaturas e entrega (Reporting Services)

Uma assinatura do Reporting Services é uma configuração que entrega um relatório em um horário específico ou em resposta a um evento. Também está no formato de arquivo especificado. 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 diversas assinaturas para um único relatório para 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. São relatórios como relatório de vendas da região oeste, vendas da região leste e todas as vendas.

Diagram of an example SSRS subscription flow.

As assinaturas não estão disponíveis em todas as edições do SQL Server. Para obter uma lista de recursos compatíveis com o SQL Server, consulte Edições e recursos com suporte no SQL Server 2022.

Neste tópico:

Tópicos nesta seção:

Cenários de assinatura e de entrega

Para cada assinatura, a extensão de entrega escolhida determina as opções de entrega que você pode configurar. Uma extensão de entrega é um módulo que dá suporte a alguma maneira de distribuição. O Reporting Services inclui diversas extensões de entrega e extensões de entrega podem estar disponíveis por meio de fornecedores de terceiros.

Se você for um desenvolvedor, poderá criar extensões de entrega personalizadas para dar suporte a outros cenários. Para obter mais informações, consulte Implementar uma extensão de entrega.

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 Você pode selecionar um dos seguintes formatos para a saída de assinatura:

- Arquivo XML com os dados de relatório
- CSV (delimitado por vírgulas)
- PDF
- MHTML (arquivo da Web)
- Microsoft Excel
- Arquivo TIFF
- Microsoft Word

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.
Pré-carregar cache Se você tiver diversas instâncias de um relatório parametrizado ou um grande número de usuários de relatórios que exibem relatórios, será possível pré-carregar relatórios no cache. O pré-carregamento reduz o tempo de processamento necessário para exibir o relatório.
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. Usuários individuais criam e gerenciam assinaturas padrão. 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 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 obter mais informações, consulte os seguintes artigos:

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.

Para servidores de relatório do modo Nativo, as atribuições de função a seguir afetam as assinaturas:

- A tarefa "Gerenciar assinaturas individuais" permite que os usuários criem, modifiquem e excluam assinaturas para um relatório específico. Nas funções predefinidas, essa tarefa faz parte das funções Navegador e Construtor de Relatórios. As atribuições de função que incluem essa tarefa permitem que um usuário gerencie somente as assinaturas que ele cria.
A tarefa "Gerenciar todas as assinaturas" permite que os usuários acessem e modifiquem todas as assinaturas. Essa tarefa é obrigatória para criar assinaturas controladas por dados. Em funções predefinidas, a função Gerenciador de Conteúdo inclui essa tarefa.
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 Criar e gerenciar 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 você definir valores padrão no relatório, poderá definir o valor do parâmetro para usar 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 Implementar uma extensão de entrega.

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 usam 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. 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.

Processar 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.

Processar 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. Opções de entrega que afetam como o relatório é renderizado e se o relatório é anexado ou vinculado ao email. Essas opções também podem variar de assinante para assinante quando os valores são passados 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ê selecionar o 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. Os dados subjacentes podem ser atualizados após a criação e a entrega da primeira cópia do relatório. Quando você atualizar o relatório, os usuários que obtêm relatórios posteriormente no processo poderão ver dados com base em diferentes conjuntos de resultados. 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.

Disparar processamento de assinatura

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 será disparada sempre que o relatório for atualizado com novos dados. A assinatura é disparada com base nas propriedades de execução do relatório definidas no relatório.

Controle programático de assinaturas

O modelo de objeto Reporting Services permite que você audite e controle programaticamente as assinaturas e o processamento de assinaturas. Consulte os seguintes artigos para obter exemplos e começar:

Criar uma assinatura controlada por dados (Tutorial do SSRS)
Agendas
Servidor de relatórios do Reporting Services (modo nativo)
Monitorar assinaturas do Reporting Services