When to call DocumentInstance.refresh()

Question

I have a jsp page that takes URL encoded prompt name/value pairs, opens reports, fills in the prompts from the name/value pairs, refreshes the reports, and returns the results as a PDF file.  It needs to be able to handle Web Intelligence reports and Desktop Intelligence reports. <br />  <br /> I&#39;ve seen conflicting documentation and example code showing when to make the "refresh()" call.  Some says before the prompts are set, some says after, some says both, and some says you don&#39;t need to do it at all. <br />  <br /> I had it working with Deski docs by filling in the parameters (DocumentInstance.setPrompts()), and then calling refresh().  But that wouldn&#39;t work with Webi.  What seems to work with Webi is calling refresh() first, then filling in the prompts and calling setPrompts().  Now I&#39;m seeing that work for Deski too.  But I can find nowhere that explains definitively what the right way is and I&#39;m a little uncomfortable with the lack of logic here.   <br />  <br /> Does anyone know what the answer is?  Below is a small sample program that I&#39;ve been using to test my hypotheses. <br />  <br />  <br /> Thanks ! <br />  <br />  <table border="0" cellspacing="1" cellpadding="3" width="90%" align="center"><tbody><tr>        <td><span class="genmed"><strong>Code:</strong></span></td>     </tr>     <tr>       <td class="code"> <br /> <%@ page language="java"%>  <br />  <br /> <%@ page import="com.crystaldecisions.sdk.exception.SDKException" %> <br /> <%@ page import="com.crystaldecisions.sdk.framework." %> <br /> <%@ page import="com.crystaldecisions.sdk.occa.infostore." %>  <br /> <%@ page import="com.crystaldecisions.sdk.plugin.CeKind" %> <br /> <%@ page import="com.businessobjects.rebean.wi." %> <br /> <%@ page import="com.businessobjects.rebean.wi.ReportEngines.ReportEngineType" %>  <br /> <%@ page import="java.io." %> <br /> <%@ page import="java.util.*" %> <br />  <br /> <%@ include file="./webitestHelpers.jsp" %>  <br />  <br /> <% <br />  <br /> // simple test program for testing refreshing Webi docs and Deski docs. <br />  <br /> String okayStatus = "OK"; <br /> String exceptionStatus = "Exception";  <br /> String status = okayStatus; <br /> String flocParamName = "Select Field Location"; <br /> String reportNameParamName = "reportName"; <br /> byte[] binaryContent = null; <br /> IEnterpriseSession boSession = null; <br />  <br /> try <br /> { <br />    // login and get a business objects session <br />    boSession = getBoSession(); <br />  <br />    String reportName = "report name not specified";  <br />    String floc = "field location not specified"; <br />  <br />    String param = request.getParameter(reportNameParamName); <br />    if (param != null)  <br />       reportName = param.trim(); <br />     <br />    param = request.getParameter(flocParamName); <br />    if (param != null)  <br />       floc = param.trim(); <br />     <br />    IInfoStore store = (IInfoStore) boSession.getService("InfoStore"); <br />  <br />    // get the ID of the folder that contains the report <br />    String folderQuery = "SELECT SI_ID FROM CI_INFOOBJECTS WHERE SI_NAME = &#39;OnDemand_ReadyQA&#39; AND SI_KIND = &#39;" + CeKind.FOLDER + "&#39;"; <br />  <br />    IInfoObjects folderObjs = (IInfoObjects) store.query(folderQuery);  <br />  <br />    // should be exactly one folder by that name <br />    if (folderObjs.size() == 1) <br />    { <br />       IInfoObject rootFolder = (IInfoObject) folderObjs.get(0);  <br />       int rootFolderId = rootFolder.getID();   <br />  <br />       // get the report named in the URL that lives in the reports folder <br />       String reportQuery = "SELECT SI_ID FROM CI_INFOOBJECTS WHERE SI_NAME = &#39;" + reportName + "&#39; AND SI_PARENTID = &#39;" + rootFolderId + "&#39;";  <br />  <br />       IInfoObjects reportObjs = (IInfoObjects) store.query(reportQuery); <br />  <br />       // should be exactly one  <br />       if (reportObjs.size() == 1) <br />       { <br />          IInfoObject reportIio = (IInfoObject) reportObjs.get(0);  <br />  <br />          ReportEngines engines = (ReportEngines)boSession.getService("ReportEngines"); <br />          ReportEngine engine; <br />  <br />          // get the right kind of engine based on the report type (webi vs deski) <br />          if ("FullClient".equals(reportIio.getKind()))  <br />             engine = engines.getService(ReportEngineType.FC_REPORT_ENGINE); <br />          else <br />             engine = engines.getService(ReportEngineType.WI_REPORT_ENGINE);  <br />  <br />          // and open the document <br />          DocumentInstance doc = engine.openDocument(reportIio.getID()); <br />  <br />           // The call that doesn&#39;t seem to make sense here.  Seems to work for Webi and Deski... <br />          doc.refresh(); <br />     <br />          // only 1 prompt exists in our little test case - fill it in with the value from the URL  <br />          Prompts prompts = doc.getPrompts(); <br />          Prompt p = prompts.getItem(flocParamName); <br />          if (p != null)  <br />          { <br />             String[] promptVals = new String[1]; <br />             promptVals[0] = floc;  <br />             p.enterValues(promptVals);          <br />             doc.setPrompts();  <br />  <br />             // we used to refresh here, and it worked for Deski, but not for Webi.   <br />             // doc.refresh(); <br />               <br />             // get a binary view of the document in pdf encoding <br />             BinaryView docbv = (BinaryView) doc.getView(OutputFormatType.PDF);  <br />             binaryContent = docbv.getContent(); <br />          } <br />          else  <br />             status = "No &#39;" + flocParamName + "&#39; parameter exists"; <br />       } <br />       else  <br />          status = "No report for query " + reportQuery; <br />    } <br />    else <br />       status = "No folder for query " + folderQuery;  <br /> } <br /> catch (Throwable t) <br /> { <br />    status = exceptionStatus; <br />  <br />    out.write("\r\n\r\n<html>\r\n<body>\r\n\r\n");  <br />        <br />    out.write("<h2>Exception</h2>"); <br />    out.write("<h3>Error:</h3> " + t.getMessage() + "<BR>");  <br />    out.write("<h3>StackTrace:</h3> "); <br />    out.write("<PRE>"); <br />    t.printStackTrace((new java.io.PrintWriter(out)));  <br />    out.write("</PRE> <BR>"); <br />     <br />    out.write("\r\n\t\t\r\n</body>\r\n</html>\r\n\r\n");  <br /> } <br /> finally <br /> { <br />    boSession.logoff(); <br />    session.invalidate(); <br /> } <br />  <br /> if (okayStatus.equals(status)) <br /> { <br />    response.setContentType("application/pdf"); <br />    ServletOutputStream os = response.getOutputStream();  <br />    os.write(binaryContent); <br /> } <br /> else if (!exceptionStatus.equals(status)) <br /> { <br />    out.write("\r\n\r\n<html>\r\n<body>\r\n\r\n");  <br />    out.write("<h2>Error</h2>"); <br />    out.write("<h3>" + status + "</h3>"); <br />    out.write("\r\n\t\t\r\n</body>\r\n</html>\r\n\r\n");  <br /> } <br />  <br /> %> <br /> </td></tr></tbody></table>

Answer 1

I tried to mimic your codes with my existing Deski report in CMS and run in my local machine. My purpose is to run deski report, pass parameter, mutiple format and save output report to unmanaged disk (network/local destination).
My connection was successfull using "Connection with userID".
However, it stops and encountered error on this line of code...
ReportEngines engines = (ReportEngines)boSession.getService("ReportEngines");
Error Message below:
Entering getRASConnection()
Error Message: No server was available to process the request. Please try again later. (Error: RFC 00101)
Any idea why it happens?
Please help me on this.
Thanks.