Active Reports 7 User Guide

1 Table of Contents

1. TableofContents 0-12

ActiveReportsDeveloper7 13

ActiveReportsDeveloperGuide 13

WelcometoActiveReportsDeveloper7 13-14

What'sNew 14-17

ActiveReportsEditions 17-23

Installation 23-24

Requirements 24

InstallActiveReportsDeveloper 24-25

InstalledFiles 25-28

InstallingHelpinVisualStudio2010 28-29

Side-by-SideInstallation 29-30

ComponentOneCopyrightNotice 30

EndUserLicenseAgreement 30-31

.NETFrameworkClientandFullProfileVersions 31

RedistributableFiles 31-33

LicenseYourActiveReports 33-38

UpgradingReports 38-39

BreakingChanges 39-42

ConvertingCrystalReports/MSAccessReports 42-45

GettingStarted 45

AddingActiveReportsControls 45-46

AddinganActiveReporttoaProject 46-47

AddingaDataSourcetoaReport 47

ViewingReports 47-48

UsingtheViewer 48-55

ActiveReportsandtheWeb 55

GettingStartedwiththeWebViewer 55-57

ActiveReports 7 User Guide 0

2014 ComponentOne, a division of GrapeCity. All Rights Reserved.

UsingtheFlashViewer 57-60

UsingtheHTMLViewer 60-62

WorkingwithHTMLViewerusingJavascript 62-63

MediumTrustSupport 63-64

UsingtheSilverlightViewer 64-67

UsingtheWPFViewer 67-73

AddinganActiveReportsApplication 73-74

Concepts 74

ActiveReportsDesigner 74-76

DesignView 76-78

ReportMenu 78-80

DesignerTabs 80-81

DesignerButtons 81-85

PageTabs 85-86

Toolbar 86-91

ReportExplorer 91-92

ExploringSectionReports 92-93

ExploringPageReports 93-95

Toolbox 95-96

PropertiesWindow 96

Rulers 96-97

ScrollBars 97

SnapLines 97-99

ZoomSupport 99-100

ReportTypes 100-103

CPLPageReport 103-105

FPLPageReport 105-106

Code-BasedSectionReport 106-107

XML-BasedSectionReport 107

PageReportConcepts 107-108



PageReportToolbox 108-109

BandedList 109-113

Barcode 113-121

Bullet 121-123

Calendar 123-127

Chart 127-135

ChartDataDialog 136-142

CheckBox 142-144

Container 144-146

FormattedText 146-148

Image 148-150

Line 150-151

List 151-154

Matrix 154-159

OverflowPlaceHolder 159-161

Shape 161-162

Sparkline 162-165

Subreport 165-167

Table 167-172

TextBox 172-176

DataSourcesandDatasets 176-177

ReportDataSourceDialog 177-180

DataSetDialog 180-183

SharedDataSource(RDSX) 183

Expressions 183-185

CommonValues 185-186

CommonFunctions 186-191

UsingScriptinaPageReport 191-192

ReportDialog 192-195

FixedPageDialog 195-197



GroupingData(PageLayout) 197-199

AddPageNumbering 199-200

Themes 200-201

Rendering 201-203

MasterReports 203-205

DataVisualizers 205-206

IconSet 206-210

RangeBar 210-213

RangeBarProgress 213-216

DataBar 216-219

ColorScale2 219-222

ColorScale3 222-225

CustomResourceLocator 225-229

SectionReportConcepts 229

SectionReportToolbox 229-230

Label 230-233

TextBox(SectionReport) 233-236

CheckBox(SectionReport) 236-237

RichTextBox 237-240

Shape(SectionReport) 240-241

Picture 241-242

Line(SectionReport) 242-243

PageBreak 243-244

Barcode(SectionReport) 244-253

SubReport(SectionReport) 253-254

OleObject 254-255

ChartControl 255-256

ReportInfo 256-258

CrossSectionControls 258-260



SectionReportStructure 260-262

SectionReportEvents 262-266

ScriptinginSectionReports 266-267

ReportSettingsDialog 267-268

GroupingDatainSectionReports 268-271

Date,Time,andNumberFormatting 271-273

OptimizingSectionReports 273-274

CacheToDiskandResourceStorage 274

TextJustification 274-275

MultilineinReportControls 275

LineSpacingandCharacterSpacing 275-276

Exporting 276-277

ExportFilters 277

HTMLExport 277-279

PDFExport 279-282

TextExport 282

RTFExport 282-283

ExcelExport 283-284

TIFFExport 284-285

FontLinking 285-286

InteractiveFeatures 286-287

Parameters 287-290

Filtering 290-291

Drill-DownReports 291-292

LinkinginReports 292-293

DocumentMap 293-294

Sorting 294-295

Annotations 295-297

WindowsFormsViewerCustomization 297-298

DesignerControl(ProEdition) 298



ShrinkTexttoFitinaControl 298-299

StandaloneDesignerandViewer 299-300

Localization 300-301

Cultures 301-306

HowTo 306-307

PageReportHowTo 307-308

WorkwithData 308

ConnecttoaDataSource 308-310

AddaDataset 310-311

CreateandEditaSharedDataSource 311-312

BindaPageReporttoaDataSourceatRunTime 312-321

WorkwithReportControlsandDataRegions 321

GroupinginaFixedPage 321-322

GroupinginaDataRegion 322-329

SetDetailGroupingInSparklines 329-330

SetFiltersinPageReports 330-333

CreateCommonPageReports 333

CreateTopNReport 333-334

CreateRedNegativesReport 334-335

CreateGreenBarReport 335

CreateaBulletGraph 335-336

CreateaWhiskerSparkline 336-337

AddParametersinaPageReport 337-338

CreateanALLParameter 338-339

AddaCascadingParameter 339-341

SetaHiddenParameter 341-342

CreateandAddThemes 342-343

CustomizeandApplyaTheme 343-344

UseConstantExpressionsinaTheme 344

SetUpCollation 344-345



AddHyperlinks 345

AddBookmarks 345-347

CreateandUseaMasterReport 347-348

ExportaPageReport(ExportFilter) 348-350

ExportaPageReport(RenderingExtension) 350-351

SortData 351-354

AllowUserstoSortDataintheViewer 355-356

CreateaDrill-DownReport 356-357

SetaDrill-ThroughLink 357-359

AddItemstotheDocumentMap 359-361

ChangePageSize 361-362

AddPageBreaksinCPL 362

AddTotalsandSubtotalsinaDataRegion 362-367

AddStaticRowsandColumnstoaMatrix 367-368

CellMergingInMatrix 368-369

SectionReportHowTo 370

WorkwithDatainSectionReports 370-371

BindReportstoaDataSource 371-376

AddGroupinginSectionReports 376-377

ModifyDataSourcesatRunTime 377-379

WorkwithReportControls 379

AddFieldExpressions 379-381

DisplayPageNumbersandReportDates 381-382

LoadaFileintoaRichTextBoxControl 382-386

UseCustomControlsonReports 386-387

CreateCommonSectionReports 387-388

CreateTopNReports 388-389

CreateaSummaryReport 389-390

CreateGreenBarReports 390-391



InheritaReportTemplate 392-393

ChangeRulerMeasurements 393-394

PrintMultipleCopies,DuplexandLandscape 394-396

ConditionallyShoworHideDetails 396-397

AddParametersinaSectionReport 397-399

AddandSaveAnnotations 399-400

AddBookmarks 400-403

AddHyperlinks 403-405

UseExternalStyleSheets 405-407

InsertorAddPages 407-410

EmbedSubreports 410-411

AddCodetoLayoutsUsingScript 411-416

ExportaSectionReport 416-418

SaveandLoadRDFReportFiles 418-419

SaveandLoadRPXReportFiles 419-421

Customize,Localize,andDeploy 421

LocalizeReports,TextBoxes,andChartControls 421-423

LocalizeActiveReportsResources 423-424

CustomizetheViewerControl 424-426

LocalizetheViewerControl 426-427

DeployWindowsApplications 427-429

DeployWebApplications 429-430

LocalizetheEndUserReportDesigner 430-431

CustomizetheFlashViewerToolbar 431-434

LocalizetheFlashViewer 434-435

ConfigureHTTPHandlersinIIS6.x 435-436

ConfigureHTTPHandlersinIIS7.x 436-440

UseFieldsinReports 440-442

UseAdvancedPrintingOptions 442-443

ProvideOne-TouchPrintingintheWebViewer(ProEdition) 443



ProvidePDFPrintingintheSilverlightViewer(ProEdition) 443-444

PrintMethodsInActiveReportsDeveloper 445-447

SamplesandWalkthroughs 447

Samples 447

PageReport 447

FPLSamples 447-448

API 448

CustomResourceLocator 448-449

Data 449

PageUnboundDataSample 449-450

Layout 450

FPLReportLoaderSample 450-452

CPLSamples 452

API 452

CreateReport 452-453

DataSetDataSource 453-455

NormalizedDataSet 455-456

OleDbDataSource 456

ReportWizard 456-458

XmlDataProvider 458-459

Layouts 459

CPLReportLoader 459-462

Web 462-463

PageReportsOnWeb 463-464

SectionReport 464

Data 464

BoundDataSample 464-466

IListBindingSample 466-468

LINQSample 468

UnboundDataSample 468-470



XMLSample 470-471

Layout 471

AnnualReportSample 471-473

CategorySelectionSample 473-474

ChartingSample 474-475

CrossSectionControlsSample 475-477

CrossTabReportSample 477-478

InheritanceSample 478-479

LayoutLoaderSample 479-483

StyleSheetsSample 483-484

SubreportSample 484-487

Preview 487

CustomAnnotationSample 487-488

CustomPreviewSample 488-492

HyperlinksandDrillThroughSample 492-494

PrintMultiplePagesperSheetSample 494-495

RDFViewerSample 495-496

Summary 496

CalculatedFieldsSample 496-497

DataFieldExpressionsSample 497-498

Web 498

StandardEditionWebSample 498-500

Professional 500

CustomDataProviderSample 500-502

DigitalSignatureSample 502-503

EndUserDesignerSample 503-506

ProfessionalWebSample 506-511

SilverlightViewerSample 511-513

ActiveReports7withMVCSample 513-514



Walkthroughs 514-516

PageReportWalkthroughs 516

SingleLayoutReports 516-520

OverflowDatainMultiplePages 520-525

OverflowDatainaSinglePage 525-528

CollateMultipleCopiesofaReport 528-531

SubreportinaCPLReport 531-539

ColumnarLayoutReports(CPL) 539-542

BandedListReports 542-546

MatrixReports 547-551

ReportswithXMLData 551-555

MasterDetailReports 555-558

ExpressionsinReports 558-560

RecursiveHierarchyReports 560-564

ReportswithParameterizedQueries 564-568

ReportswithCustomCode 568-572

ReportswithStoredProcedures 572-574

Charts(PageReport) 574-578

InteractiveReports 578

ReportswithBookmarks 578-583

DrilldownReports 583-584

Drill-ThroughReports 584-591

ParameterizedReports 591-593

CustomWebExporting(PageReport) 593-599

CustomDataProvider 599-634

SectionReportWalkthroughs 634

BasicDataBoundReports 634-636

SubreportWalkthroughs 636

SubreportswithRun-TimeDataSources 636-641

SubreportswithXMLData 641-645



ChartWalkthroughs 645

BarChart 645-647

3DPieChart 647-649

FinancialChart 649-651

UnboundChart 651-654

CustomWebExporting(StdEdition) 654-658

CustomHTMLOutputter(StdEdition) 658-665

BasicXML-BasedReports(RPX) 665-669

LayoutFileswithEmbeddedScript 669

ScriptforSimpleReports 669-676

ScriptforSubreports 676-685

AddressLabels 685-686

ColumnarReports 686-688

OverlayingReports(Letterhead) 688-694

GroupOnUnboundFields 694-700

MailMergewithRichText 700-707

RunTimeorAdHocReporting 707

RunTimeLayouts 707-717

RunTimeDataSources 717-720

CreatingaBasicEndUserReportDesigner(ProEdition) 720-725

CustomizingtheFlashViewerUI 725-731

CustomizingtheHTMLViewer 731-734

WebServices(StdEdition) 734

DataSetWindowsApplication 734-736

DocumentWebService 736-738

DocumentWindowsApplication 738-739

DataSetWebService 739-741

BasicSpreadsheetwithSpreadBuilder 741-743

WPFViewer 743-747

Troubleshooting 747-757



ClassLibrary 757-758

2. Index 759-767



ActiveReports Developer 7

ThisisthehelpfileforActiveReports,reportingsoftwareforuseinVisualStudio2008,2010,2012or2013.

InThisDocumentationActiveReports Developer GuideTheDeveloperGuidehasmanygettingstartedtopicsandhow-totopicswithcodesamplestocopyandpaste.

Class LibraryThisistheAPIdocumentationwithtopicsforallofthepublicmembersofeachassemblyincludedwithActiveReports.

ActiveReports Developer Guide

ActiveReportsDeveloperprovidesfullyintegratedVisualStudiocomponentswhichcombineuser-friendlyvisualcontrolswiththelow-levelcontrolofcodeinVisualStudio.NETprogramminglanguagestoprovideapowerfulreportdesigner.

InThisDocumentationWelcome to ActiveReports Developer 7 Thisguideprovidesbasicinformationoninstallingandusingtheproduct,aswellassupport,licensing,andwhat'snew.

License Your ActiveReports Thistopicwalksyouthroughhowtolicenseyourmachineandhowtoaddlicensingtoanyprojectscreatedduringyourevaluation.

Upgrading ReportsThistopicprovidesinformationaboutupgradingreportsfromActiveReports6andDataDynamicsReports,andaboutconvertingMSAccessReportsandCrystalReportswiththeImportWizard.

Getting StartedThissectionprovidesanoverviewoftheinterfaceandwheretofindeverythingyouneedtogetstarteddesigningreports.

ConceptsThissectionprovidesinformationonwhatyoucandowithActiveReports.

How ToThissectionprovidesstep-by-stepinstructionsformanyfeatures.

Samples and WalkthroughsThissectionprovidesadescriptionofthesamplesavailablewithActiveReportsandstep-by-stepwalkthroughsexplainingkeyfeatures.

TroubleshootingThissectionprovidestroubleshootingsymptoms,causes,andsolutionstocommonlyencounteredissues.

Welcome to ActiveReports Developer 7

ExploreActiveReportsDeveloper7.

Thissectioncontainsinformationabout

What's NewLearnaboutthenewfeaturesinActiveReportDeveloper.

ActiveReports Editions



FindoutwhichfeaturescanbeusedwithStandardandProfessionalEditionlicenses.

Installation ViewrequirementsforinstallationofActiveReports,learnwhatfilesareinstalledandhowtoverifyyourinstallation,andfindinstallationtroubleshootingtips.

ComponentOne Copyright NoticeExplainsComponentOnecopyrightinformation.

End User License AgreementUnderstandthetermsoftheActiveReportsLicenseAgreementandLimitedWarranty.

.NET Framework Client and Full Profile VersionsProvidesdetailsofassembliesthatarecompliantwith.NETFramework3.5ClientProfileand.NETFramework4.0ClientProfile

Redistributable FilesFindoutthelistoffilesthatmaybedistributed.

What's New

ActiveReportsDevelopercontainsmanynewfeaturesalongwiththepopularActiveReportsengineandreportviewers,plusthepowerfulDataDynamicsReportsdesigner.

NewPageLayoutInthenewPagelayout,youcandesignreportsatthepagelevelwithoutanybandedsections.Thisletsyouplacecontrolsanywhereonthereport.Thislayouthastwovariations,ContinuousPageLayout(CPL)andFixedPageLayout(FPL).InaCPLreport,controlsgrowverticallytoaccommodatedata.InanFPLreport,controlsdonotchangeinsizebasedonthedata,butyoucanuseanOverflowPlaceHoldertohandleanyextradata.Formoreinformation,seeFPLPageReportandCPLPageReport.

Interactivereportoptionsincludedrill-downlinks,bookmarklinks,hyperlinks,documentmaps,sorting,andfiltering.Userscanbenefitfromthesefeatureswhenviewingreportsatrun-time.ShareddatasourcereferstoafileinRDSXformatthatcontainsdataconnectioninformation.RDSX(ReportDataSourceXML)isaproprietaryfileformatthatfunctionsasareusabledatasourceforasinglereportormultiplereports.Dataregionsarereportcontrolsthatcancontainotherreportcontrolsthatrepeatforeveryrowofdata.ReportcontrolsthatfunctionasdataregionsareTable,List,BandedList,MatrixandChart.OverflowPlaceHolderisarectangularplaceholdercontrol.WhenyouuseaList,BandedList,MatrixorTabledataregiononanFPLreport,dataregionscannotgrow,soyoucanspecifyanOverflowPlaceHoldercontroltocatchtheoverflow.



ThemeEditorallowsyoutocreatethemesbysettingcolors,fonts,images,andconstantexpressionsthatyousavetoan.rdlx-themefile.Youcanaddoneormorethemestoareport.Ifareporthasmultiplethemes,youcansetupcollationtocontrolthepageorder.ExpressionEditorallowsyoutouseanexpressiontosetthevalueofacontrol,orsetconditionsunderwhichcertainstylesapply.YoucanenterMicrosoftVisualBasic.NETexpressionsinmanypropertiesusingthePropertiesWindowortheExpressionEditorDialog.DataVisualizerhasseveralwaystodisplaydataineasy-to-comprehendformatsthataresmallenoughtouseinlinewithtextinthereport.YoucanopentheDataVisualizerdialogwithintheImageorBackgroundImagepropertiesoftheImageandTextBoxreportcontrols.

LearnMore|ReportTypes|SharedDataSource|PageReportToolbox|OverflowPlaceHolder|Themes|Expressions|SingleLayoutReports|OverflowDatainaSinglePage|OverflowDatainMultiplePages

ExcelImprovementsTheExcelexportfilternowsupportsExcel2007.NewpagesettingsfeaturesincludeOrientationandPaperSize.NewsecurityfeaturesincludePassword,ProtectedBy,ReadOnlyRecommended,andWritePassword.

LearnMore|Excelexport

BarcodesNewbarcodetypesincludeDataMatrix,Matrix_2_of_5,andIntelligentMail.ThenewNWRatiopropertyallowsyoutomodifytheratiobetweennarrowandbroadbarsforsomebarcodetypes.NewQuietZone,CaptionGrouping,andRotationproperties.EnhancementstobarcodesincludeencodingenhancementinQRCodeandcaptionseparationcapabilityinEAN/UPC.

LearnMore|Barcode

NewDesignerDesignerbuttonslocatedtotherightofthedesignertabsalongthebottomofthedesignerprovidefastaccesstolayoutguides.

SnapLinesmodealignsthecontrolyouaredraggingwithothercontrolsonthereportdesignsurface.Whenyoudragthecontrolaround,snaplinesappearwhenitisalignedwithothercontrolsorwiththeedgesofthereportorsection,andwhenyoudropit,itsnapsintoplaceinperfectalignment.

SnaptoGridmodealignsthecontrolyouaredraggingwithgridlinesonthereportdesignsurface.Whenyoudropthecontrol,itsnapsintoplaceinalignmentwiththenearestgridmark.Toplaceyourcontrolsfreelyonthereportdesignsurface,turnthissettingoff.



Excel-likeautoscrollingworksin4directions,top,bottom,leftandright.Thisoptionisveryusefulwhenyoudragacontrolbeyondthevisibleareaofthereportdesignsurface.Thereportscrollsinthedirectionyoudragthemouseuntilitreachestheedgeofthedesignsurface.PanModehasahandcursorthatletsyounavigatethroughyourreportbyclickingtheleftmousebuttonanddraggingthereporttothedesiredposition.

Dimensionlinesappearduringadragoperation,andrunfromthebordersofthereportcontrolordataregionbeingmovedorresizedtotheedgesofthereportdesignsurface.Dimensionlinesletyoutrackthelocationofthecontrolasyoumoveitbydisplayingthedistancebetweenthecontrolandtheedgeofthewritableareaofthereport.

Reportcontroldialogsofferaneasywaytosetrelevantpropertiesonreportcontrols.

LearnMore|DesignerButtons|SnapLines

WindowsFormsViewerSelectionmodeallowsuserstoselectcontentsofthereport,includingpartialtextselection.Snapshotmodeallowsuserstoselectareasofthereporttocopyandpasteasanimageintoanyapplicationthatacceptspastedimages.PageSetupdialogallowsuserstochangepagescaling,setpagemarginsandaddawatermarkwhenprintingareport.

Parameterspaneallowsuserstoselectparametersforreports.Itshowsupautomaticallyforreportswithparameters.

LearnMore|UseAdvancedPrintingOptions

WebViewer(HTMLType)WebViewerisnowAJAX-basedandnolongerrequiresPostBack.Forexample,GotoPreviouspageandGotoNextpagebuttonsintheHTMLviewerworkviaWebserviceandnolongerrequirePostBack.Parameterspaneallowsuserstoselectparametersforreports.ToshoworhidetheParameterspaneinthesidebar,clicktheToggleSidebarbuttonintheviewertoolbar.



LearnMore|UsingtheHTMLViewer

SilverlightViewerTheSilverlightvieweralsohasaParameterspanethatallowsuserstoselectparametersforreports.ToshoworhidetheParameterspaneinthesidebar,clicktheToggleSidebarbuttonintheToolbar.

LearnMore|UsingtheSilverlightViewer

WPFViewerTheWPFviewerisacustomcontrolthatallowstoviewbothsectionandpagereportlayouts.ItcontainsatoolbarandasidebarwithThumbnails,Searchresults,DocumentmapandParameterspanes.

YoucanuseannotationswhenworkingwithareportintheWPFViewerandaddnotesorimagesdirectlytothereports.

LearnMore|UsingtheWPFViewer

PDF/ASupportActiveReportsPDFexportfilterandPDFrenderingextension(PageLayout)providethePDF/Asupportthatincludesversionssuch

asPdfA1a,PdfA1b,PdfA2a,PdfA2b,orPdfA2u.

LearnMore|Rendering

ActiveReports Editions

ActiveReportsDeveloper7isanenhancementofthepopularActiveReportsengineandreportviewers,plusthepowerfulDataDynamicsReportsdesigner.ItincludesthesamepowerandflexibilityofActiveReportsandthesameintegrationwiththeVisualStudio,plusaddsmanyfeatures.

Availableintwoeditions,StandardandProfessional,ActiveReportsDeveloper7deliversoutstandingreportingcapabilities.Dropdownthesectionsbelowtoseethefeaturespackedintoeachedition.

StandardEditionFeatures

TheStandardEditionprovidesareportdesignerthatisfullyintegratedwiththeVisualStudioIDE,areportviewerforWindowsForms,andexportfiltersforgeneratingreportsinvariousfileformats.Thereportdesignerevenincludesabarcodecontrolwithallofthemostpopularbarcodestyles,anditsownchartcontrol.

Designer

Fullintegrationwiththe.NETenvironmentFamiliaruserinterfacesChoiceofsectionorpagereporttypes

C#andVB.NETsupportwithcode-basedsectionreportsScriptsupportwithXML-basedsectionreportsExpressionsupportwithpagereports

TheabilitytocompilereportsintotheapplicationforspeedandsecurityortokeepthemseparateforeaseofupdatingDesignerhostingof.NETandusercontrols



ReportControls

SectionReports PageReportsReportInfoLabelLinePageBreakOleObjectSubreportShapePictureRichTextBoxwithHTMLtagsupportChartControlwithseparatedatasourceTextboxBarcodewithstandardstylesplusRSSandUPCstylesCheckboxCrossSectionBoxextendsfromaheadersectiontotherelatedfootersectionCrossSectionLineextendsfromaheadersectiontotherelatedfootersection

TabledataregionMatrixdataregionChartdataregionListdataregionBandedListdataregionCalendardataregionSparklinedataregionFormattedTextwithmailmergecapabilitiesandXHTML+CSSsupportBulletGraphBarCodeTextBoxLineContainerShapeImageSubreportOverflowPlaceholder

Expressions(pagereportsonly)

AggregatesDatavisualization

DatabarIconsetRangebarColorscale

InteractiveFeatures

Documentmap(tableofcontents)Bookmarklinks,hyperlinks,anddrillthroughlinksParametersDrill-down(pagereportsonly)Copy,pan,andzoomJumptoprevious,next,first,orlastgrouporsearchresult

ReportingEngine

ManagedcodeBindingtoADO.NET,XML,iList,andcustomdatasourcesMasterreports,themes,andstylesAllofthefeaturesofpreviousversionsofActiveReportsandDataDynamicsReports

WindowsFormsReportViewer

ManagedC#code



Verysmalldeploymentassembly,suitableforuseontheInternetTableofcontentsandbookmarksThumbnailviewHyperLinkingAnnotations(sectionreportsonly)Configurablescrollbarjumpbuttons(likethosefoundinMicrosoftWord)ParametersBookmarklinks,hyperlinksanddrillthroughlinksInteractivesorting(pagereportsonly)

ExportFilters

ActiveReportsincludesexportfilterstogenerateoutputintomanypopularformats.

Exportformats Sectionreport

Pagereport

Html:ExportreportstoHTML,DHTML,orMHTformats,allofwhichopeninaWebbrowser.

Pdf:ExportreportstoPDF,aportabledocumentformatthatopensintheAdobeReader.ThePDFexportincludesthePDF/Asupport.

Rtf:ExportreportstoRTF,RichTextformatthatopensinMicrosoftWord,andisnativetoWordPad.

Doc:ExportreportstoWord,aformatthatopensinMicrosoftWord.

Text:ExportreportstoTXT,plaintext,aformatthatopensinNotepadoranytexteditor.ExportreportstoCSV,commaseparatedvalues,aformatthatyoucanopeninMicrosoftExcel.

Image:ExportreportstoBMP,EMF,GIF,JPEG,orPNGimageformat.

Tiff:ExportreportstoTIFFimageformatforopticalarchivingandfaxing.

Excel:ExportreportstoformatsthatopeninMicrosoftExcel,XLSorXLSX(Excel2007).

Xml:ExportreportstoXML,aformatthatopensinaWebbrowserordeliversdatatootherapplications.

ImportFilters

Access ReportsCrystal ReportsActiveReports (older code-based reports only; XML-based reports open without importing)

Stand-AloneApplications

AReportDesignerapplicationandaReportViewerapplicationarealsoincludedforyourconvenience.TheycanbeopenedfromtheStartmenu,andneitherrequiresVisualStudio.TheReportDesignerapplicationcontainsallthefunctionalityoftheintegratedReportDesigner.TheReportViewerapplicationcontainsallthefunctionalityoftheReportPreviewcontrol.

WPFViewer

ManagedC#codeTableofcontentsandbookmarksThumbnailview



ParametersAnnotationsConfigurablescrollbarjumpbuttons(likethosefoundinMicrosoftWord)Bookmarklinks,hyperlinksanddrillthroughlinksInteractivesorting

ProfessionalEditionFeatures

TheProfessionalEditionincludesallofthefeaturesoftheStandardEditionandsupportsthefollowingadditionalfeatures:

End-UserReportDesigner

Thecontrolisarun-timedesignerthatmaybedistributedroyalty-free.ItallowstheActiveReportsdesignertobehostedinanapplicationandprovidesend-userreporteditingcapabilities.Thecontrol'smethodsandpropertiesprovideeasyaccessforsavingandloadingreportlayouts,monitoringandcontrollingthedesignenvironment,andcustomizingthelookandfeeltotheneedsofendusers.

ASP.NETIntegration

TheWebservercontrolprovidesconvenienceforrunningandexportingreportsinASP.NET.HTTPHandlerextensionsallowreportfiles(RPXorRDLX)orcompiledassembliescontainingreportstobedroppedontheserverandhyperlinked.

SilverlightViewerControl

TheSilverlightviewercontrolallowsyoutoprovidein-orout-of-browserreportviewinginyourSilverlightapplications.Likeourotherviewers,theSilverlightviewercontrolofferscustomizationandlocalization.

WebViewerControl

TheWebViewercontrolallowsquickviewingofActiveReportsonthewebaswellasprintingcapabilitywiththeAcrobatReaderViewerTypeenumeration.FlashViewerTypeenumerationsupportsmultiplebrowsersandofferscustomizationandlocalizationoptions.

HTTPHandlers

TheRPXandRDLXHTTPHandlerallowsthedevelopertohyperlinkActiveReportsonawebpagetoreturnHTMLformatorPDFformatreportsforviewingand/orprinting.TheCompiledReportHTTPHandlerallowsthedevelopertohyperlinkActiveReportscompiledinanassemblyonawebpagetoreturnHTMLformatorPDFformatreportsforviewingand/orprinting.

PdfSignatureandTimeStampFeatures

ThePdfSignatureclassallowsyoutoprovidePDFdocumentdigitalsignaturesandcertification.ThePdfStampclassallowsyoutodrawthedigitalsignaturesandcertificationontothedocuments.TheTimeStampclassallowsyoutoaddaTSA(TimeStampingAuthority)stamptoyourdigitalsignatures.

FontLinking

Fontlinkinghelpsyouresolvethesituationwhenfontsonadeploymentmachinedonothavetheglyphsthatwereusedinadevelopmentenvironment.Bylinkingfonts,youcanresolvetheproblemwithadifferentPDFoutputondeploymentanddevelopmentmachinesthatmayoccurduetothemissingglyphs.

FontFallback



Ifmissingglyphsarenotfoundinlinkedfonts,thePDFexportfilterlooksfortheglyphsinfontsdeclaredintheFontFallbackproperty.Adefaultfontisusedifyoudonotdeclareone,oryoucandeclareanemptystringforthispropertytoleaveoutmissingglyphsfromtheexportedfile.

BoldFontEmulation(PDFExportFilter)

Somefonts(forexample,FranklinGothicMedium,MicrosoftSansSerif,mostEastAsianfonts,etc.)mayloseboldstyleforthePDFoutput.TheProfessionalEditionprovidesboldstyleemulationinthePDFexportfiltertoeliminatethislimitation.

ComparisonBetweenEditions

ProfessionalEditionfeaturesaredisabledormarkedwithanevaluationbannerifyouhavepurchasedaStandardEditionlicense.

Features Standard Professional

VisualStudioControls

WebForms

WebViewer:UsethiscontroltodisplayyourreportsontheWeb.IncludesviewertypesHTML,PDF,andFlash.

SilverlightViewer:UsethiscontroltodisplayyourreportsinSilverlight4orhigher,andforout-of-browserviewing.

HTTPHandlers:PDFandHTML(compiledreport,RPXfile)

WindowsForms

Viewer:Usethiscontroltoofferyourusersreportzoomandpreview,multipletabsforhyperlinks,split-pageandmulti-pageviews,aTableofContentspane,aThumbnailspane,textsearches,andannotations.

Designer:Usethiscontroltocreatearoyalty-free,customdesignerthatyourenduserscanusetocreateandmodifytheirownreports.

ReportExplorer:UsethiscontrolalongwiththeDesignercontroltoprovidefunctionalitytoyourusers.

ToolBox:UsethiscontrolalongwiththeDesignercontroltoprovidereportcontrolsforyourusers.

WPFViewer

Viewer:Usethiscontroltodisplayyoursectionandpagereports.TheViewerofferstheThumbnailspane,theParameterspane,theDocumentmappane,theSearchresultspane,andtheAnnotationstoolbar.

WebandWindowsForms

HtmlExport:ExportreportstoHTML,DHTML,orMHTformatsthatopeninaWebbrowser.

PdfExport:ExportreportstoPDF,aportabledocumentformatthatopensintheAdobeReader.

RtfExport:ExportreportstoRTF,RichTextformatthatopensinMicrosoftWord,andisnativetoWordPad.

WordExport:ExportreportstoWordHTML,aformatthatopensinMicrosoftWord.

TextExport:ExportreportstoTXT,plaintext,aformatthatopensinNotepadoranytexteditor.ThisexportfiltercanalsoexportreportstoCSV,commaseparatedvalues,aformatthatyoucanopeninMicrosoftExcel.

ImageExport:ExportreportstoBMP,EMF,GIF,JPEG,TIFF,or



PNGimageformat.NotethatyoucanonlyexportsectionreportstotheTIFFimagetype.Allotherimagetypesareforpagereports.

XlsExport:ExportreportstoformatsthatopeninMicrosoftExcel,XLSorXLSX(Excel2007).

XmlExport:ExportreportstoXML,aformatthatopensinaWebbrowserordeliversdatatootherapplications.

PDFExportAdvancedFeatures

Digitalsignatures

Timestamp

EUDC

SelectfromJapaneseembeddedfontsorunembeddedfonts *1

Bold

Italic

MultiLanguage *2

PDF/ASupport

IntegratedReportDesignerDesignFormat

Sectionreportssupportbandedlayouts.Pagereportssupportfixedpagelayouts(FPL)andcontinuouspagelayouts(CPL).

ScriptandCode

Insectionreports,youcanaddC#orVBcodetoeventsbehindyourcode-basedreports,oraddscripttoeventsinthescripteditorinXML-basedreports.Inpagereports,youcanuseregularexpressionsinanyproperty,plusyoucanaddVB.NETmethodstothecodetab,andcalltheminyourexpressions.

ReportFileFormats

YoucansaveandloadpagereportsinRDLX(extendedRDL)format.YoucansaveandloadsectionreportsinRPX(reportXML)format,andyoucancompilesectionreportsinCSorVBcodeformats.

TheBarCodecontrolsupportsallofthefollowingstyles:

ANSI3of9 ANSIExtended3of9

Code2of5 Interleaved2of5

Code25Matrix Code39 ExtendedCode39

Code128A

Code128B Code128C Code128Auto Code93

ExtendedCode93 MSI PostNet Codabar

EAN-8 EAN-13 UPC-A UPC-E0

UPC-E1 RoMailRM4SCC

UCC/EAN-128

QRCode

Code49 JapanesePostal

Pdf417 EAN-128FNC1

RSS-14 RSS-14Truncated

RSS-14Stacked



ReportControls

RSS-14StackedOmnidirectional

RSSExpanded

RSSExpandedStacked

TheChartcontrolsupportsallofthefollowingstyles:

CommonCharts:Area,Bar2D,Bezier,Doughnut/Pie,Line,Scatter,StackedArea,StackedBar,StackedArea100Pct,andStackedBar100Pct3DCharts:Area3D,Bar3D,ClusteredBar,Line3D,Doughnut3D/Pie,StackedBar3D,andStackedBar3D100PctXYCharts:Bubble,BubbleXY,LineXY,andPlotXYFinancialCharts:Candle,HiLo,andHiLoOpenClose

Otherreportcontrolsinclude:

Label TextBox CheckBox Picture

Line Shape RichText PageBreak

SubReport ReportInfo CrossSectionLine CrossSectionBox

StylesandReportSettings

Youcancontrolpagesettings,printersettings,globalsettingssuchasgriddisplay,gridsize,andwhethertoshowaverificationdialogwhendeletingcontrols.Youcanspecifyrowcountorcolumncountingrids,rulerunits,andhowmanypagestodisplayinpreviews.

ExternalStyleSheets

Youcanreusereportdesignerstylesbysavingandloadingstyleinformationinexternalfiles.

Others Thedesigneralsoofferssnaplines,reportpreview,designerzoom,variousformattingsettings,controlandtextalignmentsettings,Zordersettings,unboundfields,andparameterssupport.

InputandOutputData Supporteddataincludes:ADO.NETdataprovider,ADO.NETdata

class(DataSet,DataTable,DataReader,DataView),Oracledata,XMLdata,andunbounddata

Printing Youcancontrolthepagesize,orientation,andmargins,aswellasspecifyingbound(doublepagespread),collating,duplexprinting,andpaperfeedtrays.

*1:Japanesefontscanonlybeoutputasembeddedfonts.*2:Cannothandleoutputofmultiplelanguagefontsinasinglecontrol.PleaserefertoMulti-LanguagePDFfordetails.

Installation

Thissectionhelpsyouunderstandtheinstallationprocess.

Inthissection:

RequirementsLearnaboutthehardwareandsoftwarerequiredtorunActiveReports.

Install ActiveReports Developer



FindouthowtoinstalltheActiveReportsDeveloperSetup.

Installed FilesFindoutwhatfilesareinstalledwithActiveReportsDeveloperandwheretolocatethem.

Installing Help in Visual Studio 2010FindouthowtointegrateHelpinVisualStudio2010.

Side-by-Side InstallationLearnaboutworkingwithActiveReportsDeveloper7andActiveReports6orDataDynamicsReportsonasinglemachine.

Requirements

ToinstallanduseActiveReportsDeveloper7,youneedthefollowinghardwareandsoftware.

Hardwarerequirements(minimum)Harddrivespace:200MBavailableCDDrive:ForCDpackageonly

SoftwarerequirementsOperatingSystem:WindowsXP,WindowsVista,Windows7,WindowsServer2003,WindowsServer2008,orWindowsServer2008R2Microsoft.NETFrameworkVersion:3.5SP1,4.0or4.5.NETFrameworkClientProfile:3.5or4MicrosoftVisualStudio:2008,2010,2012or2013

Note:TheExpressEditionsofVisualStudiodonotworkwithActiveReports,astheydonotsupportpackages.

ForWebdeployment:IIS5.1,6.0,7.0or7.5andASP.NET(versiontomatchthe.NETFrameworkversion)FlashPlayer:AdobeFlashPlayer11Browser:MicrosoftInternetExplorer7orhigher,MozillaFirefox5orhigher,GoogleChrome17.

Note:MicrosoftSilverlight4ToolsisrequiredfortheapplicationdevelopmentwiththeActiveReportsSilverlightViewer.

Install ActiveReports Developer

FollowthestepsbelowtoinstallComponentOneActiveReportsDeveloperonyourmachine.

Note:YourmachinesetupmayrequireyoutobeloggedinasanAdministratortoinstallnewsoftware.IfthisisthecaseandyoudonothaveAdministratorprivileges,consultyoursystemadministrator.

1. InserttheComponentOneActiveReportsDeveloperCDintoyourCD-ROMdrive.ORIfyouhavetheComponentOneActiveReportsDevelopersetuponyoursystem,double-clicktheSetup.exefileorright-clickthefileandselectInstall.

2. IntheComponentOneActiveReportsDeveloperSetupwindowthatappears,ontheWelcomescreen,clickNexttocontinuewithinstallation.



3. OntheEnd-UserLicenseAgreementscreenthatappears,gothroughthetermsintheLicenseAgreement,selectthecheck-boxtoacceptthemandclickNexttocontinuewithinstallation.

4. OntheInstallationOptionsscreenthatappears,optionallyselectComponentOneActiveReportsDeveloperSamplestoinstallthemwiththeproductandclickNexttocontinuewithinstallation.

Note:Thesesampleshelpyouinunderstandingdifferentusagescenariosthattheproductoffers.

5. OntheLicensingOptionsscreenthatappears,chooseoutofthethreelicensingoptionsandclickInstall.EvaluationActivateNowActivateLater

6. Oncetheinstallationfinishes,ascreennotifyingthecompletionofinstallationappears.ClickFinishtoclosethewindowandcompletetheinstallationprocess.

Installed Files



Youcanverifyyourpackageinstallationbyfollowingthestepsbelow:

1. OpenVisualStudio.2. FromtheVisualStudioHelpmenu,selectAboutMicrosoftVisualStudioandverifythatActiveReportsDeveloper

7.0appearsintheinstalledproductslist.

WhenyouinstallActiveReportsDeveloperanduseallofthedefaultsettings,filesareinstalledinthefollowingfolders:

C:\ProgramData\Microsoft\Windows\StartMenu\Programs\ComponentOne

File(orFolder) DescriptionActiveReportsDeveloper(folder)

ShortcuttothefoldercontainingStandaloneapplications,helpfilesandSamplesfolder.Seethenextdropdownforfurtherdetails.

LicenseManager ShortcuttotheLicenseManagerapplication.

C:\ProgramData\Microsoft\Windows\StartMenu\Programs\ComponentOne\ActiveReportsDeveloper

File(orFolder) DescriptionActiveReportsDeveloperDesigner ShortcuttotheStandaloneDesignerapplication.

ActiveReportsDeveloperDocumentationforMicrosoftHelpViewer

ShortcuttotheintegratedhelpfileforMicrosoftHelpViewer.

ActiveReportsDeveloperDocumentationforVisualStudio.NET2008

ShortcuttotheintegratedhelpfileforVisualStudio.NET2008.

ActiveReportsDeveloperImport ShortcuttotheActiveReportsDeveloperImportwizardapplication.

ActiveReportsDeveloperThemeEditor ShortcuttotheActiveReportsDeveloperThemeEditorapplication.

ActiveReportsDeveloperViewer ShortcuttotheStandaloneActiveReportsDeveloperViewerapplication.

Samples(folder) Shortcuttothefoldercontainingsampleprojects.

C:\Users\YourUserName\Documents\ComponentOneSamples\ActiveReportsDeveloper7

Folder DescriptionData(folder) Includedsampledatafiles.

PageReports(folder) IncludedPageReportsamples.

SectionReports(folder) IncludedSectionReportsamples.

C:\ProgramFiles\ComponentOne\ActiveReportsDeveloper7(C:\ProgramFiles(x86)\ComponentOne\ActiveReportsDeveloper7ona64-bitWindowsoperatingsystem)

File(orFolder) DescriptionDeployment(folder) IncludesFlashviewerfile,Flashviewerthemes,Silverlightlocalizationresourcesand

templatesforredistribution.

Help(folder) IncludesintegratedHelpfiles,Cabinetfiles,HelpIntegrationfiles,Registryobjects,MicrosoftHelpViewersupportingfileandCommandfiles.

Icons(folder) IncludesassociatedIconsimagefiles.

Localization(folder) IncludesResourceandDOSbatchfilesforlocalizingActiveReportsDevelopercomponents.

Grapecity.ActiveReports.config XMLconfigurationfile.

C:\ProgramFiles\CommonFiles\ComponentOne\ActiveReportsDeveloper7(C:\ProgramFiles(x86)\CommonFiles\ComponentOne\ActiveReportsDeveloper7ona64-bitWindowsoperatingsystem)

File(orFolder) Description



Design(folder) IncludesGrapeCity.ActiveReports.Viewer.Silverlight.v7.VisualStudio.Design.4.0.dllassemblyfile.

License(folder) IncludesLicenseServiceassemblyfile.

redist(folder) Includesnativefunctionsassemblyfor64-bitmachines.

ActiveReports.ReportService.asmx WebservicerequiredforWebSiteorWebApplications.

ApplicationLicenseGenerator.exe ApplicationLicenseGeneratorsetupfile.

ApplicationLicenseGenerator.exe.config LicenseManagersetupXMLconfigurationfile.

GrapeCity.ActiveReports.Designer.exe StandaloneDesignersetupfile

GrapeCity.ActiveReports.Designer.exe.config StandaloneDesignersetupXMLconfigurationfile

GrapeCity.ActiveReports.Imports.exe ActiveReportsDeveloperImportapplicationsetupfile.

GrapeCity.ActiveReports.Imports.exe.config ActiveReportsDeveloperImportapplicationsetupXMLconfigurationfile.

GrapeCity.ActiveReports.Imports.Win.exe ActiveReportsDeveloperImportwizardsetupfile.

GrapeCity.ActiveReports.Imports.Win.exe.config ActiveReportsDeveloperImportwizardsetupXMLconfigurationfile.

GrapeCity.ActiveReports.ThemeEditor.exe ActiveReportsDeveloperThemeEditorsetupfile.

GrapeCity.ActiveReports.ThemeEditor.exe.config ActiveReportsDeveloperThemeEditorsetupXMLconfigurationfile.

GrapeCity.ActiveReports.Viewer.exe StandaloneActiveReportsDeveloperViewersetupfile.

GrapeCity.ActiveReports.Viewer.exe.config StandaloneActiveReportsDeveloperViewersetupXMLconfigurationfile.

ReportDesigner.Switcher.exe ReportDesignerSwitchersetupfile.

ReportDesigner.Switcher.exe.config WebKeyGeneratorsetupXMLconfigurationfile.

WebKeyGenerator.exe WebKeyGeneratorsetupfile.

WebKeyGenerator.exe.config WebKeyGeneratorsetupXMLconfigurationfile.

DocumentFormat.OpenXml.dll OpenXMLassemblyfile.

GrapeCity.ActiveReports.Calendar.v7.dll Calendarcontrolassemblyfile.

GrapeCity.ActiveReports.Chart.v7.dll Chartcontrolassemblyfile.

GrapeCity.ActiveReports.Dashboard.v7.dll ActiveReportsDashboardassemblyfile.

GrapeCity.ActiveReports.Design.Win.v7.dll WindowsDesignerassemblyfile.

GrapeCity.ActiveReports.Diagnostics.v7.dll ActiveReportsDiagnosticsassemblyfile.

GrapeCity.ActiveReports.Document.v7.dll Documentassemblyfile.

GrapeCity.ActiveReports.Export.Document.v7.dll DocumentExportassemblyfile.

GrapeCity.ActiveReports.Export.Html.v7.dll HTMLExportassemblyfile.

GrapeCity.ActiveReports.Export.Excel.v7.dll ExcelExportassemblyfile.

GrapeCity.ActiveReports.Export.Image.Unsafe.v7.dll ImageExportassemblyfile.(Unsafeversion)

GrapeCity.ActiveReports.Export.Image.v7.dll ImageExportassemblyfile.

GrapeCity.ActiveReports.Export.Pdf.v7.dll PDFExportassemblyfile.

GrapeCity.ActiveReports.Export.Rdf.v7.dll RDFExportassemblyfile.

GrapeCity.ActiveReports.Export.Word.v7.dll WordExportassemblyfile.

GrapeCity.ActiveReports.Export.Xaml.v7.dll XAMLExportassemblyfile.

GrapeCity.ActiveReports.Export.Xml.v7.dll XMLExportassemblyfile.

GrapeCity.ActiveReports.Extensibility.v7.dll ActiveReportsExtensibilityassemblyfile.



GrapeCity.ActiveReports.Imports.Access.v7.dll MicrosoftAccessImportassemblyfile.

GrapeCity.ActiveReports.Imports.Crystal.v7.dll CrystalReportsImportassemblyfile.

GrapeCity.ActiveReports.Interop.v7.dll Nativefunctionsassemblyfile.

GrapeCity.ActiveReports.OracleClient.v7.dll OracleClientassemblyfile.

GrapeCity.ActiveReports.Serializer.v7.dll Serializerassemblyfile.

GrapeCity.ActiveReports.v7.dll Runtimeengineassemblyfile.

GrapeCity.ActiveReports.Viewer.Silverlight.v7.dll SilverlightViewerassemblyfile.

GrapeCity.ActiveReports.Viewer.Win.v7.dll WindowsViewerassemblyfile.

GrapeCity.ActiveReports.VisualStudio.v7.dll VisualStudioassemblyfile.

GrapeCity.ActiveReports.Web.Design.v7.dll WebDesignerassemblyfile.

GrapeCity.ActiveReports.Web.v7.dll Webassemblyfile.

C:\ProgramFiles\CommonFiles\ComponentOne\Components(C:\ProgramFiles(x86)\CommonFiles\ComponentOne\Componentsona64-bitWindowsoperatingsystem)

File(orFolder) DescriptionGrapeCity.LicenseManager.exe LicenseManagersetupfile.

GrapeCity.LicenseManager.exe.config LicenseManagersetupXMLconfigurationfile.

Installing Help in Visual Studio 2010

YoucanintegrateActiveReportsHelpintoVisualStudio2010onyourcomputerandhaveaccesstotheActiveReportsDeveloperGuideanytimeyouworkinVisualStudio2010.

1. FromtheVisualStudioHelpmenu,selectManageHelpSettings.

2. IntheHelpLibraryManagerwindowthatappears,clickInstallcontentfromdisk.

3. ClicktheBrowsebuttontonavigatetotheActiveReportsDeveloper7Helpmanifestfile,clickOpentoaddthefileandthenclickNext.

Note:Bydefault,thefile(helpcontentsetup.msha)islocatedatC:\Program



Files\ComponentOne\ActiveReportsDeveloper7\HelpOrC:\ProgramFiles(x86)\ComponentOne\ActiveReportsDeveloper7\Help(ona64-bitWindowsoperatingsystem).

4. ClicktheAddactionnexttoActiveReportsDeveloperandthenclicktheUpdatebuttontostartupdatinglocallibrary.

5. InthedisplayedSecurityAlertdialog,clickYes.

6. OntheUpdatingLocalLibrarypagethatappears,clickFinishtocompletetheActiveReportsDeveloperHelpinstallationinVisualStudio2010.

Note:Ifyoustillreceivethe404errormessagewhenyoutrytoopentheActiveReportsDeveloperHelp,werecommendthatyourestarttheHelpLibraryAgent.

Side-by-Side Installation

OnceActiveReports7isinstalledonyoursystem,itbecomestheprimaryreportdesigner.ThismeansthatwhenVisualStudioopensoneofourproprietaryfiletypes,RPXorRDLX,itusestheActiveReports7versionofthefollowingVisualStudiointegratedfeatures:

IntegratedreportdesignerReportmenuActiveReportstoolbarReportExplorer(orDataExplorerinDataDynamicsReports)Toolboxtabs

TheincludedReportDesigner.SwitchertoolallowsyoutochangewhichpackagesareregisteredinVisualStudio.YoucanchangebetweenActiveReports6andActiveReports7fortheRPXdesigner,andbetweenActiveReports7andDataDynamicsReportsfortheRDLXdesigner.

Tip:Youcanstillaccesssomeoftheintegratedfeatureseveniftheyarehidden.

AlternateReportmenusarevisible,butdisabledunlessyouareontherighttypeofreport.Right-clickintheVisualStudiotoolbarareatoselectwhichtoolbarstoshow.



TheVisualStudioViewmenu,underOtherWindows,letsyouselectReportExplorerversions.Toolboxtabsarestillvisibleforotherversions,butonesthatdonotworkwiththecurrentdesigneraredisabled.

WithActiveReports7astheprimarydesigner,ifyouopenanexistingcode-basedreportfromActiveReports6,VisualStudioknowstousetheActiveReports6designer,butifyouopenanxml-basedreportfromActiveReports6(RPX)orDataDynamicsReports(RDLX),VisualStudioseestheproprietaryfileextensionandopensitwiththemostrecentlyregisteredpackage,inthiscase,ActiveReports7.

InordertoworkwithActiveReports6RPXreports,youmustruntheSwitchertoolandchangethePrimaryRPXdesignertoActiveReports6.Ifyoudonot,thereportsopenintheActiveReports7designer,andthetoolbardoesnotwork,youmightinadvertentlyusefeaturesfromActiveReports7thatdonotexistinActiveReports6,thusbreakingthereportswhentheytrytorunwiththeActiveReports6DLLs.

SwitchingbetweenActiveReports7andActiveReports6

1. CloseallinstancesofVisualStudio.2. In...\CommonFiles\ComponentOne\ActiveReportsDeveloper7,double-clickReportDesigner.Switcher.exe

toruntheswitchertool.3. Inthedialogthatappears,underPrimaryRPXdesigner,choosetheradiobuttonfortheproductyouwanttouse

andclickOK.

Similarly,inordertoworkwithDataDynamicsReportsRDLXreports,youmustruntheSwitchertoolandchangethePrimaryRDLXdesignertoDataDynamicsReports.

SwitchingbetweenActiveReports7andDataDynamicsReports

1. CloseallinstancesofVisualStudio.2. In...\CommonFiles\ComponentOne\ActiveReportsDeveloper7,double-clickReportDesigner.Switcher.exe

toruntheswitchertool.3. Inthedialogthatappears,underPrimaryRDLXdesigner,choosetheradiobuttonfortheproductyouwantto

useandclickOK.

ComponentOne Copyright Notice

Informationinthisdocument,includingURLandotherInternetWebsitereferences,issubjecttochangewithoutnotice.Unlessotherwisenoted,theexamplecompanies,organizations,products,domainnames,e-mailaddresses,logos,people,placesandeventsdepictedhereinarefictitious,andnoassociationwithanyrealcompany,organization,product,domainname,e-mailaddress,logo,person,placeoreventisintendedorshouldbeinferred.Complyingwithallapplicablecopyrightlawsistheresponsibilityoftheuser.Nopartofthisdocumentmaybereproduced,storedinorintroducedintoaretrievalsystem,ortransmittedinanyformorbyanymeans(electronic,mechanical,photocopying,recording,orotherwise),orforanypurpose,withouttheexpresswrittenpermissionofComponentOne,adivisionofGrapeCity.

TheActiveReportsLicenseAgreementconstituteswrittenpermissionforProfessionalEditionlicenseestocopydocumentationcontentfordistributionwiththeirenduserdesignerapplicationssolongasComponentOneisgivencreditwithinthedistributeddocumentation.

ActiveReportsandtheActiveReportslogoareregisteredtrademarksofComponentOne,adivisionofGrapeCity.

Allothertrademarksarethepropertyoftheirrespectiveowners.

End User License Agreement

TheEnd-Userlicenseagreementisavailableonlineathttp://www.componentone.com/SuperPages/DevToolsEULA/.

Pleasereadcarefullybeforeinstallingthissoftwarepackage.Yourinstallationofthepackageindicatesyouracceptanceofthetermsandconditionsofthislicenseagreement.ContactComponentOne,adivisionofGrapeCity,ifyouhaveany



http://www.componentone.com/SuperPages/DevToolsEULA/

questionsaboutthislicense.

.NET Framework Client and Full Profile Versions

AllActiveReportsDeveloperassembliesarecompliantwith.NETFramework3.5Fullprofileand.NETFramework4.0Fullprofile.

Thefollowingassembliesarecompliantwith.NETFramework3.5ClientProfileand.NETFramework4.0ClientProfile:

File DescriptionGrapeCity.ActiveReports.v7.dll Run-timeengineassemblyfile.

GrapeCity.ActiveReports.Chart.v7.dll Chartcontrolassemblyfile.

GrapeCity.ActiveReports.Document.v7.dll Documentassemblyfile.

GrapeCity.ActiveReports.Interop.v7.dll Nativefunctionsassemblyfile.

GrapeCity.ActiveReports.Export.Pdf.v7.dll PDFExportassemblyfile.

GrapeCity.ActiveReports.Export.Word.v7.dll RTFExportassemblyfile.

GrapeCity.ActiveReports.Export.Xml.v7.dll TextExportassemblyfile.

GrapeCity.ActiveReports.Export.Image.v7.dll TIFFExportassemblyfile.

GrapeCity.ActiveReports.Viewer.Win.v7.dll Viewerassemblyfile.

GrapeCity.ActiveReports.Export.Excel.v7.dll MicrosoftExcelExportassemblyfile.

GrapeCity.ActiveReports.Extensibility.v7.dll Extensibilityassemblyfile.

GrapeCity.ActiveReports.Export.Document.v7.dll Documentassemblyfile.

GrapeCity.ActiveReports.Export.Image.Unsafe.v7.dll ImageExportassemblyfile.(Unsafeversion)

GrapeCity.ActiveReports.Diagnostics.v7.dll ActiveReportsDiagnosticsassemblyfile.

GrapeCity.ActiveReports.Export.Rdf.v7.dll RDFExportassemblyfile.

DocumentFormat.OpenXml.dll OpenXMLassemblyfile.

GrapeCity.ActiveReports.Export.Xaml.v7.dll XAMLExportassemblyfile.

Thefollowingassembliesarenotcompliantwith.NETFramework3.5ClientProfileand.NETFramework4.0ClientProfile:

File DescriptionGrapeCity.ActiveReports.Design.Win.v7.dll Designerassemblyfile.

GrapeCity.ActiveReports.Export.Html.v7.dll HTMLExportassemblyfile.

GrapeCity.ActiveReports.Web.v7.dll Webassemblyfile.

GrapeCity.ActiveReports.OracleClient.v7.dll OracleClientassemblyfile.

GrapeCity.ActiveReports.Calendar.v7.dll Calendarcontrolassemblyfile.

GrapeCity.ActiveReports.Dashboard.v7.dll ActiveReportsDashboardassemblyfile.

GrapeCity.ActiveReports.Interop64.v7.dll Nativefunctionsassemblyfile.x64

TheEndUserReportDesigner,theWebViewercontrolandtheHTMLExportfilterrequirethefullprofile.

Redistributable Files



ActiveReportsDeveloperisdevelopedandpublishedbyGrapeCity,Inc.YoumayuseittodevelopapplicationsinconjunctionwithMicrosoftVisualStudiooranyotherprogrammingenvironmentthatenablestheusertouseandintegratethecontrol(s).Youmayalsodistribute,freeofroyalties,thefollowingRedistributableFileswithanysuchapplicationyoudeveloptotheextentthattheyareusedseparatelyonasingleCPUontheclient/workstationsideofthenetwork:

DocumentFormat.OpenXml.dllGrapeCity.ActiveReports.Calendar.v7.dllGrapeCity.ActiveReports.Chart.v7.dllGrapeCity.ActiveReports.Dashboard.v7.dllGrapeCity.ActiveReports.Design.Win.v7.dllGrapeCity.ActiveReports.Diagnostics.v7.dllGrapeCity.ActiveReports.Document.v7.dllGrapeCity.ActiveReports.Export.Document.v7.dllGrapeCity.ActiveReports.Export.Html.v7.dllGrapeCity.ActiveReports.Export.Excel.v7.dllGrapeCity.ActiveReports.Export.Image.Unsafe.v7.dllGrapeCity.ActiveReports.Export.Image.v7.dllGrapeCity.ActiveReports.Export.Pdf.v7.dllGrapeCity.ActiveReports.Export.Rdf.v7.dllGrapeCity.ActiveReports.Export.Word.v7.dllGrapeCity.ActiveReports.Export.Xaml.v7.dllGrapeCity.ActiveReports.Export.Xml.v7.dllGrapeCity.ActiveReports.Extensibility.v7.dllGrapeCity.ActiveReports.Imports.Access.v7.dllGrapeCity.ActiveReports.Imports.Crystal.v7.dllGrapeCity.ActiveReports.Interop.v7.dllGrapeCity.ActiveReports.OracleClient.v7.dllGrapeCity.ActiveReports.Serializer.v7.dllGrapeCity.ActiveReports.v7.dllGrapeCity.ActiveReports.Viewer.Silverlight.v7.dllGrapeCity.ActiveReports.Viewer.Win.v7.dllGrapeCity.ActiveReports.VisualStudio.v7.dllGrapeCity.ActiveReports.Web.Design.v7.dllGrapeCity.ActiveReports.Web.v7.dllGrapeCity.ActiveReports.Interop64.v7.dllGrapeCity.ActiveReports.Imports.exeGrapeCity.ActiveReports.Imports.Win.exeGrapecity.ActiveReports.Flash.v7.swfGrapecity.ActiveReports.Flash.v7.Resources.swfThemes\FluorescentBlue.swfThemes\Office.swfThemes\OliveGreen.swfThemes\Orange.swfThemes\VistaAero.swfThemes\WindowsClassic.swfThemes\XP.swf



Note:SeeInstalledFilesforthelocationofthefileslistedabove.

License Your ActiveReports

YoucanusetheGrapeCityLicenseManagerutilitytolicenseActiveReportsDeveloperduringinstallationorifyoualreadyhaveatrialversioninstalled.ThistopicgivesanoverviewofallaspectsoflicensinginActiveReportsDeveloper.

LicenseTypesActiveReportsDeveloperprovidesthreelicensingoptionstochoosefrom.

LicenseType DescriptionEvaluation Noproductkeyisrequired.Allevaluationbannersaredisplayed.Thereisaninitial30day

time-limitforproductusebutitcanbeextendedaftercontactingthesalesdepartment.

Standard Productkeyforthestandardeditionisrequired.Itoffersbasicreportfunctionalitywithoutanyevaluationbanners.

Professional Productkeyforprofessionaleditionisrequired.Allreportingfunctionalityandcontrolscanbeaccessedwiththislicensewithoutanyevaluationbanners.

SeeActiveReportsEditionstounderstandthedifferencebetweenStandardandProfessionalEditions.

LicenseKeyTypes

Note:IfyouhavepurchasedActiveReportsDeveloper,yourproductkeyshouldhavebeenemailedtoyouatthetimeofpurchase.Ifyoudonothaveaproductkey,[email protected].

ActiveReportsDeveloperoffersdifferentkeytypeswithvaryingfunctionalityinthewaytheproductworks.

LicenseKeyType

Description

Trial Thiskeytypeshowsallevaluationbannersandtheproductstopsfunctioningafter30daysfromthedateofinstallation.UserscanrequestanewkeyfromtheSalesdepartmenttograntthemanadditional30days.

Standard ThiskeytypeisgiventouserswhopurchaseActiveReportsDeveloperStandardEditionorthosewhoareupgradingfromapreviousversionofActiveReportsStandardEdition.

Professional ThiskeytypeisgiventouserswhopurchaseActiveReportsDeveloperProfessionalEditionorthosewhoareupgradingfromapreviousversionofActiveReportsProfessionalEdition.

TolicenseActiveReportsDeveloperoninstallationorlicenseatrialwithoutreinstalling

1. FromtheStartmenu,gototheAllPrograms>ComponentOne>LicenseManager.2. IntheGrapeCityLicenseManagerwindowthatappears,underActionclickActivate.



mailto:[email protected]

3. OntheActivate[ActiveReports7]screenthatappears,clicktheNextbutton.4. IntheEnteraProductKeyscreenthatappearsnext,enterthefollowinginformation:

UserName:Enteryournamehere.Organization:Enteryourcompanynamehere.Email:Enteryoure-mailaddresshere.ProductKey:EntertheproductkeyexactlyasyoureceiveditfromComponentOne,includinganycapitalletters.Whenyouentertheproductkey,agreencheckmarkappearsnexttothisfieldtoindicateavalidkey.

5. ClicktheNextandthentheFinishbuttontocompletethelicensingprocess.

TolicenseActiveReportsDeveloperonamachinewithoutInternetConnection

1. Atthetimeofinstallation,onthelastscreenacheckboxthatstatesRunlicensemanagerappears.SelectthischeckboxandclicktheClosebuttontocompletetheinstallation.

2. IntheGrapeCityLicenseManagerwindowthatappears,undertheActionfield,clickActivate.

3. OntheActivate[ActiveReports7]screenthatappears,clicktheNextbutton.4. IntheEnteraProductKeyscreenthatappearsnext,enterthefollowinginformation:

UserName:Enteryournamehere.Organization:Enteryourcompanynamehere.Email:Enteryoure-mailaddresshere.ProductKey:EntertheproductkeyexactlyasyoureceiveditfromComponentOne,includinganycapitalletters.Whenyouentertheproductkey,agreencheckmarkappearsnexttothisfieldtoindicateavalidkey.

5. ClicktheNextbuttontoauthenticatethelicense.6. Ifyourmachinedoesnothaveaninternetconnection,selecttheUseabrowseronanothermachinewith

InternetconnectivityoptionfromthefollowingscreenandclicktheNextbutton.



7. FromtheActivateusingtheGrapeCitywebsitescreenthatappears,copytheProductKeyandAuthenticationNumber.

8. Onanothermachinewithaninternetconnection,gotohttps://sas.grapecity.com/activation.Remembertonotclosetheactivationdialogonyouroriginalmachinetilltheactivationprocessiscomplete.

9. EntertheProductKeyandAuthenticationNumberyoucopiedinstep7onthiswebsite.10. ClicktheSendRequestbuttontogeneratealicensekey.11. CopythelicensekeyfromthewebpagethatlookslikethefollowingimageandintheActivateusing

GrapeCitywebsitedialogunderstep3,enterthekey.

12. ClicktheNextandthentheFinishbuttontocompletethelicensingprocess.

TolicenseWindowsFormsprojectsmadeonthetrialversion

ThesestepsassumethatyoualreadyhaveanActiveReportsDeveloperlicensededitioninstalledonyoursystem.

1. OpentheprojectinMicrosoftVisualStudio.2. GototheVisualStudioBuildmenuandselectRebuildSolution.Theexecutableapplicationisnowlicensed,

andnonagscreensorevaluationbannersappearwhenyourunit.Youcandistributetheapplicationtounlicensedmachinesandnonagscreensorevaluationbannersappear.

TolicenseWebFormsprojectsmadeonthetrialversion

ThesestepsassumethatyoualreadyhaveanActiveReportsDeveloperlicensededitioninstalledonyoursystem.

1. OpentheprojectinMicrosoftVisualStudio.2. OpentheVisualStudioBuildmenuandselectRebuildSolution.

Note:ForlicensingWebSiteapplications,opentheVisualStudioBuildmenuandselectBuildRuntimeLicensestocreatetheApp_Licenses.dllfile.

3. Thewebapplicationisnowlicensed,noevaluationbannersappearwhenyourunit.YoucandistributetheWebapplicationtounlicensedmachinesandnoevaluationbannersappear.



https://sas.grapecity.com/activation

Toupgradeordowngradealicense

IfyouwanttochangeyourActiveReportsDeveloperlicensetypeyouneedtodooneofthefollowing:

UpgradefromaStandardtoaProfessionalLicense:

1. FromtheStartmenu,gototheAllPrograms>ComponentOne>LicenseManager.2. IntheGrapeCityLicenseManagerwindowthatappears,underUpgrade/DowngradeclickUpgradeto

ProfessionalLicense.3. Followtheactivationstepsfromstep3ofTolicenseanActiveReportsDeveloperTrialwithout

reinstallingtoupgrade.

DowngradefromaProfessionaltoaStandardLicense:

1. FromtheStartmenu,gototheAllPrograms>ComponentOne>LicenseManager.2. IntheGrapeCityLicenseManagerwindowthatappears,underUpgrade/DowngradeclickDowngradeto

StandardLicense.3. IntheDeactivatetheProductKeyscreenthatappearsselecttheNextbutton.4. ConfirmtheProductscreenappears.ConfirmthatthecorrectproductisgettingdowngradedandclicktheNext

button.5. DeactivationSuccessfulscreenappearswiththeProductNameasActiveReports7andtheCurrentStatusas

StandardLicense.

Requiredreferencesinthelicenses.licxfile(forStandardandProfessionalEditions)

Thelicenses.licxfilemustcontainthefollowingreferencestotheActiveReportsDeveloperversionandthereferencetotheViewercontrol:

StandardEdition:

PasteINSIDEthelicenses.licxfile.ReplaceVersion=x.x.xxxx.xwiththeactualActiveReportsDeveloperversion.

(Reference to GrapeCity.ActiveReports.SectionReport is added only for code-basedsection report templates)

GrapeCity.ActiveReports.SectionReport, GrapeCity.ActiveReports.v7, Version=x.x.xxxx.x,Culture=neutral, PublicKeyToken=cc4967777c49a3ff

GrapeCity.ActiveReports.Viewer.Win.Viewer, GrapeCity.ActiveReports.Viewer.Win.v7,Version=x.x.xxxx.x, Culture=neutral, PublicKeyToken=cc4967777c49a3ff

ProfessionalEdition:

PasteINSIDEthelicenses.licxfile.ReplaceVersion=x.x.xxxx.xwiththeactualActiveReportsDeveloperversion.

(Reference to GrapeCity.ActiveReports.SectionReport is added only for code-basedsection report templates)

GrapeCity.ActiveReports.SectionReport, GrapeCity.ActiveReports.v7, Version=x.x.xxxx.x,Culture=neutral, PublicKeyToken=cc4967777c49a3ff

GrapeCity.ActiveReports.Viewer.Win.Viewer, GrapeCity.ActiveReports.Viewer.Win.v7,Version=x.x.xxxx.x, Culture=neutral, PublicKeyToken=cc4967777c49a3ff

GrapeCity.ActiveReports.Web.WebViewer, GrapeCity.ActiveReports.Web.v7,Version=x.x.xxxx.x, Culture=neutral, PublicKeyToken=cc4967777c49a3ff

GrapeCity.ActiveReports.Design.Designer, GrapeCity.ActiveReports.Design.Win.v7,Version=x.x.xxxx.x, Culture=neutral, PublicKeyToken=cc4967777c49a3ff

GrapeCity.ActiveReports.Export.Pdf.Section.PdfExport,



GrapeCity.ActiveReports.Export.Pdf.v7, Version=x.x.xxxx.x, Culture=neutral,PublicKeyToken=cc4967777c49a3ff

Note:WhenusingthePDFexportfilterinyourproject,makesureyoucheckthelicenses.licxfileforreferencetothePDFExportAssembly.

TocreatetheWebKeywiththeWebKeyGeneratorutility

ForyourmediumtrustandWindowsAzureprojectswithActiveReportsDeveloper,youmayneedtogenerateaWebKeybyusingtheWebKeyGeneratorutilityonamachinewithlicensedActiveReportsDeveloper.

1. FromtheStartMenu,gotoAllPrograms>ComponentOne>ActiveReportsDeveloper>GenerateWebKeyandruntheWebKeyGeneratorutility.

Note:YoucanfindtheWebKeyGenerator.exeinthe....\Commonfiles\ComponentOne\ActiveReportsDeveloper7folder.

2. Inthedialogthatappears,copytheWebKeybyclickingCopy.WerecommendthatyouusethesecondCopybuttontocopytheWebKeytogetherwiththecorrespondingweb.configsection.

3. PastetheWebKeyintotheweb.configfileofyourprojectbetweentheopeningandclosing

tagstoremovethelicensingmessage.Theweb.configkeylookslikethefollowing.

XMLcode.PasteINSIDEtheWeb.configfile

Note:Ifyouseethemessage"Yourcomputerisnotcurrentlylicensed"intheWebKeyGeneratordialog,pleaselicenseyourmachine.

Tolicenseaclasslibraryproject



YoucanlicenseyourActiveReportsDeveloperclasslibraryprojectusingtheApplicationLicenseGeneratorutility.

1. EnsurethatActiveReportsDeveloperislicensedonthemachinebyfollowingthestepsaboveinthe"TolicenseActiveReportsDeveloperonamachineduringinstallation"or"TolicenseanActiveReportsDevelopertrialwithoutreinstallation"sections.

2. RuntheApplicationLicenseGenerator.exefromthe...\CommonFiles\ComponentOne\ActiveReportsDeveloper7folder.

3. ClicktheBrowsebuttonandselectthecompileddllthatrequireslicensing.4. ClicktheGeneratebutton.

Distributethegeneratedfile.GrapeCity.Licenses.dllalongwiththeapplication.

ToremoveanInvalidlicensemessage

Ifyourlicensekeyisinvalidorcorrupt,youmaygetaninvalidlicensemessage.

Toremovethemessage,doanyoneofthefollowing:

Runthesetuptore-installandauthenticatethelicense.OpentheGrapeCityLicenseManagerutilitybyclickingRuntheLicenseManger(activate/deactivate)linkinthiserrormessageandclickActivate.

FollowthelicensingstepsfromTolicenseanActiveReportsDeveloperTrialwithoutreinstallingtolicenseyourproductandremovetheerrormessage.

TodeactivateanActiveReportsDeveloperlicense

YoucandeactivateyourActiveReportsDeveloperlicenseandgobacktoaTrialLicense.

1. FromtheStartmenu,gototheAllPrograms>ComponentOne>LicenseManager.2. IntheGrapeCityLicenseManagerwindowthatappears,underActionclickDeactivate.3. IntheDeactivate[ActiveReports7]screenthatappearsselecttheNextbutton.4. ConfirmtheProductscreenappears.ConfirmthatthecorrectproductisgettingdowngradedandclicktheNext

button.5. DeactivationSuccessfulscreenappearswiththeProductNameasActiveReports7andtheCurrentStatusas

TrialLicense(numberofdaysleft).

Upgrading Reports

ActiveReportsDeveloper7allowsyoutoupgradeyourreportsfromotherversionsofActiveReportsandDataDynamicsReports.

UpgradingActiveReports6andDataDynamicsReportsProjectsYoucanautomaticallyupdatereportsandcorrespondingreferenceassembliesusingtheActiveReportsDeveloperUpgradetool,andthenhandleanyadditionalerrorsinthecode.

Important:Besuretocreateabackupforyourprojectbeforestartingtheupgradeprocess.

Toupgradeprojectreferencesandreports



1. InVisualStudio,openanexistingActiveReports6orDataDynamicsReportsprojectthatyouwanttoupgrade.2. FromtheVisualStudioToolsmenu,selectConverttoActiveReports7.3. IntheActiveReportsDeveloperUpgradetoolwindowthatappears,youcanseealistofreportfilestobe

converted.

4. ClickOKtoupgradetheproject.

Oncethetoolupgradesthereportfiles,noticethatalloftheActiveReports6orDataDynamicsReportsassembliesintheSolutionExplorerarereplacedwithActiveReportsDeveloperassemblyreferences.

Tohandleerrorsincode

TheActiveReportsDeveloperUpgradetoolupgradesthereportsandcorrespondingreferenceassemblies,buttheupgradedassemblynamesbreakthecode.

Note:Theerrormessagesinajust-upgradedprojectmayseemabitoddiftheprojectretainssomeoftheoldreferencesinmemory.ToworkaroundthisVisualStudioissue,youcancloseandreopentheprojectformoreunderstandableerrormessages.

1. WiththeupgradedprojectopeninVisualStudio,fromtheViewmenu,selectErrorListtogetthelistoferrorstobefixedincode.

2. IntheErrorListwindow,double-clickeacherrorinturntojumptothecodewhereyoucanfixtheerror.

Examplesofcodethatmightbreakandhowtofixit:

UpdatetheViewercontrolbyreplacingDataDynamics.ActiveReports.Viewer.ViewerwithGrapeCity.ActiveReports.Viewer.Win.Viewer.

Replaceexistingpropertynameswithnewpropertynames.Forexample,MultiplePageColspropertyischangedtoMultiPageCols.

Breaking Changes

WhenyouupgradereportsfrompreviousversionsofActiveReportsorDataDynamicsReports,thereareseveralbreakingchanges.

ControlChangesTheOleObjectcontrolisnowhiddenbydefaultinthetoolboxforSectionreports.ToshowthiscontrolinVisualStudio,opentheGrapeCity.ActiveReports.configfileandchangetheEnableOleObjectvaluetotrue,andincludethisfilewithyourapplication.Youcanfindthisfileinapathlikethefollowing.C:\ProgramFiles(x86)\ComponentOne\ActiveReportsDeveloper7.

ToshowtheOleObjectcontrolintheDesignercontrolinyourownendusersdesignerapplications,selecttheDesignercontroland,inthePropertieswindow,changetheEnableOleObjectpropertytoTrue.

TheWebViewercontrolisnowAJAX-based,andrequiresActiveReports.ReportService.asmxtobeintherootoftheWebsiteorWebapplication.ThisisaddedautomaticallywhenyoudropaWebViewercontrolonaWebform,oryoucanadditfromtheAddNewItemdialogbyselectingActiveReports7WebService,ormanuallybycopyingitfromC:\ProgramFiles(x86)\CommonFiles\ComponentOne\ActiveReportsDeveloper7.

TheViewercontrolnolongerhasAnnotationsturnedonbydefault.ToenableAnnotations,settheAnnotationToolbarVisiblepropertyoftheViewercontroltoTrue.

TheToolbarisnowaWindowsToolStrip.PleaseseetheMSDNToolStripClassformoreinformation.

ClassesinDifferentNamespaces



http://msdn.microsoft.com/en-US/library/system.windows.forms.toolstrip(v=vs.80).aspx

SomeclasseshavemovedtodifferentnamespacesfrompreviousversionsofActiveReports.Dropdownthetablebelowtoseesomeofthemostcommonlyusedclassesthatareinnewnamespaces.

Classesthatareinnewnamespaces

ClassName NewNamespace FormerNamespaceReport GrapeCity.ActiveReports.PageReportModel DataDynamics.Reports.ReportObjectModel

SectionReport(formerlyActiveReport)

GrapeCity.ActiveReports DataDynamics.ActiveReports

PageReport(formerlyReportDefinition)

GrapeCity.ActiveReports DataDynamics.Reports

SectionDocument(formerlyDocument)

GrapeCity.ActiveReports.Document DataDynamics.ActiveReports.Document

SystemPrinter GrapeCity.ActiveReports DataDynamics.ActiveReports.Interop

Printer GrapeCity.ActiveReports.Extensibility.Printing DataDynamics.ActiveReports.Document

ExportsHtmlExport GrapeCity.ActiveReports.Export.Html.Section DataDynamics.ActiveReports.Export.Html

PdfExport GrapeCity.ActiveReports.Export.Pdf.Section DataDynamics.ActiveReports.Export.Pdf

PdfSignature GrapeCity.ActiveReports.Export.Pdf.Section.Signing DataDynamics.ActiveReports.Export.Pdf.Signing

PdfStamp GrapeCity.ActiveReports.Export.Pdf.Section.Signing DataDynamics.ActiveReports.Export.Pdf.Signing

RtfExport GrapeCity.ActiveReports.Export.Word.Section DataDynamics.ActiveReports.Export.Rtf

TextExport GrapeCity.ActiveReports.Export.Xml.Section DataDynamics.ActiveReports.Export.Text

TiffExport GrapeCity.ActiveReports.Export.Image.Tiff.Section DataDynamics.ActiveReports.Export.Tiff

XlsExport GrapeCity.ActiveReports.Export.Excel.Section DataDynamics.ActiveReports.Export.Xls

ImageRenderingExtension GrapeCity.ActiveReports.Export.Image.Page DataDynamics.Reports.Rendering.Graphics

HtmlRenderingExtension GrapeCity.ActiveReports.Export.Html.Page DataDynamics.Reports.Rendering.Html

PdfRenderingExtension GrapeCity.ActiveReports.Export.Pdf.Page DataDynamics.Reports.Rendering.Pdf

XmlRenderingExtension GrapeCity.ActiveReports.Export.Xml.Page DataDynamics.Reports.Rendering.Xml

WordRenderingExtension GrapeCity.ActiveReports.Export.Word.Page DataDynamics.Reports.Rendering.Word

ExcelTransformationDevice GrapeCity.ActiveReports.Export.Excel.Page DataDynamics.Reports.Rendering.Excel

ReportControlsAllsectionreportcontrols GrapeCity.ActiveReports.SectionReportModel DataDynamics.ActiveReports

Allpagereportcontrols GrapeCity.ActiveReports.PageReportModel DataDynamics.Reports.ReportObjectModel

NamespaceChangesandRestructuringSomeofthechangesthatarenotcaughtbytheupgradetoolmaycausesomeissueswithyourcode.Thetwomostfrequentlyencounteredchangesare:

DataDynamics.ActiveReports.ActiveReportisnowGrapeCity.ActiveReports.SectionReportDataDynamics.ActiveReports.Document.DocumentisnowGrapeCity.ActiveReports.Document.SectionDocument

Thesearealloftheassembliesandnamespacesthathavechanged,withanymajorchangesnoted.

ActiveReports6isnowGrapeCity.ActiveReports.v7

ActiveReportclassisnowcalledSectionReport.BarWidthpropertyisnowcalledNarrowBarWidth.

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports GrapeCity.ActiveReports

GrapeCity.ActiveReports.SectionReportModelGrapeCity.ActiveReports.Data

DataDynamics.ActiveReports.DataSources GrapeCity.ActiveReports.Data

DataDynamics.ActiveReports.Interop GrapeCity.ActiveReports

DataDynamics.ActiveReports.Options GrapeCity.ActiveReports.SectionReportModel

ActiveReports.ChartisnowGrapeCity.ActiveReports.Chart.v7



ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Chart GrapeCity.ActiveReports.Chart

DataDynamics.ActiveReports.Chart.Annotations GrapeCity.ActiveReports.Chart.Annotations

DataDynamics.ActiveReports.Chart.Graphics GrapeCity.ActiveReports.Chart.Graphics

ActiveReports.Design6isnowGrapeCity.ActiveReports.Design.Win.v7

TheReportpropertyisnowanObjectthatgetsorsetsaGrapeCity.ActiveReports.Document.SectionDocumentorGrapeCity.ActiveReports.Document.PageDocument.

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Design GrapeCity.ActiveReports.Design

DataDynamics.ActiveReports.Design.ReportExplorer GrapeCity.ActiveReports.ReportExplorer

DataDynamics.ActiveReports.Design.Toolbox GrapeCity.ActiveReports.Design.Toolbox

ActiveReports.DocumentisnowGrapeCity.ActiveReports.Document.v7

TheDocumentclassisnowcalledSectionDocument.


DataDynamics.ActiveReports.Document GrapeCity.ActiveReports.DocumentGrapeCity.ActiveReports.Document.SectionGrapeCity.ActiveReports.Extensibility.Printing(GrapeCity.ActiveReports.Extensibility.v7)

DataDynamics.ActiveReports.Export GrapeCity.ActiveReports.Export

DataDynamics.ActiveReports.Export.Html GrapeCity.ActiveReports.Export.Html

DataDynamics.ActiveReports.Document.Annotations GrapeCity.ActiveReports.Document.Section.Annotations

ActiveReports.HtmlExportisnowGrapeCity.ActiveReports.Export.Html.v7

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Export.Html GrapeCity.ActiveReports.Export.Html.Section

ActiveReports.PdfExportisnowGrapeCity.ActiveReports.Export.Pdf.v7

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Export.Pdf GrapeCity.ActiveReports.Export.Pdf.Section

DataDynamics.ActiveReports.Export.Pdf.Signing GrapeCity.ActiveReports.Export.Pdf.Section.Signing

ActiveReports.RtfExportisnowGrapeCity.ActiveReports.Export.Word.v7

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Export.Rtf GrapeCity.ActiveReports.Export.Word.Section

ActiveReports.SilverlightisnowGrapeCity.ActiveReports.Viewer.Silverlight.v7


ActiveReports.TextExportisnowGrapeCity.ActiveReports.Export.Xml.v7

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Export.Text GrapeCity.ActiveReports.Export.Xml.Section

ActiveReports.TiffExportisnowGrapeCity.ActiveReports.Export.Image.v7

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReportsExport.Tiff GrapeCity.ActiveReports.Export.Image.Tiff.Section

ActiveReports.Viewer6isnowGrapeCity.ActiveReports.Viewer.Win.v7

TheHistoryclassisnowaninterface,IHistoryApi,thatresidesintheGrapeCity.Viewer.Commonnamespace.TheSearchResultsForeColorpropertynowgetsappliedastheborderaroundthesearchedtext.TheTargetViewenumerationnowhastwoenumerationvalues(PrimaryandSecondary).

ActiveReports6Namespace ActiveReportsDeveloper7Namespace



DataDynamics.ActiveReports.Toolbar TheviewernowusesVisualStudioToolStrips.PleaseseeMSDNToolStripClassformoreinformation.

DataDynamics.ActiveReports.Viewer GrapeCity.ActiveReports.Viewer.WinGrapeCity.Viewer.Common

Note:GrapeCity.ActiveReports.Viewer.Win.v7.dlldoesnotgetaddedautomaticallytotheprojectreferenceswhenthereportlayoutisadded.YouneedtoeitheraddtheViewercontrolormanuallyaddthereferencetothisassembly.

ActiveReports.WebisnowGrapeCity.ActiveReports.Web.v7

TheReportpropertyisnowanObjectthatgetsorsetsaSectionDocumentorReportDocument.

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Web GrapeCity.ActiveReports.Web

DataDynamics.ActiveReports.Web.Controls GrapeCity.ActiveReports.Web.Controls

DataDynamics.ActiveReports.Web.ExportOptions GrapeCity.ActiveReports.Web.ExportOptions

DataDynamics.ActiveReports.Web.Handlers GrapeCity.ActiveReports.Web.Handlers

ActiveReports.XlsExportisnowGrapeCity.ActiveReports.Export.Excel.v7

ActiveReports6Namespace ActiveReportsDeveloper7NamespaceDataDynamics.ActiveReports.Export.Xls GrapeCity.ActiveReports.Export.Excel.Section

DataDynamics.SpreadBuilder GrapeCity.SpreadBuilder

DataDynamics.SpreadBuilder.Cells GrapeCity.SpreadBuilder.Cells

DataDynamics.SpreadBuilder.Imaging GrapeCity.SpreadBuilder.Imaging

DataDynamics.SpreadBuilder.Printing GrapeCity.SpreadBuilder.Printing

DataDynamics.SpreadBuilder.Style GrapeCity.SpreadBuilder.Style

Converting Crystal Reports/MS Access Reports

YoucanconvertaCrystalReportsreportoraMicrosoftAccessreporttoanActiveReportsformatbyrunningtheActiveReportsDeveloperImportWizard.

RunningtheActiveReportsDeveloperImportWizard

1. FromtheStartMenu,gotoAllPrograms>ComponentOne>ActiveReportsDeveloper>ActiveReportsDeveloperImport.

2. IntheActiveReportsImportWizardthatappears,clickNexttoproceedtotheconversionprocess.

3. ChooseMicrosoftAccess(mdb)orCrystalReports(rpt)astheinputformatandclickNexttoconverttheselectedreport.



http://msdn.microsoft.com/en-US/library/system.windows.forms.toolstrip(v=vs.80).aspx

4. BrowsetothelocationthatcontainstheMicrosoftAccessfileorCrystalReportsusingtheellipsisbutton.Onceyouselectthelocation,alistofavailablereportsappearinthedialog.

5. SelectthereportstoimportandclickNexttoanalyzetheselectedreports.

6. Usetheellipsisbuttontoselectadestinationfoldertostoretheconvertedreports.Alsoselectanoutputformat(SectionReport,PageReportorBoth)foreachreportintheOutputFormatcolumn.

7. ClickNexttostarttheconversion.

8. Oncetheconversionprocessiscomplete,clickFinishtoclosethewizardandgothedestinationfoldertoviewtheconvertedreports.YoumayoptionallyleavethecheckonfortheOpenLogfilecheckboxtoseetheresultslog.

TheimportwizardconvertsreportstotheclosestpossibleActiveReportsformat,butduetodifferencesbetweenproductsandversions,theextenttowhichyourreportsareconverteddependsonyourspecificreportlayout.YoumayhavetopartiallyredesignthereportandaddscriptorcodetogetthesameoutputasMicrosoftAccessReportsorCrystalReports.

WhenconvertingtoPageReports,whetherareportisimportedasaFixedPageLayout(FPL)orContinuousPageLayout(CPL),dependsonthefollowingfactors:

IfareporthasasingledetailsectionitisimportedasaFixedPageLayout.IfareporthasaSubReportcontrolitisimportedasaContinuousPageLayout.



IfareporthasaMatrixcontrolanditslayoutiscomposedofmultiplesectionsitisimportedasaContinuousPageLayout.

Note:SectionsinareportappearasBandedList.

Pleaserefertotheadditionalinformationbelow,tounderstandtheconversionprocessindetail.

ConvertingCrystalReportsToconvertCrystalReportsintoActiveReportsformat,youneedtoinstallVisualStudioandCrystalReportsforVisualStudioonyourmachine.ThesupportedversionsofVisualStudioandcorrespondingCrystalReportsareasfollows:

VisualStudio

Editions CrystalReports AssemblyVersion

2008 Professional,TeamSystem

CrystalReportsforVisualStudio2008 10.5.3700.0

2010 ... SAPCrystalReports,developerversionforMicrosoftVisualStudio

13.x.x.x


13.x.x.x


13.x.x.x

CrystalReportcontrolsareconvertedinActiveReportsasfollows:

CrystalReport

SectionReport

PageReport

Note

Box Shape Container TheLineWidthpropertyandroundedboxesarenotimported.IftheBoxcontrolextendstomultiplesections,theboxisimportedaslinecontrols.

CrossTab SubReport BandedList CrossTabcontrolisnotimportedasitis.

Line Line Line ThesizeofDotandDash(theLineStyleproperty)isnotthesameastheoriginalreport.

Subreport SubReport Subreport Setthesubreportincodeafterconversion.

TextObject Label Textbox Onlypagenumber,totalpage,pagenofminSpecialFieldsareimported.

FieldObject TextBox Textbox Onlypagenumber,totalpage,pagenofminSpecialFieldsareimported.

Picture ... Container Pictureobjectisnotconverted.

ConvertingMicrosoftAccessReportsToconvertMicrosoftAccessreportsintoActiveReportsformat,youmusthaveAccess97,2000,2002,2003or2007installedonyoursystem.

MicrosoftAccessreportcontrolsareconvertedinActiveReportsasfollows:

MicrosoftAccessReport

SectionReport

PageReport

Note

Rectangle Shape Container ControlsplacedinsidetheRectanglecontrolarealsoimportedalongwiththeparentcontrol.

CheckBox Label Textbox ...



Image ... Image ImagecontrolisnotconvertedwhileconvertingtoaSectionReport.

Label Label Textbox ...

Textbox TextBox Textbox ...

Line Line Line ...

PageBreak PageBreak Container InPageReports,thePageBreakAtEndpropertyisautomaticallysettoTrueonimportingaPageBreakcontrol.

Subform/Subreport SubReport Subreport ...

LimitationsinCrystalReport/MSAccessconversionAnycontrols,functions,andtextformatswhicharenotsupportedbyActiveReportsarenotconverted.Theshadowpropertyofacontrolisnotimportedwhileconvertingareport.TheOLEobjectisnotinCrystalReportsisnotimportedasitistreatedasPictureObjectintheobjectstructure.InMicrosoftAccessreports,VBAcodeappearsinascommentedstatementsinscript.Youhavetomodifythecodeafterimporting.

Getting Started

QuicklybeginusingActiveReportsbyreviewingsomeofthemostcommonlyusedfeatures.

Thissectioncontainsinformationabout

Adding ActiveReports ControlsLearnhowtoaddActiveReportscontrolstothetoolboxinVisualStudio.

Adding an ActiveReport to a ProjectLearnhowtoaddanActiveReporttoaVisualStudioproject.Alsointhissection,learnaboutthedifferenttypesofreportsandhowtoaddcodeorscripttoeach.

Adding a Data Source to a ReportLearnaboutthedifferentwaysthatyoucanadddatatoeachtypeofreport,andwheretofindmoreinformationoneach.

Viewing Reports LearnhowtopreviewareportatdesigntimeorviewitinWindowsForm,WeborSilverlightViewers.

Adding an ActiveReports ApplicationLearnhowtoaddanActiveReportsapplicationtotheVisualStudioprojectandavoidadditionalimplementationrenderingthereportintheViewer.

Adding ActiveReports Controls

YoucanaddanActiveReporttoaprojectwithoutusingtheVisualStudiotoolbox,butinordertousetheViewercontrol,anyoftheexports,theDesignerandrelatedcontrols,ortheWebViewercontrol,youneedtohavetheminyourtoolbox.

TheinstallergenerallyaddsthecontrolstotheVisualStudiotoolboxinanActiveReports7tab.However,iftheyareremovedforanyreason,youcanre-addthematanytime.

Toaddthecontrols1. Right-clicktheVisualStudiotoolboxtabwhereyouwanttoaddActiveReportscontrolsandselectChoose



Items.2. IntheChooseToolboxItemswindowthatappears,onthe.NETFrameworkComponentstab,intheFilter

textbox,enterGrapeCity.ActiveReports.3. Selectthecheckboxesnexttoanyofthecontrolsthatyouwanttoaddtoyourtoolbox:

ViewerWebViewerDesignerReportExplorerToolbox

HtmlExportPdfExportRtfExportTextExportTiffExportXlsExport

4. FortheSilverlightViewercontrol,gototheSilverlightComponentstabandselectViewer.5. ClickOKtoaddthecontrolstotheselectedtoolboxtab.

.NETFrameworkVersionThefollowingfeaturesallrequirethe.NETFrameworkfullprofileversion.

DesignercontrolWebViewercontrolHTMLExportOracledataproviderCalendarcontrolSparklineorBulletcontrolNativeFunctions(Interop64)

ToensurethatyouareusingthefullprofileversioninaVBproject

1. FromtheVisualStudioProjectmenu,selectYourProjectProperties.2. OntheCompiletab,clicktheAdvancedCompileOptionsbutton.3. IntheAdvancedCompilerSettingsdialogthatappears,dropdowntheTargetframeworkfieldandselecta

versionthatdoesnotspecifyClientProfile.

ToensurethatyouareusingthefullprofileversioninaC#project

1. FromtheVisualStudioProjectmenu,selectYourProjectProperties.2. OntheApplicationtab,dropdowntheTargetframeworkfieldandselectaversionthatdoesnotspecify

ClientProfile.

Caution:ActiveReportscontrolsmaynotappearinthetoolboxunlessyourprojectisusing.NET3.5orlater.

Adding an ActiveReport to a Project

TouseActiveReportsinaVisualStudioproject,youaddoneoftheincludedreporttemplates.

ToaddanActiveReporttoaproject1. FromtheVisualStudioProjectmenu(orWebsitemenuinWebprojects),selectAddNewItem.2. Selectthetypeofreportthatyouwanttoadd(forinformationonthedifferences,seeReportTypes):

ActiveReports7SectionReport(code-based)ActiveReports7SectionReport(xml-based)ActiveReports7PageReport



3. IntheNamebox,typeanameforthereport,andclickAdd.Theselectedreporttypeisaddedtoyourprojectandopensinthereportdesigner.

Note:WhenyouaddareportlayouttheViewerassembly(GrapeCity.ActiveReports.Viewer.Win.v7.dll)isnotaddedautomaticallytotheprojectreferences.Youmayneedtomanuallyadditinyourprojectifrequired.

Adding a Data Source to a Report

Thefirstthingyouprobablywanttodowhenyoucreateareportistoadddata.Youcanaccomplishthisinavarietyofways,dependingonthetypeofreportyouareusing.

PageReportDataWithpagereports,youbasicallyconnecttoadatasource,andthenaddadataset.Youcanalsocreateashareddatasourceifyouusethesameoneformanyreports.Forinformationonhowtoperformthesetasks,seeWorkwithDataintheHowTosection.Formoreinformationoneachitemintheassociateddialogs,seeDataSourcesandDatasetsintheConceptssection.

Formoreadvancedwaystoconnectdatatopagereports,seetheWalkthroughssectionforstepbystepinstructionsonusingReportswithStoredProcedures,orcreatingaCustomDataProvider.

SectionReportDataWithsectionreports,youbindareporttoanyofavarietyofdatasourcesandselectthedatausingaSQLqueryorXPathexpressionintheDataSourceDialog.Youcanalsousecodetocreateanunbounddatasourceortochangethedatasourceatruntime.Formoreinformationonallofthesemethodsofbindingreportstodata,seeWorkwithDataintheSectionReportHowTosection.

Viewing Reports

ActiveReportsprovidesanumberofwaystoviewyourreportoutput.YouhaveanoptionofpreviewingthereportasyoucreateitinaVisualStudioprojectatdesigntime.

PreviewingReportsatDesignTimeActiveReportsmakesiteasyforyoutopreviewyourreportwhileyouarestillcreatingit.ClickthePreviewtabatthebottomofthedesignerandseetheoutputasitappearsinaviewer.SeeDesignerTabsforfurtherinformation.



Withthein-builtViewersforWindowsForms,WebandSilverlight,youcanviewyourreportinanyoftheseplatformsaswellinaseparateviewercontrol.Thefollowingtopicsintroducealltheavailablereportviewingoptions.

Inthissection

Using the ViewerThissectionexplainshowtoviewareportintheWindowsFormsVieweranddemonstratestheViewer'sfeaturesandshortcutkeys.

ActiveReports and the Web ThissectionintroducestheWebViewerwhereyoucanviewyourreportoutputinvarioustypesofviewersandprovideskeyfeaturesofeachviewertype.

Using the Silverlight Viewer ThissectiondescribeshowtoviewareportintheSilverlightviewerandintroducesitstoolbarandfeatures.

Using the WPF Viewer ThissectiondescribestheWPFViewertoolbar,itsadditionalfeaturesandhowtoviewareportintheWPFviewer.

Using the Viewer

Besidespreviewingyourreportatdesigntime,youcanalsoviewthereportsyoudesignintheViewer.ThisviewercontainsatoolbarandasidebarwithThumbnails,Searchresults,DocumentmapandParameterspanes.

ViewerToolbar

Thefollowingtableliststheacti

Active Reports 7 User Guide

Documents

Transcript of Active Reports 7 User Guide