Building Queries Based On Bex Queries: Sap Businessobjects Business Intelligence Suite 4.0 Support Package 5
Building Queries Based On Bex Queries: Sap Businessobjects Business Intelligence Suite 4.0 Support Package 5
2013-03-11
Copyright
2013 SAP AG or an SAP affiliate company. All rights reserved.No part of this publication may be
reproduced or transmitted in any form or for any purpose without the express permission of SAP AG.
The information contained herein may be changed without prior notice. Some software products
marketed by SAP AG and its distributors contain proprietary software components of other software
vendors. National product specifications may vary. These materials are provided by SAP AG and its
affiliated companies ("SAP Group") for informational purposes only, without representation or warranty
of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials.
The only warranties for SAP Group products and services are those that are set forth in the express
warranty statements accompanying such products and services, if any. Nothing herein should be
construed as constituting an additional warranty. SAP and other SAP products and services mentioned
herein as well as their respective logos are trademarks or registered trademarks of SAP AG in
Germany and other countries. Please see
http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark
information and notices.
2013-03-11
Contents
Chapter 1
1.1
1.1.1
1.1.2
1.1.3
1.1.4
1.2
1.2.1
1.2.2
1.2.3
1.3
1.3.1
1.3.2
1.3.3
1.3.4
1.3.5
1.3.6
1.3.7
1.3.8
Appendix A
More Information...................................................................................................................21
Index
Which interfaces can you use for working with BEx queries?....................................................5
BEx queries defined.................................................................................................................6
Supported BEx query metadata................................................................................................6
Restrictions when using BEx queries........................................................................................8
Accessing BEx queries...........................................................................................................10
To enable access to BEx queries ...........................................................................................11
To define a BICS connection with the CMC...........................................................................11
To define a BICS connection to a BEx query in the information design tool............................11
Building a Web Intelligence query on a BEx query..................................................................12
Hierarchical queries defined...................................................................................................12
About building a query based on a BEx query ........................................................................13
To create a new query based on a BEx query.........................................................................13
About the scaling factor in BEx queries..................................................................................14
About hierarchy node variables in BEx queries.......................................................................14
Hierarchical member selection in BEx queries........................................................................14
Using contexts in BEx queries................................................................................................19
Changing the data source for BEx queries..............................................................................20
23
2013-03-11
Contents
2013-03-11
1.1.1 Which interfaces can you use for working with BEx queries?
To build queries, view reports, edit or refresh reports, you use the interfaces described in the sections
below.
Building queries
To create a document or build a query based on a BEx query, you should use one of the following:
The Rich Internet Application, accessible from the BI launch pad.
Web Intelligence Rich Client installed from the SAP Business Objects suite.
2013-03-11
2013-03-11
Supported
Yes
Hierarchies
Yes
Yes
Navigational Attributes
Yes
Display Attributes
Yes
Yes
Yes
Custom Structures
Yes
Variables
Yes
The metadata types are mapped to Universe objects that can be used to build your queries and run
reports. The datamapping is as follows:
Characteristic
Dimension
Hierarchy
Hierarchy
Hierarchy level
Attribute
Attribute
Attribute
Measure (numeric)
How SAP Business Warehouse Key Figures map to Web Intelligence measure objects
For data sources based on BEx queries, BW Key Figures are mapped to measure objects in Web
Intelligence. Depending on the BW Key Figure data type, these measures have a specific type assigned
STRING, DATE or NUMERIC)
2013-03-11
However, in the BEx query design, if the Key Figure and Characteristic objects are arranged in columns
and rows so that the result set columns contains different object types in each row, this will result in the
measure object in Web Intelligence report to show up as type "STRING". For Web Intelligence, in order
to be agnostic, the rule applies that one column equals one data type. The data type "STRING" is thus
applied when it recognizes heterogeneous data types in the column. This is the case when the Key
Figure Structure is on the Columns Axis only. You can also put both structures on the same axis in your
BEx Query.
Note:
If you want to manipulate the results by adding aggregations, for example, you have the choice to
change the mapped Web Intelligence measure in the report by converting it via a formula into different
data types.
Linked nodes
Lower level nodes are always shown after the main node.
Decimal number
Variables dependent on compound char- When there are dependencies between variables in comacteristics and the parent object
pound characteristics and their parent, the dependencies
are not guaranteed.
2013-03-11
If you define variables ready for input in BEx Query Designer, it is not possible to manually enter a string in the prompt
panel in Web Intelligence. You can only select from a list
of values. Manual input is not currently supported for BEx
queries.
Or operator
Expand to level
Measures which aggregate with the SUM function, aggregate the sum in Web Intelligence. Other types of measure
aggregation are delegated.
Query stripping
Query exceptions
Complex selection
When a variable is defined to support the complex selection, there is no equivalent. This is limited to range selection.
2013-03-11
Zero suppression
Rows of zero values are not removed from the result table.
Local calculations ("Rank", "Minimum"...) The key figures on which the local calculation are defined
are removed from the BEx query. Avoid the use of these,
prefer the equivalent calculation function in the report.
Result rows
It is recommended to avoid Formula with calculation depending on the layout (Percentage share of result ) that
are not supported. You can use equivalent calculation
function in the Web Intelligence report.
Drill-replace capability
Conditions
Do not use conditions. When the query is run, the conditions, if present in the query, are not applied.
Measures
A hierarchy
Attributes
You can only access BEx queries that have the flag "Allow External Access to the Query" enabled.
You must have the appropriate security rights to access and use the BEx queries for reporting.
To define the connection, you can use the CMC to define the connection, or you can use the information
design tool to publish the connection to the CMC. The simplest method is to use the CMC.
10
2013-03-11
1.2.3 To define a BICS connection to a BEx query in the information design tool
To connect to a BEx query, you can define a BICS connection in the information design tool. You can
define a connection to a single BEx query or to an InfoProvider containing several BEx queries.
1. In the information design tool, use the New OLAP Connection wizard to define an OLAP connection
and choose the SAP NetWeaver BW SAP BICS Client middleware driver.
2. Publish the connection to a repository where it can be accessed by Web Intellignce.
Use the New OLAP Connection wizard to define an OLAP connection.
11
2013-03-11
You can now use Web Intelligence to select the connection and connect to the BEx query.
Unit Sales
Store Cost
All Customers
364,707
371,579
276,773
234,555
CA
45,506
67,999
OR
32,104
56,700
US
12
2013-03-11
Customers
Albany
Unit Sales
Store Cost
10,324
12,325
Related Topics
Hierarchical member selection in BEx queries
Using contexts in BEx queries
13
2013-03-11
the member selector, an error message appears. Use the "Set Variables" dialog to set values for
the mandatory variable.
Note:
You cannot filter on result objects in BEx queries.
Note:
If the BEx query you connected to is designed to include an SAP server-side variable, you can
change the value of the variable in the "Query Panel" - click the Set Variable button and select a
new variable from the available List of Values.
14
2013-03-11
Europe
Middle East
Africa
North America
Asia PAC
Asia
Pacific
Australia
Philippines
New Zealand
South America
15
Rule
Example
If Europe is selected and you select EMEA, Middle East and Africa are also selected. The following member selections appear:
EMEA
Children of EMEA
2013-03-11
Rule
Example
If you select a member when descendant members are already selected, all children of the
member, and all siblings of the selected descendant members are also selected.
If you select a member when descendant members are already selected, all children of the
member, and all siblings of the selected descendant members are also selected.
Related Topics
Restrictions when using BEx queries
Hierarchical member selection in BEx queries
Using contexts in BEx queries
16
2013-03-11
Option
Description
Descendants
17
Parent
Ancestors
Siblings
2013-03-11
Option
Description
Descendents until
18
2013-03-11
Wildcard
Description
4. Click Search in Text to search the display text of the members, or Search in Key to search their
database keys.
Selection in member prompts is restricted to explicit selection of members. The user cannot select
members using functions such as Ancestors or Parent.
The rules about selecting members using functions apply here. Refer to the link at the bottom of this
topic.
1. Click Prompts .
2. Click Enable Parameter to enable member selection when the query is run.
You cannot access the other tabs in the Member Selector when this option is selected.
3. Type the prompt text in the Prompt Text box.
4. Click Keep last values selected if you want the prompt to select the previously-chosen values by
default when it is displayed.
5. Click Set default values, click Edit and select the default values if you want the prompt to select
default values when it is displayed.
6. Close the Member Selector
The prompt text appears beneath the hierarchy in the query panel.
Related Topics
To select hierarchy members using functions
19
2013-03-11
A context is a defined group of objects that share a common business purpose. This business purpose
is usually the type of information that these related objects represent. For example, a sales context is
a grouping of all the objects that can be used to create sales queries. A reservations context is a grouping
of all the objects that can be used in reservation queries. Contexts are defined in the universe by the
universe designer.
You can combine any objects within the same context to create a query. You can also combine objects
in different contexts. If you use an object that is common multiple contexts in a query and it is not
possible to determine the best context that fits all the other objects in the query, you are prompted to
choose the context to apply.
Related Topics
Restrictions when using BEx queries
Hierarchical member selection in BEx queries
Change to...
A BEx query
A BEx query
When you change the source, the Query Panel automatically starts. You must edit the query accordingly.
20
2013-03-11
More Information
More Information
Information Resource
Location
http://www.sap.com
Navigate to http://help.sap.com/businessobjects and on the "SAP BusinessObjects Overview" side panel click All Products.
You can access the most up-to-date documentation covering all SAP
BusinessObjects products and their deployment at the SAP Help Portal.
You can download PDF versions or installable HTML libraries.
Certain guides are stored on the SAP Service Marketplace and are not
available from the SAP Help Portal. These guides are listed on the Help
Portal accompanied by a link to the SAP Service Marketplace. Customers
with a maintenance agreement have an authorized user ID to access
this site. To obtain an ID, contact your customer support representative.
http://service.sap.com/bosap-support > Documentation
Docupedia
Developer resources
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
21
2013-03-11
More Information
Information Resource
Location
https://www.sdn.sap.com/irj/boc/businessobjects-articles
These articles were formerly known as technical papers.
https://service.sap.com/notes
Notes
These notes were formerly known as Knowledge Base articles.
Forums on the SAP Community
Network
https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education
Training
Consulting
22
Consultants can accompany you from the initial analysis stage to the
delivery of your deployment project. Expertise is available in topics such
as relational and multidimensional databases, connectivity, database
design tools, and customized embedding technology.
2013-03-11
Index
A
about BEx queries 5
accessing
BEx queries 11
accessing BEx queries 10
attributes
in BEx queries 8
B
BEx queries
about 5
accessing 10
allowing external access for Web
Intelligence 11
building on 13
calculated members in 18
connecting via BICS connection 11
connecting via SAP 11
definition of 6
hierarchical 12
hierarchy node variables 14
restrictions 8
restrictions on member functions
in hierarchies 16
scaling factor 14
selecting members in 14, 20
supported metadata 6
BEx query
new 13
server side variable 13
BEx query restrictions
attributes 8
cannot filter result objects 13
complex selection 8
conditions 8
decimal number 8
expand to level 8
filters as default values 8
formula with calculation 8
hierarchical measure structures 8
hierarchy ancestors 16
hierarchy siblings 16
hiererchy parents 16
linked node variables 14
linked nodes 8
local calculations 8
lower level nodes 8
max number of objects in a query
8
23
calculated members
in BEx queries 18
calculations
(local) in BEx queries 8
complex selection
in BEx queries 8
conditionss
in BEx queries 8
contexts
in BEx queries 20
decimal numbers
in BEx queries 8
measures
in BEx queries 8
Member Selector
searching for members in 18
members
building prompts to select 19
in BEx queries 18
searching for in the Member
Selector 18
selecting from a hierarchy using
functions 16
selecting in BEx queries 14
metadata
supported in BEx queries 6
supported in InfoCubes 6
expand to level
in BEx queries 8
NetWeaver BW 5
number of objects
in BEx queries 8
F
filters as default values
in BEx queries 8
functions
using to select members of a
hierarchy 16
hierachical members
in BEx queries 14
hierarches
in BEx queries 8
hierarchical queries 12
hierarchy node variables
in BEx queries 14
L
linked nodes
in BEx queries 8
local calculations
in BEx queries 8
lower level nodes
in BEx queries 8
P
position at lower level nodes
in BEx queries 8
prompts
building member selection prompts
19
2013-03-11
Index
Q
queries
about accessing BEx queries 10
about BEx queries 5
allowing access to BEx queries 11
BEx 20
BEx queries defined 6
BEx queries supported metadata
6
BEx query restrictions 8
BICS connection to BEx query 11
building on BEx queries 13
calculated members in BEx queries
18
connecting to BEx query via SAP
11
hierarchical 12
hierarchy node variables in BEx
queries 14
24
queries (continued)
selecting members in BEx queries
14, 20
query default layout
in BEx queries 8
query exceptions
in BEx queries 8
SAP NetWeaver BW 5, 6
scaling factor 14
searching for members 18
selecting members
in BEx queries 14
selecting members of a hierarchy using
functions 16
server side variable
in BEx query 13
restrictions
BEx queries 8
result rows
in BEx queries 8
row/column display
in BEx queries 8
SAP connection
BEx queries 11
zero suppression
in BEx queries 8
variable orders
in BEx queries 8
variables
in BEx queries 8
2013-03-11