Unfortunately Xcelsius does not have a native mechanism to send data back to the database, as a dashboard’s main purpose to read data and not write back to the database.  However, I do see the value in being able to persist comments so that we can go back later and be able to look at documentation on why certain things happened, etc.

In this article I will give step by step instructions on how to use web services and Xcelsius to accomplish the task of inserting comments.  However you will have to write your own web service code

Preparation

In order to facilitate the ability to create comments from Xcelsius we must have a mechanism to do so and a place to persist the comments.

You will need to store the comments in a database.

Thus you will need the following:

• Database
• Database table that will house the comments and additional parameters such as user, dashboard, etc

To allow Xcelsius to send comments to the database, we will need to create a Web Service and then call that Web Service from Xcelsius while sending in the appropriate parameters (comments, user, dashboard, etc).

To facilitate the ability to use Web Services, you must have a .NET or Java application server available.

Pseudo steps to create the Web Service

1. Start creating your web service using the programming language of choice (VB .NET or Java)
2. Create a method that will house your “insert comment” code
3. Method will need to have input parameters that contains your comment text and any other parameters such as user, dashboard, etc

       Steps in the method

1. Log into database
2. Begin Transaction
3. Create insert statement that will insert the input parameters (comment text, etc)
4. Make sure that there is some sort of rollback mechanism to handle errors
5. End transaction
6. Close database connection

When you are finished coding, you will then need to deploy the Web Service onto your .NET or Java application server.

Useful Resources to help you code your Web Service

1.  Introduction on what a Web Service is

http://en.wikipedia.org/wiki/Web_service

http://www.w3schools.com/webservices/ws_intro.asp

2.  Example of creating a simple VB . NET Web Service for a .NET application server

http://www.w3schools.com/webservices/ws_example.asp
3.  Example of creating a simple java based Web Service that runs on a Java server

http://www.roseindia.net/webservices/buildingsimplewebservice.shtml

4.  Java code to connect to a DB, create a table, insert into table, and retrieve from a table (you are only interested in inserting) Start on step 22 if you are interested in the code

http://www.java2s.com/Code/Java/Database-SQL-JDBC/AccessMySQLDatabaseopenconnectioncreatetableinsertandretrieve.htm

Xcelsius Steps

In the Xcelsius example, we will walk through the steps on creating an input/output comment box; and creating a web service connection that inserts a user’s comment into the database.

1.  Drag an Input Text Area and Label component onto the canvas.  Users will enter their comments into the input text area and the label component contain existing comments.

2.  Bind the Input Text Area to the cell highlighted in yellow.  The web service connection will use this as one of the inputs.

3.  Now let’s setup our Web Service Connection.  On the data manager, add a Web Service Connection and enter the WSDL url into the WSDL URL: input box.

4.  Bind the input values to the cells of your spreadsheet.  (In our example we bind to 3 input values. Note that the output value is optional so we will skip that part.  In addition we will skip creating a Web Service Connection that retreives prior comments since it uses the same concept of what we are doing here)

5.  Insert a Connection Refresh Button component onto the canvas.  Make sure the Web Service Connection is checked.

Unfortunately my previous tutorial at http://davidlai101.com/blog/2008/11/04/all-you-need-to-know-about-opendoc/ only works with Business Objects XI R2

Please note that the tutorial was taken from SAP BusinessObjects Dashboards 4.0 Cookbook so if you are interested in more useful Xcelsius recipes, be sure to purchase a copy

If you only need the Excel Template for setting up OpenDocument calls, you can download it here

If you are interested in getting detailed information on OpenDocument Parameters please download the official SAP OpenDocument documentation here

Otherwise continue reading for the Tutorial

Getting ready

A WEBI report with a prompt must be setup first.  In our example, the WEBI report will ask for a Region parameter.

You can download the example XLF source file from here

How to do it…

1.            Drag a Combo Box selector onto the canvas and bind the label values to the list of Regions on the Excel spreadsheet as shown below. Set Label as the Insertion Type and bind the Destination to the cell highlighted in yellow, which will be the input parameter passed to the opendoc call.

2.            Log into BI Launch Pad (Formerly Infoview), go to the location of where the Web Intelligence report is located. Right click and select properties.

3.            Copy the CUID

4.            On cell B14 shown below, an opendoc url is constructed. Paste the CUID from Step 3 onto Cell B23 highlighted in grey. Cell C23 equals the Selected Region cell C2 from Step 1.

5.            Drag a URL Button component onto the canvas from the Web Connectivity section of the Components window. In the URL Button properties change the Label text to Open WEBI report, and bind the URL to the opendoc url cell B14 from Step 2.

In this example, we’ll go through a quick scenario on solving a crossdomain.xml related issue.

You will need to Install Charles on your machine and install the Charles addon for Firefox.

In the image below, I’m receiving “Cannot Access External Data” error. I’m scratching my head wondering what could be wrong.

So what I’ll do to analyze the problem is to first Enable Charles by clicking on Tools -> Charles -> Enable Charles

Then start the Charles program and Start Recording

Then reopen the link where the error occurred.  In our example, I tried putting a swf on an external website that grabs data from another Business Objects Enterprise server.

Once you get the error again, stop recording on Charles and take a look at the Overview.

As you can see, the Overview contains a Response Code of 404.

So we’ll go take a look at the Response.

Now we know what the error is.  It’s trying to look for crossdomain.xml which is missing from the root.  To fix the problem we’ll need to setup crossdomain.xml and place it in the root of the Business Objects Enterprise application server.

Please post on the comments section if you would like to share other ideas of when to use Charles/Fiddler when debugging Business Objects related development.

Embedded Bar Chart in Table

In this example I will give step by step instructions on embedding a horizontal bar
chart into a table. This will allow end users to be able to compare values on the
bar making each row visually comparable which adds great value as well as being able
to see other misc table values very easily.

A big thanks goes to Michael Thompson for coming up with a WEBI solution to accomplish
this task if we are using live office.  You can visit his blog post here.

Embedded Bar Chart in Table

The first option is if the number of rows are static.  If this is the case, we can
simply put a bar chart underneath the table so it looks like it’s part of the table. We
can then easily bind the chart to the appropriate values.

However this only works if the number of rows are static, the reason being that we
cannot control the synchronization of bar size and spacing with a table that has a
dynamic number of rows.

So now we’ll show how to accomplish this if we are using Live Office or QAAWS.
Note that you can create an object in the universe that will get the same value as the bar length calculation
we will be performing below. But I’ll show you the other options so that you will have a variety of
solutions to choose from.

If using Live Office:
1. Create an emulated bar using a filler character. To get your filler character
ready, Open up Microsoft Word, then Insert -> Symbol. Make sure the Font is (normal text)
and select Character code “2588″ from “Unicode (hex)”

2. Now let’s create a new Web Intelligence document.
Choose the eFashion 1998 Universe.
I’ve just chosen a set of lines, sales revenue measure in my query.
For our table we will have the lines, sales revenue and sales revenue chart as columns

3. Create a variable called “length of bar”
The formula for the variable will be “=Round(([Sales revenue]/(max([Sales revenue]) forall ([Lines]))*40;0)”
We’ll use a multiple of 40 because with 100 the bar is too long.

4. Go back to your temporary Word document and copy the symbol that you inserted.

Now on the Sales revenue column put the formula shown below
“=fill(pasted symbol from Word;[length of bar])”

5. In Xcelsius setup your live office connection and bind the values to a spreadsheet table object and you are done!

If using QWAAS:
Since we can’t do the logic in WEBI, we’ll need to do it in Excel to construct the emulated bar.
The logic is very similar.
1. Create a QAAWS object using the same query that we used in the Live Office Example

2. On a cell above the QAAWS values that come in let’s get the max sales revenue.  We will assume that there are a dynamic
range of rows ranging from 1 to 50 “=max(B4:B54)”

3. Copy the symbol from Word

Now on each row from C5 to C54 put the formula =”rept(“pasted symbol from Word”, round((B5/$C$2)*40,0))”
The rept function is just like the fill function in webi.
Also we are using *40 because with 100 the bar will be too long.

4. Now copy the columns appropriately so that when we bind to the spreadsheet, the formatting looks nice.

That’s it,
Now that you are familiar with how to emulate a bar, you can try creating a bar length object in the universe so you keep
all data manipulations logic in the data layer for best practices

You can download the source files for the 3 examples here for reference

I’m very pleased to announce that the Xcelsius Cookbook, which Xavier Hacking and I have been working very hard on, is scheduled to be released in it’s final format on May 2011.

The book will be structured like a cookbook where we will go through step by step on accomplishing different tasks (recipes) in Xcelsius.

In addition we will be showcasing some of the more popular 3rd party addons, provide best practices for development, as well as provide some real life dashboard examples built using recipes learned from the cookbook.

The book is currently available as RAW (Read as we write) format since it is currently under development, so feel free to check it out at the Packt Publishing website for more information.  In addition, since SAP is re-branding Xcelsius yet again, the book name will most likely change to SAP Business Objects Dashboards Cookbook.  Stay Tuned for updates!

Thanks for all your support!

The easiest way to accomplish this is to have a separator column to separate each table, and then overlay a background or rectangle on the blank column. However the rectangle/background looks very ugly as what I have shown on the video.

Please watch the video for a detailed example on how to accomplish the synchronization trick with multiple scorecards.

www.youtube.com/watch?v=9lDCYXT_5Jw

I’ve also outlined the steps to accomplish this if you click on “More”

Step 1: Have 2 or more scorecards lined up side by side on the canvas

Step 2: Stretch the scorecards to the maximum vertical length that you think will be possible. For example it might be a maximum of 20 rows. The reason why we have to do this is because the table doesn’t automatically shrink even if we ignore blank row cells.

Step 3: Put the scorecards inside a canvas of your desired vertical length. Make sure that “vertical scrollbar” is automatic and “horizontal scrollbar” is Off for the Scroll Bar Options of the Canvas container.

Step 4: On the scorecard components, uncheck the rows selectable option and column sorting

Step 5: Overlay a list box selector on top of the scorecards and make it the same size and length starting from after the header.  It is important to make sure that the text in both the list box selector and the scorecard components are the same.

Step 6: Set the transparency on the list box selector to about 80-85% and create a dummy column that has a “.” if there exists a value for the scorecard and blank if there is none.  Right justify the list box selector text so we don’t see the “.”

There you go! now when you hover over one scorecard row, it looks like all the scorecard rows are being hovered in sync!

You can download the example xlf file from here

So we’ll need some sort of hidden login mechanism that bypasses the pop-up and allows data to be refreshed on the dashboard.

Thanks to Ryan Goodman for de-mystifying the CELogonToken @ http://ryangoodman.net/blog/index.php/2008/01/21/xcelsius_single_sign_on_with_celogontoke
and thanks to William Sees for posting his code in the SDN network @ http://forums.sdn.sap.com/thread.jspa?threadID=1544768&tstart=30

In this article we will go step by step through the solution on how to retrieve a Business Objects Logon token and insert it into the CELogonToken Flash variable.

First let’s talk about the CELogonToken and what it does

What is the CELogonToken and what happens during dashboard run time?

The CELogonToken is a Flash Variable that is passed into the Xcelsius Dashboard whenever an Xcelsius Dashboard is opened up from Infoview. The token is populated with a session token that BOE creates when a person is logged into Infoview and any Xcelsius Dashboard using Query as a Web Service or Live Office connections will automatically use the CELogonToken to perform authentication. With each transaction to Business Objects, the token is passed back to Business Objects for authentication. If the CELogonToken does not exist (ie: if we opened the dashboard swf outside of Infoview), the login pop-up asking for authentication will show up when the data is trying to refresh.

How does Xcelsius consume the CELogonToken?
If you look at the <OBJECT> tag in the code below, you will see that the CELogonToken Flash Variable is populated with a Business Objects session token.  From there authentication can take place transparently when the Query as a Web Service or Live Office connection is executed from the dashboard.

<OBJECT classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,40,0" WIDTH="100%" HEIGHT="100%" VIEWASTEXT>
<PARAM VALUE="../../../../opendoc/documentDownload?iDocID=10000&sKind=Flash">
<PARAM VALUE=high>
<PARAM VALUE=#FFFFFF>
<PARAM VALUE="CELogonToken=servername.domain%4066270JJ45M1Ox2XibIf2B66268JUPcDiNQd2vGZEBe&CEWebServiceURL=http%3A%2F%2Fservername %3Aportnumber%2Fdswsbobje%2Fservices%2Fsession">
<EMBED src="../../../../opendoc/documentDownload?iDocID=10000&sKind=Flash" flashVars="CELogonToken=servername.domain%4066270JJ45M1Ox2XibIf2B66268JUPcDiNQd2vGZEBe&CEWebServiceURL=http%3A%2F%2Fservername%3Aportnumber8443%2Fdswsbobje%2Fservices%2Fsession" quality=high bgcolor=#FFFFFF WIDTH="100%" HEIGHT="100%" ALIGN="" PLUGINSPAGE="http://www.macromedia.com/go/getflashplayer">
</EMBED>
</OBJECT>

Instructions

Now that we have a better understanding of what the CELogonToken does, lets go through the steps on getting the transparent authentication to work.

Step 1:

Make sure your dashboard is complete with a QAAWS or Live Office Connection.

Step 2:

Create a jsp (dashboardTest.jsp) that your tomcat webapp server can access and store that in a directory.  For testing purposes just create the following directory <BO Installation>\Tomcat55\webapps\InfoViewApp\DashboardTest

This will ensure that the jsp can access all the required packages.  You can customize which directory you want to put the jsp but you will need to make sure the BOE sdks are accessible.

Step 3:

Again for testing purposes, export the swf file as Test.swf in <BO Installation>\Tomcat55\webapps\InfoViewApp\DashboardTest

Step 4:

Insert the code snippet at the end of the article into the dashboardTest.jsp file.  Note that everything I have highlighted in blue you will need to change according to your specific settings.

Step 5:

Open up the URL in your browser http://server:port/InfoViewApp/DashboardTest/dashboardTest.jsp and verify that the data connection refreshes without the login pop-up coming up.

Explanation of jsp Code

The first part of the code imports the required libraries from the Business Objects SDK to retrieve the logon token.

<%@ page import="com.crystaldecisions.sdk.exception.SDKException,
com.crystaldecisions.sdk.framework.*,
com.crystaldecisions.sdk.occa.infostore.*,
com.crystaldecisions.sdk.occa.security.*,
java.net.*,
com.crystaldecisions.Enterprise.*,
com.crystaldecisions.sdk.plugin.admin.*,
com.businessobjects.webutil.Encoder"
%>
<%@ page import="java.sql.*"%>

The second part of the code sets the server, username and password. We can use a hard coded username/password if for example we want one universal Dashboard user that has view access to a set of dashboards which would make maintenance easier. If you are interested in single sign on you will have to write some extra code to grab the appropriate username and password. Finally you can create a method that returns the username/password in an external class if you don’t want to hardcode the username/password. The code bolded in the try block retrieves the Business Objects logon token.

//-------------------------------------------------------------------Create BO Session and redirect to Infoview
IEnterpriseSession enterpriseSession;
/* * Set Enterprise Logon credentials. */
final String BO_CMS_NAME = "server";
final String BO_AUTH_TYPE = "secEnterprise";
final String BO_USERNAME = "username";
final String BO_PASSWORD = "password";

ILogonTokenMgr logonTokenMgr;
String defaultToken = "";
final String INFOVIEW_URL = "http://server:port/InfoViewApp/logon/start.do";
/*
* Log onto Enterprise
*/
boolean loggedIn = true;
try {
enterpriseSession = CrystalEnterprise.getSessionMgr().logon(BO_USERNAME,BO_PASSWORD, BO_CMS_NAME,
BO_AUTH_TYPE);
logonTokenMgr = enterpriseSession.getLogonTokenMgr();
defaultToken = logonTokenMgr.createWCAToken("", 20, 1);
}

The third part of the code does a check to see if the token generated above was valid and generates the appropriate output which will call the dashboard with the appropriate CELogonToken variable.

//-------------------------------------------------------------------If login successful
if(loggedIn) {
String Flashvars="&CELogonToken=" + Encoder.encodeURL(defaultToken);
Flashvars += "&CEWebServiceURL=" + Encoder.encodeURL("http://server:port/dswsbobje/services/session");
String output = "";
output = output + "<OBJECT classid='clsid:D27CDB6E-AE6D-11cf-96B8-444553540000 codebase='http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,19,0' id='myMovieName' style='width: 355px; height: 237px'> \r\r";
output = output + "<PARAM VALUE='Test.swf'> \r\r"; //( \r = carriage return to make output more legible )
output = output + "<PARAM VALUE=high> \r\r";
output = output + "<PARAM value=\"" + Flashvars + "\">\r\r";
output = output + "<EMBED src='Test.swf' flashvars=\" " + Flashvars + "\" quality=high bgcolor=#FFFFFF WIDTH='1000' HEIGHT='600' NAME='myMovieName' ALIGN=\"\" TYPE='application/x-shockwave-flash' PLUGINSPAGE='http://www.macromedia.com/go/getflashplayer'></EMBED></OBJECT>\r\r";
out.println(output);
}
//-------------------------------------------------------------------If login failed
else {
out.println("Login to Business Objects Failed.");
}

Full JSP Code (Sections highlighted need to be changed)

<%@ page import="com.crystaldecisions.sdk.exception.SDKException,
com.crystaldecisions.sdk.framework.*,
com.crystaldecisions.sdk.occa.infostore.*,
com.crystaldecisions.sdk.occa.security.*,
java.net.*,
com.crystaldecisions.Enterprise.*,
com.crystaldecisions.sdk.plugin.admin.*,
com.businessobjects.webutil.Encoder"
%>
<%@ page import="java.sql.*"%>
<%
//-------------------------------------------------------------------Create BO Session and redirect to Infoview
IEnterpriseSession enterpriseSession;
/* * Set Enterprise Logon credentials. */
final String BO_CMS_NAME = "server";
final String BO_AUTH_TYPE = "secEnterprise";
final String BO_USERNAME = "username";
final String BO_PASSWORD = "password";
ILogonTokenMgr logonTokenMgr;
String defaultToken = "";
final String INFOVIEW_URL = "http://server:port/InfoViewApp/logon/start.do";
/*
* Log onto Enterprise
*/
boolean loggedIn = true;
try {
enterpriseSession = CrystalEnterprise.getSessionMgr().logon(BO_USERNAME,BO_PASSWORD, BO_CMS_NAME,
BO_AUTH_TYPE);
logonTokenMgr = enterpriseSession.getLogonTokenMgr();
defaultToken = logonTokenMgr.createWCAToken("", 20, 1);
}
catch (Exception error)
{
loggedIn = false;
}
//-------------------------------------------------------------------If login successful
if(loggedIn) {
String Flashvars="&CELogonToken=" + Encoder.encodeURL(defaultToken);
Flashvars += "&CEWebServiceURL=" + Encoder.encodeURL("http://server:port/dswsbobje/services/session");
String output = "";
output = output + "<OBJECT classid='clsid:D27CDB6E-AE6D-11cf-96B8-444553540000 codebase='http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,19,0' id='myMovieName' style='width: 355px; height: 237px'> \r\r";
output = output + "<PARAM VALUE='Test.swf'> \r\r"; //( \r = carriage return to make output more legible )
output = output + "<PARAM VALUE=high> \r\r";
output = output + "<PARAM value=\"" + Flashvars + "\">\r\r";
output = output + "<EMBED src='Test.swf' flashvars=\" " + Flashvars + "\" quality=high bgcolor=#FFFFFF WIDTH='1000' HEIGHT='600' NAME='myMovieName' ALIGN=\"\" TYPE='application/x-shockwave-flash' PLUGINSPAGE='http://www.macromedia.com/go/getflashplayer'></EMBED></OBJECT>\r\r";
out.println(output);
}
//-------------------------------------------------------------------If login failed
else {
out.println("Login to Business Objects Failed.");
}
%>

I’ve attached a video and the example xlf source file which shows how to use the push button as a default/reset button.

www.youtube.com/watch?v=p2ECKzjfb5g

If you have any additional examples that you would like to share, please post them on the comments section below.

Please download the source file here

I’ve attached a video which shows a couple examples on using dynamic color binding.

www.youtube.com/watch?v=oCEnMUwdrUw

If you have any additional examples that you would like to share, please post them on the comments section.

Please view my video on how to simply accomplish this using a grid component in Xcelsius

www.youtube.com/watch?v=2oxXZrvxOb4

Please visit my post on “MyXcelsius” for a more advanced example of conditional formatting in Xcelsius involving dynamic sliders and charts.

You can download the source file for the example here