Accesso con URL (SSRS)

  • Articolo

L'accesso tramite URL al server di report in SQL Server Reporting Services (SSRS) consente di inviare comandi a un server di report tramite una richiesta URL. Questa funzionalità consente di personalizzare la modalità di rendering dei report in un server di report in modalità nativa o in una raccolta di SharePoint. Ad esempio, è possibile visualizzare il report utilizzando un set specifico di valori dei parametri del report o visualizzare una particolare pagina di interesse nel report. È possibile definire questi parametri in un URL usando parametri di accesso url predefiniti.

È possibile personalizzare il modo in cui il server di report elabora il report incorporando parametri relativi ai formati di rendering o all'aspetto del visualizzatore di report. È quindi possibile inviare questo URL ad altri utenti in modo che possano accedere al report nello stesso modo nel browser.

Le altre azioni che si possono eseguire con l'accesso tramite URL sono:

Concetti relativi all'accesso tramite URL

Il server di report processa parametri contenuti nelle richieste dell’URL al server di report. Il modo in cui le richieste URL vengono gestite dal server di report dipende dai parametri, dai prefissi di parametro e dai tipi di elementi inclusi nell'URL. Gli URL del server di report sono conformi alle linee guida per la formattazione degli URL proposte dalla bozza di standard congiunta del World Wide Web Consortium W3C/IETF. La funzionalità URL di Reporting Services è compatibile con la maggior parte dei browser Internet o delle applicazioni che supportano il reindirizzamento URL standard.

Sintassi per l'accesso con URL

Le richieste URL possono contenere più parametri elencati in qualsiasi ordine. I parametri si separano con una e commerciale (&), mentre le coppie nome/valore si separano con un segno di uguale (=).

Comprendere i diversi componenti di una stringa di accesso URL è essenziale per l'invio efficace di comandi a un server di report SSRS. La stringa di accesso all'URL include:

  • https://[rswebserviceurl]: URL del servizio Web del server di report.
  • ?: indica l'inizio della stringa di query che contiene parametri.
  • [pathinfo]: percorso del report o dell'elemento nel server.
  • [&prefix:param=value]: uno o più parametri con prefissi facoltativi che personalizzano il rendering o il comportamento del report.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]

Descrizione della sintassi

Nella sezione seguente viene fornita una descrizione dettagliata di alcuni parametri usati nella stringa di accesso all'URL. Per un elenco completo, vedere Informazioni di riferimento sul parametro di accesso URL.

rswebserviceurl

URL del servizio Web del server di report.

  • Per la modalità nativa, si tratta dell'URL del servizio Web dell'istanza del server di report del servizio Web configurato in Gestione configurazione Reporting Services. Per altre informazioni sul formato dell'URL, vedere Configurare gli URL del server di report (Gestione configurazione del server di report).

    Ad esempio:

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

  • Per la modalità integrata SharePoint, è l'URL del proxy Reporting Services a un sito di SharePoint integrato con Reporting Services.

    Ad esempio:

    https://myspsite/subsite/_vti_bin/reportserver

    Suggerimento

    È importante che nell'URL sia inclusa la sintassi proxy _vti_bin per indirizzare la richiesta tramite SharePoint e il proxy HTTP di Reporting Services . Tramite il proxy viene aggiunto del contesto alla richiesta HTTP. Questo contesto è necessario per garantire l'esecuzione corretta del report per i server di report in modalità SharePoint.

pathinfo

Il nome di percorso relativo dell'elemento nel database del server di report in modalità nativa o l'URL completo dell'elemento in un catalogo di SharePoint.

Il percorso dell'elemento del catalogo. Per la modalità nativa, si tratta del percorso relativo dell'elemento nel database del server di report, che inizia con una barra (/). Ad esempio:

/AdventureWorks2022/Employee_Sales_Summary_2022

Per la modalità integrata SharePoint, si tratta dell'URL completo dell'elemento nella raccolta di SharePoint, inclusa l'estensione dell'elemento. Ad esempio:

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

&prefix:param=value

In una stringa di accesso URL aggiungere parametri e i relativi valori corrispondenti per personalizzare il rendering o il comportamento del report. È possibile costruire parametri in coppie nome/valore usando la sintassi param=value, separata da un e commerciale (&).

Usare prefissi facoltativi come rs: o rc: per definire come destinazione processi specifici all'interno del server di report.

Nota

Se per un parametro di accesso tramite URL non viene incluso un prefisso, il parametro viene elaborato dal server di report come parametro del report. Nei parametri del report non si utilizzano prefissi dei parametri e non esistono distinzioni tra maiuscole e minuscole.

L'esempio seguente mostra l'URL completo come descritto in questo articolo:

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

Contenuto correlato