Cisco TEO Adapter Guide for OLAP Database

Cisco TEO Adapter Guide for OLAP

Database

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.

C H A P T E R

1

C H A P T E R

2

OL-24579-02

C O N T E N T S

New and Changed Information

v

Latest Release

v

Previous Releases

v

Preface

vii

Organization

vii

Conventions

viii

Product Documentation

ix

Documentation Formats

ix

Guides and Release Notes

ix

Online Help

ix

Open Source License Acknowledgements

ix

Obtaining Documentation and Submitting a Service Request

ix

Understanding the OLAP Database Adapter Objects

1-1

Accessing the OLAP Database Adapter Properties

1-1

Viewing OLAP Database Adapter Properties

1-2

Viewing General Information

1-2

Viewing Adapter Prerequisites

1-3

Viewing Adapter-Supported Objects

1-4

Viewing Adapter History

1-5

Managing SAP BI Warehouse Targets

2-1

Accessing the Targets View

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

Viewing Member Of Properties

2-9

Viewing Extended Properties

2-10

Cisco TEO Adapter Guide for OLAP Database iii

Contents

C H A P T E R

3

Viewing Used By Properties

2-11

Viewing Target History

2-12

Using the OLAP Database Activities

3-1

Defining an Activity

3-1

Defining Select from SAP BI Warehouse Activity

3-4

Viewing Select from SAP BI Warehouse Activity Results

3-6

I N D E X

iv

Cisco TEO Adapter Guide for OLAP Database

OL-24579-02

New and Changed Information

New and changed information for the most recent releases of the Cisco TEO Adapter for OLAP Database is as follows:

Latest Release

Previous Releases

Latest Release

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”

Previous Releases

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

Preface

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.

Organization

This guide includes the following sections:

Chapter 1

Chapter 2

Chapter 3

Understanding the OLAP

Database Adapter Objects

Managing SAP BI Warehouse

Targets

Using the OLAP Database

Activities

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

Conventions

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

Product Documentation

Documentation Formats

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.

Guides and Release Notes

You can download the TEO product documentation from Cisco.com. Release Notes can be found on

Cisco.com and the product CD.

Online Help

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.

Open Source License Acknowledgements

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

.

Obtaining Documentation and Submitting a Service Request

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

Understanding the OLAP Database Adapter

Objects

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

Accessing the OLAP Database Adapter Properties

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.

Viewing OLAP Database Adapter Properties

You use the OLAP Database Adapter Properties dialog box to view the functionality provided by the adapter.

Viewing General Information

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.

Viewing Adapter Prerequisites

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

Viewing Adapter-Supported Objects

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

Viewing Adapter History

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

Managing SAP BI Warehouse Targets

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

Accessing the Targets View

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

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

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.

Enabling an SAP BI Warehouse Target

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 an SAP BI Warehouse Target

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

Deleting an SAP BI Warehouse Target

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.

Modifying SAP BI Warehouse Targets

Use the Definitions—Targets view to display and modify the SAP BI Warehouse target properties.

Modifying Display Name and Description

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

Modifying SAP BI Warehouse Connection Information

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.

Viewing Member Of Properties

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

Viewing Extended Properties

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

Viewing Used By Properties

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

Viewing Target History

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

Using the OLAP Database Activities

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

Defining an Activity

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.

Defining Select from SAP BI Warehouse Activity

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.

Viewing Select from SAP BI Warehouse Activity Results

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

2-1

UCS Software Adapter properties

1-1

activities defining

3-1

activities, defining

3-1

adapter accessing UCS Software Adapter properties

1-1

adapter-supported objects

1-4

history

1-5

D defining activity, general

3-1

deleting

SAP BI Warehouse targets

2-6

disabling SAP BI Warehouse target

2-5

E enabling SAP BI Warehouse target

2-5

M managing

SAP BI Warehouse targets

2-5

P properties

OL-24579-02

I N D E X

SAP BI Warehouse target

2-7, 2-8

Select from SAP BI Warehouse 3-5

S

SAP BI Warehouse targets

accessing 2-1

enabling

2-5

managing

2-5

Select from SAP BI Warehouse activity properties

3-5

Select from SAP BI Warehouse results (Instance)

3-6

Select from SAP BI Warehouse results (Paged

Output)

3-7

T targets deleting

2-6

disabling

2-5

history

2-12

Used by

2-11

V viewing

adapter history 1-5

adapter-supported objects 1-4

objects using target

2-11

paged output

3-7

Select from SAP BI Warehouse results

3-6

target history

2-12

Cisco TEO Adapter Guide for OLAP Database

IN-1

Index

IN-2

Cisco TEO Adapter Guide for OLAP Database

OL-24579-02