Acceso URL (SSRS)

  • Artículo

El acceso URL del servidor de informes de SQL Server Reporting Services (SSRS) permite enviar comandos a un servidor de informes a través de una solicitud URL. Esta funcionalidad le permite personalizar cómo representar informes en un servidor de informes en modo nativo o en una biblioteca de SharePoint. Por ejemplo, es posible que haya visto el informe utilizando un conjunto específico de valores de parámetro de informe o tal vez haya consultado una determina página de su interés. Puede definir estos parámetros en una dirección URL mediante parámetros de acceso a direcciones URL predefinidos.

Puede personalizar el modo en el que el servidor de informes procesa el informe incluyendo parámetros sobre los formatos de representación o especificando la apariencia del visor de informes. A continuación, puede enviar esta dirección URL a otros usuarios para que puedan acceder al informe de la misma manera en el navegador.

A continuación se indican otras acciones que puede realizar con el acceso por dirección URL:

Conceptos de acceso URL

El servidor de informes procesa los parámetros incluidos en las solicitudes URL que se dirigen dicho servidor. La manera en la que el servidor de informes administra las solicitudes URL depende de los parámetros, prefijos de parámetro y tipos de elementos que están incluidos en la dirección URL. Las direcciones URL del servidor de informes se rigen por las instrucciones de formato de dirección URL propuestas por el estándar de borrador W3C/IETF del World Wide Web Consortium. La funcionalidad de dirección URL de Reporting Services es compatible con la mayor parte de los exploradores de Internet o aplicaciones que admiten el direccionamiento con direcciones URL estándar.

Sintaxis de acceso URL

Las solicitudes URL pueden contener varios parámetros que se muestran en cualquier orden. Separe los parámetros mediante un símbolo de Y comercial (&) y los pares nombre-valor se separan con un signo igual (=).

Comprender los distintos componentes de una cadena de acceso URL es esencial para enviar comandos de forma eficaz a un servidor de informes de SSRS. La cadena de acceso URL incluye:

  • https://[rswebserviceurl]: la dirección URL del servicio web del servidor de informes.
  • ?: indica el inicio de la cadena de consulta que contiene parámetros.
  • [pathinfo]: ruta de acceso al informe o elemento del servidor.
  • [&prefix:param=value]: uno o varios parámetros con prefijos opcionales que personalizan la representación o el comportamiento del informe.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Descripción de la sintaxis

En la sección siguiente se proporciona una descripción detallada de algunos parámetros usados en la cadena de acceso URL. Para obtener una lista completa, consulte Referencia de parámetros de acceso URL.

rswebserviceurl

Dirección URL del servicio web del servidor de informes.

  • Para el modo nativo, es la dirección URL del servicio web de la instancia del servidor de informes del servicio web configurada en el Administrador de configuración de Reporting Services. Para obtener más información, consulte Configurar las direcciones URL del servidor de informes (Administrador de configuración del servidor de informes).

    Por ejemplo:

    https://myrshost/reportserver
https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE

  • En el modo integrado de SharePoint, es la dirección URL del proxy de Reporting Services de un sitio de SharePoint integrado con Reporting Services.

    Por ejemplo:

    https://myspsite/subsite/_vti_bin/reportserver

    Sugerencia

    Es importante que la dirección URL incluya la sintaxis de proxy de _vti_bin para enrutar la solicitud a través de SharePoint y el proxy HTTP de Reporting Services. El proxy agrega algún contexto a la solicitud HTTP, contexto que es necesario para garantizar la correcta ejecución del informe para los servidores de informes de modo de SharePoint.

pathinfo

Nombre de la ruta de acceso relativa del elemento en la base de datos del servidor de informes en modo nativo o dirección URL completa del elemento en un catálogo de SharePoint.

Ruta de acceso del elemento del catálogo. En modo nativo, es la ruta de acceso relativa del elemento de la base de datos del servidor de informes, que comienza por una barra diagonal (/). Por ejemplo:

/AdventureWorks2022/Employee_Sales_Summary_2022

En el modo integrado de SharePoint, es la dirección URL completa del elemento de la biblioteca de SharePoint, incluida la extensión del elemento. Por ejemplo:

https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl

&prefix:param=value

En una cadena de acceso URL, se agregan parámetros y sus valores correspondientes para personalizar la representación o el comportamiento del informe. Los parámetros se crean en pares nombre-valor mediante la sintaxis param=value, separados por una Y comercial (&).

Use prefijos opcionales como rs: o rc: para dirigirse a procesos específicos dentro del servidor de informes.

Nota:

Si no se incluye un parámetro de acceso URL, el parámetro se procesa en el servidor de informes como un parámetro de informe. Los parámetros de informe no usan un prefijo de parámetro y distinguen entre mayúsculas y minúsculas.

En el ejemplo siguiente se muestra la dirección URL completa tal y como se describe en este artículo:

https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008

Contenido relacionado