Release 2.3
April 2012
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA http://www.cisco.com
800 553-NETS (6387)
Text Part Number: OL-24579-02
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: www.cisco.com/go/trademarks . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
Cisco TEO Adapter Guide for OLAP Database
© 2011–2012 Cisco Systems, Inc. All rights reserved.
OL-24579-02
C O N T E N T S
v
v
v
vii
vii
viii
ix
ix
ix
ix
Open Source License Acknowledgements
ix
Obtaining Documentation and Submitting a Service Request
ix
1-1
Accessing the OLAP Database Adapter Properties
1-1
Viewing OLAP Database Adapter Properties
1-2
1-2
1-3
Viewing Adapter-Supported Objects
1-4
1-5
2-1
2-1
Creating SAP BI Warehouse Target
2-2
Managing SAP BI Warehouse Targets
2-5
Enabling an SAP BI Warehouse Target
2-5
Disabling an SAP BI Warehouse Target
2-5
Deleting an SAP BI Warehouse Target
2-6
Modifying SAP BI Warehouse Targets
2-6
Modifying Display Name and Description
2-6
Modifying SAP BI Warehouse Connection Information
2-8
2-9
2-10
Cisco TEO Adapter Guide for OLAP Database iii
Contents
2-11
2-12
3-1
3-1
Defining Select from SAP BI Warehouse Activity
3-4
Viewing Select from SAP BI Warehouse Activity Results
3-6
iv
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
New and changed information for the most recent releases of the Cisco TEO Adapter for OLAP Database is as follows:
•
•
Table 1 April 2012—Cisco TEO Adapter Guide for OLAP Database 2.3 Changes
Feature
Revised Text Part Number (-01 to -02).
Updated Trademark and Copyright date
Updated “Defining a JMX Activity” section.
Location
Front cover, footers
Inside cover page
Chapter 3, “Using the OLAP Database
Activities”
Table 2 September 2011—Cisco TEO Adapter for OLAP Database 2.2 Changes
Feature Location
Updated guide name, adapter name and added Text
Part Number
Added Adapter Objects Chapter
All
Added section on viewing the new Extended Target
Properties
Chapter 1, “Understanding the OLAP Database
Adapter Objects”
Chapter 3, “Managing SAP BI Warehouse
Targets”
OL-24579-02
Cisco TEO Adapter Guide for OLAP Database v
New and Changed Information vi
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
The Cisco TEO Adapter for OLAP Database provides the functionality in Tidal Enterprise Orchestrator
(TEO) to support collecting statistics from SAP BI Data Warehouse environments.
This guide provides information on the objects supported by the OLAP Database Adapter.
This guide includes the following sections:
Chapter 1
Chapter 2
Chapter 3
Describes the objects provided by the adapter.
Provides information about creating and managing the SAP BI Warehouse targets.
Provides information about defining the OLAP
Database activities used in the processes.
OL-24579-02
Cisco TEO Adapter Guide for OLAP Database vii
Preface
This guide uses the following conventions:
Convention bold font italic font
[ ]
{x | y | z }
[ x | y | z ] string courier
< >
[ ]
!, #
font
Indication
Commands and keywords and user-entered text appear in bold font.
Document titles, new or emphasized terms, and arguments for which you supply values are in italic font.
Elements in square brackets are optional.
Required alternative keywords are grouped in braces and separated by vertical bars.
Optional alternative keywords are grouped in brackets and separated by vertical bars.
A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.
Terminal sessions and information the system displays appear in courier
font.
Nonprinting characters such as passwords are in angle brackets.
Default responses to system prompts are in square brackets.
An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.
Note Means reader take note .
Tip Means the following information will help you solve a problem .
Caution Means reader be careful . In this situation, you might perform an action that could result in equipment damage or loss of data.
Timesaver Means the described action saves time . You can save time by performing the action described in the paragraph.
Warning Means reader be warned . In this situation, you might perform an action that could result in bodily injury.
viii
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Preface
Documentation is provided in the following electronic formats:
•
•
Adobe® Acrobat® PDF files
Online help
You must have Adobe® Reader® installed to read the PDF files. Adobe Reader installation programs for common operating systems are available for free download from the Adobe Web site at www.adobe.com.
You can download the TEO product documentation from Cisco.com. Release Notes can be found on
Cisco.com and the product CD.
Online help is available and can be accessed using the following methods:
• Click the Help button on any dialog in the application to open the help topic in a pane to the right of the dialog.
• In the Tidal Enterprise Orchestrator console:
– Click the Help Pane tool on the toolbar to open the help topic in a pane to the right of the console results pane.
– Click Help on the menu bar.
Licenses and notices for open source software used in Cisco Tidal Enterprise Orchestrator can be found in the Open Source License Acknowledgements found on Cisco.com. If you have any questions about the open source contained in this product, please email external-opensource-requests@cisco.com
.
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation , which also lists all new and revised Cisco technical documentation, at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a RSS feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.
OL-24579-02
Cisco TEO Adapter Guide for OLAP Database ix
Preface x
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
C H A P T E R
1
The OLAP Database Adapter provides the SAP BI Warehouse target and SAP BI Warehouse activities to access SAP BI Data Warehouse cubes and execute MDX queries.
This chapter provides information on accessing and viewing the objects provided by the OLAP Database
Adapter. It contains the following sections:
•
Accessing the OLAP Database Adapter Properties, page 1-1
•
Viewing OLAP Database Adapter Properties, page 1-2
You can view the OLAP Database Adapter properties from the Administration—Adapters view in the
Console. This view displays general information about the functionality provided by the adapter, version number, release date and install date.
Step 1 On the Administration workspace, click Adapters to display the installed adapters in the Adapters pane.
Figure 1-1 Administration—Adapters View
Cisco TEO Adapter Guide for OLAP Database
1-1 OL-24579-02
Chapter 1 Understanding the OLAP Database Adapter Objects
Viewing OLAP Database Adapter Properties
Step 2 Select OLAP Database Adapter and use one of the following methods to open the OLAP Database
Adapter Properties dialog box:
•
•
Right-click and choose Properties .
In the Details pane, click any of the hyperlinks on the General tab.
You use the OLAP Database Adapter Properties dialog box to view the functionality provided by the adapter.
Use the General tab on the OLAP Database Adapter Properties dialog box to view general information about the adapter.
Figure 1-2 OLAP Database Adapter Properties—General Tab
The fields on the General tab are display only and provide the following information about the adapter:
Field
Display name
Type
Description
Company
Version
Description
Name of the adapter that displays in the Adapters pane.
Object type.
Text description of the adapter.
Name of company that created or supplied the adapter
(Cisco).
Version number of the adapter.
1-2
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 1 Understanding the OLAP Database Adapter Objects
Viewing OLAP Database Adapter Properties
Field
Release date
Install date
Description
Date and time the adapter was available in the product.
Date and time the adapter was installed.
Use the Prerequisites tab to view the adapter requirements on the TEO server.
Step 1 On the OLAP Database Adapter Properties dialog box, click the Prerequisites tab.
Figure 1-3 OLAP Database Adapter Properties—Prerequisites Tab
OL-24579-02
Step 2 Review the following information about the adapter prerequisites:
Column
Name
Importance
State
Minimum Value
Detected Value
Explanation
Description
Name of the required hardware or software for the supported adapter.
Indicates whether the item is Required or Optional for the adapter.
Indicates whether the system has the required hardware or software installed (Satisfied or Not satisfied).
Indicates the minimum value required for the item.
Displays the software or hardware version on the system.
Display only . Information related to the selected adapter requirement.
Cisco TEO Adapter Guide for OLAP Database
1-3
Chapter 1 Understanding the OLAP Database Adapter Objects
Viewing OLAP Database Adapter Properties
Use the Provides tab to view the name and type of object provided by the adapter.
Step 1 On the OLAP Database Adapter Properties dialog box, click the Provides tab.
Figure 1-4 OLAP Database Adapter Properties—Provides Tab
Step 2 Review the following information about the objects provided by the adapter:
Column
Name
Type
Description
Name of the activities, processes and objects that the adapter supports.
Object type (Target, Activity, Event).
1-4
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 1 Understanding the OLAP Database Adapter Objects
Viewing OLAP Database Adapter Properties
Use the History tab to view a history of changes that have been made to the adapter.
Step 1 On the OLAP Database Adapter Properties dialog box, click the History tab.
Figure 1-5 OLAP Database Adapter Properties—History Tab
OL-24579-02
Step 2 View the following information:
Field
Created by
Created time
Time
Change Type
User
Description
Description
Display only . User name of the person who created the object.
Display only . Date and time the object was created.
Date and time the action occurred.
Action that occurred.
User name of the person that performed the action.
Information about the action that was performed.
Step 3
Step 4
To view the audit history for a specific action, select the item, right-click and choose Properties .
Click OK to close the dialog box.
Cisco TEO Adapter Guide for OLAP Database
1-5
Viewing OLAP Database Adapter Properties
Chapter 1 Understanding the OLAP Database Adapter Objects
1-6
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
C H A P T E R
2
The SAP BI Warehouse targets enable you to run a process on a specific SAP BI Warehouse server. The targets can be defined once and reused in several processes.
This chapter guides you through accessing, creating and managing the SAP BI Warehouse targets. It includes the following sections:
•
•
•
Accessing the Targets View, page 2-1
Creating SAP BI Warehouse Target, page 2-2
Managing SAP BI Warehouse Targets, page 2-5
You use the Definitions—Targets view to create, manage and delete targets. Information about the configured targets display in the Targets pane, including the type of target, its status, the automation pack it is associated with, and the date and time modifications were made to it.
Figure 2-1 Definitions—Targets View
OL-24579-02
Cisco TEO Adapter Guide for OLAP Database
2-1
Chapter 2 Managing SAP BI Warehouse Targets
Creating SAP BI Warehouse Target
Before you can create or run processes in your SAP BI Warehouse environment, you must create the targets on which the processes will run. You use the New SAP BI Warehouse Properties dialog to create the target.
Step 1 On the Definitions workspace, right-click Targets and choose New > SAP BI Warehouse to open the
New SAP BI Warehouse Properties dialog box.
Figure 2-2 New SAP BI Warehouse Properties—General Tab
Step 2 On the General tab, enter the following general information about the target (optional):
Field
Display name
Type
Owner
Description
Name of the target that displays in the Targets pane.
Display only.
Type of target.
User name of the owner of the category. This is typically the person who created the category.
Click the Browse tool to change the owner.
2-2
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 2 Managing SAP BI Warehouse Targets
Creating SAP BI Warehouse Target
Field
Status
Status information
Organization
Description
Enabled
Description
Display only. Indicates the status of the target. The status determines whether the target is available or unavailable for process or activity execution:
• Unknown—Status of the target cannot be identified
•
•
Normal—No known problems with this target
Unreachable—Target cannot currently be reached
• Disabled—Target is disabled and in unvailable for activity execution
Display only. Detailed information regarding the target status and the reasons for the target being unreachable.
Name of the company that supports the target.
Text description of the target.
Check or uncheck the check box to enable or disable the target. The check box is checked by default, which makes it available immediately upon creation.
If you uncheck the check box, the target is disabled and will be unavailable for execution.
Step 3 Click the Connection tab to specify the connection information for the SAP BI Warehouse target.
Note The Required Value icon displayed on a tab or page indicates that the field is required and is either missing a value or contains an invalid value.
OL-24579-02
Cisco TEO Adapter Guide for OLAP Database
2-3
Creating SAP BI Warehouse Target
Figure 2-3
Chapter 2 Managing SAP BI Warehouse Targets
New SAP BI Warehouse Properties—Connection Tab
Step 4 On the Connection tab, enter the following information:
Field
SAP system ID
SAP BI XMLA Web Service URL
Default timeout for MDX query activity
(seconds)
Default runtime user
Description
System ID for the SAP system where the SAP BI
Warehouse server resides.
URL to connect to the SAP BI XMLA web service.
Number of seconds to wait before a MDX query activity fails because it timed out. The default number of seconds is 120.
Runtime user account to be used to connect to the target. Choose the default runtime user from the drop-down list.
•
•
To view the properties for the runtime user, click the Properties tool.
To create a new runtime user, choose New >
Runtime User .
Step 5 Click OK to close the dialog box.
2-4
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 2 Managing SAP BI Warehouse Targets
Managing SAP BI Warehouse Targets
Use the Definitions—Targets view to manage the SAP BI Warehouse targets. From this view, you can enable and disable the target, delete the target, and view and modify the target properties.
A target is enabled by default after it is created. If a target is manually disabled, it must be enabled before it is available for execution.
Step 1
Step 2
On the Definitions—Targets view, use one of the following methods to enable the target:
•
•
In the Targets pane, right-click the SAP BI Warehouse target and choose Enable .
In the Targets pane, select the SAP BI Warehouse target and then click the Click here link in the
Details pane.
Verify the status in the Enabled column in the Targets pane changes to True. If necessary, click the
Refresh icon to update the view.
Disabling a target prevents the item from being available for execution. However, a disabled target is not removed from the list of targets in the Targets pane.
Step 1
Step 2
On the Definitions—Targets view, use one of the following methods to disable the target:
•
•
In the Targets pane, right-click the SAP BI Warehouse target and choose Disable .
In the Targets pane, select the SAP BI Warehouse target and then click the Click here link in the
Details pane.
Verify the status in the Enabled column on the Targets pane changes to False. If necessary, click the
Refresh icon to update the view.
OL-24579-02
Cisco TEO Adapter Guide for OLAP Database
2-5
Chapter 2 Managing SAP BI Warehouse Targets
Managing SAP BI Warehouse Targets
Before deleting a target, open the SAP BI Warehouse target properties dialog box and click the Used By tab to view where objects are being used by the target. This ensures that deleting the target does not affect any processes or activities.
Step 1 In the Definitions—Targets view, right-click the SAP BI Warehouse target and choose Delete .
Figure 2-4 Confirm Delete
Step 2 Click Yes to confirm the deletion. The target will be removed from the product.
Use the Definitions—Targets view to display and modify the SAP BI Warehouse target properties.
Step 1
Step 2
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Double-click the SAP BI Warehouse target, or right-click and choose Properties .
2-6
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 2 Managing SAP BI Warehouse Targets
Figure 2-5 SAP BI Warehouse Properties—General Tab
Managing SAP BI Warehouse Targets
OL-24579-02
Step 3 Use the General tab to view or modify the following information:
Field
Display name
Type
Owner
Status
Status information
Organization
Description
Enabled
Description
Name of the target that displays in the Targets pane.
Display only.
Type of target.
User name of the owner of the category. This is typically the person who created the category.
Click the Browse tool to change the owner.
Display only. Indicates the status of the target. The status determines whether the target is available or unavailable for process or activity execution.
Display only. Detailed information regarding the target status and the reasons for the target being unreachable.
Name of the company that supports the target
Brief description of the target
Check or uncheck the check box to enable or disable the target. The check box is checked by default, which makes it available immediately upon creation.
If you uncheck the check box, the target is disabled and will be unavailable for execution.
Step 4 Click OK to save your changes and close the dialog box.
Cisco TEO Adapter Guide for OLAP Database
2-7
Chapter 2 Managing SAP BI Warehouse Targets
Managing SAP BI Warehouse Targets
You can modify the SAP BI Warehouse server or change the default runtime user record that connects to the server.
Step 1
Step 2
Step 3
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Double-click the SAP BI Warehouse target or right-click and choose Properties .
On the SAP BI Warehouse Properties dialog box, click the Connection tab.
Figure 2-6 SAP BI Warehouse Properties—Connection Tab
Step 4 Use the Connection tab to modify any of the following information:
Field
SAP system ID
SAP BI XMLA Web Service URL
Default timeout for MDX query activity
(seconds)
Default runtime user
Description
System ID for the SAP system where the SAP BI
Warehouse server resides.
URL to connect to the SAP BI XMLA web service.
Number of seconds to wait before a MDX query activity fails because it timed out. The default number of seconds is 120.
Runtime user account to be used to connect to the target. Choose the default runtime user from the drop-down list.
• To view the properties for the runtime user, click the Properties tool.
• To create a new runtime user, choose New >
Runtime User .
2-8
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 2 Managing SAP BI Warehouse Targets
Managing SAP BI Warehouse Targets
Step 5 Click OK to close the dialog box.
You can view the target groups to which a target belongs using the Member Of tab on the SAP BI
Warehouse Properties dialog box.
Step 1
Step 2
Step 3
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Double-click the SAP BI Warehouse target, or right-click and choose Properties .
On the SAP BI Warehouse Properties dialog box, click the Member Of tab.
Figure 2-7 SAP BI Warehouse Properties—Member Of Tab
OL-24579-02
Step 4
Step 5
Step 6
In the list box, view the target groups that the target is a member.
To view the properties of a specific target group, right-click and choose Properties .
Click OK to close the dialog box.
Cisco TEO Adapter Guide for OLAP Database
2-9
Chapter 2 Managing SAP BI Warehouse Targets
Managing SAP BI Warehouse Targets
You can view the extended properties that have been defined for the target using the Extended Properties tab on the SAP BI Warehouse Properties dialog box.
Note For additional information about Target Extended Properties, see the Tidal Enterprise Orchestrator
Reference Guide .
Step 1
Step 2
Step 3
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Double-click the SAP BI Warehouse target, or right-click and choose Properties .
On the SAP BI Warehouse Properties dialog box, click the Extended Properties tab.
Figure 2-8 SAP BI Warehouse Properties—Extended Properties Tab
Step 4
Step 5
Step 6
In the list box, view the extended target properties.
To modify the extended property, select it and then click Edit .
Click OK to close the dialog box.
2-10
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 2 Managing SAP BI Warehouse Targets
Managing SAP BI Warehouse Targets
You can view the objects that are directly associated with the selected target (for example, a process or activity) using the Used By tab on the SAP BI Warehouse Properties dialog box.
Step 1
Step 2
Step 3
In the Definitions view, click Targets to display the defined targets display in the Targets pane.
Double-click the SAP BI Warehouse target, or right-click and choose Properties .
On the SAP BI Warehouse Properties dialog box, click the Used By tab.
Figure 2-9 SAP BI Warehouse Properties—Used By Tab
OL-24579-02
Step 4
Step 5
Step 6
View the objects that used the target in the list box.
To view the properties of a specific target group, right-click and choose Properties .
Click OK to close the dialog box.
Cisco TEO Adapter Guide for OLAP Database
2-11
Chapter 2 Managing SAP BI Warehouse Targets
Managing SAP BI Warehouse Targets
You can view the history of changes that have been made to the target using the History tab on the SAP
BI Warehouse Properties dialog box.
Step 1
Step 2
Step 3
In the Definitions view, click Targets to display the defined targets in the Targets pane.
Double-click the SAP BI Warehouse target, or right-click and choose Properties .
On the SAP System Properties dialog box, click the History tab.
Figure 2-10 SAP BI Warehouse Properties—History Tab
Step 4
Step 5
Step 6
View the changes that have been made to the target.
To view the audit history for a specific action in the list box, right-click the item and choose Properties .
Click OK to close the dialog box.
2-12
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
C H A P T E R
3
The OLAP Database activities enable you to create processes specific to your SAP BI Warehouse environment. When defining an activity in the process workflow, the properties pane contains property pages that are specific to the selected activity.
This chapter provides instructions for defining an activity using the OLAP Database activities, instructions for completing the property pages for each specific activity, and instructions on viewing the activity results. It includes the following sections:
•
•
Defining an Activity, page 3-1
Defining Select from SAP BI Warehouse Activity, page 3-4
Use the following steps to define an activity in the Process Editor. The property pages that display depend on the activity. Refer to the appropriate section for instructions on completing the activity property pages.
Step 1 On the Toolbox pane, navigate to the Database—OLAP section, click the activity and drag it onto the
Workflow pane.
The Activity Properties dialog box displays.
Note The Required Value icon displayed on a tab or page indicates that the field is required and is either missing a value or contains an invalid value.
Click the Reference tool to select a defined variable or reference an object within the process on the Insert Variable Reference dialog. For additional information, see the Tidal Enterprise
Orchestrator Reference Guide .
Step 2 On the General tab, enter the following information:
Field
Display name
Type
Description
Description
Name of the activity.
Display only . Type of activity.
Text description of the activity.
Cisco TEO Adapter Guide for OLAP Database
3-1 OL-24579-02
Chapter 3 Using the OLAP Database Activities
Defining an Activity
Step 3
Step 4
Click the activity-specific tab and enter the required information. See the appropriate section in this chapter for instructions on completing the fields on the activity-specific tab.
Click the Target tab to specify the process target. You can use the process target or override it and specify a different target for the specific activity.
Field
Execute on the process target
Execute on activity target
Execute on this target
Execute on this target reference
Execute on this target group
Description
Click this radio button to use the same target that was specified for the process.
Click this radio button to indicate that the activity should execute against a target selected in an activity within the process. Chooe the activity from the drop-down list.
Click this radio button and then click the Browse tool to launch the Select Target dialog box and choose a specific target on which to execute the activity.
The targets that display in the Select Target dialog box are targets already defined in TEO.
To view the properties for the selected target, click the
Properties tool.
Click this radio button and then click the Reference tool to select the target reference property on which to execute the activity.
You can also click the click the Browse tool to launch the Select Target dialog box and choose a specific target on which to execute the activity.
Click this radio button and then click the Browse tool to launch the Select Target Group dialog box and choose a specific target on which to execute the activity.
The target groups that display in the Select Target
Group dialog box are target groups already defined in
TEO.
To view the properties for the selected target group, click the Properties tool.
From the Choose a target using this algorithm drop-down list, select the algorithm which will determine the target to execute from the eligible target group.
Note The available algorithms that display depend on the selected activity.
3-2
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 3 Using the OLAP Database Activities
Defining an Activity
Step 5 Click the Credentials tab to specify the runtime user whose credentials should be used for process execution:
Field
Use target's default runtime user
Use process runtime user
Override process runtime user
Description
Click this radio button to use the default runtime user for the target that is specified in the activity.
Click this radio button to use the credentials for the runtime user that was specified for the process.
Click this radio button to specify different credentials than what are used for the process. The selected runtime user overrides the runtime user that was specified for the process.
•
•
To view the properties for the selected runtime user, click the Properties tool.
To create a runtime user record for the process, click
New .
For additional information on creating a runtime users, see the Tidal Enterprise Orchestrator Reference Guide .
Step 6 Click the Knowledge Base tab to specify a knowledge base article for the activity. The following information displays:
Field
Knowledge base
Summary
Possible Cause
Possible resolution
Related information
Description
Knowledge base article associated with the activity.
Brief description of the issue.
Explanation of the condition that may be causing the issue.
List of actions that can be performed to attempt to resolve the issue.
Additional information related to the issue.
a.
b.
If the knowledge base article is not displayed by default, click the Browse tool in the Knowledge
Base field.
On the Select Knowledge Base dialog box, select the appropriate knowledge base article in the list and click OK .
Note Click New to create a new knowledge base article. For additional information on knowledge base articles, see the Tidal Enterprise Orchestrator Reference Guide .
OL-24579-02
Cisco TEO Adapter Guide for OLAP Database
3-3
Chapter 3 Using the OLAP Database Activities
Defining Select from SAP BI Warehouse Activity
Step 7 Click the Result Handlers tab to specify condition branches for the activity.
Button
Add
Remove
Move Up
Move Down
Description
Adds a condition branch.
Removes the condition branch from the activity.
Moves the condition up one position in the list of conditions.
Moves the condition down one position in the list of conditions.
Step 8 Click the Save tool to save the activity definition.
Use the Select from SAP BI Warehouse activity to define an MDX query to collect SAP BI Warehouse statistics.
Step 1 On the Toolbox, click the Select from SAP BI Warehouse activity and drag it onto the Workflow pane.
Figure 3-1 Select from SAP BI Warehouse Properties—General Tab
3-4
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 3 Using the OLAP Database Activities
Defining Select from SAP BI Warehouse Activity
Step 2 On the General tab, enter the following information:
Field
Display name
Type
Description
Description
Name of the activity.
Display only . Type of activity generated.
Text description of the activity.
Step 3 Click the OLAP tab.
Figure 3-2 Select from SAP BI Warehouse Properties—OLAP Tab
OL-24579-02
Step 4 Complete the following information:
Field
MDX command text (limit to 2 dimensions)
Row number per page
Maximum number of rows
Description
MDX query command text.
Number of rows to display in each output page.
Maximum number of rows to return from the MDX query.
Use database target query timeout Click this radio button to use the query timeout specified for the database target.
Override database target query timeout Click this radio button to specify a different query timeout than that specified for the database target.
Enter the value in the text field.
Cisco TEO Adapter Guide for OLAP Database
3-5
Chapter 3 Using the OLAP Database Activities
Defining Select from SAP BI Warehouse Activity
Step 5
Step 6
Complete the appropriate information in the following tabs:
•
•
•
•
Target—Specify whether the defined process target should be used or overridden.
Credentials—Specify the runtime user whose credentials should be used for process execution.
Knowledge Base—Select the appropriate knowledge base article to associate with the process.
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save tool to complete the activity definition.
When the Select SAP BI Warehouse activity is executed, results are displayed in the Operations workspace activity instance view.
Step 1
Step 2
Step 3
Step 4
In the Operations workspace, expand the Activity Views folder and then click the view that represents how the process was executed (for example, View Adhoc if the process was manually executed).
In the View Results pane, expand the process and double-click the activity instance, or right-click and choose Properties .
On the Select from SAP BI Warehouse Instance Properties dialog box, click the OLAP tab to view the activity properties.
Click the Instance tab to view the number of rows affected and any warning or informational messages.
Figure 3-3 Select SAP BI Warehouse Instance Properties—Instance Tab
3-6
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
Chapter 3 Using the OLAP Database Activities
Defining Select from SAP BI Warehouse Activity
The following information displays:
Field
Number of rows affected
Warning or informational message
Description
Number of rows affected from running the MDX query.
Message returned from the MDX query.
Step 5 Click the Paged Output tab to view the query results. The information that displays on this page will vary depending on the MDX query that was run.
Figure 3-4 Select SAP BI Warehouse Instance Properties—Paged Output Tab
OL-24579-02
Step 6 Click Close to close the dialog box.
Cisco TEO Adapter Guide for OLAP Database
3-7
Defining Select from SAP BI Warehouse Activity
Chapter 3 Using the OLAP Database Activities
3-8
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02
A accessing
Targets view
UCS Software Adapter properties
activities defining
activities, defining
adapter accessing UCS Software Adapter properties
adapter-supported objects
history
D defining activity, general
deleting
SAP BI Warehouse targets
disabling SAP BI Warehouse target
E enabling SAP BI Warehouse target
M managing
SAP BI Warehouse targets
P properties
OL-24579-02
I N D E X
SAP BI Warehouse target
Select from SAP BI Warehouse 3-5
S
SAP BI Warehouse targets
enabling
managing
Select from SAP BI Warehouse activity properties
Select from SAP BI Warehouse results (Instance)
Select from SAP BI Warehouse results (Paged
Output)
T targets deleting
disabling
history
Used by
V viewing
objects using target
paged output
Select from SAP BI Warehouse results
target history
Cisco TEO Adapter Guide for OLAP Database
IN-1
Index
IN-2
Cisco TEO Adapter Guide for OLAP Database
OL-24579-02