Walkthroughs Copyright © 2004 Business Objects Page 532 What Needs to be Installed? You need to install Crystal Reports for Visual Studio 2005 before you can create Web or Windows applications that use Crystal reports. Click the appropriate link to jump to that section: Visual Studio Versions Crystal Reports Versions Visual Studio Versions Crystal Reports is available for purchase as a separate application, or as a version that is installed as part of most versions of Microsoft Visual Studio (commonly known as Crystal Reports for Visual Studio). If you intend to use Crystal Reports for Visual Studio, you must verify that the version of Visual Studio that you have installed ships with Crystal Reports for Visual Studio. Visual Studio is available in the following versions: Version Crystal Reports included? Visual Studio .NET 2002, Standard (C#, Visual Basic, or C++) No Visual Studio .NET 2002, Professional or higher Yes Visual Studio .NET 2003, Standard (C#, Visual Basic, or C++) No Visual Studio .NET 2003, Professional or higher Yes Visual Studio 2005 Express Edition (C#, Visual Basic, C++, SQL, J#, Web Developer) No Visual Studio 2005, Professional or higher Yes The Crystal Reports Component By default, the Crystal Reports component is installed as part of your Visual Studio installation. If you must install the Crystal Reports component, relaunch the Visual Studio installer and follow directions to add enterprise development tools. Crystal Reports Versions Multiple versions of Crystal Reports are available. Many of the procedures in this document are version-specific. To best use this document to your advantage, determine first which version of Crystal Reports you have installed. To determine which version you are currently using 1. Go to the GAC (Global Assembly Cache) at: C:\WINNT\assembly or C:\Windows\assembly Walkthroughs Copyright © 2004 Business Objects Page 533 2. Look for files in this assembly folder whose prefix begins with CrystalDecisions. 3. Locate the CrystalDecisions.CrystalReports.Engine file. Note If you have installed more than one version of Crystal Reports, you have multiple versions of these files in the Global Assembly Cache. The CrystalDecisions.CrystalReports.Engine file is selected, because this file is included with every version of Crystal Reports. 4. Note the Version column shown in the window. This is the "Assembly version." 5. Locate the highest number for a particular assembly. 6. Right-click the file, select Properties, and then click the Versions tab within the Properties window. 7. Compare the file version against the version number in the chart below. Note If you are using Crystal Reports version 9.0 with Microsoft Visual Studio .NET 2003, the maintenance release CR 9.2 (available as the CR 9.2 upgrade CD) must be installed. Crystal Decisions supports only CR 9.2 in Visual Studio .NET 2003. If Borland C# is installed after Visual Studio .NET 2003, it updates the assembly versions. Walkthroughs Copyright © 2004 Business Objects Page 534 Product Hot Fix Applied? Optional Add-Ons Assembly Version File Version Crystal Reports for Visual Studio .NET 2002 no none 9.1.3300 9.1.9360 Crystal Reports for Visual Studio .NET 2002 (patched) yes none 9.1.3300 9.1.9466 Crystal Reports 9 no RAS 9 9.2.3300 9.2.9466 Crystal Reports 9.2 (maintenance release) yes RAS 9 9.2.3300 9.2.9500 Crystal Reports for Visual Studio .NET 2003 no none 9.1.5000 9.1.9800.0 Crystal Reports for Visual Studio .NET 2003 (patched) yes none 9.1.5000 9.1.9800.0 Crystal Reports 10 no RAS 10 10.0.3300. 0 10.0.9500.0 Crystal Reports 11 no RAS 11 11.0.3300. 0 11.0.9500.0 Crystal Reports for Visual Studio 2005 no none 10.2.3600. 0 10.2.51014.0 Crystal Reports for Borland C# no none 9.1.5000 9.1.9800.0 Walkthroughs Copyright © 2004 Business Objects Page 535 What Needs to be Verified? Verification needed to develop projects using Crystal Reports for Visual Studio .NET To develop a project that uses Crystal Reports for Visual Studio .NET, verify the following: Add New Item Dialog Box Includes Crystal Reports Sample Reports' Directory Tutorials' Sample Code Directory Viewers' Virtual Directory Verification needed to work with tutorials If you also want to work with the tutorials that are provided in this documentation, you must verify that the following additional items are in place: Location of Xtreme Sample Database ODBC DSN Entry for Xtreme Sample Database Optional verification needed to work with SQL Server/MSDE tutorials If you want to work with the SQL Server/MSDE-specific tutorials that are provided in this documentation, verify that the following SQL Server/MSDE-specific items are in place: MSDE Installation with Windows or SQL Server Authentication Northwind Database Installation Walkthroughs Copyright © 2004 Business Objects Page 536 Add New Item Dialog Box Includes Crystal Reports In an earlier section, you learned which Visual Studio version to install and how to install the Crystal Reports component manually, if you did not install it by default during your Visual Studio installation. To verify that the Crystal Reports component of Visual Studio is installed, check that Crystal Reports appears in the Add New Item dialog box in Visual Studio. To verify that Crystal Reports is installed 1. Launch Visual Studio. 2. Create a new Web or Windows project (in any language), or open an existing Web or Windows project. 3. On the Project menu, click Add New Item. 4. In the Add New Item dialog box, scroll down and verify that Crystal Reports is one of the available items. Walkthroughs Copyright © 2004 Business Objects Page 537 64-Bit Development Configuration Note This section contains information specific to users with a 64-Bit development machine. Crystal Reports for Visual Studio 2005 projects can be built on a 32-bit or a 64-bit machine. In addition, the projects' code can be ported to and updated on a 64-bit machine. Itanium (IA64) processors are supported for run-time only. On a 64-bit machine, the 32-bit Crystal Reports for Visual Studio 2005 IDE will run under WOW64 (the x86 emulator that runs 32-bit applications on a 64-bit machine). Before you can run an application on a 64-bit machine you must install the Crystal Reports 64 bit configuration application for your 64-bit environment. If you have installed Visual Studio into the default installation directory, the configuration application can be found in the below directory. x64 C:\Program Files\Microsoft Visual Studio 8\Crystal Reports\CRRedist\X64\CRRedist2005_x64.msi Walkthroughs Copyright © 2004 Business Objects Page 538 Optional Installation: MSDE If you want to work with the SQL Server/MSDE-specific tutorials that are provided in this documentation, install the following SQL Server/MSDE-specific items: MSDE Installation with Windows or SQL Server Authentication Northwind Database Installation Security: Creating a Limited Access Database Account Walkthroughs Copyright © 2004 Business Objects Page 539 MSDE Installation with Windows or SQL Server Authentication Some of the tutorials in this documentation show how to display a Crystal report whose data configuration requires a programmatic logon to a secure SQL database. These tutorials include the following: Logging onto a Secure SQL Server Database (CrystalReportViewer Object Model) Logging onto a Secure SQL Server Database Using SQL Authentication (ReportDocument Object Model Logging onto a Secure SQL Server Database Using Integrated Security (ReportDocument Object Model) Reduced-Code Secure Database Logon in a Web Site Connecting to IDataReader To work with these tutorials, you need Microsoft SQL Server (or its free version, MSDE) installed and configured with either Windows Authentication (if you wish to use Integrated Security) or SQL Server Authentication (if you wish to use SQL Security). Note Microsoft recommends Integrated Security as the most secure approach. If you already have Microsoft SQL Server or MSDE installed with either Windows or SQL Server Authentication, proceed to Northwind Database Installation to verify that the sample database "Northwind" is installed. If you do not have either server installed, this section shows you how to install MSDE with Windows or SQL Server Authentication. Note To configure your project to connect to Oracle or other SQL database servers, see the knowledge database at: http://support.businessobjects.com/search/ Alternate versions of MSDE You now have two alternate ways to install MSDE, depending on whether you are using the MSDE shipped with Visual Studio .NET 2002, or MSDE Release A from the Microsoft web site. Installing MSDE shipped with Visual Studio .NET 2002 You can install the version of MSDE provided with Visual Studio .NET 2002. This version is located in the following file directory: C:\Program Files\Microsoft Visual Studio .NET\FrameworkSDK\Samples\Setup\msde\setup\sql2000.msi However, if you use this version, you must upgrade to the latest service pack for MSDE. Go to http://www.microsoft.com/sql/downloads/. This version uses the sql2000.msi installer. Note In this step procedure, you install MSDE in Mixed Mode, allowing you to use either Windows Authentication or SQL Server Authentication. Walkthroughs Copyright © 2004 Business Objects Page 540 To install MSDE in Mixed Mode using the sql2000.msi installer 1. Go to the command prompt. Note Run this installer from the command prompt, to include a command parameter. 2. Change to the directory that contains the installer file, as shown in the table above. 3. Type the command with the following command parameter: sql2000.msi SECURITYMODE=SQL 4. After the installer has finished, restart your computer. 5. Once the computer is restarted, go to the command prompt again. 6. At the prompt, type this command to log in to the server: osql -U sa 7. Press ENTER. 8. When asked for a password, press ENTER (at this point, the password is null). A prompt appears with the number 1. 9. Decide on a password and enter it with the following command (include all characters shown). In this example, the password 1234 is used. sp_password null, '1234', 'sa' 10. Go to the next line and type the following: go That word indicates to osql that the command is complete. 11. Press ENTER to execute the command. This message appears: Password changed. 12. Type exit , and then press ENTER. Finally, you must upgrade to the latest service pack for MSDE. 13. Download the service pack from http://www.microsoft.com/sql/downloads/. 14. Install the service pack. This completes your installation of MSDE using the sql2000.msi installer. In the next section, you verify that the Northwind database is installed. Installing MSDE Release A from the Microsoft web site You can download MSDE Release A from the Microsoft website. Go to http://www.microsoft.com/sql/downloads/. This version uses a setup.exe installer. Note In this step procedure, you install MSDE in Mixed Mode, allowing you to use either Windows Authentication or SQL Server Authentication. To install MSDE Release A in Mixed Mode using the setup.exe installer 1. Unzip the MSDE Release A download zip file to a file directory on your hard drive. 2. Launch the command prompt. Walkthroughs Copyright © 2004 Business Objects Page 541 Note Run this installer from the command prompt, to include a command parameter. 3. Change to the file directory that you have just unzipped. Note This directory contains the setup.exe installer file. 4. Type the command with the security mode command parameter set to SQL and the password set to a password of your choice. Note In this example, the password 1234 is used. setup.exe SECURITYMODE=SQL SAPWD="1234" 5. After the installer has finished, restart your computer. This completes your installation of MSDE using the setup.exe installer. In the next section, you verify that the Northwind database is installed. [...]... path Crystal Reports for Visual Studio NET 2002 CrystalReportWebFormViewer C:\Program Files\Microsoft Visual Studio NET \Crystal Reports\ Viewers Crystal Reports 9 crystalreportviewers C:\Program Files\Common Files \Crystal Decisions\2.0\crystalreportvie wers Crystal Reports for Visual Studio NET 2003 CrystalReportWebFormViewer2 C:\Program Files\Microsoft Visual Studio NET 2003 \Crystal Reports\ Viewers Crystal. .. 9\Samples\En\Databases\xtreme.mdb Crystal Reports for Visual Studio NET 2003 C:\Program Files\Microsoft Visual Studio NET 2003 \Crystal Reports\ Samples\Database\xtreme.mdb Crystal Reports 10 C:\Program Files \Crystal Decisions \Crystal Reports 10\ Samples\En\Databases\xtreme.mdb Crystal Reports 11 C:\Program Files\Business Objects \Crystal Reports 11\Samples\En\Databases\xtreme.mdb Crystal Reports for Visual Studio 2005 C:\Program... Files\Microsoft Visual Studio NET \Crystal Reports\ Samples \Reports\ Feature Examples\ and C:\Program Files\Microsoft Visual Studio NET \Crystal Reports\ Samples \Reports\ General Business\ Crystal Reports 10 C:\Program Files \Crystal Decisions \Crystal Reports 10\ Samples\En \Reports\ Feature Examples\ and C:\Program Files \Crystal Decisions \Crystal Reports 10\ Samples\En \Reports\ General Business Crystal Reports 11 C:\Program... Files\Business Objects \Crystal Reports 11\Samples\En \Reports\ Feature Examples\ and C:\Program Files\Business Objects \Crystal Reports 11\Samples\En \Reports\ General Business Crystal Reports for Visual Studio 2005 C:\Program Files\Microsoft Visual Studio 8 \Crystal Reports\ Samples\En \Reports\ Feature Examples\ and C:\Program Files\Microsoft Visual Studio 8 \Crystal Reports\ Samples\En \Reports\ General Business\... Reports\ Samples \Reports\ Feature Examples\ and C:\Program Files\Microsoft Visual Studio NET \Crystal Reports\ Samples \Reports\ General Business\ Crystal Reports 9 C:\Program Files \Crystal Decisions \Crystal Reports 9\Samples\En \Reports\ Feature Examples\ and C:\Program Files \Crystal Decisions \Crystal Reports 9\Samples\En \Reports\ General Business\ Crystal Reports for Visual Studio NET 2003 C:\Program Files\Microsoft Visual. .. Sample Reports' Directory Some of the tutorials rely on sample reports that are installed with Crystal Reports for Visual Studio NET If you have installed Crystal Reports with the default settings and file paths, sample reports are in the directories shown below Crystal Reports Version Path to Sample Reports Crystal Reports for Visual Studio NET 2002 C:\Program Files\Microsoft Visual Studio NET \Crystal Reports\ Samples \Reports\ Feature... the table below Crystal Reports version System DSN name Path to xtreme.mdb Crystal Reports for Visual Studio NET 2002 Xtreme Sample Database C:\Program Files\Microsoft Visual Studio NET \Crystal Reports\ Samples\Database\xtr eme.mdb Crystal Reports 9 Xtreme Sample Database 9 C:\Program Files \Crystal Decisions \Crystal Reports 9\Samples\En\Databases\xtre me.mdb Crystal Reports for Visual Studio NET 2003... configure a new Windows project or Web project/site with Crystal Reports for Visual Studio NET 2002 or 2003, and Crystal Reports for Visual Studio 2005 The new project that you create also serves as a prerequisite for the tutorials that are provided with this online help Project Setup in Visual Studio 2005 In Crystal Reports for Visual Studio 2005, the structure of Web and Windows applications is no... Preparing the Windows Form Adding a CrystalReportViewer Control Creating a New Windows Project in Visual Studio 2005 Before you create a Windows project, verify that Crystal Reports for Visual Studio 2005 has been installed on your system Copyright © 2004 Business Objects Page 559 Walkthroughs To set up a Windows project in Crystal Reports for Visual Studio 2005 1 Launch Visual Studio 2005 2 From the File... Adding a CrystalReportViewer Control in Visual Studio 2005 To display reports on a Windows Form, you add a CrystalReportViewer control To add a CrystalReportViewer control in Crystal Reports for Visual Studio 2005 1 Open Form1 in Design view 2 From the Toolbox, open the Crystal Reports node to locate the CrystalReportViewer control 3 Drag and drop the CrystalReportViewer control onto the form The CrystalReportViewer . Crystal Reports 10 no RAS 10 10.0.3300. 0 10. 0.9500.0 Crystal Reports 11 no RAS 11 11.0.3300. 0 11.0.9500.0 Crystal Reports for Visual Studio 2005 no none 10. 2.3600. 0 10. 2. 5101 4.0 Crystal. Microsoft Visual Studio (commonly known as Crystal Reports for Visual Studio) . If you intend to use Crystal Reports for Visual Studio, you must verify that the version of Visual Studio that. Business Crystal Reports for Visual Studio 2005 C:Program FilesMicrosoft Visual Studio 8 Crystal Reports SamplesEn Reports Feature Examples and C:Program FilesMicrosoft Visual Studio 8Crystal