Crystal Enterprise 10 - SAP Developer Network

Crystal Enterprise 10 

Using Business Views with the Java SDK 

Overview 

Contents 

This document discusses how to use the Crystal Enterprise Java SDK to 

interface with Business Views. 

INTRODUCTION............................................................................................ 2 

DYNAMIC DATA CONNECTION ......................................................................2 

Example .......................................................................................................3 

CHANGING BUSINESS VIEWS AT RUNTIME ....................................................5 

Repository organization...............................................................................5 

Example .......................................................................................................6 

FINDING MORE INFORMATION ......................................................................8 

Business Views Administrator’s Guide.......................................................8 

Business Views Security Whitepaper ..........................................................8 

7/1/2005 1:05:00 PM Copyright © 2005 Business Objects. All rights reserved. Page 1

Crystal Enterprise 10 Using Business Views with the Java SDK 

Introduction 

Dynamic Data Connection 

NOTE 

Business Views is a new feature introduced in Crystal Reports 10 and 

Crystal Enterprise 10 that provides view time security. When viewing a 

report(s) based on a Business View, only the rows and columns that the 

current user is entitled to view are visible. 

This security model applies when not only viewing reports in Crystal 

Reports but also when scheduling reports with saved data in Crystal 

Enterprise. Business Views are stored in the Crystal Enterprise 10 Crystal 

Management Server (CMS) Repository, along with other report design 

components. 

You are able to interact with Business Views in two ways using the 

Crystal Enterprise 10 Java SDK. With Dynamic Data Connections, you 

are able to change the data connection of a Business View by passing its 

Cluster Unique Identifier (CUID). You are also able to change the 

Business View to which a report is connected. This document discusses 

these two methods of interaction. 

Dynamic Data Connections consist of a collection of pointers to different 

data connections. By setting a parameter value, you are able to specify 

which data connection to use. 

A Dynamic Data Connection enables you to change between data 

sources as needed, whereas a data connection is more static. Therefore, a 

Dynamic Data Connection provides additional flexibility in terms of 

specifying a data source, but it is not a mandatory object when you 

create your Business View. You are able to create Data Foundations with 

or without using a Dynamic Data Connection. 

You must first create more than one data connection before you can create a Dynamic 

Data Connection. 

Many organizations use a development, test, and production system 

model for housing their data. That is, the data is initially stored on a 

development system and then later migrated to a test system. After 

extensive testing, the data in the test system is ready to be used in the 

production system. Dynamic Data Connections can serve this purpose. 

When a report is connected to a Dynamic Data Connection, a report 

parameter is automatically created. The parameter contains the same 

number of default values as data connections in the Dynamic Data 

Connection. Each of the values represents the CUID of the data 

connection in the Dynamic Data Connection. The parameter description 

is the name of the data connection. To connect to a specific data 

connection, the current value of the parameter must be set to the 

corresponding CUID. 

7/1/2005 1:05:00 PM Copyright © 2005 Business Objects. All rights reserved. Page 2 

ce10_using_business_views_with_java_sdk.pdf


Example 

The following code demonstrates how to set the current value of the 

parameter to the CUID of the desired Data Connection: 

import com.crystaldecisions.sdk.occa.report.application.*; 

import com.crystaldecisions.sdk.occa.report.definition.*; 

import com.crystaldecisions.sdk.occa.report.data.*; 

import com.crystaldecisions.sdk.occa.report.lib.*; 

import com.crystaldecisions.sdk.framework.*; 

import com.crystaldecisions.sdk.occa.managedreports.*; 

import com.crystaldecisions.sdk.occa.infostore.*; 

import com.crystaldecisions.sdk.plugin.desktop.report.*; 

import com.crystaldecisions.sdk.plugin.desktop.common.*; 

import com.crystaldecisions.report.web.viewer.*; 

import 

com.crystaldecisions.sdk.occa.report.reportsource.IReportSo 

urce; 

import java.util.*; 

/* Connect to Crystal Enterprise */ 

CrystalEnterprise ce = new CrystalEnterprise(); 

ISessionMgr sm = ce.getSessionMgr(); 

IEnterpriseSession es = sm.logon(“cmsUser”, “cmsPassword”, 

“mAPSName”, 

“mAuthType”); 

/* Get the InfoStore service from Crystal Enterprise */ 

IInfoStore infoStore = (IInfoStore)es.getService("", 

"InfoStore"); 

/* Retrieve the report by name from Crystal Enterprise */ 

IInfoObjects oInfoObjects = infoStore.query("Select * From 

CI_INFOOBJECTS 

Where SI_NAME = 'reportName'"); 

/* Open the report into a Report Document object */ 

IInfoObject oInfoObject = (IInfoObject)oInfoObjects.get(0); 

IReport report = (IReport)oInfoObject; 

/* create a new Fields collection to represent the report’s 

parameters */ 

Fields params = new Fields(); 

/* Get the old IReportParameter object */ 




IReportParameter oldParam = 

(IReportParameter)report.getReportParameters().get(0); 

/* Convert the IReportParameter object to the 

ParameterField object that the viewer accepts */ 

ParameterField newParamField = 

oldParam.getParameterField(); 

/* Get the Description of the parameter value for 

demonstration purposes */ 

String description = 

((IReportParameterSingleValue)oldParam.getDefaultValues().g 

et(0)).getDescription(); 

out.println( "Parameter Value Description = " + description 

+ "" ); 

ParameterFieldDiscreteValue newDiscreteValue = 

new ParameterFieldDiscreteValue(); 

IReportParameterValues oldDefaultValues = 

(IReportParameterValues)oldParam.getDefaultValues(); 

String CUIDofDataConnection0 = 

((IReportParameterSingleValue)oldDefaultValues.get(0)).getV 

alue(); 

out.println( "CUID --> " + CUIDofDataConnection0 + "" 

); 

/* Pass the CUID of the Business View to the value object 

*/ 

newDiscreteValue.setValue( CUIDofDataConnection0 ); 

/* Pass the value object into the new Parameter Field */ 

Values values = new Values(); 

newParamField.setCurrentValues( values ); 

newParamField.getCurrentValues().add( newDiscreteValue ); 

out.println( "Currnet Values = " + 

((IParameterFieldDiscreteValue)newParamField.getCurrentValu 

es().getValue(0)).getValue() ); 

/* Add the new parameter field to the collection of 

parameters */ 

params.add( newParamField ); 

/* Create a Report source object to pass to the Viewer */ 




NOTE 

IReportSourceFactory factoryPS = (IReportSourceFactory) 

es.getService("PSReportFactory"); 

IReportSource reportSource = 

factoryPS.openReportSource(oInfoObject,Locale.ENGLISH); 

/* View the Report */ 

CrystalReportViewer viewer = new CrystalReportViewer(); 

viewer.setEnterpriseLogon(es); 

viewer.setReportSource( reportSource ); 

viewer.setParameterFields( params ); 

viewer.processHttpRequest(request, response, 

getServletConfig().getServletContext(), out); 

Changing Business Views at Runtime 

Refer to the Crystal Java Developer’s Library that is included on the Crystal Enterprise 10 

CD for more information. 

With the Report Application Server (RAS) SDK in Crystal Enterprise 10, 

you are able to change a report’s Business View, as well as any of its 

implemented security constraints, at runtime. To change a Business View 

at runtime, the new Business View must be identical in schema, name, 

and number of Business Elements (see Table 1). 

Original Business View Destination Business View 

Business Element Employee Business Element Employee 

Business Element Customer Business Element Customer 

Table 1 

In the example in Table 1, the Employee Business Element in the original 

Business View is replaced by the Employee Business Element in the 

destination Business View. They are identical in name and number of 

elements. 

Repository organization 

To have multiple Business Elements with the same name in one 

repository system, the elements must be organized in separate folders. 

Each Business View should be stored in its own folder that contains all 

its Business Elements. 




Example 

The following code demonstrates how to change a report’s Business 

View at runtime: 

import com.crystaldecisions.sdk.occa.infostore.*; 

import com.crystaldecisions.sdk.framework.*; 

import com.crystaldecisions.sdk.occa.report.application.*; 

import com.crystaldecisions.sdk.occa.report.definition.*; 

import com.crystaldecisions.sdk.occa.report.data.*; 

import com.crystaldecisions.sdk.occa.report.lib.*; 

import com.crystaldecisions.sdk.occa.managedreports.*; 

import 

com.crystaldecisions.report.web.viewer.CrystalReportViewer; 

import java.util.*; 

/* Login to Crystal Enterprise and retrieve a Session */ 

IEnterpriseSession es = 

CrystalEnterprise.getSessionMgr().logon( “cmsuser”, 

“cmspassword”, “CMSName”, “cmsAuthType” ); 

/* Retrieve a RAS report service */ 

IReportAppFactory rptAppFactory = 

(IReportAppFactory)es.getService("", "RASReportService"); 

/* Get the InfoStore service from Crystal Enterprise */ 

IInfoStore infoStore = (IInfoStore)es.getService("", 

"InfoStore"); 

/* Retrieve the report by name from Crystal Enterprise */ 

IInfoObjects oInfoObjects = infoStore.query("Select SI_ID 

From CI_INFOOBJECTS 

Where SI_NAME = 'reportName'"); 

/* Convert the report into a Report Document object */ 

ReportClientDocument clientDoc = 

rptAppFactory.openDocument((IInfoObject)oInfoObjects.get(0) 

, 0, Locale.ENGLISH); 

/* Retrieve the DatabaseController */ 

DatabaseController oDatabaseController = 

clientDoc.getDatabaseController(); 




/* Retrieve the 'Xtreme Production Business View' */ 

String query = "SELECT SI_CUID FROM CI_APPOBJECTS WHERE 

SI_NAME = 

'VisNetView' "; 

oInfoObjects = null; 

oInfoObjects = infoStore.query(query); 

IInfoObject oBusinessView = 

(IInfoObject)oInfoObjects.get(0); 

/* Set the datasource to another Business View */ 

oDatabaseController.setDataSource( oBusinessView ); 

/* View the report */ 

CrystalReportViewer viewer = new CrystalReportViewer(); 

viewer.setEnterpriseLogon(es); 

viewer.setName("Crystal_Report_Viewer"); 

viewer.setOwnPage(true); 

viewer.setReportSource(clientDoc.getReportSource() ); 

viewer.processHttpRequest(request, response, 

getServletConfig().getServletContext, out); 

NOTE Refer to the Crystal Java Developer’s Library that is included on the Crystal Enterprise 10 

CD for more information. 




Finding More Information 

Business Views Administrator’s Guide 

http://support.businessobjects.com/communityCS/TechnicalPapers/ce 

10_businessview_en.pdf.asp 

Business Views security whitepaper 

http://support.businessobjects.com/communityCS/TechnicalPapers/C 

E10_BusinessViews_Security.pdf.asp 

For more information and resources, refer to the product documentation 

and visit the support area of the web site at 

http://www.businessobjects.com/ 

www.businessobjects.com 

No part of the computer software or this document may be reproduced or transmitted in any form or by any means, 

electronic or mechanical, including photocopying, recording, or by any information storage and retrieval system, 

without permission in writing from Business Objects. 

The information in this document is subject to change without notice. Business Objects does not warrant that this 

document is error free. 

This software and documentation is commercial computer software under Federal Acquisition regulations, and is 

provided only under the Restricted Rights of the Federal Acquisition Regulations applicable to commercial computer 

software provided at private expense. The use, duplication, or disclosure by the U.S. Government is subject to 

restrictions set forth in subdivision (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at 

252.227-7013. 

The Business Objects product and technology are protected by US patent numbers 5,555,403; 6,247,008; 

6,578,027; 6,490,593; and 6,289,352. The Business Objects logo, the Business Objects tagline, 

BusinessObjects, BusinessObjects Broadcast Agent, BusinessQuery, Crystal Analysis, Crystal Analysis 

Holos, Crystal Applications, Crystal Enterprise, Crystal Info, Crystal Reports, Rapid Mart, and 

WebIntelligence are trademarks or registered trademarks of Business Objects SA in the United States 

and/or other countries. Various product and service names referenced herein may be trademarks of 

Business Objects SA. All other company, product, or brand names mentioned herein, may be the 

trademarks of their respective owners. Specifications subject to change without notice. Not responsible for 

errors or omissions. 

Copyright © 2005 Business Objects SA. All rights reserved.

Crystal Enterprise 10 - SAP Developer Network

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?