Getting Started and Moving Ahead With Crystal Reports

19/6/2015 GettingstartedandmovingaheadwithCrystalReports.NETapplicationsBusinessIntelligence(BusinessObjects)SCNWiki

http://wiki.scn.sap.com/wiki/display/BOBJ/Getting+started+and+moving+ahead+with+Crystal+Reports+.NET+applications 1/4

GettingStarted Newsletters Store

SearchtheCommunity

Welcome,Guest Login Register

Products Services&Support AboutSCN Downloads

Industries Training&Education Partnership DeveloperCenter

LinesofBusiness UniversityAlliances Events&Webinars Innovation

AddedbyBhushanHyalij,lasteditedbyBhushanHyalijonAug11,2014

BusinessIntelligence(BusinessObjects) / / .NETSDK

GettingstartedandmovingaheadwithCrystalReports.NETapplications

PurposeWorkingthroughtheforumsandsupportincidentsIhaveobservedthatmostoftheissuescouldberesolvedjustbyproperlytroubleshootingthem(theapplicationortheenvironment),usingthevastdocumentationavailableonourcommunitynetwork.

TheideabehindthisarticleistoprovideguidelinesandtherelateddocumentationforDevelopment,DeploymentandtroubleshootingvariousissueswithaCrystalReports.NETapplication.

Ihavetriedtoincludeasmanyarticles,KBsaspossiblewrittenbyourexperts.

Gettingstarted:Firstofall,basedontheVisualStudioversionyouareusing,choosetherespectivecompatibleversionofCrystalReports.

ForcheckingthecompatibilityandthesupportedoperatingsystemsbyeachCRversionseethis.

CrystalReportsv.9.1toCRVS2010RuntimeDistribution&SupportedOperatingSystems

So,letsstartfrombeginning

PrepareyourdevelopmentmachineInstallVisualStudioInstallCrystalReportsversioncompatiblewithaboveversionofVisualStudio.See:KBA1514084CompatibilityofCrystalReportswithVisualStudio

Afterinstallationisdone,quicklydobelowtests.

CheckyourGACforCrystalDecisions.*assemblies,justtomakesurethattheSDKisinstalled.

NOTE:CrystalReports2011andCrystalReports2013doesnothave/installany.NETassemblies(doesnothaveanSDK).

Seethisblog.:HowdoyouspellconfusionCRforVS,Crystal2011,BI4.xandthe.NETSDKs

OpenVisualStudio,startanewproject/app,checktoolbox,moveyourmouseoverCrystalreportsViewer,checkthetooltipforVersion.CompareitwiththeversionofCrystalReportsyouhavejustinstalled,theyshouldbethesame.

ThesamecouldbecheckedatthecodebehindoftheCRvieweronceitisdropped/addedtoaform.

NowyouhavepreparedyourDevelopmentmachineforCrystalReports.Netapplications.

Letsstartdevelopingtheapplication.

Thedeveloperresourcesarehere:

CrystalReports2008:http://scn.sap.com/docs/DOC27446

'SAPCrystalReportsdeveloperversionforMicrosoftVisualStudio'whichworkswithVS2010,VS2012(SP5onwards)andVS2013(SP9onwards):http://scn.sap.com/docs/DOC7824

Evrythingelseishere:http://scn.sap.com/docs/DOC27465

NowthatwearewellequippedwiththeSDKresourcesandawellpreparedDEVenvironment,wearereadytodevelopourapplication.

TomakeanyoftheCrystalReportworkthroughtheapplicationitisMENDETORYthatthereportshouldworkfinefromtheCrystalReportsdesigner.IfitdoesnotworkinthedesigneritWILLNOTworkfromtheapplication/runtime.

ApplicationDevelopment:CrystalReports.NetSDKcouldbeusedmainlytoView,Export,PrintaCrystalreport.

CrystalReports.NetSDKapplicationscanbefoundhere.

http://www.sdn.sap.com/irj/boc/go/portal/prtroot/docs/library/uuid/d0bf84962a812b1095acb1f48d5b63f5

InProcRAS.NetSDKcanbeusedforReportcreationandmanipulation.Samplescanbefoundbelow.

http://wiki.sdn.sap.com/wiki/display/BOBJ/Crystal+Reports+for+.NET+SDK+Samples



http://www.sdn.sap.com/irj/boc/go/portal/prtroot/docs/library/uuid/70834815d1662b10a2a2e7c8c9d3c668

IssuescouldbebroadlycategorizedasHowtoissues,Environmentconfigurationissues,Codingerrors,orruntimeexceptionsetc.

MostoftheHowtoissuescouldberesolvedbycarefullystudyingthesampleapplicationsandthedeveloperresourcesSDKDeveloperguideandtheAPIreferenceguide.

Herearesomeverycommonissues/errorswhichoccurwhiledevelopingaCrystalReports.Netapplicationandfewquickstepstoovercomethem.

ErrorLoadreportfailed:

Checkthepathofthereportprovidedintheapplicationandifthereportexistsatthatlocation.

Checkiftheapplicationhaspermissions/rightstoaccessthereport.

Fordetailedstepsseethis:http://scn.sap.com/docs/DOC21995

ErrorBobjisundefined:

Seethis:HowdoItroubleshootBobjisundefined

ErrorTherequestcouldnotbesubmittedforbackgroundprocessing

Seethis:TroubleshootingBackgroundprocessingerror

ItisalwaysrecommendedtosettheTargetplatformoftheapplicationinVisualStudiowhiledevelopingtheapplicationtoeitherX86orX64insteadofkeepingitANYCPU,whichresolvesmanypossibleissuesduringdeployment.

IfyouareintendingtouseADO.NETdatasetswithCrystalReports,hereiswhatyoushouldread.

KB1511438HowtouseDatasetstopassdatatoCrystalreport.

AndthearticlesTroubleshootingVS.NetDatasetsandCrystalReportsandCrystalReportsforVisualStudio.NETWalkthroughReportingOffADO.NETDatasets

Inmostcaseswerecommendtheuseofthetroubleshootingtoolstofurtherdiagnosetheseissues.

Sohereissomeinformationregardingthetroubleshootingtools:

Utilitytoolsforbettertroubleshooting

Foranyotherissuestrybelowsearchwhichwillreturnalltherelatedarticles,forumthreadsandknowledgebasearticlesonSCN.http://search.sap.com/ui/scn#query=&startindex=1&filter=scm_a_site%28scm_v_Site11%29

WhichisalsoavailableatthetoprightcornerofeverySCNpage.

ApplicationDeploymentOnceyougettheapplicationworkingontheDevelopmentmachine,itstimetodeploytheapplication.

ThebestinformationisprovidedintheDeveloperguideoftheCrystal.NETSDKDeploymentsection.FindthelinktoDeveloperguideabove.

AndthearticleCrystalReportsandVisualStudio.NETApplicationDeployment

CrystalReportsruntimesalongwithotherCrystalcomponentscanbedownloadedatCrystalReportsDownload.

OneotheraspecttodecideuponisCrystalReportslicensing.

Oncetheapproachisdecidedandtheapplicationisdeployed,fewcommonissueswhichcouldpossiblyoccurareasfollows:

Error:RetrievingtheCOMclassfactoryforcomponentwithCLSID

ThisisverycommonerrormessageandisdiscussedmanytimethroughforumsandKBs,seethissearch:

http://search.sap.com/ui/scn#query=COM+CLSID%2C+.net&startindex=1&filter=scm_a_site%28scm_v_Site11%29



Rememberthereareno64bitruntimesavailableforEveryversionofCrystalReports.

Seethis:KB1483811Wherearethe64bitruntimefilesforCrystalReports2008.NETSDK?

Andthisarticle:CrystalReportsSupportof64bitOperatingSystems

ForthoseversionsofCrystalReportswhichdonothave64bitruntimes,seebelowarticle

HowtodeployaCrystalReports.NetWebapplicationona64bitoperatingsystem?

Error:Themaximumreportprocessingjobslimitconfiguredbyyoursystemadministratorhasbeenreached.

Seethis:CrystalReportsMaximumReportProcessingJobsLimithttp://scn.sap.com/docs/DOC21533

Andtheblog:Whatexactlyis'maximumreportprocessingjoblimit'forCrystalReports?

Databaseconnectivityissues:

MostoftheDatabaseconnectivityissuescouldberesolvedbycarefullyconfiguringtheserver/orclientmachinefortheapplication.Herearefewthingstodo.

Checkifthedatabaseisaccessiblefromthismachine(a.udlfilemayhelp)

Checkifthesamedatabaseclient/driver/providedwhichisusedonthedevelopmentmachineisinstalledhere.(checkdatabasepropertiesofthereportSetDatabaselocationoptioninthedesigner)

Iftheuserloggingintotheapplication/machinehasrightstoaccesstheDB/DBserver.

Andthebasicthing,checkthelogoncredentialssuppliedbytheapplication.

Formoreseethis:TroubleshootingGuidetoDatabaseConnectivityIssueswithCrystalReportsinVisualStudio.NETApplications

HereistheutilitywhichgeneratestheDatabaselogoncodeforaCrystalReport.

1553921Isthereautilitythatwouldhelpinwritingdatabaselogoncode?

CrystalReports.NETapplicationperformanceissues:

Issueslike,reporttakeslongerontheserver/clientascomparedtodevelopmentmachine.

Reporttakeslongeronthefirstloadandthenworksfine.

Reporttakeslongertimetoexport/printcouldberesolvedandperformancecouldbeoptimizedbyadaptingtheguidelinesprovidedinthisarticle:

ImprovingCrystalReportsPerformanceinVisualStudio.NETApplications

OnemorethingwhichplaysamajorroleinthereportperformanceistheperformanceoftheDatabase.

UseSQLprofilerordatabasetracing(orsomethingsimilarforyourDB)toobserveifitistheDBwhichiscausingthereporttoworkslowly.UltimatelyCrystalReportsisaDatarepresentationtool.

Crystalreportprintingissues:

Error:Communicationerrorhasoccurred,printingwillbestopped.

Thisalsoaverygenericissueandcouldbecausedbymanyfactors,seebelowsearchfortherelatedforumthreadsandKBarticles.

http://search.sap.com/ui/scn#query=Communication+error+has+occurred%252C+printing+will+be&startindex=1&filter=scm_a_site(scm_v_Site11)

HerearesomeverygoodarticleswhichspeakaboutCrystalreportprintingfromanapplication.

PrintingWebbasedreportswithCrystalReportsforVisualStudio.NET

CrystalReportsforVisualStudio.NETExportandPrintaCrystalReport

RASServerSidePrinting

Foranyotherspecific/adhocissues/errorsearchourcommunityforumsandknowledgebasearticleshere:

http://search.sap.com/ui/scn#query=Crystal+.NET&startindex=1&filter=scm_a_site%28scm_v_Site11%29

Ifnoneoftheabovehelps,postyourqueryatourdevelopmentforum

SAPCrystalReports,versionforVisualStudiospaceonSCN

Iftheissueisimportantorcouldnotberesolvedonforums,finallyyoumaylogasupportincidentwithusfromSAPServiceMarketplaceorpurchaseasinglesupportincident.



Alsocheckoutthisblogwhichoutlinesthescopeofsupport.HowcanSAPCrystalReports&BOESDKdevelopersupporthelpyou?

RelatedContent

RelatedDocumentsMytroubleshootingtipsforVS.NETapplicationsusingCrystalReportsbyLudek

CrystalReportsforVisualStudio2010Updates&RuntimeDownloads

CrystalReports2008VersionandDownloadinformationforSPsandFPs

CrystalReports2008(and9.1,XIR1,XIR2)VersionandDownloadinformationforServicePacks

Allthesampleapplications

Troubleshootingerror:"UnsupportedOperation.AdocumentprocessedbytheJRCenginecannotbeopenedintheC++stack".

So,what'supwithCR2011and.NETSDKactually,anySDK?

WhatdoIneedtodotogetthefastestissueresolution?

ComparisonoffeaturesbyversionforSAPCrystalReportsandSAPCrystalServer

Nolabels

FollowSCNContactUs SAPHelpPortalPrivacy TermsofUse LegalDisclosure Copyright