Documentation errors and corrections in Reporting Services Books Online topics about debugging and deploying custom assemblies and report server extensions (842855)


The information in this article applies to:

  • Microsoft SQL Server 2000 Reporting Services

INTRODUCTION

In Reporting Services Books Online January 2004 Update, the following topics contain documentation errors:
  • "Debugging Custom Assemblies"
  • "Debugging Data Processing Extension Code"
  • "Debugging Delivery Extension Code"
  • "Deploying the Printer Delivery Sample"
  • "Deploying FsiDataExtension"
This article describes the correct information for each of these topics. This article also describes additional information about adding new CodeGroup elements that grant permissions to the custom assemblies or to the report server extensions in the policy configuration files.

MORE INFORMATION

The following topics in Reporting Services Books Online January 2004 Update include information about debugging custom assemblies and custom report server extensions:
  • "Debugging Custom Assemblies"
  • "Debugging Data Processing Extension Code"
  • "Debugging Delivery Extension Code"
These topics tell you to make sure that the Common Language Runtime program type and the Native program types are selected in the Attach to Process dialog box when you debug custom assemblies or custom report server extensions. However, if you select the Native program type in the Attach to Process dialog box, the debugging performance of Microsoft Visual Studio .NET 2003 decreases. Therefore, click to select only the Common Language Runtime program type to debug the custom assemblies and the custom report server extensions.

The following list describes the documentation errors and the corrections for each topic:
  • Step 6 in the "To debug using two instances of Visual Studio" section in the "Debugging Custom Assemblies" topic contains the following information:

    "From the list of processes, select the devenv.exe process that corresponds to your Report Project and click Attach. When the Attach to Process dialog opens, make sure that the program types Common Language Runtime and Native are selected, and then click OK."

    The step should read as follows:

    "From the list of processes, select the evenv.exe process that corresponds to your Report Project, and then click Attach. When the Attach to Process dialog opens, make sure that the Common Language Runtime program type is selected, and then click OK."
  • Step 6 in the "To debug your data processing extension code" section in the "Debugging Data Processing Extension Code" topic contains the following information:

    "From the list of processes, select the devenv.exe process that corresponds to your Report Project and click Attach. When the Attach to Process dialog opens, make sure that the program types Common Language Runtime and Native are selected, and then click OK."

    The step should read as follows:

    "From the list of processes, select the devenv.exe process that corresponds to your Report Project, and then click Attach. When the Attach to Process dialog opens, make sure that the Common Language Runtime program type is selected, and then click OK."
  • Step 6 in the "To debug your delivery extension code" section in the "Debugging Delivery Extension Code" topic contains the following information:

    "From the list of processes, select the aspnet_wp.exe process (or w3wp.exe if your application is deployed on IIS 6.0), and click Attach. When the Attach to Process dialog opens, make sure that the program types Common Language Runtime and Native are selected, and then click OK."

    The step should read as follows:

    "From the list of processes, select the aspnet_wp.exe process (or w3wp.exe if your application is deployed on IIS 6.0), and click Attach. When the Attach to Process dialog opens, make sure that the Common Language Runtime program type is selected, and then click OK."
Additionally, Reporting Services Books Online January 2004 Update contains errors in the "Deploying the Printer Delivery Sample" topic and in the "Deploying FsiDataExtension" topic.

Deploying the Printer Delivery Sample

In the "Build Location" section of this topic, step 5 in the "To compile the sample using Visual Studio .NET" procedure contains the following information:

"Click Browse, and find the Microsoft.ReportingServices.Interfaces on your local drive. By default, the assembly is located in C:\Program Files\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer\bin, then click OK."

The step should read as follows:

"Click Browse, and find the Microsoft.ReportingServices.Interfaces.dll on your local drive. By default, the assembly is located in C:\Program Files\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer\bin, then click OK."

Deploying FsiDataExtension

In the "Deployment" section of this topic, step 3 in the "To configure code access security for the sample" procedure contains code group information that mentions the path of the Microsoft.Samples.ReportingServices.FsiDataExtension.dll assembly that is deployed in Report Designer. The path is not correct:
<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\80\Tools\ReportDesigner\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>
The code group information should read as follows:
<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\80\Tools\ReportDesigner\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

New CodeGroup elements in the policy configuration files of Reporting Services

After you create a custom assembly or a custom report server extension, you must add a code group if you have to increase code permissions beyond the default execution permissions. You must modify the Reporting Services security policy configuration files, such as the report server policy configuration file Rssrvpolicy.config, to add the code group.

The order of the code groups in the policy configuration files is important. Therefore, we recommend that you add the code groups that correspond to your custom assembly or to the custom report server extension immediately after the existing code group entry that has the URL membership condition set to "$CodeGen$/*". For example, you can add a code group for your custom assembly or for the custom report server extension in a policy configuration file as follows:
<CodeGroup
    class="UnionCodeGroup"
    version="1"
    PermissionSetName="FullTrust">
    <IMembershipCondition 
        class="UrlMembershipCondition"
        version="1"
        Url="$CodeGen$/*"
    />
</CodeGroup>
<CodeGroup 
    class="UnionCodeGroup"
    version="1"
    PermissionSetName="FullTrust"
    Name="MyCustomCodeGroup"
    Description="Code group for my custom extension">
        <IMembershipCondition class="UrlMembershipCondition"
        version="1"
        Url="C:\Program Files\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer\bin\MyAssembly.dll"
        />
</CodeGroup>

REFERENCES

For more information, visit the following Microsoft Web sites:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/RSPROG/htm/rsp_prog_rdl_8wyq.asp?frame=true

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/RSPROG/htm/rsp_prog_extend_dataproc_9plu.asp?frame=true

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/RSPROG/htm/rsp_prog_extend_deliver_2jqa.asp?frame=true

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/RSAMPLES/htm/rss_sampleapps_v1_0q28.asp?frame=true

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/RSAMPLES/htm/rss_sampleapps_v1_16g2.asp?frame=true

Modification Type:MajorLast Reviewed:6/24/2004
Keywords:kbhowto kbExtension kbReport kbDesigner kbdocfix kbdocerr kbinfo KB842855 kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.