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
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 2/4
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
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 3/4
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.
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 4/4
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