Escolher entre o acesso à URL e o SOAP no Reporting Services

Aplica-se a: SQL Server Reporting Services (2016) ❌ SQL Server Reporting Services (2017) ❌ Servidor de Relatórios do Power BI

A integração do Reporting Services a aplicativos personalizados pode ser desafiadora. O desafio, no entanto, não é a complexidade do modelo de programação ou APIs, mas as muitas maneiras possíveis de integrá-lo. O Reporting Services foi projetado desde o início como uma plataforma de desenvolvedor e, como tal, foi criado com a flexibilidade de programação em mente. Com a flexibilidade vem a necessidade de tomar decisões importantes sobre como integrar a navegação de relatórios e a funcionalidade de gerenciamento do Reporting Services aos seus aplicativos de negócios existentes.

Observação

A partir do SQL Server 2017 Reporting Services, o acesso à API REST está disponível para o desenvolvimento de soluções. O acesso à API SOAP foi preterido. Para obter mais informações, consulte Desenvolver com as APIs REST do Reporting Services.

Existem dois modos de integrar o Reporting Services a aplicativos personalizados: acesso à URL e a API SOAP do Reporting Services. A opção utilizada dependerá de vários fatores. Em alguns casos, a integração do Reporting Services aos seus aplicativos de negócios personalizados exigirá o uso do acesso à URL e do SOAP. Você deve fazer as seguintes perguntas:

• Que tipo de funcionalidade de relatório empresarial você ou os seus usuários finais exigem? Você precisa de uma maneira simples de abrir relatórios e de navegar neles ou precisa de recursos mais avançados de gerenciamento de servidor de relatório a partir da sua solução comercial personalizada?

• Em qual tipo de ambiente os seus usuários operam normalmente? O seu aplicativo comercial é um aplicativo Web ou um aplicativo do Windows? Com que facilidade os usuários finais podem alternar entre um ambiente do Win32 e um ambiente da Web? De que tipo de controle você precisa sobre o ambiente nos quais os relatórios serão executados e gerenciados?

Depois de responder às perguntas anteriores, você pode decidir como integrar o Reporting Services à sua infraestrutura de TI. Normalmente, o acesso à URL é o preferido para a exibição e navegação de relatórios individuais. O acesso à URL permite que você navegue de forma livre e rápida sem a sobrecarga do serviço Web. Além disso, o acesso à URL é, atualmente, a única técnica de programação que usa o Visualizador de HTML completo para navegação de relatórios, o que inclui a barra de ferramentas de relatório. O acesso à URL também oferece um desempenho melhor do que o SOAP porque ignora o marshaling de solicitações SOAP para e do servidor. Em cenários de integração que exigem acesso rápido e fácil a relatórios com ferramentas internas para exibição e navegação, o acesso à URL é a melhor opção.

Observação

O acesso à URL do servidor de relatório dá suporte ao Visualizador de HTML e à funcionalidade estendida da barra de ferramentas de relatório. A API SOAP API não dá suporte a esse tipo de relatório renderizado. Se você renderizar relatórios usando a API SOAP, crie e desenvolva sua própria barra de ferramentas de relatório.

Para obter mais informações sobre a barra de ferramentas de relatório, consulte Visualizador de HTML e a barra de ferramentas de relatório.

Para obter mais informações sobre o acesso à URL, consulte Acesso à URL.

O acesso à URL é útil para exibir relatórios, mas não fornece a funcionalidade de gerenciamento de relatório e namespace que pode ser essencial para qualquer cenário de relatório corporativo. Nesse caso, a funcionalidade ampla e sofisticada da API SOAP do Reporting Services é recomendada. Com a API SOAP você pode gerenciar e implantar relatórios, criar agendas, configurar propriedades de servidor, gerenciar o namespace de servidor de relatório, criar assinaturas e mais. A API SOAP exibe o conjunto completo de funcionalidades de gerenciamento do Reporting Services. A API SOAP também pode habilitar a exibição e a navegação de relatórios por meio do método Render da API. No entanto, a exibição de relatórios por meio da API SOAP não habilita a funcionalidade de exibição interna da barra de ferramentas de relatório, nem manipula automaticamente a interatividade de relatório fornecida pelo acesso à URL.

Para obter mais informações sobre a API SOAP do Reporting Services, consulte Serviço Web do Servidor de Relatórios.

Na maioria dos casos, o acesso à URL e as chamadas SOAP são necessários para atender às suas necessidades de relatórios. O SOAP é usado ao se conectar inicialmente ao banco de dados do servidor de relatório e apresentar a lista disponível de relatórios em uma interface do usuário. O acesso à URL é usado para realmente acessar e navegar em relatórios individuais.

Para obter um exemplo de combinação do acesso de URL com o serviço Web para fornecer relatórios integrados, consulte Amostras de produto do SQL Server Reporting Services.

Mais perguntas? Experimente perguntar no fórum do Reporting Services