Step-by-step Guide to Linking WebI Documents using

Transcription

Step-by-step Guide to Linking WebI Documents using
Step-by-step Guide to Linking WebI
Documents using OpenDocument in
SAP BusinessObjects Enterprise XI
3.1
Applies to:
SAP BusinessObjects XI 3.1. For more information, visit the Business Objects homepage.
Summary
This document explains how to link two Web Intelligence (WebI) reports together through OpenDocument
functionality in step-by-step manner. It explains the procedure to navigate from one WebI report to another;
passing parameter values from a WebI report to other; passing on-click value from one WebI report to
another; and displaying the linked report based on the parameter value passed to it.
Author:
Vineeta Singh
Company: Infosys
Created on: 26 April 2010
Author Bio
Vineeta works at Infosys Technologies as a SAP BW developer. She has experience in both SAP BW and
SAP BusinessObjects XI 3.1.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
1
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Table of Contents
Overview ............................................................................................................................................................. 3
Steps to Link two WebI documents................................................................................................................. 6
Steps to pass parameter values from one WebI document to another ........................................................ 13
Passing a Single Value .............................................................................................................................................. 13
Passing Multiple Values ............................................................................................................................................. 16
Steps to pass on-click value as parameter value from one WebI document to another .............................. 20
Prompt Text in Target WebI document has Spaces ................................................................................................... 29
Related Content ................................................................................................................................................ 32
Disclaimer and Liability Notice .......................................................................................................................... 33
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
2
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Overview
OpenDocument is functionality in BusinessObjects which enables URL reporting and linking documents
similar to RRI functionality in SAP BW.
It basically provides URL access to multiple document types by passing a URL string to a BusinessObjects
Enterprise server. OpenDocument provides commands to control how reports are generated and displayed.
We can use OpenDocument feature in BusinessObjects Enterprise to create cross-system links to and from
the following document types:




.wid: Web Intelligence version 6.x documents
.rep: Desktop Intelligence documents
.rpt: Crystal reports
.car: OLAP Intelligence Reports
This document deals with linking of two web intelligence documents (.wid) using OpenDocument feature
implementation in a step-by-step manner.
OpenDocument URL creation syntax
An OpenDocument URL is generally structured as follows in a java implementation as is the case in this example.
http://<servername>:<port>/OpenDocument/opendoc/openDocument.jsp?<parameter1>&<parame
ter2>&...&<parameterN>



Ampersand (&) is used to join all the parameters.
ServerName and port refers to the BO Enterprise server name and port.
Parameters to be used in our example are iDocID, sType, sRefresh, sWindow, lsS, lsM.
Following is the brief description of the parameters to be used.
Parameter
iDocID
Description
Document identifier.
Valid Values
Document identifier (InfoObjectID).
sType
The file type of target document or report.
• wid
• rpt
• car
sRefresh
Indicates whether a refresh should
be forced when the target document
or report is opened.
•Y
•N
sWindow
Indicates whether the target report will
open in the current browser window or
whether a new window will be launched.
• Same (current browser window)
• New (new browser window is launched)
lsS[NAME]
Specifies a value for a single prompt.
[NAME] is the text of the prompt.
hard-coded value or dimension object
lsM[NAME]
Specifies multiple values for a
prompt. [NAME] is the text of the
prompt.
hard-coded values separated by semicolon(;) or
dimension object
In case there are multiple prompts in target document e.g. Prompt1 accepts multiple input values,
Prompt2 accepts single input value and Prompt 3 accepts single input value, Use the combination of lsS and
lsM parameters joined by ampersand (“&”) in the OpenDocument URL as follows.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
3
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
lsM<Prompt1-text>=<value1>;<value2>;<value n>&lsS<Prompt2-text>=<value1>&lsS<Prompt3text>=<value1>
Now let us create two sample Web Intelligence (WebI) reports which can be used further to show linking
together using OpenDocument.
Report A: Inventory Report with details on Plant, Issued and Received Stock.
Report B: Inventory Report with details on Material hierarchy, Material Group and Total Stock.
Create a mandatory prompt on MaterialGroup dimension object with Prompt Text as “MaterialGroup”.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
4
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
5
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Steps to Link two WebI documents
1. Right-click Report B. Click Properties. A window displays the document information.
2. Make a note of the ID of the document. In this example ID of Report B is 5241. This ID is used to
refer to Report B while creating OpenDocument statement for linking Report A to Report B.
3. Open Report A in Edit Report mode.
4. Right-click the cells of the Plant Column.
5. Click Hyperlinks > New Hyperlink. A new window appears.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
6
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
6. Type the following statement in the new window.
http://<servername:port>/OpenDocument/opendoc/openDocument.jsp?iDocID=5241&sType=w
id&sRefresh=Y&sWindow=Same
7. Click the Parse button. In this example, IDocID= 5241 (ID of Report B), sType = wid (as target
document is in Web intelligence document format).
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
7
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Once Parse button is clicked, following screen displays with the parts of the URL parsed into sections
depending on parameters specified in OpenDocument URL.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
8
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
8. Specify the Tool Tip and Target Window as follows. Click OK.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
9
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
10
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
We can view the formula generated by this URL code.
9. Go to Edit Report Mode in Report A. Click View Structure button.
10. Double-click Plant Column. Press Ctrl+Enter.
The following generated formula is visible.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
11
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
11. Run
Report
A.
Place
the
cursor
on
Plant
column.
It
will
show
the
tooltip
text.
12. Click on any hyperlink text in Plant column in Report A.
The prompt created on Report B opens in the current window. On specifying the prompt values for
MaterialGroup, Report B opens in the current window.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
12
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Steps to pass parameter values from one WebI document to another
Passing a Single Value
Sample Use Case: Displaying the material details report (Report B) for material group „MG2‟ on selecting
any Plant in Report A.
1. Open Report A in Edit Report mode.
2. Right-click on the Plant column cells. Click Hyperlinks > Edit Hyperlink.
3. Add a parameter lsSMaterialGroup=MG2.
4. Click Parse button > OK.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
13
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Here, lsS[NAME] parameter has [NAME]=MaterialGroup i.e. Prompt Text in Report B. Single value passed
to lsSMaterialGroup is MG2.
We can view the formula generated by this URL code below.
5. Go to Edit Report mode in Report A.
6. Click the View Structure button > double-click Plant Column.
7. Press Ctrl+Enter.
The following generated formula is visible.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
14
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
8. Run Report A. Click any hyperlink text in Plant column. Report B opens in the current window with
data displayed only for MaterialGroup=MG2.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
15
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Passing Multiple Values
Sample Use Case: Displaying the material details report (Report B) for material group „MG1‟ and „MG2‟ on
selecting any Plant in Report A.
1. Open Report A in Edit Report mode.
2. Right-click the Plant column cells.
3. Click Hyperlinks > Edit Hyperlink. Add a parameter lsMMaterialGroup=MG1;MG2.
4. Click Parse button > OK.
Here, lsM[NAME] parameter has [NAME]=MaterialGroup i.e. Prompt Text in Report B.
Multiple values passed to lsMMaterialGroup are MG1 & MG2.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
16
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
We can view the formula generated by this URL code.
5. Go to Edit Report mode in Report A.
6. Click View Structure button. Double-click Plant Column.
7. Press Ctrl+Enter.
The following generated formula is visible.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
17
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
8. Run Report A. Click any hyperlink text in Plant column. Report B opens in the current window with
data is displayed for Material Groups MG1 and MG2.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
18
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
19
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Steps to pass on-click value as parameter value from one WebI document to another
1. Open Report A in Edit Query mode.
2. Drag one more dimension object MaterialGroup in the Result Objects pane.
3. Run the query and save the report.
Sample Use Case: Displaying the material hierarchy report (Report B) for material group selected in Report
A.
1. Open Report A in Edit Report mode.
2. Right-click the MaterialGroup column cells. Click Hyperlinks > Edit Hyperlink
3. Add parameter lsSMaterialGroup=([MaterialGroup]).
4. Click Parse button > OK.
Here, lsS[NAME] parameter has [NAME]=MaterialGroup i.e. Prompt Text in Report B. ([MaterialGroup])
refers to Dimension Object name which is passed to lsSMaterialGroup parameter. This captures the value
in the cell in MaterialGroup Column in Report A when clicked.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
20
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
21
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Note: Alternatively, Instead of typing object name, we can select the object as follows.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
22
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
23
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
24
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
25
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
We can view the formula generated by using the following URL code.
5. Go to Edit Report mode in Report A.
6. Click View Structure button. Double-click MaterialGroup Column.
7. Press Ctrl+Enter.
The following generated formula is visible.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
26
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
8. Run Report A and click on MG1 value in MaterialGroup column. Report B opens in the current
window with data for MaterialGroup=MG1 only.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
27
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
9. Run Report A and click on MG2 value in MaterialGroup column. Report B opens in the current
window with data for MaterialGroup=MG2 only.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
28
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Prompt Text in Target WebI document has Spaces
In the following scenario, the prompt text in the target WebI document has spaces. In this case, the prompt
text is “Enter Material Group” in Report B.
The lsS<prompt> parameter in OpenDocument URL in Report A should be as follows using URLEncode()
function.
lsS” + URLEncode(“<prompt name having spaces>”) + “=” +([<object-name>])
1. Go to Edit Report mode in Report A.
2. Click View Structure button. Double-click MaterialGroup Column.
3. Press Ctrl+Enter. Edit the lsS<Prompt-text> parameter in the formula editor as follows.
4. Click tick icon to check the formula for correctness. Click OK. .
="<a
href=\"http://<servername:port>/OpenDocument/opendoc/openDocument.jsp?iDocID=5241&sTy
pe=wid&sRefresh=Y&sWindow=Same&lsS" + URLEncode("Enter Material Group") + "="
+([MaterialGroup])+ "\" title=\"Navigate to Report B\" target=\"_self\"
nav=\"web\">"+[MaterialGroup]+"</a>"
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
29
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
5. Go to View Results button.
6. Right-click any cell in the MaterialGroup column > click Hyperlinks > Edit Hyperlink.
The following Hyperlink code is generated from the formula.
http://<servername:port>/OpenDocument/opendoc/openDocument.jsp?iDocID=5241&sType=wid&
sRefresh=Y&sWindow=Same&lsS" + URLEncode("<prompt name having spaces>") +
"=([<Object-Name>])
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
30
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
7. Click OK. Run Report A. Report B will open based on the „Material Group‟ value clicked.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
31
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Related Content
How to Use The openDocument URL Command
WebI trick - drill among multiple reports
SAP BusinessObjects Community
For more information, visit the Business Objects homepage.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
32
Step-by-step Guide to Linking WebI Documents using OpenDocument in SAP BusinessObjects Enterprise XI 3.1
Disclaimer and Liability Notice
This document may discuss sample coding or other information that does not include SAP official interfaces and therefore is not
supported by SAP. Changes made based on this information are not supported and can be overwritten during an upgrade.
SAP will not be held liable for any damages caused by using or misusing the information, code or methods suggested in this document,
and anyone using these methods does so at his/her own risk.
SAP offers no guarantees and assumes no responsibility or liability of any type with respect to the content of this technical article or
code sample, including any liability resulting from incompatibility between the content within this document and the materials and
services offered by SAP. You agree that you will not hold, or seek to hold, SAP responsible or liable with respect to the content of this
document.
SAP COMMUNITY NETWORK
© 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com
33