Skip to Content
author's profile photo Former Member
Former Member

Unmanaged RAS in .NET doesn't work.

I've been studying the KB articles and looking through some forum posts here, but I can't get a simple .NET app working with unmanaged RAS API. Everything I tried keeps telling me that I need the RAS server running. I don't understand if this is unmanaged RAS, then I don't have a RAS server to go against. I assume that maybe there is a RAS service running in the background, but I don't know. I've also downloaded the online .NET RAS samples, but they crash too. Here is what I've done:

Install VS.NET 2008

Install CR 2008

Install CR 2008 SP0

I built a very simple application using some of the sample code as a base, and here is what I have:

private void OpenSampleReport_unmanagedRAS()


string sampleReportPath = @"C:\Employee Profile.rpt";

object path = (object)sampleReportPath;

ReportDocument rd = new ReportDocument();

ISCDReportClientDocument rcd = new ReportClientDocumentClass();


rcd.ReportAppServer = "localhost";

//Error on next line: 'The ReportClientDocument property can only be accessed when the

//report is opened using a Report Application Server.

rcd = rd.ReportClientDocument;

crystalReportViewer1.ReportSource = rd;



Here is what happens when I run a sample report from the BOBJ site (NewReport.sln). Here is a code snippet:

void CreateReport()


// create a report client document

m_crReportDocument = new ReportClientDocument();

m_crReportDocument.ReportAppServer = "";

// initiate new report

//Error on next line: "Failed to connect to server ""


// create ODBC connection

m_crConnectionInfo = CreateConnectionInfo();

As you can see, it expects me to be running a RAS server on my localhost, but this doesn't appear to be the case. Do I need to turn on a RAS service after installing CR 2008 SP0? Do I need to run a separate install for the RAS? Is there a way to see if a RAS service is running (I don't see it listed under Windows Services).

Again, this is for unmanaged RAS and a thick client application so that I can modify reports using from within my Windows application.


Add a comment
10|10000 characters needed characters exceeded

Related questions

3 Answers

  • Best Answer
    Posted on Jun 26, 2008 at 02:43 AM

    Hi Brian,

    There pretty much is no such thing as unmanaged RAS any longer. It quit shipping with CR after version 10. It was a stand alone RAS server that ran without being included in the Enterprise product.

    What you are talking about is inprocess RAS.

    RAS is included inproc in XI R2 SP2 and above and CR 2008 which means there is no seperate RAS server.

    Here is how to create the reportclientdocument object from the reportdocument object using inproc RAS.

    Give this simple code a try and let me know if it works. This at least shows how to get to the reportclientdocument object. In my opinion only reason to use RAS inproc is if you want to use the RCAPI abilities of RAS. If you aren't then using the ReportDocument is fine.

    private void OpenSampleReport_InprocRAS()


    string sampleReportPath = @"C:\Employee Profile.rpt";

    ReportDocument rd = new ReportDocument();


    ISCDReportClientDocument rcd = new ReportClientDocumentClass();

    rcd = rd.ReportClientDocument

    crystalReportViewer1.ReportSource = rcd;


    I hope this helps!


    Add a comment
    10|10000 characters needed characters exceeded

  • Posted on Jun 26, 2008 at 01:45 PM

    Hello Brian,

    Just some background info, to expand on Jason's message earlier, concerning the Report Application Server (RAS) components - RAS server, inproc RAS, and the RAS SDK.

    The RAS Server is a server-side of a server-client architecture for Crystal Report creation/modification/viewing. The RAS server processes requests from the RAS SDK, using the report engine to run reports. Connection between RAS server and RAS SDK is via CORBA - TCP/IP.

    The RAS Server can run in two versions: stand-alone or as part of Enterprise (Crystal Enterprise, Crystal Reports Server or BusinessObjects Enterprise). Current stand-alone version (Crystal Reports Server XI Release 2 Embedded) is a OEM/Parter only solution.

    As part of Enterprise, RAS can be used for "managed reporting" or "unmanaged reporting".

    With stand-alone or unmanaged reporting, the RAS accesses the rpt file directly, where the rpt file is deployed on the RAS server (you'd reference it by its physical path) or on the application server running the RAS SDK (you'd reference it via URL "rassdk://<physical path here>").

    With managed reporting, the RAS accesses reports that are managed by the Enterprise system (you'd reference report by their SI_ID value on Enterprise).

    The difference between stand-alone and unmanaged is that unmanaged uses Enterprise authentication - it uses the Guest account, taking up one CAL license count per report, while stand-alone uses 3 CPL (Concurrent Process License) licensing.

    With stand-alone or unmanaged reporting, you'd specify the location of the RAS server in RAS SDK using the ReportAppServer property of the ReportClientDocument.

    With managed, you'd request the service from EnterpriseSession.

    So what's Inproc RAS? CR.NET uses underlying RAS SDK for its functionality. Rather than connect to a remote RAS server, however, the inproc RAS SDK directly invokes the report engine within the CR.NET process.

    The underlying RAS SDK was not exposed for public use until Crystal Reports XI Release 2 Service Pack 2.

    This extends functionality of CR.NET in allowing for report creation/modification functionality. Of course, the server-client RAS server is a better scalability fit for applications under more than modest load.


    Ted Ueda

    Add a comment
    10|10000 characters needed characters exceeded

  • author's profile photo Former Member
    Former Member
    Posted on Aug 11, 2008 at 10:27 AM

    Hello Meenakshi,

    for .NET inproc RAS there is still no GUI for an embeddable designer like we used to have it for the RDC / embedded designer.

    You would need to porgram this manually.

    Please see here [a sample how to create a simple report from scratch|] in CS VS 05.

    Please post if you need more samples.


    Add a comment
    10|10000 characters needed characters exceeded

Before answering

You should only submit an answer when you are proposing a solution to the poster's problem. If you want the poster to clarify the question or provide more information, please leave a comment instead, requesting additional details. When answering, please include specifics, such as step-by-step instructions, context for the solution, and links to useful resources. Also, please make sure that you answer complies with our Rules of Engagement.
You must be Logged in to submit an answer.

Up to 10 attachments (including images) can be used with a maximum of 1.0 MB each and 10.5 MB total.