Distribuzione di un'estensione per il recapitoDeploying a Delivery Extension

Le estensioni per il recapito forniscono le informazioni di configurazione in un file di configurazione XML.Delivery extensions supply their configuration information in the form of an XML configuration file. Il file XML è conforme all'elemento XML Schema definito per le estensioni per il recapito.The XML file conforms to the XML schema defined for delivery extensions. Le estensioni per il recapito forniscono l'infrastruttura per l'impostazione e la modifica del file di configurazione.Delivery extensions provide infrastructure for setting and modifying the configuration file.

Se un'estensione per il recapito viene sostituita o aggiornata, tutte le sottoscrizioni che fanno riferimento all'estensione per il recapito rimangono valide.If a delivery extension is replaced or upgraded, all subscriptions that reference the delivery extension remain valid.

Dopo avere scritto e compilato l'estensione per il recapito Reporting ServicesReporting Services in una libreria MicrosoftMicrosoft .NET Framework.NET Framework, è necessario copiarla nella directory appropriata e aggiungere una voce al file di configurazione Reporting ServicesReporting Services appropriato, in modo che il server di report possa individuarla.After you have written and compiled your Reporting ServicesReporting Services delivery extension into a MicrosoftMicrosoft .NET Framework.NET Framework library, you must copy the extension to the appropriate directory and add an entry to the appropriate Reporting ServicesReporting Services configuration file so the report server can locate it.

Elemento Extension del file di configurazioneConfiguration-File Extension Element

Le estensioni per il recapito distribuite nel server di report devono essere immesse come elementi Extension nel file di configurazione.Delivery extensions that you deploy to the report server need to be entered as Extension elements in the configuration file. Il file di configurazione per il server di report è RSReportServer.config.The configuration file for the report server is RSReportServer.config.

Nella tabella riportata di seguito vengono descritti gli attributi dell'elemento Extension per le estensioni per il recapito.The following table describes the attributes for the Extension element for delivery extensions.

AttributeAttribute DescrizioneDescription
NomeName Nome univoco per l'estensione, ad esempio "Posta elettronica server di report" per l'estensione per il recapito tramite posta elettronica o "Condivisione file server di report" per l'estensione per il recapito tramite condivisione.A unique name for the extension (for example, "Report Server E-Mail" for the e-mail delivery extension or "Report Server FileShare" for the file share delivery extension). La lunghezza massima consentita per l'attributo Name è 255 caratteri.The maximum length for the Name attribute is 255 characters. Il nome deve essere univoco tra tutte le voci dell'elemento Extension di un file di configurazione.The name must be unique among all entries within the Extension element of a configuration file. Se è presente un nome duplicato, il server di report restituirà un errore.If a duplicate name is present, the report server returns an error.
TipoType Elenco delimitato da virgole che include lo spazio dei nomi completo insieme al nome dell'assembly.A comma-separated list that includes the fully qualified namespace along with the name of the assembly.
VisibleVisible Il valore false indica che l'estensione per il recapito non deve essere visibile nelle interfacce utente.A value of false indicates that the delivery extension should not be visible in user interfaces. Se l'attributo non è incluso, il valore predefinito è true.If the attribute is not included, the default value is true.

Per altre informazioni sul file RSReportServer.config, vedere File di configurazione di Reporting Services.For more information about the RSReportServer.config file, see Reporting Services Configuration Files.

Distribuzione dell'estensione nel server di reportDeploying the Extension to the Report Server

Il server di report utilizza estensioni per il recapito per l'elaborazione e il recapito di notifiche o report.The report server uses delivery extensions for processing and delivering notifications or reports. È necessario distribuire l'assembly di estensioni per il recapito in un server di report come assembly privato.You should deploy your delivery extension assembly to the report server as a private assembly. È inoltre necessario creare una voce nel file di configurazione del server di report, ovvero RSReportServer.config.You also need to make an entry in the report server configuration file, RSReportServer.config.

Per distribuire un assembly di estensioni per il recapito in un server di reportTo deploy a deliver extension assembly to a report server

  1. Copiare l'assembly dal percorso di gestione temporanea nella directory bin del server di report in cui si desidera utilizzare l'estensione per il recapito.Copy your assembly from your staging location to the bin directory of the report server on which you want to use the delivery extension. Il percorso predefinito della directory bin del server di report è %Programmi%\Microsoft SQL Server\MSRS13.<NomeIstanza>\Reporting Services\ReportServer\bin.The default location of the report server bin directory is %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer\bin.

    Importante

    Se si tenta di sovrascrivere un assembly di estensioni per il recapito esistente, è necessario arrestare il servizio del server di report prima di copiare l'assembly aggiornato.If you are attempting to overwrite an existing delivery extension assembly, you must first stop the Report Server service before copying the updated assembly. Riavviare il servizio dopo il completamento della copia dell'assembly.Restart your service after the assembly is through copying.

  2. Dopo aver copiato il file di assembly, aprire il file RSReportServer.configAfter the assembly file is copied, open the RSReportServer.config file. Il file RSReportServer.config si trova nella directory %Programmi%\Microsoft SQL Server\MSRS13.<NomeIstanza>\Reporting Services\ReportServer.The RSReportServer.config file is located in the %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer directory. È necessario immettere una voce nel file di configurazione per il file di assembly di estensioni per il recapito.You need to make an entry in the configuration file for your delivery extension assembly file. È possibile aprire il file di configurazione con MicrosoftMicrosoft Visual StudioVisual Studio o con un semplice editor di testo, ad esempio Blocco note.You can open the configuration file with MicrosoftMicrosoft Visual StudioVisual Studio or a simple text editor, such as Notepad.

  3. Individuare l'elemento Delivery nel file RSReportServer.config.Locate the Delivery element in the RSReportServer.config file. È necessario immettere una voce per l'estensione per il recapito appena creata nel percorso seguente:An entry for your newly created delivery extension should be made in the following location:

    <Extensions>  
       <Delivery>  
          <Your extension configuration information goes here>  
       </Delivery>  
    </Extensions>  
    
  4. Aggiungere una voce per l'estensione per il recapito.Add an entry for your delivery extension. La voce deve includere un elemento Extension con i valori per Name e Type e può essere simile a quanto riportato di seguito:Your entry should include an Extension element with values for Name and Type, and might look like the following:

    <Extension Name="My Delivery Extension Name" Type="CompanyName.ExtensionName.MyDeliveryExtensionClass, AssemblyName" />  
    

    Il valore per Name è il nome univoco dell'estensione per il recapito.The value for Name is the unique name of the delivery extension. Il valore per Type è un elenco delimitato da virgole che include una voce per lo spazio dei nomi completo della classe che implementa l'interfaccia IDeliveryExtension, seguita dal nome dell'assembly, senza l'estensione dll.The value for Type is a comma-separated list that includes an entry for the fully qualified namespace of your class that implements the IDeliveryExtension interface, followed by the name of your assembly (not including the .dll file extension). Per impostazione predefinita, le estensioni per il recapito sono visibili.By default, delivery extensions are visible. Per nascondere un'estensione dalle interfacce utente, ad esempio il portale Web, aggiungere un attributo Visible all'elemento Extension e impostarlo su false.To hide an extension from user interfaces, such as the web portal, add a Visible attribute to the Extension element, and set it to false.

  5. Aggiungere infine un gruppo di codice per l'assembly personalizzato che conceda l'autorizzazione FullTrust per l'estensione per il recapito.Finally, add a code group for your custom assembly that grants FullTrust permission for your delivery extension. A questo scopo, aggiungere il gruppo di codice al file rssrvpolicy.config che per impostazione predefinita si trova in %Programmi%\Microsoft SQL Server\MSRS13.<NomeIstanza>\Reporting Services\ReportServer.You do this by adding the code group to the rssrvpolicy.config file located by default in %ProgramFiles%\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer. Il gruppo di codice può essere simile a quanto riportato di seguito:Your code group might look like the following:

    <CodeGroup class="UnionCodeGroup"  
       version="1"  
       PermissionSetName="FullTrust"  
       Name="MyExtensionCodeGroup"  
       Description="Code group for my delivery extension">  
          <IMembershipCondition class="UrlMembershipCondition"  
             version="1"  
             Url="C:\Program Files\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"  
           />  
    </CodeGroup>  
    

    L'appartenenza URL è solo una delle numerose condizioni di appartenenza che è possibile scegliere per l'estensione per il recapito.URL membership is only one of many membership conditions you might choose for your delivery extension. Per altre informazioni sulla sicurezza dall'accesso di codice in SSRSSSRS, vedere Sviluppo sicuro (Reporting Services)For more information about code access security in SSRSSSRS, see.Secure Development (Reporting Services)

Verifica della distribuzioneVerifying the Deployment

È possibile verificare se l'estensione per il recapito è stata distribuita correttamente nel server di report tramite il metodo ListExtensions del servizio Web.You can verify whether your delivery extension was deployed successfully to the report server by using the Web service ListExtensions method. È inoltre possibile aprire il portale Web e verificare che l'estensione sia inclusa nell'elenco delle estensioni per il recapito disponibili per una sottoscrizione.You can also open the web portal and verify that your extension is included in the list of available delivery extensions for a subscription. Per altre informazioni sul portale Web e sulle sottoscrizioni, vedere Sottoscrizioni e recapito (Reporting Services).For more information about the web portal and subscriptions, see Subscriptions and Delivery (Reporting Services).

Vedere ancheSee Also

Implementazione di un'estensione per il recapito Implementing a Delivery Extension
Libreria di estensioni di Reporting ServicesReporting Services Extension Library