auditor

BusinessObjects Auditor Guide

BusinessObjects Auditor 6.1

Windows and UNIX

ewboa60.book Tuesday, August 19, 2003 10:52 AM

2 BusinessObjects Auditor Guide

Copyright No part of the computer software or this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or by any information storage and retrieval system, without permission in writing from Business Objects S.A.The information in this document is subject to change without notice. If you find any problems with this documentation, please report them to Business Objects S.A. in writing at [email protected] Objects S.A. does not warrant that this document is error free.Copyright © Business Objects S.A. 2003. All rights reserved.Printed in France.

Trademarks The Business Objects logo, WebIntelligence, BusinessQuery, the Business Objects tagline, BusinessObjects, BusinessObjects Broadcast Agent, Rapid Mart, Set Analyzer, Personal Trainer, and Rapid Deployment Template are trademarks or registered trademarks of Business Objects S.A. in the United States and/or other countries.Contains IBM Runtime Environment for AIX(R), Java(TM) 2 Technology Edition Runtime Modules (c) Copyright IBM Corporation 1999, 2000. All Rights Reserved.This product includes code licensed from RSA Security, Inc. Some portions licensed from IBM are available at http://oss.software.ibm.com/icu4j.All other company, product, or brand names mentioned herein, may be the trademarks of their respective owners.

Use restrictions This software and documentation is commercial computer software under Federal Acquisition regulations, and is provided only under the Restricted Rights of the Federal Acquisition Regulations applicable to commercial computer software provided at private expense. The use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in subdivision (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013.

Patents U.S. Patent Numbers 5,555,403, 6,247,008, and 6,578,027.

Part Number 397-50-610-01


BusinessObjects Auditor Guide 3

Contents

ContentsPreface Maximizing Your Information Resources 7

Information resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Useful addresses at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Part I Administering Auditor

Chapter 1 Introducing BusinessObjects Auditor 17What you can do with Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Auditor components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20The Audit facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Chapter 2 Setting Up and Removing Auditor 23Installing Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Configuring Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Setting privileges for an Auditor-dedicated Designer user . . . . . . . . . . . . . . 35Exporting universes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Exporting predefined indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Monitoring multiple clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Restoring predefined indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Removing Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Chapter 3 Setting Access Rights 63Access rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65



Contents

Chapter 4 Universes, Classes and Objects 71Universe structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Universes and analytical categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Predefined vs. custom-made universes . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Broadcast Agent analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Repository analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Universe domain analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101System information universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Part II Using Auditor

Chapter 5 Using Predefined Indicators 131Predefined indicators available with Auditor . . . . . . . . . . . . . . . . . . . . . . . 133User Information category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Document Management category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Universe Management category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146Broadcast Agent category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151System Information category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Chapter 6 Creating, Modifying, and Publishing Indicators 159Universes, classes, and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Access rights for indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Creating indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Modifying indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Publishing indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Saving indicators in Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Deleting indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Exercise: Creating a new indicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173



Contents

Chapter 7 Using Auditor to Solve Business Problems 177How do I monitor the use of Business Objects products? . . . . . . . . . . . . . 183How do I track Broadcast Agent usage? . . . . . . . . . . . . . . . . . . . . . . . . . . 186How do I find out which machines are accessing my system? . . . . . . . . . 187Can I detect fraud with Auditor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188How do I monitor login information? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189How do I monitor the load on my server? . . . . . . . . . . . . . . . . . . . . . . . . . 191How do I track the most requested documents? . . . . . . . . . . . . . . . . . . . . 192How do I track the least/most popular documents? . . . . . . . . . . . . . . . . . . 193How do I monitor universe hits? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195How do I use AUDITOR for billing? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197How do I perform impact analysis? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Index 199



Contents


preface

Maximizing Your Information Resources




OverviewInformation, services, and solutions

The Business Objects business intelligence solution is supported by thousands of pages of documentation, available from the products, on the Internet, on CD, and by extensive online help systems and multimedia. Packed with in-depth technical information, business examples, and advice on troubleshooting and best practices, this comprehensive documentation set provides concrete solutions to your business problems. Business Objects also offers a complete range of support and services to help maximize the return on your business intelligence investment. See in the following sections how Business Objects can help you plan for and successfully meet your specific technical support, education, and consulting requirements.



Information resources

Information resourcesWhatever your Business Objects profile, we can help you quickly access the documentation and other information you need.

Where do I start? Below are a few suggested starting points; there is a summary of useful web addresses on page 12.

Documentation RoadmapThe Documentation Roadmap references all Business Objects guides and multimedia, and lets you see at a glance what information is available, from where, and in what format. View or download the Business Objects Documentation Roadmap at www.businessobjects.com/services/documentation.htm

Documentation from the productsYou can access electronic documentation at any time from the product you are using. Online help, multimedia, and guides in Adobe PDF format are available from the product Help menus.

Documentation on the webThe full electronic documentation set is available to customers with a valid maintenance agreement on the Online Customer Support (OCS) website at www.businessobjects.com/services/support.htm

Buy printed documentationYou can order printed documentation through your local sales office, or from the online Business Objects Documentation Supply Store at www.businessobjects.com/services/documentation.htm

Search the Documentation CDSearch across the entire documentation set on the Business Objects Documentation CD shipped with our products. This CD brings together the full set of documentation, plus tips, tricks, multimedia tutorials, and demo materials.Order the Documentation CD online, from the Business Objects Documentation Supply Store, or from your local sales office.


www.businessobjects.com/services/documentation

http://www.businessobjects.com/services/documentation

http://www.businessobjects.com/services/documentation

http://www.businessobjects.com/services/documentation.htm

http://www.businessobjects.com/services/support.htm




MultimediaAre you new to Business Objects? Are you upgrading from a previous release or expanding, for example, from our desktop to our web solution? Try one of our multimedia quick tours or Getting Started tutorials. All are available via the Online Customer Support (OCS) website or on the Documentation CD.

How can I get the most recent documentation?You can get our most up-to-date documentation via the web. Regularly check the sites listed below for the latest documentation, samples, and tips.

Tips & TricksOpen to everyone, this is a regularly updated source of creative solutions to any number of business questions. You can even contribute by sending us your own tips.www.businessobjects.com/forms/tipsandtricks_login.asp

Product documentationWe regularly update and expand our documentation and multimedia offerings. With a valid maintenance agreement, you can get the latest documentation – in seven languages – on the Online Customer Support (OCS) website.

Developer Suite OnlineDeveloper Suite Online provides documentation, samples, and tips to those customers with a valid maintenance agreement and a Developer Suite license via the Online Customer Support (OCS) website.

Send us your feedbackDo you have a suggestion on how we can improve our documentation? Is there something you particularly like or have found useful? Drop us a line, and we will do our best to ensure that your suggestion is included in the next release of our documentation: [email protected]

NOTEIf your issue concerns a Business Objects product and not the documentation, please contact our Customer Support experts. For information about Customer Support visit: www.businessobjects.com/services/support.htm


http://www.businessobjects.com

http://www.businessobjects.com/forms/tipsandtricks_login.asp

mailto:[email protected]



Services

ServicesA global network of Business Objects technology experts provides customer support, education, and consulting to ensure maximum business intelligence benefit to your business.

How we can support you?Business Objects offers customer support plans to best suit the size and requirements of your deployment. We operate three global customer support centers:• Americas: San Jose, California and Atlanta, Georgia• Europe: Maidenhead, United Kingdom• Asia: Tokyo, Japan and Sydney, Australia

Online Customer SupportOur Customer Support website is open to all direct customers with a current maintenance agreement, and provides the most up-to-date Business Objects product and technical information. You can log, update, and track cases from this site using the Business Objects Knowledge Base.

Having an issue with the product?Have you exhausted the troubleshooting resources at your disposal and still not found a solution to a specific issue? For support in deploying Business Objects products, contact Worldwide Customer Support at: www.businessobjects.com/services/support.htm

Looking for the best deployment solution for your company?Business Objects consultants can accompany you from the initial analysis stage to the delivery of your deployment project. Expertise is available in relational and multidimensional databases, in connectivities, database design tools, customized embedding technology, and more.For more information, contact your local sales office, or contact us at: www. businessobjects.com/services/consulting.htm

Looking for training options? From traditional classroom learning to targeted e-learning seminars, we can offer a training package to suit your learning needs and preferred learning style. Find more information on the Business Objects Education website: www.businessobjects.com/services/education.htm


http://www.businessobjects.com/services/education.htm


http://www.businessobjects.com/services/consulting.htm



Useful addresses at a glance

Address ContentBusiness Objects Documentation

www.businessobjects.com/services/documentation.htm

Overview of Business Objects documentation. Links to Online Customer Support, Documentation Supply Store, Documentation Roadmap, Tips & Tricks, Documentation mailbox.

Business Objects Documentation mailbox

[email protected]

Feedback or questions about documentation.

Product documentation

www.businessobjects.com/services/support.htm

The latest Business Objects product documentation, to download or view online.

Business Objects product information

www.businessobjects.com

Information about the full range of Business Objects products.

Developer Suite Online

www.techsupport.businessobjects.com

Available to customers with a valid maintenance agreement and a Developer Suite license via the Online Customer Support (OCS) website. Provides all the documentation, latest samples, kits and tips.

Knowledge Base (KB)


Technical articles, documents, case resolutions.Also, use the Knowledge Exchange to learn what challenges other users – both customers and employees – face and what strategies they find to address complex issues. From the Knowledge Base, click the Knowledge Exchange link.

Tips & Tricks

www.businessobjects.com/forms/tipsandtricks_login.asp

Practical business-focused examples.



mailto:[email protected]


http://www.businessobjects.com

http://www.techsupport.businessobjects.com/


http://www.businessobjects.com/forms/tipsandtricks_login.asp


Useful addresses at a glance

Online Customer Support


www.businessobjects.com/services

Starting point for answering questions, resolving issues.

Information about registering with Worldwide Customer Support.

Business Objects Education Services

www.businessobjects.com/services/education.htm

The range of Business Objects training options and modules.

Business Objects Consulting Services

www.businessobjects.com/services/consulting.htm

Information on how Business Objects can help maximize your business intelligence investment.

Address Content



http://www.businessobjects.com/services/

http://www.businessobjects.com/services/education.htm

http://www.businessobjects.com/services/consulting.htm



About this guideThis guide describes BusinessObjects Auditor.The first part of this guide, Administering Auditor, describes how to set up, configure and administer an Auditor deployment. It is designed for Business Objects system administrators and supervisors.The second part of the guide, Using Auditor, describes how to use Auditor to analyze Business Objects user and system activity. It is designed for the IT administrators in charge of monitoring and tuning the Business Objects deployment.

NOTEThis guide replaces the BusinessObjects Auditor Administrator’s Guide and the BusinessObjects Auditor User’s Guide.

Conventions used in this guideThe conventions used in this guide are described in the table below.

Convention IndicatesThis font Code, SQL syntax, computer programs. For

example: @Select(Country\Country Id). This font is also used for all paths, directories, scripts, commands and files for UNIX.

Some code more code

Placed at the end of a line of code, the symbol ( ) indicates that the next line should be entered continuously with no carriage return.

$DIRECTORYPATHNAME The path to a directory in the Business Objects installation/configuration directory structure. For example:• $INSTALLDIR refers to the Business Objects

installation directory.• $LOCDATADIR refers to a subdirectory of the

BusinessObjects installation directory called locData.


part

Administering Auditor


chapter

Introducing BusinessObjects Auditor




OverviewBusinessObjects Auditor is a web-based product that allows you to monitor and analyze user and system activity for WebIntelligence, InfoView, BusinessObjects in 3-tier mode and Broadcast Agent, then display the results on a user-friendly web interface. This information provides valuable insight into your Business Objects deployment, enabling you to optimize your Business Intelligence solution.

NOTE

In this guide, “Auditor” is a shortened form of the full product name, BusinessObjects Auditor.

Auditor is built on the existing Business Objects technology and server infrastructure, taking advantage of their ease of use, security, scalability, and extensibility.



What you can do with Auditor

What you can do with AuditorAuditor enables you to determine which users are using a particular Business Objects system, how often they are using it, and what data they are accessing.You can use Auditor to:• monitor your Business Intelligence system by examining user activity, access

rights, resource information pertaining to the use of documents and universes, as well as system information such as response time, Broadcast Agent details, and server load

• analyze system trends over daily, weekly, and monthly periods• delete or modify unused objects and reports, in order to provide users with

easier and quicker access to essential information• accelerate analysis by using the Favorites and Dashboard features, which

give you direct access to the queries you want to see• optimize your data warehouse and speed up refresh actions by tracking

frequently-used queriesAuditor can help identify situations where aggregate tables or additional indexes can be used.

• generate new billing opportunities by highlighting the most popular reports




Auditor componentsAuditor contains the following components:• indicators that enable you to monitor and analyze• analytical categories (and subcategories) by which indicators are classified• universes on top of which indicators are built

IndicatorsAuditor uses predefined indicators to give you quick access to the information you need in order to monitor, analyze, and optimize your Business Objects deployment. These indicators are delivered as part of the Auditor package.Predefined indicators cover a wide range of useful data. They are your key to information such as: • which users are accessing and utilizing your system• the most popular reports and universes• reports impacted by changing an objectEach indicator contains one or more reports that focus on a very specific area of analysis; for example, the Average Refresh Time indicator, which shows the average refresh time (in seconds) for all documents, broken down by document name, user, document type, and node.You can modify the existing indicators, and then save the modified indicators. For monitoring and analysis that is even more finely tuned to your unique system, you can create your own indicators.

CategoriesThe analytical categories organize the Business Objects deployment into practical areas of analysis. There are five categories:• User Information• Document Management• Universe Management• Broadcast Agent• System InformationEach category has a number of subcategories, which further organize indicators for ease of access, pointing you directly to the information you want.



Auditor components

UniversesAuditor is delivered with a set of predefined universes that facilitate monitoring and analysis activities. These universes are designed and tested to provide you with an effective set of reporting options.Each universe provides an interface for different classes of database objects, permitting compatible objects to be used in building queries.For more information about universes and the classes and objects of which they are composed, see Universes, Classes and Objects on page 71.




The Audit facilityA key component in the Auditor environment is the Audit facility, which tracks crucial information relating to user and system activity. Each time any of 42 predefined events occurs, a record of the event is created and stored by the Audit facility. You can then retrieve and analyze the individual events.The Audit facility is part of the Business Objects system. You activate and administer it using the Administration Console.

The Audit facility has two modes for gathering and storing event records:• File mode

Business Objects stores the user or system information in flat (*.log) files, which are saved to a directory of your choice. These text files can be viewed in the Administration Console or in a simple text editor, such as Notepad.

• Database modeBusiness Objects stores the user or system information in the Audit database. Because of its complexity, information in Database mode normally is viewed and analyzed through the use of indicators in Auditor. However, this can also be performed in SQL, if no other solution is available.

Auditor can access and present audited data only when Database mode is activated.


chapter

Setting Up and Removing Auditor




OverviewThis chapter describes:• Installing Auditor• Configuring Auditor• Setting privileges for an Auditor-dedicated Designer user• Exporting universes• Exporting predefined indicators• Monitoring multiple clusters• Restoring predefined indicators• Removing AuditorFor the first five sections you should have the following guides close by for reference:• Designer’s Guide• Installation and Configuration for UNIX

orInstallation and Configuration for Windows

• Supervisor’s Guide• WebIntelligence User’s Guide• installation and configuration documentation for the application server• readme for BusinessObjects Enterprise 6

NOTEIf you are migrating Auditor to a new version of BusinessObjects, see Migrating from a Previous Version.For deployment information, see the Deployment Guide.



Installing Auditor

Installing AuditorTo install Auditor you need to complete the following steps:1. Requesting a connection to a database server2. Installing the application and web servers3. Installing the BusinessObjects Enterprise 6 product suite

Requesting a connection to a database serverThe Audit database is located on the database server, and so you need a connection created. Only your database system administrator can do this for you, along with providing you user names and passwords that allow access to the database server.You will need this information for the section Configuring Auditor on page 26.

Installing the application and web serversIf you have a JSP deployment, you must install Java SDK, Tomcat, and Apache, before installing the BusinessObjects Enterprise 6 product suite.You can download the Java Development Kit (JDK), Apache, and Tomcat software from the Sun website: http://java.sun.com.

Finding the latest news on versions supported by Business ObjectsYou can find an up-to-date list of the application and web server versions supported by Business Objects in the Products Availability Report (PAR). To find this:1. Go to www.techsupport.businessobjects.com.

The Online Customer Support page appears.2. Log in to the site.3. In the Products tab, click the PAR link.


http://java.sun.com

http://www.techsupport.businessobjects.com



Configuring AuditorYou need to complete the following steps to configure Auditor:1. Configuring the web and application servers2. Creating a data source for the Audit database3. Creating the Audit repository4. Setting up the Audit database

Configuring the web and application serversConfiguring the web and application servers on the host creates the following virtual directories for the applications:• http://<hostname>:<portname>/wijsp

When the complete setup of Auditor is complete, this link provides access to the InfoView portal.

• http://<hostname>:<portname>/wiadminWhen the complete setup of Auditor is complete, this link provides access to the Administrative Console.

• http://<hostname>:<portname>/auditorWhen the complete setup of Auditor is complete, this link provides access to Auditor.

For complete configuration instructions, see the Business Objects installation and configuration guides for Windows and UNIX.



Configuring Auditor

Creating a data source for the Audit databaseIf you have not already created a data source, you must do so using the ODBC Administrator so that you can access your repository and audit database.To create a data source for the repository:1. Select Start, Programs, Administrative Tools, Data Sources (ODBC).

The ODBC Data Source Administrator dialog box appears.2. Click the System DSN tab.

3. Click Add.The Create New Data Source dialog box appears.




4. Select the driver for which you want to set up a data source and click Finish.If you select Oracle ODBC Driver, the Oracle8 ODBC Driver Setup dialog box appears.

If you select IBM DB2 ODBC Driver, the IBM DB2 Driver Add dialog box appears.

5. Enter the required information and click OK.



Configuring Auditor

Creating the Audit repositoryYou need to create a separate repository for the Audit database.Creating a separate Audit repository database is important for the following reasons:• Data from auditor reports will not be included in general usage reports.• Auditor activity will not slow down the repository used for other system

activities.To use the Audit feature, various clusters can write to the same database and not share the same repository. However, for most Auditor predefined indicators, the audit data is analyzed against the repository data. For more information on repositories, see the Supervisor’s Guide.To create the Audit repository:1. Click Start, Programs, Business Objects, Supervisor.

The User ID dialog box appears.

2. Click Admin.The Administration Setup Wizard opens.




3. Click Begin.The Choose Setup Configuration dialog box appears.

4. Do one of the following:- If you want are setting up a new Audit repository, select Run a default installation, and then click Next.- If you have migrated from a previous version of BusinessObjects, select Run a safe recovery, and then click Next. Skip to step 6.

5. Enter a name and password for the repository supervisor. Click Next.The Define the Repository Connection dialog box appears.

6. From the Select the network layer drop-down menu, select a network layer. Click Setup.The connection dialog box appears.



Configuring Auditor

7. From the Database engine drop-down menu select the engine for your connection.

8. Enter the user name, password, and database. Click Test.9. If the test is not successful, verify that you have entered in the correct user,

password, and database name.10. If the test is successful, click OK, then Next.

The Build the Repository dialog box appears if you are creating a new repository. Click Next. The Repository Access dialog box appears.If you are running a safe recovery, the Repository Access dialog box appears.

11.Select the location for the key file and either enter a new name or leave the default key name and click Next.If you are running a safe recovery, a dialog box may appear asking if you want to overwrite the existing key. Click Yes.

NOTEYou need to copy the .key file from:

Business Objects\BusinessObjects Enterprise 6\locdatato the following location:

Business Objects\BusinessObjects Enterprise 6\nodes\<hostname>\ mycluster\locdata

12.Click Finish.Supervisor opens.




Setting up the Audit databaseAuditor delivers reports based on the system and user activity data stored in the Business Objects system’s Audit database and the repository. In order to be able to use the system’s audit information from Auditor, you must:• use Supervisor to set up a secured connection to an Audit-dedicated

database• use the Administration Console to make sure that the system writes its audit

information to that audit database

Creating a secured connection for the Audit-dedicated database1. In Supervisor, select Tools, Connections from the menu.2. In the Name text box, type a name for the connection.

3. From the Database engine drop-down menu, select the database engine you are using.

4. In the Login Parameters section, enter the user name, password, and Audit database name. The user name and password are created for you by the system administrator for the server on which the Audit database is located.



Configuring Auditor

5. Click Test, to test the connection.6. If the test is not successful, check that you entered in the correct information.

If the test is successful, click OK.

The connection is listed in the Connections dialog box.

NOTEIf you need to create other connections:1. In the Connections dialog box, click Add2. Select the correct network layer and click OK.3. Repeat steps 2 through 6.




Creating tables in the Audit database1. Start the BusinessObjects server, Tomcat, and Apache.2. To open the Administrative Console, do one of the following:

- Click Start, Programs, Business Objects, Administrative Console 6.1.- Log in to http://<hostname>:<port number>/wiadminThe BusinessObjects Administrative Console login dialog box appears.

3. Log in using the user name and password that have access to the Audit database.The Business Objects Administrator Console page appears.

4. Click Audit.5. From the Audit database connection drop-down menu select the secured

connection you just created in Supervisor.

6. If necessary, set the maximum audit information cache size and regularity with which the cache is emptied into the Audit database.For information on setting the cache parameters, see the System Administrator’s Guide.

7. Click Apply.The system verifies that the database tables exist. If they do not, an SQL script is executed to create them.

For complete information about the Audit facility and how to configure it for use with Auditor, see the System Administrator’s Guides.



Setting privileges for an Auditor-dedicated Designer user

Setting privileges for an Auditor-dedicated Designer user

Once you have set up the Audit database, you may want to allow another user, perhaps as your backup, the permission to export universes and predefined indicators.To create users with a Designer profile and the specific privileges required to export the universes and predefined indicators required for your Auditor deployment:1. Click Start, Programs, Business Objects, Supervisor.2. Create a new user and assign a profile.

The following user rights need to be enabled:- Manage All corporate categories- Save to corporate documents- Manage personal categories- Save and read personal documentsThe following user rights need to be disabled:- Do not delete other users’ corporate documents




Exporting universesThe Universe Exporter allows you to easily create domain connections and database views, and export the Auditor universes to your corporate repository.If you need to do these actions manually, the following sections can help you:• Manually exporting universes• Manually creating the database views

NOTEYou must:• be using Microsoft Office 2000 in order to use Universe Exporter. If you are

not using Microsoft Office 2000, you need to export universes manually. See page 47.

• have Designer installed on your machine in order to export the universes you require for using Auditor with your system.

Using the Universe ExporterTo launch the Universe Exporter:1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.

A user identification dialog box appears.



Exporting universes

2. Enter the user name and password that have access rights to the Audit database, and click OK. This user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.

The Universe Exporter contains the following tabs.

Each tab corresponds to a specific stage or procedure that is described in the following sections. These procedures can be performed in any order, but you need to create the database views in the Security, Universe, and Audit tabs before you can successfully export documents.

Page name DescriptionWelcome Explains what the Universe Exporter does

Security Creates an OLEDB/ODBC connection for the Security domain, and creates the database views

Universe Creates an OLEDB/ODBC connection for the universe domain, and creates the database views

Audit Creates an OLEDB/ODBC connection for the Audit domain, and creates the database views

Export For automatic export of the Auditor universes




Creating a connection to the domainThe first time you use Universe Exporter you need to create a connection to the database, or perhaps you need to create a connection to a new Audit domain. This procedure applies in the Security, Universe, and Audit tabs.To create a connection to the database:1. Click Start, Auditor 6.1., Universe Exporter.

A user identification dialog box appears.2. Enter the user name and password that have access rights to the Audit

database, and click OK. This user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.

3. Click the tab for the domain requiring a domain connection.4. In the Data Source Name section, click New.

The Data Source Connection Editor dialog box appears.

5. Click the tab that corresponds to your type of database.

NOTEFor Sybase, use the ODBC tab and then select Sybase as the database. You can use the ODBC tab when you need to create an Oracle or IBM DB2 connection on a client that does not have OLE DB Oracle or IBM DB2.



Exporting universes

6. In the Name field, enter a unique name for the connection.7. In the Data Source text box, enter:

NOTEFor SQL Server, the server is the name of the machine that contains the database.

8. In the User ID text box, type the user name that has access rights to the Audit database.This user name must have at least one Designer profile for you to be able to create connections.

9. In the Password text box, type the password.10.Click Test.

If you do not receive notice that the server is responding, verify that you typed in the correct parameters and that the User ID has the permission in Supervisor to create this sort of connection.

11.Click OK. The tab reappears. In the Views section, a list of views is now available, with the Already in database? status of No.

NOTEIf you have migrated from a previous version of Business Objects, you need to delete any remaining views by selecting them in the Views list and clicking Delete and then recreating the views by clicking Create.

For... Data sourceOracle Net Service Name

IBM DB2 Database Alias

SQL Server Database Name




12.To add these views to the database, click Create.All the views for the security domain are marked Yes in the Views area.



Exporting universes

Using the Security tab to manage database connectionsTo launch the Universe Exporter:1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.

A user identification panel appears.2. Enter the user name and password that have access rights to the Audit

database, and click OK. The user name must have at least one Designer profile for you to be able to export universes.The Universe Exporter appears.

3. Click the Security tab or Next on the Welcome page.The Security tab appears.

4. In the Data Source Name list, select a connection to your database. If you do not have a connection, see Creating a connection to the domain on page 38.Any views that already exist for the selected connection are marked Yes in the Views area.


5. If you want to delete a view, select a view and click Delete.6. Click Next to go to the Universe tab, or Finish to save all your changes.




Using the Universe tab to manage connections to universes1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.


database, and click OK. The user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.

3. Click the Universe tab in the Universe Exporter window.The Universe tab appears.



5. If you want to delete a view, select a view and click Delete.6. Click Next to go to the Audit tab, or Finish to save your modifications.



Exporting universes

Using the Audit tab to manage connections to the Audit database1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.



3. Click the Audit tab in the Universe Exporter window. The Audit tab appears.



5. If you want to delete a view, select a view and click Delete.6. Click Next to go to the Export tab, or Finish to save your modifications.




Using the Export tab to manage the export of specific universesFrom this tab, you can set the parameters to export the specific universes you wish to use with Auditor. These parameters include the universe’s:• security domain connection• universe domain connection• audit database connection• assigned user groups• destination universe domainOnce you’ve defined these settings, the Export tab lets you trigger the export itself.1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.



3. Navigate to the Export tab either by clicking Next from the Audit tab, or by clicking the Export tab in the Universe Exporter window. The Export tab appears.



Exporting universes

4. Select a connection from the drop-down menu in the domain section for the domain that you want to use.If you need to add a connection, see Adding a new connection in the Export tab on page 46.

TIPTo hide other connections that you did not create for the three domains, select the Filter BusinessObjects connections for previously defined connections box.

5. In the lower right corner of the Export tab, select the user group and domain to which the universes will be exported.

6. Click Export Universes.A summary of the universe export appears.

7. Click OK, then Finish.

NOTE

You can confirm that the universes have been exported by viewing the Universe page in Supervisor.




Adding a new connection in the Export tab1. To add a new connection in the Export tab, click Add Connection.

The Add a connection dialog box appears.

2. Select a network layer, then click OK.3. Click the Login tab and enter the parameters for the new connection.4. Click the Advanced tab and select Disconnect After Each Transaction.

5. Click OK.The connection is now available in the Export tab.



Exporting universes

Manually exporting universesTo manually export the Auditor universes:1. Do either of the following:

- Copy the *.unv files (BCA.unv, SECURITY.unv, UNIVERSE.unv and ACTIVITY.unv) to the machine running Designer.- Make them available to this machine by sharing them

The files are located at: $INSTALLDIR\auditorData\Universes\Universes

2. Start Designer.3. Enter your user name and password.Perform the remaining steps below for each universe:4. Open a universe (*.unv) file.5. Click File, Parameters.6. In the Definition section, do either of the following:

- Assign one of the existing secured connections to the universe.- Create a new secured connection (you must do this if there is no existing secured connection available).

7. Click OK.8. Click File, Export. If you are prompted to save the universe before exporting

it, click Continue.The Export Universe dialog box appears.

9. Select the relevant domain and group, and then click OK.If you previously exported this universe, you are prompted to overwrite the previous version.The suggested connections for the universes are:

Universe Domain DatabaseBroadcast Agent Analysis Security Corporate repository

Repository Analysis Security Corporate repository

Universe Domain Analysis Universe Corporate repository

System Information Audit database Audit database




Manually creating the database viewsIf you do not want to automatically create the database views by using the Universe Exporter, follow the procedures below for creating them manually.The objects used in the universes are based on the views, and not directly on the repository or the Audit database tables.For each database, you must create five sets of views. A view is created by executing the script contained in an *.sql file.To create the database views:1. Open an SQL session.2. Execute the five scripts for your particular database.

- For the xxx_activity_xxx.sql files, use the audit database.- For the xxx_bca_xxx.sql and xxx_security_xxx.sql files, use the security domain.- For the xxx_universe_xxx.sql files, use the universe domain.The following table shows the location and names of the *.sql files containing the scripts.

Database Location of files File namesOracle $INSTALLDIR\

Universes\auditorData\ Views\ Oracle\

creviews_activity_ora.sqlcreviews_security_bca_ora.sqlcreviews_universe_ora.sql

IBM DB2 $INSTALLDIR\ Universes\auditorData\ Views\IBMDB2\

creviews_activity_db2udb.sqlcreviews_security_bca_db2udb.sqlcreviews_universe_db2udb.sql



Exporting predefined indicators

Exporting predefined indicatorsThe Document Exporter enables you to automatically export the Auditor documents (predefined indicators) to the corporate repository.

NOTEThe Business Objects server and Business Objects 6.1 must be running before you start the Document Exporter.

If you cannot run Document Explorer, you can export these indicators manually. For instructions, see Manually exporting predefined indicators on page 52.

Accessing the Document Exporter in UNIX1. At the command prompt, go to:

<$INSTALLDIR>/tools/With a standard Business Objects deployment the path would be:BOBJ/Enterprise6/tools/

2. To open document explorer type:./DocumentExporter.sh




Exporting documents with the Document Exporter1. Click Start, Programs, Business Objects, Auditor 6.1, Document

Exporter. The Document Exporter login dialog box appears.

2. Enter the Auditor user name and password.To export documents, you must ensure that the Auditor user name and password have the correct privileges. See Setting privileges for an Auditor-dedicated Designer user on page 35.

3. Click OK.The BusinessObjects Auditor 6.1 Document Exporter dialog box appears.

The Document Name column shows all the documents that are delivered with Auditor. Documents already exported to the Corporate and Personal areas are marked “Y” in the In Corporate and In Personal columns, respectively.




4. Select the document domain in the drop-down list near the top of the dialog box.

5. For each document that you want to export, select its box in the Document Selection column.- To select all the documents, click All. (Click None to deselect them.)- To select only the documents that have not already been published to your Corporate area, click Not in Corporate.- To select only the documents that have not already been published to your Personal area, click Not in Personal.

6. If you select the Publish the selected document to option, do either or both of the following:- To export the selected documents to the Corporate area, select the Corporate list type check box, and then choose a user group.- To export the selected documents to your Personal area, select the Personal list type check box.

7. Click Apply.When the documents are successfully exported, they are marked “Y” in the In Corporate and/or In Personal columns.

8. When you are finished exporting documents, click Exit.To remove documents with Document Exporter, go to Removing the documents on page 61.




Manually exporting predefined indicatorsTo manually export the Auditor predefined indicators:1. Create a temporary folder on your computer.2. Copy into this folder all of the documents in:

$INSTALLDIR\auditorData\Documents3. Select all of the documents.4. Click File, Properties.

5. De-activate the Read-only attribute and click OK.




6. Refer to the file input.txt located in the Documents file for the correct document category and keyword.

The input.txt document lists the information in the following sequence:<document name>, <keyword>, <category>

7. Select Start, Programs, Business Objects, BusinessObjects Enterprise 6.The BusinessObjects panel opens. If the New Report Wizard dialog box appears, click Cancel.

8. Select File, Open. Select all of the documents in the temporary report folder then click OK.

TIPSelect all of the documents in a specific category. That way you publish all of the se documents at the same time to Corporate Documents.




9. Click File, Properties.

10. In the Keywords text box, type the keyword for the documents.11.Click File, Publish to.

The Send dialog box opens.12.Click Categories.

The Select Categories dialog box appears.




13.Click Manage.The Categories dialog box appears.

14.Click Add.A new folder appears, with an empty space for the category name.

15.Type a name for the category, for example Document Management. Click OK.The Send dialog box reappears.

16.Next to the Document(s) to Send section, click Add.The Add Documents dialog box appears with a list of the documents open in BusinessObjects.




17.Select the documents that belong in the Document Category you created. Click OK to return to the Send dialog box, and OK again to publish the documents.

18.To verify that the documents were published correctly, select File, Retrieve from, Corporate Documents.The Retrieve dialog box appears. The documents you imported are listed.



Monitoring multiple clusters

Monitoring multiple clustersYou can use Auditor to monitor multiple clusters, with no administrative overhead. To set up the system to do this, you connect to the Administration Console for each cluster to be monitored, and set the Audit database connection to the same database in the Audit page.

EXAMPLESetting up the monitoring of multiple clustersYou want Auditor to monitor oracleCluster1, oracleCluster2 and db2Cluster1. Having already set up the Audit database and its connection:1. Click Start, Programs, Business Objects, Administration Console 6.1

The Administration Console appears.2. In the Administration Console on Cluster1’s primary node, click Audit.3. Click Log to database.

A login panel appears.4. Enter the user name and password with access to the Audit database.5. From the Audit database connection drop-down menu select oracleCluster1.6. Click Apply.

7. Repeat steps 5 and 6 for oracleCluster2 and db2Cluster1.The audit information for all three clusters are now recorded in the same database. The Administration Console for each cluster initializes the database and registers the new cluster.




Restoring predefined indicatorsIf a user mistakenly deletes a predefined indicator, you need to republish the indicator back to the corporate repository. The replacement indicator is found in the personal documents’ area of the user with which Auditor was originally installed. To restore an indicator, you can use the Document Exporter or the following procedure:1. Log into InfoView using the user name and password with access to the Audit

database at: http://<hostname>:<portname>/wijsp.2. Click Personal Documents.

The indicators in the Personal area are displayed.3. Click the indicator you want to restore.

The associated document appears.4. Click Publish.

The Publish as Corporate Document page appears.5. Verify that the document’s name, description, and category are the same as

those of the original indicator.6. Verify that the document keyword corresponds to the indicator’s subcategory

in Auditor.7. Click No for the Overwrite if Document Exists option.

The original document was presumably deleted.8. Select the Refresh option:

- Refreshed ManuallyThe indicator is refreshed only when a user refreshes it manually.

- Scheduled RefreshSelect this option if you want to schedule a refresh using Broadcast Agent.

The Scheduling Options page appears. 9. Set the refresh frequency you want, and then click OK.

For information on the refresh frequency, see the InfoView User’s Guide.10.Click Publish.

If the name already exists, a message appears at the bottom of the page. You must either return to step 5 to change the name, or to step 7 to select Yes.

11.Log into Auditor, and you see the indicator under the specified category and subcategory.



Removing Auditor

Removing AuditorTo remove Auditor from the server, there is a procedure to follow. The following sections must be completed in this sequence:1. Deleting the universes2. Removing the database views3. Removing the documents4. Removing the Auditor files

Deleting the universesTo delete the universes:1. Click Start, Programs, Business Objects, Supervisor.2. Select Tools, Delete Universe.

The Delete Universes dialog box appears.

3. Select the Auditor universes, and then click OK.




Removing the database viewsTo remove the database views:1. Open the Universe Exporter.2. Click the Security tab.

The Security page appears.

3. In the Data Source Name area, select the connection to the security domain.4. Click Delete near the bottom of the dialog box.

All the views for the security domain are marked “No” in the Views area.5. Repeat the previous two steps for the Universe and Audit tabs.6. Click Finish.



Removing Auditor

Removing the documentsTo remove the documents:1. Open the Document Exporter:

- Under UNIX – at the command prompt, type ./DocumentExporter.sh This file is usually located in $AUDITORINSTALLDIR/DocumentExporter/.

- In Windows click Start, Programs, Business Objects, Auditor 6.1, Document Exporter.The Log In dialog box appears.

2. Enter the Auditor user name and password.Use the same Business Objects user name that you originally used to export the documents during installation.

3. Click OK.The main window of the Document Exporter appears.

4. Select the document domain in the drop-down list near the top of the dialog box.




5. Select the documents you want to remove by:- select the box in the Document Selection column- click All to select all of the documents- click None to deselect all of the documents

6. Click Remove the selected document from.7. Do either or both of the following:

- To remove the selected documents from the Corporate area, click Corporate list type.- To remove the selected documents from your Personal area, click Personal list type.

8. Click Apply.The Status dialog box appears with the number of selected documents deleted and offers you the option of viewing a detailed status report. If you want to see this report, click Yes. If not, click No.When the documents are successfully removed, they are marked “N” in the In Corporate and/or In Personal columns.

9. When you are finished removing documents, click Exit.

Removing the Auditor filesTo remove the Auditor software from the server, follow the instructions in the Installation and Configuration Guides for Windows or Unix.


chapter

Setting Access Rights




OverviewAuditor runs in a secure environment, using a repository to store all security information. Auditor inherits the access rights functionality of Supervisor for *.rep documents. You therefore modify access rights for Auditor using Supervisor. In addition, Auditor adds a layer of Form Authentication architecture using Java Server Page (JSP) technology.This chapter explains how to set access rights for Auditor using Supervisor. For complete information about setting access rights for Business Objects users, see the Supervisor’s Guide.



Access rights

Access rightsIn Supervisor, access rights are organized into command sets. A command set contains related menu commands, toolbar buttons, and other interface elements. Access rights usually are controlled by enabling or disabling command sets.Command sets, in turn, are grouped into families. The command set families are:• Document

Document handling; analytical categories• Options

Options for list display, home page, password, editing, and technology• Query and Report Panels

BusinessObjects Query Panel and WebIntelligence Report Panel functionality




Command set family: DocumentThe following table shows which command sets to choose in order to restrict Document functionality.

Interface impactThe following table shows the impact on the user interface of disabling or hiding Document command sets.

I don’t want my group/user to... So I disable or hide command setPublish indicators to the repository Publish Document

Save indicators Save Document

See the list of indicators Read Corporate Documents

Disabling or hiding command set...

Has this impact on the interface

Publish Document Removes the Publish command under the indicator name.

Save Document Removes the Save command under the indicator name.

Read Corporate Documents Removes the following tabs:• Dashboard• Customize Dashboard• Favorites• Options



Access rights

Command set family: OptionsThe following table shows which command sets to choose in order to restrict Options functionality.

Interface impactThe following table shows the impact on the user interface of disabling or hiding Options command sets.

I don’t want my group/user to... So I disable or hide command setSee document list options or change the default home page

Change List Display and Default Home Page

Change their own password Change Password

Change the viewing and editing of technology options (applets and technology options on the Options page)

Change Viewing and Editing Technology Options



Change List Display and Default Home Page

Removes the Start Page tab from Options

Change Password Removes the Password tab from Options

Change Viewing and Editing Technology Options

Removes the Create and Edit Indicators tab from Options




Command set family: Query and Report PanelThe following table shows which command sets to choose to restrict Query Panel and Report Panel functionality.

Interface impactThe following table shows the impact on the user interface of disabling or hiding Query and Report Panel command sets.

I don’t want my group/user to... So I disable or hide command setCreate a new indicator Download 3-Tier BusinessObjects

Modify an existing indicator Edit Documents

Use the formatting toolbar Formatting Toolbar

Refresh lists of values Refresh Lists of Values

Run and refresh indicators Run and Refresh Documents

Use or refresh lists of values Use List of Values

View the SQL of a query View SQL



Create Indicators Removes the Add a New Indicator tab

Edit Indicators Removes the Edit button from indicatorsRemoves the Add a New Indicator tab

Formatting Toolbar Removes the formatting commands from the Report Panel

Refresh Lists of Values Does not show the Refresh button when a choice of values is displayed for a document



Access rights

Run and Refresh Documents

The user can modify the document but cannot run the associated query (that is, the Run button is removed from the applet).The Add a New Indicator, Dashboard, and Customize Dashboard tabs are removed.If a report is published with a manual Refresh, the user can open and modify it, but cannot run or refresh it.If a report is published with the Refresh on Open option, the user cannot open, modify, or refresh it.

Use List of Values If the user: 1. creates a document2. drags an object from the Classes and Objects

Panel to the Conditions tab3. clicks on the operand of the objectthen the Show Values From List and Prompt Values From List options are unavailable.If the user:1. opens an expanded documents page2. clicks Edit underneath a document, then3. creates or edits an object using a List of Values

in the Conditions tab of the WebIntelligence Report Panel

then Refresh is unavailable in the List of Values dialog boxes.

View SQL If the user creates a new indicator, or opens an existing indicator, then the SQL button is not available in the WebIntelligence Report Panel.




chapter

Universes, Classes and Objects




OverviewThis chapter describes the universes that are provided with Auditor, as well as the objects that can be selected from the universes to create and edit indicators.Knowledge of universes is important for understanding the elements used in creating and modifying indicators. For example, the BusinessObjects Query Panel is displayed following the selection of either Add a New Indicator or the Edit option for an existing indicator. It is the universe that determines the objects that are available in the panel for building the new query.



Universe structure

Universe structureUniverses are composed of objects and classes. Objects are elements that map to a set of data from a relational database. Objects allow you to retrieve data for your queries. Classes are logical groupings of objects.Universes permit mutually compatible objects to be used in queries by means of the BusinessObjects Query Panel. Objects are classified as one of the following types:• Dimension

A dimension retrieves the data that provides the basis for analysis. This data is usually character-type data or dates. In the following universe sections the names of objects that are dimensions are followed by (D).

• DetailA Detail object is always associated with a specific Dimension object, in order to provide additional information. In the following universe sections the names of objects that are detail objects are followed by (De).

• MeasureA measure retrieves numeric information that is the result of calculations on data in the database. In the following universe sections the names of objects that are measures are followed by (M).




Universes and analytical categoriesUniverses correspond approximately to the various analytical categories in Auditor. The universe/analytical category mapping is shown in the following table.

NOTEThis table and the ones following show the full names of the universes. The part of the name after the colon shows the domain to which the universe is attached. In the remainder of this document, the shorter name (such as Repository Analysis) is used.

This universe... Is used by indicators in these categoriesBroadcast Agent Analysis: Security

Broadcast Agent

Repository Analysis: Security Document ManagementUser InformationBroadcast Agent

Universe Domain Analysis: Universe

Universe Management

System Information: Audit System InformationUser InformationDocument ManagementUniverse Management



Predefined vs. custom-made universes

Predefined vs. custom-made universesWith Auditor, you can use either a set of predefined universes delivered with the product, or any other universes available to you through the Business Objects system.

Predefined universesAuditor comes with the following predefined universes:

They allow you to carry out monitoring and analysis activities immediately after installation.These predefined universes are attached to different domains. These domains are connected to databases during installation, prior to export of the universes.

Custom-made universesIn Auditor, you can access universes that you:• created in Designer• exported to the repository• made accessible to users via SupervisorThe universes that you create appear in the list of default universes. This list is automatically presented to users when they create a new indicator without having selected a default universe (see Creating indicators on page 163).

Universe name File nameBroadcast Agent Analysis: Security BCA.unv

Repository Analysis: Security SECURITY.unv

Universe Domain Analysis: Universe UNIVERSE.unv

System Information: Audit ACTIVITY.unv

Universe Domain DatabaseBroadcast Agent Analysis: Security Security Corporate repository

Repository Analysis: Security Security Corporate repository

Universe Domain Analysis: Universe Universe Corporate repository

System Information: Audit Audit database Audit database




Broadcast Agent analysis universeThis section lists the classes in the Broadcast Agent Analysis universe, and the objects that are available for selection within each class.Objects in each class are listed alphabetically, and not in the order in which they appear in the user interface.

NOTEBecause the security domain handles international date and time operations, dates may be displayed in Greenwich mean time (GMT) format, which is the time zone reference for the repository. For more information, see the Broadcast Agent Administrator’s Guide.

BCA information classThis class provides Broadcast Agent system information. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsBCA & BO Server Names (D)

Two server names, or Not Processed.The first name is the server on which Broadcast Agent is running; the second name is the Business Objects server on which the task was processed (the machine running BOManager).For a task that has not been executed, the column returns “Not Processed.”The column is updated after a task is processed.

BCA ID (De) Broadcast Agent server IDs.Each Broadcast Agent server is assigned a unique ID.

BCA Name (D) Name of the monitored Broadcast Agent.

BCA Name (label) (D)

Name of the monitored Broadcast Agent, preceded by the text string “Broadcast Agent.”



Broadcast Agent analysis universe

BCA Server Name (D)

Name of the machine on which the Broadcast Agent server is running, or Not Processed.For a task that has never been executed, the object has no value.The value is updated after a task is processed.

BCA Status (D) Enabled, Disabled, or “Exceeded number of logins allowed.”

Group Name (D) Broadcast Agent group names

BO Server Name (D)

Name of the Business Objects server that sent the job to Broadcast Agent (that is, the server machine running BOManager).For a task that has not been executed, the object returns “Not Processed.”The object can be seen from any console, and is updated after a task is processed.

BO Server Name (with label) (D)

Name of the Business Objects server that sent the job to Broadcast Agent, preceded by the text string “WebI Server Name.”For a task that has not been executed, the object returns “Not Processed.”The object can be seen from any console and is updated after a task is processed.

This object... Returns




Batch information classThis class provides Broadcast Agent system information. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsBatch ID (D) ID of the pending Broadcast Agent job.

End User Process ID (D)

The end-user module process ID launched on the server.

Job Description (D)

Job description initially completed by the user submitting the document.The description can be modified.

Job Platform (D) All Platforms, Windows Platform, Windows Platform (BusinessObjects 4.1 task), UNIX Platform, New attempt on a UNIX platform, All attempts failed on UNIX platforms, or “Not Processed.”

Overwrite Mode (D)

With or without, depending on whether the Broadcast Agent job was submitted with the overwrite option turned on.

Priority (D) High, Normal, or Low

Priority (picture) (De)

A graphical indicator of the job’s priority: High, Normal, or Low (Auditor interface only).




Actions subclassThis is a subclass of the Batch Information class that provides information on Broadcast Agent batch job actions. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsAction Type (De) One of the following Broadcast Agent action types:

• First Begin Date• Distributed via Web Server• Distributed via Server File System• File Watcher Detection.

Data (De) Value of the condition associated with the batch job.

Particular Conditions (D)

Details of the Broadcast Agent action, such as: • First Begin Date, if distributed via a web server• Web Server name, if distributed via a server file system• Server File System, File Watcher detection on file named

Report Bursting feature (D)

Mode used to refresh the document, such as Refresh with Profile of Each Recipient, Refresh with Profile of the Submitter.

Script Options (D)

Broadcast Agent script options that the user selected and sent with the document.The values are separated by commas: Refresh Document = 1, Print Document = 2, WebServer = 3, Custom Macro, = 4, Condition = 5, Channel = 6,Save as RTF = 7, Save as TXT = 8, Save as PDF = 9




Scheduling Information subclassThis is a subclass of the Batch Information class that provides job frequency information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsBegin Time (D) Start time of the pending Broadcast Agent job.

For hourly tasks, it displays the information in the following form: “30 minutes after the hour from 9 to 11.”

Days of the Month (D)

Days selected for monthly tasks.The information appears in the following form: “2nd 3rd 4th 26th and last day of the month.”

Days of the Week (D)

Days selected for daily, monthly interval, and user-defined tasks.The information appears in the following form: “Monday Wednesday Friday.”

Frequency (D) One of the following: • Once (4,6)• Hourly (8,10)• Daily (16,18)• Weekly (32,34)• Monthly (64,66)• Monthly interval (128, 130)• User defined (256, 258).

Periodicity (D) Scheduling for daily, weekly, and monthly tasks.The information appears in the following form: “Every 6 week(s).”

Periodicity Detail (D)

Day scheduling for monthly interval tasks and the scheduling details for user-defined tasks.The information appears in the following form: “Every 2nd business day.”




Monitoring Job Information subclassThis is a subclass of the Batch Information class that provides job status information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsJob Error Code (De)

Broadcast Agent job error code, if there is one.Make a note of the code so that you can use it when referring to the Error Message Guide.

Job Error or Warning Text (D)

Full error description, with the error code that relates to the Error Message Guide.

Job State (D) Indication of whether a job is still running.

Job Status (D) Text description of a job’s current status.




Document information classThis class provides Broadcast Agent document data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsCategory Creator (De)

Name of the user who created the document category.

Category Name (De)

Document's category name.

Category Path (De)

Hierarchical path of the document category if there is one.

Document Category (D)

List of document categories with the hierarchical path if there is one.

Document ID (D) Document ID

Document Name (D)

Name of a document sent to Broadcast Agent.

Document Name & Type (D)

Complete document name with its type.

Document Persistent (D)

Persistent if a document is published to the corporate repository, or Not Persistent if the document is automatically deleted when retrieved by the last user.

Document Repository ID (De)

ID of the document repository.

Document Repository Name (D)

Name of the repository where a document is stored.

Document Size (M)

Size of a sent document, in bytes.The object does not represent the size of a document when it is stored in the document domain; rather, it represents the initial size of the document (the size of the document when it was submitted).

Document Type (D)

The WebIntelligence or BusinessObjects document.The file extension type is .rep, .bqy, .wqy, .wid, or .rea; otherwise, it is Unknown.




Document Type (Picture) (De)

Graphical image representing the WebIntelligence or BusinessObjects document type.

Last Action (D) Last action performed on a document, and the date of the action.Values that can be returned include: Unchanged, Deleted, Inserted, Updated, Moved, or Other.

Last Action Date (D)

Most recent, date of a change to a referenced document.

Last Action Type (D)

Last type of action performed on a referenced document.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.

Number of documents (M)

Number of documents sent to Broadcast Agent.





Submitter information classThis class provides information on the users and user groups submitting documents. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsBO Version of the Submitter (D)

Version number of the end-user module that submitted the job to Broadcast Agent.This object value is updated only at the time of document submission.

Group Submit Name (D)

Group receiving the user’s submitted document.

Group Submit Name (with label) (D)

Group receiving the user’s submitted document, preceded by the text string “Group Submit Name”.

Submit name & User Profile (D)

The submit name and user profile, as defined in Supervisor.

Submit name & User Profile (label) (D)

The submit name and user profile as defined in Supervisor, preceded by the appropriate text string.

User Submit Name (D)

Name of the user who submitted the job to Broadcast Agent.

User Submit Type (D)

User type or user profile, as defined in Supervisor.




Recipient information classThis class provides data on document recipients. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsCount Recipients (M)

Total number of recipients of a document.

Distribution Path (De)

Values of the distribution path.

Distribution System (D)

Distributed via Web Server, or Distributed via Server File System, to indicate how the processed Broadcast Agent document is to be distributed.Also returns information on the concatenated path.

Group Recipient Name (D)

Group Name receiving the document.

Recipient Name (D)

Name of the recipient.

Recipient Status (D)

Enabled, Disabled, or “Exceeded number of logins allowed.”

Recipient User Type (D)

User profile, as set in Supervisor.Possible values are: General Supervisor, Supervisor, Designer, Supervisor-Designer, User, Broadcast Agent, or Versatile.




Time frame classThis class provides job duration data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

Submit Date Time Frame subclassThis is a subclass of the Time Frame class that provides job submission dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.

Start Date Time Frame subclassThis is a subclass of the Time Frame class that provides system start dates for jobs. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsAverage Duration (M) Average duration of a job, in seconds.

Job Duration (M) Duration of a job, in seconds.

Job Duration Max (M) Maximum duration of a job, in seconds.

Job Duration Min (M) Minimum duration of a job, in seconds.

This object... ReturnsSubmit Datetime (D)

Date on which the task was submitted on the client machine.

This object... ReturnsStart Date (D) Date on which the task started on the server.

This is the start time for waiting tasks; it is a system parameter that is used until the task is completed. Note: You may receive the value “Friday 06 February 2037 6:28:16 AM.




End Date Time Frame subclassThis is a subclass of the Time Frame class that provides job end dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.

Expiration Date Time Frame subclassThis is a subclass of the Time Frame class that provides job expiry dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.

Begin Date Time Frame subclassThis is a subclass of the Time Frame class that is used to control job start dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsEnd Date (D) Date on which a task ended on the server.

This is the end time for waiting tasks; it is a system parameter that is used until the task is completed.Note: You may receive the value “Friday 06 February 2037 6:28:16 AM.

This object... ReturnsExpiration Date (D)

Date on which a task expired.

This object... ReturnsBegin Date (D) Date from which a job is considered valid.

• Set this date in the Conditions tab if you want to control the execution date.

• When a job is run, the task is duplicated, its status is set to Running (for the duplicated task), and the execution date of the original task is computed.




Audit BCA measures classThis class provides various Broadcast Agent job counts. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

NOTEYou cannot use more than one object from the Audit BCA Measures Class in a single indicator.

This object... ReturnsCount BCA Jobs (M) Number of batch jobs submitted.

Count Job Expired (M) Number of jobs that were retried but not ultimately executed.

Count Job Failed (M) Number of failed jobs.

Count Job Running (M) Number of jobs currently running.

Count Job Success (M) Number of successful jobs.

Count Job Suspended (M)

Number of suspended jobs.

Count Job Waiting (M) Number of waiting jobs.




Broadcast Agent analysis incompatibilitiesThe following table lists the objects in the Broadcast Agent Analysis universe that are known to be incompatible with each other.

* This incompatibility can be caused by one of two factors:• Incompatibility of WHERE clauses• Use of the “Count” operator

This object... in Class... is incompatible with...*

in Class

Count BCA Jobs Audit BCA Measures the other objects Audit BCA Measures

Count Job Expired Audit BCA Measures the other objects Audit BCA Measures

Count Job Failed Audit BCA Measures the other objects Audit BCA Measures

Count Job Success

Audit BCA Measures the other objects Audit BCA Measures

Count Job Suspended

Audit BCA Measures the other objects Audit BCA Measures

Count Job Waiting Audit BCA Measures the other objects Audit BCA Measures




Repository analysis universeThis section lists the classes in the Repository Analysis universe, and the objects that are available for selection within each class.

NOTEBecause the security domain handles international date and time operations, dates may be displayed in GMT format, which is the time zone reference for the repository. For more information, see the Broadcast Agent Administrator’s Guide.

User classThis class provides information on the people who want to access your business intelligence system. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsFailed Logins (D) Number of times that a user tried to log in, without success.

Group Name (D) Existing group names “the list of” or “group names from the repository.”Do not use with User Name, use instead User Group.Note: The Status object in the Document class can only be used with the Document Name and User Name (or Group Name) objects to query the documents that are enabled or diabled for a user (or group).

Identification Strategy (D)

No Password Checking or Full Password Checking.

Inheritance Rights (De)

Group from which rights were inherited.


Most recent date of a change of the user.


The last type of action to be associated with the user. Values that can be returned include: Unchanged, Inserted, Updated, or Moved.

Resource (D) Supervisor, Designer, Agent, Query, Reporter, WebReporter, or Unknown.



Repository analysis universe

Resource Status (D)

Disabled or Enabled.

User Group (D) Name of the user group.

User Group (with label) (D)

Name of the user group, preceded by the text string “User Group.”

User Level (D) Security level for an individual end-user object: Public, Controlled, Restricted, Confidential, or Private.

User Name (D) The list of user names from the repository.Note: The Status object in the Document class can only be used with the Document Name and User Name (or Group Name) objects to query the documents that are enabled or diabled for a user (or group).

User Name (with label) (D)

The list of user names from the repository, preceded by the text string “User Name.”

User Profile (D) User profile, as stored in the repository.

User Status (D) Disabled, Enabled, or “Exceeded number of logins allowed.”

User Status (picture) (De)

A graphical representation of user status (WebIntelligence only).





Security Commands subclassThis is a subclass of the User class that provides information on the command restrictions applied to groups or individual users. It also shows their access rights to the functionality in Business Objects products. The following table shows the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsSecurity Configuration (D)

Name of the Business Objects product on which the restrictions are placed. These products include Designer, InfoView, Supervisor, BusinessObjects, and WebIntelligence.

Security Family (D)

Functionality family on which the restriction is placed.

Security Status (D)

Status of the restriction: Enabled, Disabled, Inherited, or Hidden.

Security Functionality (D)

Name of the functionality on which the restriction is placed for Designer, BusinessObjects, Supervisor, InfoView, or WebIntelligence.

Designer Functionality (D)

Name of the functionality on which the restriction is placed for Designer.

BusinessObjects Functionality (D)

Name of the functionality on which the restriction is placed for BusinessObjects.

Supervisor Functionality (D)

Name of the functionality on which the restriction is placed for Supervisor.

BusinessQuery Functionality (D)

Name of the functionality on which the restriction is placed for BusinessQuery.

WebIntelligence Functionality (D)

Name of the functionality on which the restriction is placed for WebIntelligence.




Documents classThis class provides information on documents in the corporate repository. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsCategory Creator (De) Name of the user who created the document

category.

Category Name (De) Document’s category name.

Category Path (De) Hierarchical path of the document category if one exists.

Document Age (hour) (D)

Document age, in hours.

Document Age (min) (D)

Document age, in minutes.

Document Age (sec) (D)

Document age, in seconds.

Document Category (D) A list of document categories with hierarchical path if one exists.

Document Creation Date (D)

Document creation date.

Document Domain (D) The list of document domain names.Note: The Status object cannot be associated directly to the Document Domain object without the Document Name object.

Document ID (D) Document ID.

Document Name (D) Document name. Note: The Status object cannot be associated directly to the Document Domain object without the Document Name object. The Status object can only be used with the Document Name object and User Name (or Group Name) objects in the User Class to query the documents that are enabled or diabled for a user (or group).




NOTE

It is not possible to retrieve inherited values of the rights on documents, and it is necessary to look at the rights on each group and domain access to verify if a user or group has the rights to use a document.

Document Name & Type (D)

Document name, along with its type.

Document Persistent (D)

“Persistent” if a document is published to the corporate repository, or Not Persistent if the document is automatically deleted when retrieved by the last user.

Document Size (M) Document size, in bytes.

Document Type (D) Document type: .rep, .bqy, .wid, .wqy, or .rea.

Document Type (picture) (De)

HTML hyperlink to a graphical image of the document type (Auditor interface only).

Last Action Date (D) Date on which the document was most recently changed.

Last Action Type (D) The last type of action to be associated with the document.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.

Owner/Sender (D) Owner/Sender of the document.

Status (D) Document status: Enabled, Hidden, Inherited, Disabled.This object cannot be associated directly to the Document Domain object without the Document Name object. This object can only be used with the Document Name object and User Name (or Group Name) objects in the User Class to query the documents that are enabled or diabled for a user (or group).





Document Domain subclassThis is a subclass of the Documents class that provides information on the domain that contains the documents. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

NOTEIf the Document Domain Creator object is used in a query with other objects from the Document classes, a blank cell appears for the creator name for the following reasons:• the initial system supervisor ID that was used to create the two first domains

is no longer available• the supervisor who created the domain has been deleted from the repository To retrieve creator names, you need to keep all the supervisors who created the document and universe domains in the repository. You cannot display the creator name of the initial domains.

This object... ReturnsDocument Domain (D) The list of document domain names.

Document Domain Creator (D)

The name of the user who created the document domain.

Document Domain Creation Date (D)

The date that the domain was created.

Last Action Date (D) Date on which the document was most recently changed.

Last Action Type (D) The last type of action to be associated with the document domain.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.




Data Providers subclassThis is a subclass of the Documents class that is used to supply information on the provision of data. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

Received By subclassThis is a subclass of the Documents class that provides information on the users receiving documents from the corporate repository. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsData Provider Name (D)

Name of the data provider.

Data Provider Source (D)

Information about the origin of the data in the data provider: universe name, file path, or name of query.No values are shown for third-party documents

Duration (D) Time, in seconds, that it took to run the query.

Last Refresh Date (D)

Last refresh date of the data provider.

Number of Rows (D)

Number of rows in the query.

Partial Indicator (D)

Information on the data provider, indicating whether the results are Partial or Total.

This object... ReturnsRecipient Function (D)

User profile as set in Supervisor: General Supervisor, Supervisor, Designer, Supervisor-Designer, User, Broadcast Agent, or Versatile.

Recipient Name (D)

User name of the recipient.

Recipient Name (with label) (D)

User name of the recipient, preceded by the text string “Recipient Name.”




Universe Domain subclassThis is a subclass of the Documents class that provides information on the domain that contains the universes. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

NOTEIf the Universe Domain Creator object is used in a query with other objects from the Universe classes, a blank cell appears for the creator name for the following reasons:• the initial system supervisor ID that was used to create the two first domains

is no longer available• the supervisor who created the domain has been deleted from the repository To retrieve creator names, you need to keep all the supervisors who created the document and universe domains in the repository. You cannot display the creator name of the initial domains.

This object... ReturnsUniverse Domain (D) The list of universe domain names.

Universe Domain Creator (D)

The name of the user who created the universe domain.

Universe Domain Creation Date (D)

The date that the domain was created.

Last Action Date (D) Date on which the universe domain was most recently changed.

Last Action Type (D) The last type of action to be associated with the universe domain.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.




Universe classThis class provides universe setup information. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This Object... ReturnsFile Name (D) The eight-byte name of the universe file (the

downloaded universe file is stored locally as a *.unv file).

Last Update Time (M) Time of the last universe update.

Objects Filter (De) Objects filter for the universe, set in Supervisor.

Row Restriction (De) Row restriction for the universe, set in Supervisor.

Status (M) Universe status: Enabled, Hidden, Inherited, or Disabled.

Table Mapping (De) Table mapping for the universe, set in Supervisor.

Universe Description (De)

The first 256*2 characters of the universe description.

Universe Domain (D) Name of the universe domain.

Universe ID (D) Universe ID.

Universe Name (D) Name of the universe.

Universe Revision (De) Revision number of the universe.




Connection classThis class provides universe connection data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsConnection Name (D)

Name of the universe connection.

Connection RDBMS (D)

ID of the database middleware.

Connection Type (D)

Connection type: Document Domain, Universe Domain, or Secured.


Date on which the universe connection was most recently changed.


The last type of action to be associated with the universe connection.Values that can be returned include: Unchanged, Deleted, Inserted, Updated, or Moved.




Repository Analysis incompatibilitiesThe following table lists the objects in the Repository Analysis universe that are known to be incompatible with each other:

This object... in Class... is incompatible with this object...

in Class

Data Provider Universe Data Providers Universe Domain Universe

Data Provider Universe Data Providers Universe Name Universe

Data Provider Universe Data Providers File Name Universe

Data Provider Universe Data Providers Status Universe

Data Provider Universe Data Providers Connection Name Universe

Data Provider Universe Data Providers Connection RDBMS Universe

Data Provider Universe Data Providers Connection Type Universe

Data Provider Universe Data Providers Last Action Date Universe

Data Provider Universe Data Providers Last Action Type Universe

Status Documents Universe Domain Universe

Status Documents Universe Name Universe

Status Documents File Name Universe

Status Documents Status Universe

Status Documents Connection Name Connection

Status Documents Connection RDBMS Connection

Status Documents Connection Type Connection

Status Documents Last Action Date Connection

Status Documents Last Action Type Connection



Universe domain analysis universe

Universe domain analysis universeThis section lists the classes in the Universe Domain Analysis universe, and the objects that are available for selection within each class.

Universe parameters classThis class provides information on the maintenance of universes. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsCreation Date (D)

Date on which a universe was created.

Filename (D) The eight-byte name of the universe file. The downloaded universe file is stored locally as a *.unv file.

Filename (with label) (D)

The eight-byte name of the universe file, preceded by the text string “Filename”.

First Author (D) Original creator, user ID, of a universe.

Last Author (D) ID of the user who last updated a universe.

Last Modify Date (D)

Date on which a universe was last modified.

Linked Universe ID (D)

ID of the linked universe, if applicable.

Linked Universe Name (D)

Name of the linked universe, if applicable.This object applies only to linked universes, and not to classes and objects in the current universe

Max Number Of Columns (D)

Maximum number of columns allowed in queries for the selected universe.

Max Number of Lines (D)

Maximum number of rows that can be returned for the selected universe.

Max Query Time (D)

Maximum query time, in seconds, allowed by the selected universe.

Number of Linked Universes (M)

Number of other universes to which the selected universe is linked in the repository.




Class details classThis class provides information on universe classes. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

Number of Universes (M)

Number of universes in the repository.

Universe Help Text (D)

Help text available when selecting and opening a universe.This object does not apply to linked universes, but rather only to the current universe.

Universe ID (D) Internal ID associated with a universe.

Universe Name (D)

Name of a universe.

Universe Name (with label) (D)

Name of a universe, preceded by the text string “Universe Name”.

Universe Name (with ID) (D)

Name of a universe, with its internal ID.

Version (D) Version number of a universe.This object does not apply to linked universes, only to the current universe.


This object... ReturnsClass Description (D) Description of a class.

Class Hidden (D) Yes for a hidden class, or No for a visible, user-enabled class.All the classes listed in this guide have a Class Hidden value of No.

Class ID (D) ID of a class.

Class Name (D) Name of a class.

Class Name (with label) (D)

Name of a class, preceded by the text string “Class Name.”

Number of Classes (M) Number of unique universe classes.




Object details classThis class provides universe object data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

Advanced subclassThis is a subclass of the Object Details class that provides further information on objects, particularly relating to security. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsHidden Object (D) Yes for a hidden object, or No for a user-enabled

object.

Number of Objects (M) Number of distinct objects.

Object Description (D) Help text for an object.

Object ID (D) ID of an object.

Object Name (D) Name of an object.

Object Name (with label) (D)

Name of an object, preceded by the text string “Object Name.”

Object Position (D) Numerical position of an object within its class.

Object Table Name(s) (D)

Table names referenced by an object.

Object Type (D) The type of the object: Dimension, Detail, or Measure.

SELECT Clause (D) SQL Select clause for the selected object.

WHERE Clause (D) SQL Where clause for the selected object.

This object... ReturnsIncompatible Table (D)

A list of incompatible table names specified by Designer for proper hierarchy navigation.

Object Properties (D)

The properties of an object.

Object Security Access Level (D)

Public, Controlled, Restricted, Confidential, Private, or Unknown.These values are set individually in Designer.




Condition details classThis class provides information on universe conditions. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsCondition Description (D)

Description of the condition.

Condition Hidden (D) Yes for a hidden condition, No for a user-enabled condition, or Unknown.

Condition ID (D) Condition ID.

Condition Name (D) Condition name.

Condition Position (D) Position of the condition within the universe.

Condition Table Name(s) (D)

A list of table names used in the condition.

Condition WHERE Clause (D)

The Where clause associated with a condition, if applicable.

Incompatible Table (D) A list of incompatible table names, specified in Designer, for proper hierarchy navigation.

Number of Conditions (M)

Total number of conditions.




Universe tables classThis class provides information on universe tables. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

Alias Information subclassThis is a subclass of the Universe Tables class that provides table alias information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsNumber of Tables (M) Total number of unique tables.

Table Name (with label) (D) Name of a table, preceded by the text string “Table Name.”

Table/Alias Name (D) Name of a table (original or alias).

Table/Alias Properties (D) Table/alias properties.

Table ID (D) Table ID.

This object... ReturnsAlias Table ID (D) Alias table ID.

Alias (Y or N) (D) Y (yes) if the table is an alias; otherwise, N (no).

Original Database Table Name (D)

Base table name for an alias.




Joins classThis class provides information on universe joins. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

Contexts classThis class provides data relating to universe contexts. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsJoin ID (D) Join ID.

Join SQL (D) Join SQL.

Number of Joins (M) Number of joins in the universe.

Table 1 Name (D) Name of the first table in the join.

Table 2 Name (D) Name of the second table in the join.

This object... ReturnsContext ID (D) Context ID.

Context Join ID (D) Context join ID.

Context Join SQL (D) Context join SQL.

Context Join Table 1 Name (D) Name of the first table of the context join.

Context Join Table 2 Name (D) Name of the second table of the context join.

Context Name (D) Context name.

Number of Contexts (M) Number of contexts.




Hierarchies classThis class provides information on universe hierarchies. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

Number of Objects in Hierarchies subclassThis is a subclass of the Hierarchies class that provides counts of objects used in hierarchies. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsHierarchy ID (D) ID of a hierarchy.

Hierarchy Name (D) Name of a hierarchy.

Hierarchy Name (with label) (D)

Name of a hierarchy, preceded by the text string “Hierarchy Name”.

Hierarchy Position in Universe (D)

Position of a hierarchy in its universe.

Number of Hierarchies (M) Total number of hierarchies.

Object Name in Hierarchy (D)

Name of an object in a hierarchy.

Object Position in Hierarchy (D)

Position of an object in a hierarchy.

This object... ReturnsNumber of Objects (M) Number of distinct objects in hierarchies.

Number of Object Instances (M)

Number of object appearances (instances) in hierarchies.




Universe Domain Analysis incompatibilitiesThe following table lists the objects in the Universe Domain Analysis universe that are known to be incompatible.


in Classes

Object Security Access Level

Advanced All objects Joins, Contexts and Hierarchies

Class Description Class Details All objects Joins, Contexts and Hierarchies

Condition Name Condition Details

All objects Joins, Contexts and Hierarchies

Context Id Contexts All objects Hierarchies

Object Position Object Details All objects Joins, Contexts and Hierarchies

Table/Alias Name Universe Tables

Table Name Universe Tables


Table Name (with label)

Universe Tables


Alias Table ID Universe Tables



System information universe

System information universeThis section lists the classes in the System Information universe, and the objects that are available for selection within each class.

Actions classThis class provides specific data on user actions. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

This object... ReturnsAction App (D) Name of the application that generated the event.

Action App ID (D) The ID of the application that generated the event.This object provides a better compatibility than Action App Name, which may change between different versions of the Business Objects suite.

Action Error ID (D) Error ID (if applicable).This object is used by the Broadcast Agent Analysis universe to record error codes. See Monitoring Job Information subclass on page 81.

Action Host (D) Business Objects server that generated the event.

Action ID (D) Internal ID used to trace events.

Action Name (D) Name of the event, for example, “Get list of Corporate Documents” or Login.

Action Name ID (D)

ID of the event name.

Action Time (D) Action’s date and time.

Action Type (D) Type of action, such as Repository Name.

Action Type Detail (De)

A breakdown of Action Type, such as “Document” within Repository Name.

Action Type Detail (with label) (De)

A text string in front of Action Type Detail, such as “Object Name: Document”.

Cluster ID (D) Internal ID of the cluster in which the event occurs.

Cluster Name (D) Name of the cluster in which the event occurs.




NOTEWhen you migrate from a previous version of BusinessObjects to BusinessObjects 6.1 the object Cluster ID=0, and Cluster Name='WebIntelligence 2.x Cluster' are not in the audit database. They are generated into virtual views as null values shown as 0 in the 'Cluster ID' objects. This also applies to Cluster Name objects set to 'WebIntelligence 2.x Cluster'.

Session ID (D) InfoView session ID.This can be used to generate traces of the first and last events, and to break down reports by session generated by a user.

User Name (D) Name of the user who generated the event.

User Name (with label) (D)

Name of the user who generated the event, preceded by the text string “User Name.”





Action Details subclassThis is a subclass of the Actions class that provides a variety of information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsNumber of Elements (D)

Number of items in the Inbox, Corporate or Personal document list, or number of universes.This number is logged when a “Get list” event occurs.

Number of Rows (D) Number of rows retrieved back for each action.For each action name, see the “Number of Rows Retrieved” measure in the Action Measure subclass.

Object Name (D) Name of the object.

Object Name (with label) (D)

Name of the object, preceded by the text string “Object Name.”

Repository Name (D) Repository name.

SQL Value (D) SQL statement sent by the system whenever a result is computed or generated.

Total Size of Elements in List (D)

Total size of documents in the Inbox, Corporate or Personal document list.This size is logged when a “Get list” event occurs.

Universe Name (D) Universe name.

Universe Name (with label) (D)

Universe name, preceded by the text string “Universe Name.”




Administration SDK subclassThis is a subclass of the Action Details subclass that provides security information from Administration SDK. When a security property on a user or a group is modified by Administration SDK, an event occurs. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsGroup Name (Administration) (D)

Name of the group which was created or deleted from the Administration SDK.

Object Security Level (D) The security level property of the user:• private• confidential• restricted• controlled• public

Parent Group Name (Administrator) (D)

Name of the group of the user who had Administration SDK security updates, for example, when if a user was created or their profile set.

Password (D) Encrypted value of the User password set by the Administration SDK.

Password Can Change (D) User password event logged when the user password property has been changed.When this parameter is set to 'TRUE', the user will be able to change his password. Otherwise the value is 'FALSE' and the password remains the same.

Password Checking (D) User password event logged when the user password property has been changed.When this parameter is set to 'TRUE', the user will have to check his password. Otherwise the value is 'FALSE' and no check will be asked again.




Password Limited Validity (D)

Three event details logged when the user password periodicity property has been changed:• password limited validity• validity is periodic• validity period (days)When this parameter is set to 'TRUE', the user will have to change his assigned password after a specified fixed number of days (retrieved in Password Validity Period (Days) object).Otherwise the value is 'FALSE', and the validity period is removed.

Password Must Change (D)

User password event logged when the user password property has been changed.When this parameter is set to 'TRUE', the user will have to change his password at the first login. Otherwise the value is 'FALSE' and the password can remain the initial assigned password.

Password Periodic Validity (D)

Three event details logged when the user password periodicity property has been changed:• password limited validity• validity is periodic• validity period (days)When this parameter is set to 'TRUE', the user will have to change his assigned password after a specified number of days (retrieved in Password Limited Validity object) on a cyclic mode. Otherwise the value is 'FALSE', and the periodic property is removed

Password Status (D) User password enabled or not by the Administration SDK.





Browser information subclassThis is a subclass of the Action Details subclass that provides information about the client’s browser when a login event occurs. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

Password Validity Period (Days) (D)

User password property: number of days that can elapse before the user is required to change their password.

Profile Name (D) User profile setting:• private• confidential• restricted• controlled• public

User Name (Administration) (D)

Name of the user who had Administration SDK security updates, for example, when if a user was created or their profile set.

This object... ReturnsBrowser Type (D) Version and type of Internet browser.

Client IP (D) Internet Protocol (IP) address of the client.

Client OS (D) Version and type of operating system.





Document subclassThis is a subclass of the Action Details subclass. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsDocument Category (D) Category of the document.

Document Description (D) Document description.

Document ID (D) Document ID.

Document Name and Type (D)

Document name and type.

Document Name (with label) (D)

Name of the document, preceded by the text string “Document Name.”

Document Type (D) Three-character document suffix, such as .rep, .wid and .wqy.

Keyword (D) Keyword entered when a Publish/Send/Save event occurs.

Overwrite (D) Option selected when a Publish/Save event occurs.Values are “True” or “False.”

Refresh Options (D) Refresh options entered when a Publish/Send/ Save event occurs.Values for third-party documents are:• “Refresh on open”• “Refresh manually”• “Scheduled refresh”• “None”

User Name (Target) (D) Distinct destination groups when a Publish/Save event occurs.There is one row generated for each target entered.




Page information subclassThis is a subclass of the Action Details subclass that provides page information when a Get Page event occurs or when an Apply Format event occurs (Report Name detail only). The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsDocument Type (D) Three characters document extensions, for example

.xls, .pdf, and .xml, when a Get Page event occurs.

Page Range (D) Page Range when a Get Page event occurs.

Report Name (D) Report Name when a Get Page or an Apply Format event occurs.




Action Measures subclassThis is a subclass of the Actions class that is used to quantify user actions. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsAction Duration (sec) (M)

Total duration of an event, in seconds. Actual action durations are stored in milliseconds, and any unknown action values are returned as NULL.

Count (M) A generic count. Use this object in combination with another object to count the number of occurrences. It is not specific to a particular data type.

Document Size (M) Document size in bytes. This is a non-aggregate object, returning all sizes individually without adding them together.

Number of Action Details (M)

Total number of items associated with each user action.

Number of Actions (M) A count of the number of actions recorded

Number of Documents Used (M)

Number of documents that have been accessed.

Number of Log Offs (M) Number of log offs.

Number of Logins (M) Number of attempted logins.

Number of Rows Retrieved (M)

Number of rows retrieved from a document.

Number of Sessions (M)

Number of complete user sessions.

Number of Users (M) Number of user sessions opened so far.




Session Duration (hour) (M)

Total duration of a complete session, in hours.Use this object in conjunction with:• the Session ID object (see Actions class on

page 109). Otherwise, action times, and not session times, are returned.

• the User Name object to return session times by user.

Session Duration (min) (M)

Total duration of a complete session, in minutes.Use this object in conjunction with:• the Session ID object (see Actions class on

page 109). Otherwise, action times, and not session times, will be returned.

• the User Name object to return session times by user.

Sum Document Size (M)

Total size of a document, in bytes.Use this object in conjunction with the Document Name object (Actions class on page 109) to return bytes per document.





Averages subclassThis is a subclass of the Action Measures subclass that provides data based on a series of actions over time. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsAvg Action Duration (sec) (M)

Average duration of an event, in seconds.

Avg Actions per Day (M) Average number of actions over a month, divided by 30.

Avg Actions per Hour (M)

Average number of actions over a day, divided by 24.

Avg Actions per Month (M)

Average number of annual actions, divided by 12.

Avg Document Size (M) Average document size, in bytes.

Avg Rows Retrieved (M)

Average number of rows retrieved via user queries.

Avg Session Duration (hour) (M)

Total session time over a day, divided by 24.You must use this object with the Session ID object (Actions class on page 109). Otherwise, your results may not be accurate.

Avg Session Duration (month) (M)

Total session time over a month, divided by 30.You must use this object with the Session ID object (Actions class on page 109). Otherwise, your results may not be accurate.

Avg Session Duration (week) (M)

Total session time over a week, divided by 7.You must use this object with the Session ID object (Actions class on page 109). Otherwise, your results may not be accurate.

Avg Users per Day (M) Number of unique user sessions, divided by 30.

Avg Users per Hour (M) Average number of user sessions that were started per hour.

Avg Users per Month (M)

Average number of user sessions that were started per month.




Action Time subclassThis is a subclass of the Actions class that provides the timing of user actions. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsAction Day (D) Day on which an action took place.

Action Hour AM/PM (D) Hour in which an action took place, in AM/PM format.

Action Hour (D) Hour in which an action took place, in 24-hour format.

Action HHMISS (D) Hour in which an action took place, in 24-hour format and in minutes and seconds.Example: 17:53:59 = 5:53 pm and 59 seconds

Action Minutes (D) Number of minutes past the hour in which an action took place.

Action Month (D) Number of the month in which an action took place.

Action Month Name (De)

Name of the month in which an action took place.

Action Quarter (D) The quarter in which an action took place, such as Q4.

Action Seconds (D) Number of seconds after the minute in which an action took place.

Action Week (D) Number of the week in which an action took place.

Action YYYY (D) Year (YYYY) in which an action took place.

Action YYYY-MM (D) Year (YYYY) and month (MM) in which an action took place, such as 2001-01 for January 2001.

Action YYYY-MM-DD (D)

Year (YYYY), month (MM), and day (DD) on which an action took place, such as 2001-01-25 for January 25, 2001.

Action YYYY-MM-DD HHMISS (D)

Start time (to the second) of the event, in the format YYYY/MM/DD HH:MM:SS; for example, 2001/09/25 17:35:59 for 5:35 pm and 59 seconds on September 25, 2001.




Last Action Start Time (D)

Start time (to the second) of the event for a given event type.For example, it is used to retrieve the last time a refresh was performed.

Session End Time (D) Time at which a user’s session ended, in the format YYYY/MM/DD HH:MM:SS.Use this object in conjunction with the Session ID object (Actions class on page 109). Otherwise, action times, and not session times, will be returned.

Session Start Time (D) Time at which a user’s session started, in the format YYYY/MM/DD HH:MM:SS.Use this object in conjunction with the Session ID object (Actions class on page 109). Otherwise, action times, and not session times, will be returned.





Action Time Frame (with label) subclassThis is a subclass of the Action Time class that enables you to return text strings for action times. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsAction Day (with label) (D)

Text string for the day on which an action took place, such as “Day: 28”.

Action DD/MM (with label) (D)

Text string “Action Start Time” preceding the day and month in which an action took place, such as “Action Start Time: 25/09”.

Action Hour (with label) (D)

Text string for the hour in which an action took place, such as “Hour: 03”.

Action Minutes (with label) (D)

Text string for the minutes past the hour in which an action took place, such as “Minutes: 46”.

Action MM/DD (with label) (D)

Text string “Action Start Time” preceding the month and day on which an action took place, such as “Action Start Time: 09/25”.

Action Month (with label) (D)

The month.

Action Month Name (with label) (De)

Text string for the month in which an action took place, such as “Month: 12”.

Action Quarter (with label) (D)

Text string for the quarter in which an action took place, such as “Quarter: Q4”.

Action Seconds (with label) (D)

Text string for the seconds after a minute in which an action took place, such as “Seconds: 50”.

Action Week (with label) (D)

Text string for the week in which an action took place, such as “Week: 51”.

Action Year (with label) (D)

Text string for the year in which an action took place, such as “Year: 2001”.




Session analysis (no actions) classThis class provides session data that is not action-related. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.

NOTEThe objects in the Session Analysis (No Actions) subclass are not designed to be used with objects of the Actions class. The two sets of objects should not be mixed when creating and editing indicators.


This object... ReturnsCluster ID (D) Internal ID of the cluster in which the session occurs.

Cluster Name (D) Name of the cluster in which the session occurs.

Session Host (user IP) (D)

IP address of the session host.

Session User (D) Session user name.

Session User (no 'unknown' users) (D)

Session user name, if known.This object filters out “unknown” users.

Session End Time (D) Session end time, in the format YYYY/MM/DD HH:MM:SS, for example, 2001/09/25 17:35:59 for 5:35pm and 59 seconds on September 25, 2001

Session ID (D) Session ID.

Session Start Time (D) Session start time, in the format YYYY/MM/DD HH:MM:SS, for example, 2001/09/25 16:30:29 for 4:30 pm and 29 seconds on September 25, 2001




Session Measures subclassThis is a subclass of the Session Analysis (No Actions) class that allows you to measure the number and duration of sessions.

NOTEThe objects in the Session Measures subclass are not designed to be used with objects of the Actions class. The two sets of objects should not be mixed when creating and editing indicators.

The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsNumber of Sessions (M) Number of completed user sessions.

Number of Session Users (M) Number of users who opened sessions.

Session Duration (sec) (M) Total session duration, in seconds.

Session Duration (min) (M) Total session duration, in minutes.

Avg Session Duration (sec) (M) Average session duration, in seconds.

Avg Session Duration (min) (M) Average session duration, in minutes.




Session Time subclassThis is a subclass of the Session Analysis (No Actions) class that enables you to view the times at which sessions took place.

NOTEThe objects in the Session Time subclass are not designed to be used with objects of the Actions class. The two sets of objects should not be mixed when creating and editing indicators.

The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.

This object... ReturnsSession Day (D) The day number, such as 05 for the fifth day.

Session Duration (1 min intervals) (D)

Time blocks of one minute.Can be used by the Visit Duration indicator to divide session times into intervals of one minute, instead of the default five minutes

Session Duration (5 min intervals) (D)

Time blocks of five minutes. Used as the default setting by the Visit Duration indicator to divide session times into five minute intervals.

Session Hour (D) Time of a session in 24-hour format.

Session Minutes (D) Minutes past the hour in which a session took place.

Session MM (D) Month in which a session took place, such as 03 for March.

Session Quarter (D) The quarter in which a session took place, such as Q2.

Session Start (D) Unformatted session start time.

Session Week (D) Week in which a session took place, such as 52 for the last week of the year.

Session YYYY (D) Year in which a session took place.

Session YYYY-MM (D) Year and month of a session.

Session YYYY-MM-DD (D) Year, month, and day of a session.




Site log info classThis class provides you with process logging. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.


This object... ReturnsCluster ID (D) Internal ID of the cluster in which the site log

occurs.

Cluster Name (D) Name of the cluster in which the site log occurs.

Log Host (D) The host a user is logged onto.

Log ID (D) ID of the log file.

Log Info (D) Information on the log file.

Log Level (D) Level of the log file.

Log Module (D) The log module.

Log PID (D) The log Personal Identifier.

Log Time (D) Time of the log creation.




System information incompatibilitiesThe following table lists the objects in the System Information universe that are known to be incompatible.


in Classes

Number of Log Offs

Action Measures

All objects Action Measures, Averages, Action Time

Number of Sessions

Action Measures

Avg Document Size

Averages

Number of Sessions

Action Measures

Avg Rows Retrieved

Averages

Number of Sessions

Action Measures

All objects Session Measures

Avg Users per Month

Averages Avg Users per Day Averages

Avg Users per Month

Averages Avg Users per Hour

Averages

Avg Actions per Month

Averages Avg Actions per Day

Averages


Averages Avg Actions per Hour

Averages


Averages Number of Sessions

Session Measures


Averages Number of Session Users

Session Measures


Averages Session Duration (sec)

Session Measures


Averages Session Duration (min)

Session Measures


Averages Avg Session Duration (sec)

Session Measures


Averages Avg Session Duration (min)

Session Measures




Avg Actions per Day


Session Measures

Avg Actions per Day


Session Measures

Avg Actions per Day


Session Measures

Avg Actions per Day


Session Measures

Avg Actions per Day


Session Measures

Avg Actions per Day


Session Measures

Avg Actions per Hour


Session Measures



Session Measures



Session Measures



Session Measures



Session Measures



Session Measures


in Classes


part

Using Auditor


chapter

Using Predefined Indicators




OverviewThis chapter provides a detailed review of the predefined indicators. The content is divided into two parts:• an alphabetical list of all indicators• a detailed description of the indicators, divided into analytical categories.

Each category has a number of subcategories, which further organize indicators for ease of access.

Indicators access full-client (*.rep) documents.

Why are predefined indicators important?Auditor uses predefined indicators to give you access to the information you need in order to monitor, analyze, and optimize your Business Objects deployment. These indicators are delivered as part of the Auditor package.Each indicator contains one or more reports that focus on a very specific area of analysis; for example, the Average Refresh Time indicator, which shows the average refresh time (in seconds) for all documents, broken down by document name, user, document type, and node.Predefined indicators are your key to information such as: • the users accessing and utilizing your system• the most popular reports and universes• the number of reports that are impacted by changing an objectFor monitoring and analysis that is even more finely tuned to your particular system, you can create your own indicators.



Predefined indicators available with Auditor

Predefined indicators available with AuditorThe following table lists all the predefined indicators provided with Auditor.

Indicator Category Subcategory10 Least Read Documents Document Management Top 10 & Bottom 10

10 Least Exported Documents

Document Management Top 10 & Bottom 10

10 Most Read Documents Document Management Top 10 & Bottom 10

10 Most Exported Documents

Document Management Top 10 & Bottom 10

Average Number of Users Concurrently Logged in

System Information Traffic

Average Refresh Time Document Management Usage

Average Session Duration per Cluster


Average Session Duration per User


Average Session Duration System Information Traffic

Broadcast Agents on the System

Broadcast Agent Global Console

Cluster Nodes System Information Usage

Deactivated Users User Information Security

Document Information Detail Document Management Analysis

Document Information Summary

Document Management Analysis

Document Size in Repository Document Management Analysis

Document Usage Document Management Usage

Documents Never Read Document Management Analysis

Impact Analysis Universe Management Impact Analysis

IP Addresses Accessing my Audited Clusters

System Information Security




Job Success Rate Broadcast Agent Job Information

Job Summary Broadcast Agent Job Information

Jobs per BCA Broadcast Agent Job Information

Jobs per Frequency Broadcast Agent Job Information

Jobs per User Broadcast Agent Job Information

Joins per Universe Universe Management Properties

Last Login for User User Information Activity

Most Active Users User Information Top 10 & Bottom 10

Most Popular Actions User Information Activity

Most Popular Actions per Document

Document Management Analysis

Most Popular Universes Universe Management Usage

Number of Objects per Universe

Universe Management Properties

Number of Users in the Repository

User Information Activity

Number of User Sessions User Information Activity

Objects Accessed Universe Management Usage

Objects Used in Documents Document Management Analysis

Peak Usage System Information Usage

Refresh and Edit Activity User Information Activity

Total Users Concurrently Logged in by Day


Types of Browsers in Use System Information Usage

Universe Information Detail Universe Management Properties

Universe Information Summary

Universe Management Properties

Universe Usage Universe Management Usage

User Activity User Information Activity

Indicator Category Subcategory



Predefined indicators available with Auditor

User Activity per Session User Information Activity

User Information Detail User Information Security

User Information Summary User Information Security

User Profiles in the Repository

User Information Security

Users Who Logged Off Incorrectly

User Information Activity

Indicator Category Subcategory




User Information categoryThe User Information category provides analysis of user activity, enabling you to monitor resource usage and examine security-related details. For example, you can track session duration, or view a detailed breakdown of user actions per time period.The User Information predefined indicators are divided into the following subcategories:• activity• security• top 10 & bottom 10

Business QuestionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the User Information category.

This business question... Opens this indicatorWhat is the total number of users? Number of Users in the

Repository

What are my user profiles? User Profiles in the Repository

What is my user activity by month, week, day? User Activity

Whose passwords have been deactivated? Deactivated Users

What are the most popular actions? Most Popular Actions

Who does not log out correctly? Users Who Logged Off Incorrectly

When was the last time users logged in? Last Login for User

Are my users editing reports or only refreshing them?

Refresh and Edit Activity



User Information category

ActivityAuditor provides the following predefined indicators for the Activity subcategory within the User Information category.

This indicator... Provides... Via these reportsLast Login for User

Last date and time to the second that a given user logged in to the system.

• Last Login for User

Most Popular Actions

Quantity of the most popular actions during a given time period.

• Most Popular Actions per Year

• Most Popular Actions per Quarter

• Most Popular Actions per Month

• Most Popular Actions per Week

• Most Popular Actions per Day

Number of Users in the Repository

Number of users in the repository, along with the following information about them:• how many have logged in at

least once• how many occurrences for

each user• how many users have never

logged in

• Number of Users in the Repository

• Number of Instances per User

• Active and Inactive Users

Number of User Sessions

Total number of user sessions by cluster, year, month, week, and day.

• Number of Sessions Per Month

• Number of Sessions Per Week

• Number of Sessions Per Day





Number of edit and refresh actions per document trace, per cluster and per selected user over the whole period edited in the audit database.

• Refresh Actions per User

User Activity Number of users using the system, for each month, week, or day within a given time period.You are prompted for the start and end dates of the time period.

• User Activity per Month

• User Activity per Week

• User Activity per Day

User Activity per Session

Analyzes user activity for the whole content of the audit database per cluster, session, action and date.

N/A

Users Who Logged Off Incorrectly

Of the users who logged in during a given year:• total number of users• total number of logins• number of log off actions• number of users who logged

off incorrectly• percentage of users who

logged off incorrectly• breakdown of above

information by user

• Statistics• Users Who Logged

Off Incorrectly

This indicator... Provides... Via these reports



User Information category

SecurityAuditor provides the following predefined indicators for the Security subcategory within the User Information category.

This indicator...

Provides... Via these reports

Deactivated Users

List of deactivated users and their profiles.

• Deactivated Users• Disabled Logins• Users Not Active in Last

30 Days

User Information Detail

List of users and the groups to which they belong.For each separate membership instance, the following are shown:• user profile• user status• failed logins• user level• identification strategyThe security commands for a given user are classified by command sets.

• User Instance Status• User Instance Security

Commands

User Information Summary

Users in each user group.For each user, the following are shown:• user name• user profile• status

Users and Groups

User Profiles in the Repository

• of the total number of users in the repository, the percentage in each profile

• a list of deactivated users• total number and names of

users for each profile

• User Profiles• Deactivated Users• User Names per Profile




Top 10 & Bottom 10Auditor provides the following predefined indicators for the Top 10 & Bottom 10 subcategory within the User Information category.

This indicator... Provides... Via these reportsMost Active Users Number of logins and

refreshes for each of the top ten users.

• Top 10 Users by Number of Logins

• Top 10 Users by Number of Refresh Actions



Document Management category

Document Management categoryThe Document Management category provides analysis of document use, as well as information about the documents themselves. For example, you can monitor the most popular and least popular documents, or find out which documents have never been read.Document Management is divided into the following subcategories:• analysis• top 10 & bottom 10• usage

Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the Document Management category.

This business question... Opens this indicatorWhat are my 10 most popular documents? 10 Most Read Documents

What are my 10 least popular documents? 10 Least Read Documents

Which documents have never been opened? Documents Never Read

What is my average document size? Document Size in Repository

How many objects are in each document? Objects Used in Documents

How many users have unread reports in their inbox?

Documents Never Read

What are the 10 most frequently exported documents?


What is the average time needed for reports to refresh?

Average Refresh Time




AnalysisAuditor provides the following predefined indicators for the Analysis subcategory within the Document Management category.

This indicator...


Document Information Detail

• total number of documents past and present in the repository

• alphabetical list of documents and their types.

• actions performed on a given document, classified by type of action.

• batch jobs performed per document. Overall number (and percentage) of successes and failures for each Broadcast Agent is shown.

• Document Information

• Document Usage

• Batch Usage

Document Information Summary

For each document domain:• total size in KB of all documents, by type• number and percentage of documents for

each document type• list of analytical categories, showing for

each category the creator, total size in KB and number of all documents, and the percentage of documents in each type

• document name, type, ID, and size• percentage and total size in KB of

documents held by each userFor each document owner:• total number and size of documents• a list of documents classified by type,

showing document name, domain, creation date, and size in KB

• Document Domain

• Top 10 Document Owners





List of documents for which there are no events “read corporate document” or “read inbox document” in the audit database.

• Documents Never Read in Corporate

• Documents Never Read in User Inbox

Document Size in Repository

total space used by all:• inbox documents• corporate documents

• Document Size in Corporate

• Document Size in User Inbox

Most Popular Actions per Document

Most popular actions taken for a given document by:• user• session• action name• date

N/A

Objects Used in Documents

• average number of objects for each type of document

• list of objects contained in each document, with the total number of objects

• 20 most and least frequently used objects for each type of document. Objects are listed in order of rank

• Average Number of Objects per Document Type

• Objects Used per Document

• 20 Most Used Objects per Document Type

• 20 Least Used Objects per Document Type

This indicator...





Top 10 & Bottom 10Auditor provides the following predefined indicators for the Top 10 & Bottom 10 subcategory within the Document Management category.

This indicator...


10 Least Exported Documents

List of documents for which there are the least number of respective events:• download documents• send to users• get a CSV document

• 10 Least converted to CSV

• 10 Least Sent to Users

• 10 Least Downloaded

10 Least Read Documents

Number of times:• the 10 least read documents were

read• the 10 least refreshed documents

were refreshed• the 10 least edited documents

were edited

• 10 Least Read• 10 Least

Refreshed• 10 Least Edited


List of documents for which there are the most respective events:• download documents• send to users• get a CSV document

• 10 Most Converted to CVS

• 10 Most Sent to Users

• 10 Most Downloaded

10 Most Read Documents

Number of times:• the 10 most read documents were

read• the 10 most refreshed documents

were refreshed• the 10 most edited documents

were edited

• 10 Most Read• 10 Most Refreshed• 10 Most Edited




UsageAuditor provides the following predefined indicators for the Usage subcategory within the Document Management category.

This indicator... Provides... Via these reportsAverage Refresh Time

The average refresh time per document, user, or cluster over the whole period covered in the audit database.

• Average Refresh Time per Document

• Average Refresh Time per User

• Average Refresh Time per Cluster

Document Usage Lists:• the repository documents for

which there are no events in the audit database

• the documents for which events were audited but that are no longer referenced in the repository

• the most accessed documents

• the least accessed documents

• audit actions distribution for each document

• Documents Never Accessed

• Documents Deleted from Repository

• Most Accessed Documents

• Least Accessed Documents

• Document Usage




Universe Management categoryThe Universe Management category provides detailed analysis of universe structures, such as tables, joins, classes, and objects. This information enables you to analyze the potential impact of:• database schema modifications on universes• universe modifications on your Business Intelligence systemIn addition, universe and object hit information allows you to bill extranet users according to the repositories and objects they access.Universe Management is divided into the following subcategories:• impact analysis• properties• usage

Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the Universe Management category.

This business question... Opens this indicatorHow many universes do I have? Universe Information

Summary

How many documents do I have in each universe?

Impact Analysis

Which documents (already in use) are impacted if I modify an object?

Impact Analysis

Which joins are used in my universes? Joins by Universe

Which connections are my universes using? Universe Information Summary

Which are the most popular universes? Most Popular Universes



Universe Management category

Impact analysisAuditor provides the following predefined indicators for the Impact Analysis subcategory within the Universe Management category.

This indicator...


Impact Analysis

• number of documents in each universe

• number of objects in each document

• list of all the objects used in each document

• Number of Documents per Universe

• Number of Objects per Document

• Objects Used in Documents




PropertiesAuditor provides the following predefined indicators for the Properties subcategory within the Universe Management category.

This indicator...


Joins per Universe

Joins for the currently selected universe. A join is a relational operation causing two or more tables with a common domain to be combined into a single table.For each join: • join ID• associated tables• join SQL string

Joins by Universe

Number of Objects per Universe

Number of objects in each universe.Filters are available for:• universe• class• object

• Universe Classes

• Universe Objects

Universe Information Detail

Prompt on the universe name. • Universe Tables

• Classes and Objects

• Conditions• Contexts• Hierarchies



Universe Management category


• number of universes in the current domain, and in all the domains in the repository.For each universe:- domain- number of revisions- status (enabled/disabled)- time of last update- description- whether there is a filter- row restrictions- table mapping- connection name, database, and type- last action date and type- file name- creation date- first and last authors- maximum number of lines and columns- maximum query time (in seconds)

• number of times each universe was accessed, per quarter.

• for each universe, a list of documents classified by document domain. For each document:- Document name and type- Document category and size (in KB)- Creation date

• Universe Summary

• Universe Usage

This indicator...





UsageAuditor provides the following predefined indicators for the Usage subcategory within the Universe Management category.

This indicator...


Most Popular Universes

Number of actions for each universe, by month or week, during a given year. Universes are listed in order of rank.

• Most Popular Universes per Month

• Most Popular Universes per Week

Objects Accessed

List of all objects used in the universe showing:• the documents they appeared in • the number of times the object was

accessed

• Objects Accessed per Month

• Objects Accessed per Day

Universe Usage

Universe usage since a chosen date. • Universes Never Accessed

• Universes Deleted from Repository

• Universe Usage



Broadcast Agent category

Broadcast Agent categoryThe Broadcast Agent category provides an overview of how Broadcast Agent is used, including job scheduling, success rate, and sender/receiver details. The Broadcast Agent category in Auditor is divided into the following subcategories:• global console• job information

Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the Broadcast Agent category.

Global consoleAuditor provides the following predefined indicators for the Global Console subcategory within the Broadcast Agent category.

This business question... Opens this indicatorHow many Broadcast Agents do I have? Broadcast Agents on the System

How many tasks were processed by BCA? Jobs per BCA

How many tasks are pending on BCA? Job Summary

What is the success rate of Broadcast Agent jobs?

Job Summary

This indicator... Provides... Via these reportsBroadcast Agents on the System

Correspondence between Broadcast Agents and cluster nodes, along with the duration of jobs per Broadcast Agent.

• Broadcast Agents and Cluster Node Locations

• Broadcast Agents and Duration of Jobs (sec)




Job informationAuditor provides the following predefined indicators for the Job Information subcategory within the Broadcast Agent category.

This indicator... Provides... Via these reportsJob Success Rate

Analysis per error code, job frequency, document, and current connection of the universe on which the document is based.

• Failure Distribution• Failure per BCA Error• Failure per Frequency• Failure per Document

Job Summary Job status per Broadcast Agent. • Jobs per Status• Pending Jobs• Successful Jobs• Failed Jobs

Jobs per BCA Job status per Broadcast Agent.For each job, these details are shown: • user name• job description• job platform• priority• frequency• begin time• job status (success or failed)

• Jobs per Broadcast Agent – Summary

• Jobs per Broadcast Agent

• Jobs per Node Location

Jobs per User Breakdown of Broadcast Agent jobs according to user.

• Jobs per User – Summary

• Jobs per User• Job Duration per User

(sec)• Job Failure per User

Jobs per Frequency

Analysis of Broadcast Agent jobs by frequency.

• Frequency Distribution

• Frequency Detail



System Information category

System Information categoryThe System Information category provides analysis of trends in BusinessObjects usage. For example, you can check the number of connected users, average session duration, or the number of rows retrieved. This category is also useful for the detection of fraud.The System Information indicators are divided into the following subcategories:• security• traffic• usage

Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the System Information category.

This business question... Opens this indicatorWhat is the average session duration? Average Session Duration per User

Which types of browser are being used?

Types of Browsers in Use

How many servers do I have? Cluster Nodes

How many users are on my system? Average Number of Users Concurrently Logged In

Who uses my system the most? Refresh and Edit Activity

Which IP addresses are being used to access my BI server solution and how often?


How many users are accessing my system daily and when is the most popular time?

Average Number of Users Concurrently Logged In




SecurityAuditor provides the following predefined indicators for the Security subcategory within the System Information category.

This indicator... Provides... Via these reportsIP Addresses Accessing my Audited Clusters

During a given time period:• list of the IP addresses

accessing the clusters, with the total number of addresses

• number of actions performed on each IP address

• IP Addresses Accessing my Audited Clusters per Year

• IP Addresses Accessing my Audited Clusters per Month




TrafficAuditor provides the following predefined indicators for the Traffic subcategory within the System Information category.

This indicator...


Average Session Duration per Cluster

For each cluster or host machine during a given year or set of years, the average session duration (in minutes) per time period.The information is aggregated for the selected years in the Average Session Duration in Minutes over the Period report.

• Average Session Duration in Minutes over the Period

• Average Session Duration in Minutes per Week

• Average Session Duration in Minutes per Day


For each user during a given year, the average session duration (in minutes) per time period.

• Average Session Duration in Minutes Over the Year

• Average Session Duration in Minutes per Month per User

• Average Session Duration in Minutes per Week per User




Average Session Duration

For any selected group of users, the average session duration per user by:• year• quarter• month• week• day• hour

N/A


For a given month:• average number of

concurrent sessions during each hour

• names and number of users concurrently logged in during each hour

• Average Number of Concurrent Logged In Sessions

• Users Concurrently Logged In

• Average Users Concurrently Logged In

Total Users Concurrently Logged In by Day

For a given day:• total number of concurrent

sessions during each hour• names and total number of

users concurrently logged in during each hour

• Total Number of Concurrent Logged In Sessions

• Users Concurrently Logged In

This indicator...





UsageAuditor provides the following predefined indicators for the Usage subcategory within the System Information category.

This indicator... Provides... Via these reportsTypes of Browsers in Use

• types of browser being used and the percentage for each one

• number of logins for each type of browser

• Types of Browser• Number of Logins per

Browser

Cluster Nodes • for each cluster, the number of nodes and the number of active modules

• for each module, the last known status and the date and time of the last update

• Servers in the Cluster• Module’s Last Known

Status

Peak Usage An aggregate for a set of selected years and the model of a "typical day" for logins, sessions, and number of actions No for a specified time period.

• User Login Peaks• Session Login Peaks• Number of Action

Peaks


chapter

Creating, Modifying, and Publishing Indicators




OverviewThis chapter explains how to create, modify, and publish indicators in Auditor. In Auditor, you can modify a predefined indicator, and then save it under a new name. For monitoring and analysis that is even more finely tuned to your particular system, you can create your own, entirely new indicators.



Universes, classes, and objects

Universes, classes, and objectsKnowledge of universes is important for understanding the elements used in creating and modifying indicators. For example, it is the universe that determines the objects that are available for building a new indicator.Auditor is delivered with the following predefined universes that enable you to immediately carry out monitoring and analysis activities.

The predefined universes are attached to different domains. These domains are connected to databases during installation, prior to export of the universes.

Each universe provides an interface for different classes of database objects, permitting compatible objects to be used in building queries using the BusinessObjects Query Panel.The Query Panel is displayed in Auditor following the selection of either:• the Add a New Indicator command• the Edit option for an existing indicatorThe objects available in the selected universe are listed in the BusinessObjects Query Panel.If you are modifying an existing indicator, one or more universes are already associated with the query. If you are creating a new indicator, you can choose the universe that is associated with the query.

Universe File nameBroadcast Agent Analysis BCA.unv

Repository Analysis SECURITY.unv

Universe Domain Analysis UNIVERSE.unv

System Information ACTIVITY.unv

Universe Domain DatabaseBroadcast Agent Analysis Security Corporate repository

Repository Analysis Security Corporate repository

Universe Domain Analysis Universe Corporate repository

System Information Audit database Audit database




Access rights for indicatorsThe options displayed for a given indicator depend on the user’s access rights in Business Objects. For example, a user can have the right to refresh an indicator but not to modify it.

For this action... You need these access rights in Business Objects...

Creating indicators Create documentsEdit documents

Modifying indicators Edit documents

Publishing indicators Publish documents

Saving indicators Save documents

Reading indicators Read corporate documents

Refreshing indicators Run and refresh

Deleting indicators Do not delete other user’s corporate documents (must be disabled)



Creating indicators

Creating indicatorsBefore you create an indicator, you must select a universe.To create a new indicator:1. In the Auditor main window, click the analytical category in which you want to

create the new indicator.The Category start page appears.

2. Click Add a New Indicator.The main window of BusinessObjects appears.The New Report wizard also is displayed if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.

3. Use the wizard to create a standard BusinessObjects document based on a universe, for example Broadcast Agent Analysis: Security.The BusinessObjects Query Panel appears, displaying the classes and objects available in the universe.

4. Build the indicator query using the universe’s classes and objects.5. Test the query by clicking Run.

The indicator you created is displayed.If you want to preserve the new indicator, you can publish or save it directly from BusinessObjects, without returning to Auditor.




Publish to Corporate Indicators1. Save the report to the default directory:

\Business Objects\BusinessObjects Enterprise 6\UserDocs2. If you want to assign a subcategory, choose File, Properties, and enter the

subcategory name in the Keywords field.

NOTEThe field is case-sensitive.

3. On the File menu, choose Publish To, Corporate Documents.The Send dialog box appears.

4. If the report does not appear in the Documents to send area, click Browse.5. If you want to change the analytical category, click Categories.6. If you want to schedule a refresh using Auditor, click Schedule.

The Scheduling Options page appears. 7. Set the refresh frequency you want, and then click OK. 8. Click OK.

Save to Personal Indicators1. On the File menu, choose Send To, Personal Documents.

The Send Personal Document dialog box appears.2. Fill in the required information, and then click Save. 3. If you want to change the analytical category, select the category from the

Categories list.



Modifying indicators

Modifying indicatorsYou can add or remove objects, change the formatting and layout, or modify the conditions of an existing indicator.

To modify an existing indicator1. Log in to the Auditor site: http://<hostname>:<portname>/auditor2. In the Auditor main window, click the category containing the indicator you

want to modify.3. Under the name of the indicator, click the Edit option.

The BusinessObjects Query Panel opens and the indicator’s classes and objects are available.

If you want to preserve the new indicator, you can publish or save it directly from BusinessObjects, without returning to Auditor.

click Edit




Publish to Corporate Indicators1. Save the report to the default directory:

\Business Objects\BusinessObjects Enterprise 6\UserDocs2. If you want to assign a subcategory, select File, Properties, and enter the

subcategory name in the Keywords field.

NOTEThe field is case-sensitive.

3. On the File menu, choose Publish To, Corporate Documents.The Send dialog box appears.

4. If the report does not appear in the Send Documents area, click Browse.5. If you want to change the analytical category, click Categories.6. If you want to schedule a refresh using Auditor, click Schedule.

The Scheduling Options page appears. Set the refresh frequency you want, and then click OK.

7. Click OK.

Save to Personal Indicators1. On the File menu, choose Send To, Personal Documents.

The Send Personal Document dialog box appears.2. Fill in the required information, and then click OK. 3. If you want to change the analytical category, select the category from the

Categories list.



Publishing indicators

Publishing indicatorsWhen you publish an indicator in Auditor, it is saved as a corporate indicator in a document domain in the corporate repository. This allows other users to access the same indicator.

NOTEWhen you save an indicator, it is maintained as a personal indicator. The indicator will be available only to you. (See Saving indicators in Auditor on page 170.)

The indicator is published in the analytical category and subcategory of your choice. It then appears in the list of indicators, under Corporate, for the selected category and subcategory.This section covers publishing that is performed from the list of indicators in Auditor.




To publish an indicator:1. In Auditor, in the analytical category, locate the name of the indicator in the

list of indicators.2. Click the arrow next to the name of the indicator to display the available

options.3. Click the Publish option.

The Publish page appears. The name of the indicator defaults to the current indicator name.

4. Enter a new name for the indicator (optional).We recommend entering a new, unique name, even if you have edited an existing indicator. This preserves the original set of predefined indicators supplied with Auditor.

5. Select the indicator’s category and subcategory.6. Select the document domain where you want to publish your indicator.

The domains listed are those in which you have both writing and modification rights.



Publishing indicators

7. Select the destination user group(s) for which you want to make the indicator available.

8. Click Yes or No for the Overwrite if indicator exists option:- If you select Yes, this indicator replaces any other indicator in the same document domain with the same name.- If you select No, and another indicator exists in the same document domain with the same name, Auditor prompts you to change the name of your indicator.

9. Choose a refresh option:- Refreshed manually

The indicator is refreshed only when a user refreshes it manually.- Scheduled Refresh

If you want to schedule a refresh using Auditor, choose this option.The Scheduling Options page appears.

10.Set the refresh frequency you want, and then click OK. 11.Click Publish.

Auditor publishes the indicator.




Saving indicators in AuditorWhen you save an indicator, it is maintained as a personal indicator. Personal indicators are stored in a given user’s file in the BusinessObjects installation directory, which by default is:

Program Files\Business Objects\BusinessObjects Enterprise 6\nodes\ <hostname>\auditorData\Documents\mycluster\Storage\user\<username>

They are accessible only by the user or an administrator with rights to access the user’s files.

NOTEWhen you publish an indicator in Auditor, it is saved as a corporate indicator to a document domain in the corporate repository. This allows other users to access the same indicator. (See Publishing indicators on page 167.)

The indicator is saved in the analytical category and subcategory of your choice. It then appears in the list of indicators, under Personal, for the selected category and subcategory.This section covers saving that is performed from the list of indicators in Auditor. The saving of indicators in BusinessObjects has a different procedure; see Creating indicators on page 163.To save an indicator in Auditor:1. Select an analytical category.2. Locate the name of the indicator in the list of indicators.3. Click the arrow next to the name of the indicator to display the available

options.



Saving indicators in Auditor

4. Click the Save option.The Save as Personal Document page appears.

The name of the indicator defaults to the current indicator name, or, if it is a new indicator, to “undefined.”

5. Enter a new name for the indicator (optional).It is best to enter a new, unique name, even if you have refreshed or edited an existing indicator. This preserves the original set of predefined indicators supplied with Auditor.

6. Select the indicator’s category and subcategory.7. Click Yes or No for the Overwrite if indicator exists option.

- If you select Yes, this indicator replaces any other indicator in the same document domain with the same name.- If you select No, and another indicator exists in the same document domain with the same name, Auditor stores your indicator in the document domain with a different indicator ID, and both indicators become available.

8. Click OK.Auditor saves the indicator.




Deleting indicatorsIf you have the required access rights, you can delete an indicator.To delete an indicator:1. In the Auditor main window, click the analytical category containing the

indicator you want to delete.2. Under the name of the indicator, click Delete.

A confirmation message appears.3. Click OK.

REMINDERYou can delete any of the predefined indicators if you have been granted the necessary access rights in Supervisor. However, if you delete a predefined indicator by mistake, and have no backup (for example, in your personal documents area), you must reexport the document using Document Exporter. For more information see Exporting predefined indicators on page 49.



Exercise: Creating a new indicator

Exercise: Creating a new indicatorIn the following procedure, we create an indicator that displays the users who accessed documents on a particular day.To create the indicator:1. In the Auditor main window, select the User Information category.

2. Click Add a New Indicator.

BusinessObjects opens. The New Report wizard also opens if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.

3. Using the New Report wizard, select:- Generate a Standard Report- Universe- System Information: Audit universe

4. Click Finish.The BusinessObjects Query Panel appears.

5. Drag the following objects to the Result Objects pane:- Action YYYY-MM-DD (Actions folder, Action Time subfolder)- User Name (Actions folder)- Document Name & Type (Actions folder, Action Details subfolder, Document subfolder)

6. Right-click the Action YYYY-MM-DD object, and point to Apply Simple Condition.

7. From the list of values, select the day for which you want to run the report.8. Click Run.

The new report appears in BusinessObjects.9. Name the report “Usage for a Day,” and add any formatting changes you

want.




10.Choose File, Save As, and then save the report as “Usage for a Day.”11.Choose File, Publish To, Corporate Documents.

The Send page appears.12.Do the following:

- Select the user groups to which you want to make the indicator available.- Select the new indicator in the Documents to Send list.- Click Categories, and then select User Information.

13.Click OK.14.After the confirmation message appears, return to the Auditor main window.



Exercise: Creating a new indicator

15.Click the User Information category, and then verify that the newly-published indicator appears under Corporate indicators. If it does not appear, refresh the list.

16.View and test the new indicator.

click the Refresh icon if the newly-published indicator does not appear


chapter

Using Auditor to Solve Business Problems




OverviewThis chapter focuses on specific applications of Auditor. These applications simulate many of the situations faced by users of the product.For each situation, the discussion includes one or more of the following ways to solve the problem:• use an existing indicator• modify an existing indicator• create a new indicator• select a business questionIt is assumed that you already know how to use Auditor, as explained in the previous chapters of this guide.



Business questionsEach category start page contains several preset business questions, taking you straight to the relevant indicator. This helps you to quickly find the information you are looking for. When you click a question, the first report of the associated indicator appears. If there are business questions relevant to the subject being discussed, they are listed at the end of the section.The following table shows all the business questions and the indicators they open.

Category Business question IndicatorUser Information

What is the total number of users? Number of Users in the Repository

What are my user profiles? User Profiles in the Repository

What is my user activity by month, week, day?

User Activity

Whose passwords have been deactivated?

Deactivated Users

What are the most popular actions? Most Popular Actions

Who does not log out correctly? Users Who Logged Off Incorrectly

When was the last time users logged in?

Last Login for User

Are my users editing reports or only refreshing them?


Document Management

What are my 10 most popular documents?


What are my 10 least popular documents?


Which documents have never been opened?


What is my average document size? Document Size in Repository




How many objects are in each document?


How many users have unread reports in their inbox?






Universe Management

How many universes do I have? Universe Information Summary


Impact Analysis


Impact Analysis

Which joins are used in my universes?

Joins by Universe

Which connections are my universes using?


Which are the most popular universes?


Broadcast Agent

How many Broadcast Agents do I have?

Broadcast Agents on the System

How many tasks were processed by Broadcast Agent?

Jobs per Broadcast Agent

How many tasks are pending on Broadcast Agent?

Job Summary


Job Summary

System Information

What is the average session duration?


Which types of browser are being used?

Types of Browsers in Use

Category Business question Indicator



How many servers do I have? Cluster Nodes

How many users are on my system? Average Number of Users Concurrently Logged In

Who uses my system the most? Refresh and Edit Activity



How many users are accessing my system daily and when is the most popular time?


Category Business question Indicator




Creating a business questionYou can also create your own business questions:1. Open the file BusinessQuestionsEN.txt, located in the folder in which the

Auditor .war files were deployed. For example, for the Tomcat application server, the BusinessQuestionsEN.txt file should be located in: $TOMCATINSTALLDIR\webapps\auditor

2. Find the section for the category in which you want the question to appear. 3. After the last indicator in the list (in the example above Average Number of

Users Concurrently Logged In), add the following lines:BQNumber=<number of last BQNumber + 1>BQuestions<number of last question + 1>=<name of new question>IndName<number of last question + 1>=<name of indicator opened by the question>ReportName<number of last question + 1>=<name of report opened by the question>

4. Save and close the BusinessQuestionsEN.txt file.

NOTETo delete a business question, delete the three lines mentioned in Step 3.



How do I monitor the use of Business Objects products?


In Auditor, you can use certain objects to determine which Business Objects products and versions are being used.You can use this kind of information for building a profile of your customer base, and for monitoring user preferences. Then, you can better allocate resources to the products that are most heavily used, and more efficiently balance the load on your servers.To monitor the products in use, create a new indicator:1. In Auditor click the System Information category.

2. Click the Add a New Indicator command.

BusinessObjects opens.The New Report wizard also opens if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.

3. Using the New Report wizard, select:- Generate a standard report- Universe- System Information: Audit universe





5. Drag the Action App object (Actions folder) to the Result Objects pane.

6. Click Run.




The new indicator appears in BusinessObjects.

The indicator displays the products in use. By adding extra dimensions, you can generate more detailed usage statistics.




How do I track Broadcast Agent usage?Auditor provides a number of predefined indicators associated with Broadcast Agent, including job scheduling and success rate information. For example, you can find out the number of successful jobs, or obtain a list of submitted documents.The following predefined indicators are available:• Broadcast Agents on the System• Jobs per Broadcast Agent• Jobs per User• Job SummaryUsing this information, you can troubleshoot Broadcast Agent errors, analyze usage patterns, and then use the Administration Console to balance the allocation of system resources accordingly.

Business questionsThe following business questions are designed to help you track Broadcast Agent usage.

This business question... In this category... Opens this indicator...How many Broadcast Agents do I have?

Broadcast Agent Broadcast Agents on the System

How many tasks were processed by Broadcast Agent?

Broadcast Agent Jobs per Broadcast Agent

How many tasks are pending on Broadcast Agent?

Broadcast Agent Job Summary


Broadcast Agent Job Summary



How do I find out which machines are accessing my system?

How do I find out which machines are accessing my system?

Through the use of the predefined indicator IP Addresses Accessing my Audited Clusters in the System Information category, Auditor allows you to view:• IP addresses of successfully logged-in clients• number of logins per IP address during a given reporting periodBecause the IP address is linked to the client machine rather than to the actual user, this information can be used to monitor the various machines—and the number of users logged in to those machines—within a given reporting period.To find out which machines are being used:1. In Auditor click the System Information category.2. Click the IP Addresses Accessing My Audited Clusters indicator.3. Click the Refresh option under the name of the indicator.

A date selection box appears.4. Enter or browse for the year or years that you want. Hold down the CTRL key,

to select multiple years.5. Click Run Query.

Auditor runs the query and displays the following report.

Business questionsThe following preset business questions are designed to help you find out which machines are being used to access your system.

This business question... In this category... Opens this indicator...Which IP addresses are being used to access my BI server solution and how often?

System Information IP Addresses Accessing my Audited Clusters




Can I detect fraud with Auditor?Yes, Auditor is an efficient tool for detecting fraud.Because you can use Auditor to monitor both the client IP address and the user login name, you can determine whether two physical users are using the same login name. If you are charging extranet users by login name, this allows you to identify breaches of extranet user contract.One way to do this is to modify the IP Addresses Accessing my Audited Clusters indicator (see previous section) by adding the User Name object to the table.To modify the IP Addresses Accessing my Audited Clusters indicator:1. In Auditor click the System Information category.2. Click the Edit option for the IP Addresses Accessing my Audited Clusters

indicator.The report appears in BusinessObjects.

3. Open the Query Panel.4. From the Actions folder, drag the User Name object to the Result Objects

pane, and drop it into the last position.5. Rerun the indicator.

In the report detail above, you can see that a single user name is being accessed from different IP addresses.

Business questionsThe following preset business questions are designed to help you detect fraud.

This business question... In this category... Opens this indicator...Whose passwords have been deactivated?

User Information Deactivated Users

Who does not log out correctly? User Information Users Who Logged Off Incorrectly


System Information




How do I monitor login information?

How do I monitor login information?The predefined indicators in the System Information category provide user login information that enables you to leverage optimal performance from your deployment. This includes:• the number of users who are concurrently logged on during the various hours

of a particular day, using the Total Users Concurrently Logged in by Day indicator

• the average length of time for which users are logged in, using the Average Session Duration indicator

Monitoring the daily number of logged-in usersTo see the number of concurrent logged-in users:1. In Auditor click the System Information category.2. Click the Refresh option for the Total Users Concurrently Logged in by Day

indicator.A date selection box appears.

3. Enter or browse for the day or days that you want. Select multiple days by holding down the CTRL key.

4. With the Total Number of Concurrent Log on Sessions report tab selected, click Run Query.




Monitoring the average duration of user sessionsThe Average Session Duration per User and the Average Session Duration per Cluster indicators enable you to monitor the average length of time that users are logged on to the system.The Average Session Duration per Host indicator provides an additional piece of important information. Each time a user logs on, a WIQT instance is launched. By default, the WIQT stays in memory for one minute after the last user activity. You can set the time-out in the Administration Console.To monitor the average session duration:1. In Auditor click the System Information category.2. Select the Traffic subcategory.3. Click the Refresh option for the Average Session Duration per User indicator.

A date selection box appears.4. Select the year you want.5. Click Run Query.

Verify that the Average Session Duration in Minutes Over the Year report tab is selected.

6. Click the other report tabs to see more detailed information.

Business questionsThe following preset business questions are designed to help you monitor login information.

This business question... In this category... Opens this indicator...Who does not log out correctly?

User Information Users Who Logged Off Incorrectly

When was the last time users logged in?

User Information Last Login for Users

What is the average session duration?

System Information


How many users are on my system?

System Information




How do I monitor the load on my server?

How do I monitor the load on my server?Auditor can display user activity; that is, the number of actions performed by users within a specified period. The Peak Usage indicator provides this information.The number of actions performed differs from the number of users logged in. For example, out of the users who are currently logged in, it is possible that no more than 15% of them are simultaneously performing actions.To monitor the number of actions:1. In Auditor click the System Information category.2. Select the Usage subcategory.3. Click the Refresh option for the Peak Usage indicator, then select the year

you want.4. Click the Number of Action Peaks tab.5. Click Run Query.

This shows you the peak usage times per hour over the course of the year.

Business questionsThe following preset business questions are designed to help you monitor the load on your server.

This business question... In this category... Opens this indicator...What are the most popular actions?

User Information Most Popular Actions


Document Management





How do I track the most requested documents?You can monitor the documents that users are downloading most frequently from Business Objects. Because the predefined indicators differentiate between BusinessObjects documents (*.rep), WebIntelligence 2.x documents (*.wqy), WebIntelligence 6.1 documents (*.wid) and third-party documents, you can see a separate summary for each document type.

Most frequently exported documentsTo monitor the most frequently exported documents:1. In Auditor click the Document Management category.2. Select the Top 10 & Bottom 10 subcategory.3. Click the Refresh option for the 10 Most Exported Documents indicator.4. Click the 10 Most Exported report tab.

Most popular documents loaded into a spreadsheetThe 10 Most Converted to Excel report (10 Most Exported Documents indicator) enables you to monitor the 10 CSV (comma-separated value) documents that users exported most frequently, during a given reporting period. Usually, the most common type of CSV format accessed in Auditor is Microsoft Excel.To monitor the most popular CSV documents:1. In Auditor click the Document Management category.2. Select the Top 10 & Bottom 10 subcategory.3. Click the Refresh option for the 10 Most Exported Documents indicator.4. Verify that the 10 Most Converted to Excel report tab is selected.

Business questionsThe following preset business questions are designed to help you track the most requested documents.

This business question... In this category... Opens this indicator...What are my 10 most popular documents?

Document Management



Document Management




How do I track the least/most popular documents?

How do I track the least/most popular documents?

You can use the 10 Least Read Documents indicator to find the ten documents (of any type) for which there have been the least number of actions by selected users within a given period. The information is broken down into the following reports:• 10 Least Read• 10 Least Refreshed• 10 Least EditedThe 10 Least Read Documents indicator provides you with a simple way of identifying outdated or redundant documents. You can then archive these documents, thereby freeing space and speeding up the user navigation process.Similarly, the 10 Most Read Documents indicator shows the ten documents for which there have been the most number of actions by selected users within a given period. The information is broken down into the following reports:• 10 Most Read• 10 Most Refreshed• 10 Most EditedTo track the least read documents:1. In Auditor click the Document Management category.2. Select the Top 10 & Bottom 10 subcategory.3. Click the Refresh option for the 10 Least Read Documents indicators.4. Verify that the 10 Least Read tab is selected.5. Click Run Query.




Business questionsThe following preset business questions are designed to help you track the least/most popular documents.

This business question... In this category... Opens this indicator...What are my 10 most popular documents?

Document Management


What are my 10 least popular documents?

Document Management


Which documents have never been opened?

Document Management


How many users have unread documents in their inbox?

Document Management



Document Management




How do I monitor universe hits?

How do I monitor universe hits?The Most Popular Universes indicator enables you to determine which universes have received the most actions. Then, by creating a similar indicator, you can determine which types of action are being generated.To see the most popular universes:1. In Auditor click the Universe Management category.2. Select the Usage subcategory.3. Click the Refresh option for the Most Popular Universes indicator, and then

select the year.4. Make sure the Most Popular Universes by Month report tab is selected.You can now create a separate indicator for individual universes, to show a detailed breakdown of actions. As an example, we will create an indicator to measure activity in a given universe:1. In Auditor click the Universe Management category.2. Click the Add a New Indicator command.

The main window of BusinessObjects appears.The New Report wizard also is displayed, if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.

3. Using the New Report wizard, select:- Generate a Standard Report- Universe- System Information universe





5. Drag the following objects to the Result Objects pane:- Universe Name (Action Details subfolder). Create a condition to be equal to a universe that you want to monitor.- Action YYYY-MM (Action Time folder). Create a prompt for month.- Action Name (Actions folder)- Document Name & Type (Action Details subfolder)- Number of Actions (a measure from the Action Measures folder).- Repository Name (Action Details subfolder). Create a condition to be equal to the constant <name of your domain>.

6. Save and close the Query Panel.7. In the Slice and Dice Panel, bring the Universe Name and Action YYYY-MM

objects into the Section frame.8. Run the indicator.9. Give the indicator a name, such as “Repository Action Analysis.” 10.Make any formatting changes you want.11.Publish the new indicator. 12.Make note of where you publish it because you will need to use it in the next

example.

Business questionsThe following preset business questions are designed to help you monitor universe hits.

This business question... In this category... Opens this indicator...Which are the most popular universes?

Universe Management




How do I use Auditor for billing?

How do I use Auditor for billing?You can use the indicators in Auditor to help you bill users of your extranet. The types of actions for which you bill depend, of course, on your particular business requirements. However, the universes, objects, and indicators provided by Auditor enable you to set up a wide variety of billing scenarios.For example, you want to charge extranet users $10 per document refresh within the eFashion universe. You can use the indicator in the previous section, Repository Analysis Actions, as a base, section it by user, and limit it to refresh actions only.To create the new report:1. Access the Repository Action Analysis indicator that you created and

published in the previous section.2. Click the Edit option for the indicator.

The indicator appears in BusinessObjects.3. Open the Query Panel, and then do the following:

- Bring in the Action Type object, Actions folder. Create a condition to be equal to the constant “Document Name.”- Bring in the User Name object, Actions folder.- For the Action Name object, already in the Query Panel, create a condition to be equal to the constant “Refresh Document.”

4. Run the indicator.5. Give the indicator a name, such as “Broadcast Agent Refresh Billing.” 6. Make any formatting changes you want.7. Publish the indicator under a new name.

Business questionsThe following preset business questions are designed to help you use Auditor for billing.

This business question... In this category... Opens this indicator...How many users are accessing my system daily and when is the most popular time?

System Information


Who uses my system the most? System Information





How do I perform impact analysis?The following predefined indicators help you determine the impact of changes made to your data model:• impact Analysis• number of Objects per Document• objects Used in DocumentsThis information enables you to efficiently plan modifications and avoid lengthy investigations into system malfunctions. Examples of these modifications are changing an object name or deleting a universe.

NOTEOnly documents that have already been used appear in these reports.

To access the Impact Analysis group of reports:1. In Auditor click the Universe Management category.2. Click the Refresh option for the Impact Analysis indicator.

Business questionsThe following preset business questions are designed to help you perform impact analysis.

This business question... In this category... Opens this indicator...How many objects are in each document?

Document Management



Universe Management

Impact Analysis


Universe Management

Impact Analysis



Index

IndexSymbols10 least accessed documents 14410 least exported documents 14410 least read documents 19310 most accessed documents 14410 most exported documents 144, 19210 most read documents 193

Aaccess rights for indicators 162action app id object 109action app object 109action day (with label) object 122action day object 120action DD/MM (with label) object 122action details subclass 111-116

administration SDK subclass 112-114browser information subclass 114document subclass 115page information subclass 116

action duration object 117action error id object 109action HHMISS object 120action host object 109action hour (with label) object 122action hour am/pm object 120action hour object 120action id object 109action measures subclass 117-118

incompatibilities 127action minutes (with label) object 122action minutes object 120action MM/DD (with label) object 122action month (with label) object 122action month name (with label) object 122action month name object 120action month object 120action name id object 109

action name object 109action quarter (with label) object 122action quarter object 120action seconds (with label) object 122action seconds object 120action time frame (with label) subclass 122action time object 109action time subclass 120-121

incompatibilities 127action type detail (with label) object 109action type detail object 109action type object 109action week (with label) object 122action week object 120action year (with label) object 122action YYYY object 120action YYYY-MM object 120action YYYY-MM-DD HHMISS object 120action YYYY-MM-DD object 120actions class 109-122

action details subclass 111-116action measures subclass 117-118action time frame (with label) subclass 122action time subclass 120-121averages subclass 119

actions subclass 79actions type object 79activity subcategory 137

last login for user 137most popular actions 137number of user sessions 137number of users in the repository 137refresh and edit activity 138user activity 138user activity per session 138users who logged off incorrectly 138

activity.unv 161administration SDK subclass 112-114



Index

advanced subclass 103incompatibilities 108

alias (y or n) object 105alias information subclass 105alias table id object 105

incompatibilities 108analysis subcategory 142-143

document information detail 142document information summary 142document size in repository 143documents never read 143objects used in documents 143

analytical categoriesBroadcast Agent analysis 74description 20repository analysis 74system information universe 74universe domain analysis 74

assigned user groups 44audit BCA measures class 88

incompatibilities 89audit database

connecting 44setting up 32

audit database domain 161audit facility

database mode 22description 22file mode 22

audit tab 43Auditor

components 20-21monitoring multiple clusters 57removing 59-62uses 19

Auditor filesuninstalling 62

average duration object 86average number of users concurrently logged in

156average refresh time 145average session duration 156average session duration per cluster 155, 190average session duration per user 155, 190

averages subclass 119incompatibilities 127, 128

avg action duration (sec) object 119avg actions per day object 119

incompatibilities 127avg actions per hour object 119

incompatibilities 127avg actions per month object 119

incompatibilities 127avg document size object 119

incompatibilities 127avg rows retrieved object 119

incompatibilities 127avg session duration (hour) object 119avg session duration (min) object 124

incompatibilities 127avg session duration (month) object 119avg session duration (sec) object 124

incompatibilities 127, 128avg session duration (week) object 119avg users per day object 119

incompatibilities 127, 128avg users per hour object 119

incompatibilities 127, 128avg users per month object 119

incompatibilities 127

Bbatch id object 78batch information class 78-81

actions subclass 79monitoring job information subclass 81scheduling information subclass 80

BCA & BO server names object 76BCA id object 76BCA information class 76-77BCA name (label) object 76BCA name object 76BCA server name object 77BCA status object 77bca.unv 161begin date object 87begin date time frame subclass 87begin time object 80



Index

billing reportsbusiness questions 197creating 197

BO server name (with label) object 77BO server name object 77BO version of the submitter object 84Broadcast Agent

tracking usage 186Broadcast Agent analysis

analytical categories 74audit BCA measures class 88batch information class 78-81BCA information class 76-77bca.unv 161document information class 82-83domain 75incompatibilities 89predefined universes 75recipient information class 85submitter information class 84time frame class 86-87universe 76-89

Broadcast Agent analysis universe 161Broadcast Agent category 151-152

business questions 151, 186global console subcategory 151job information subcategory 152

Broadcast Agent usagebusiness questions 186

Broadcast Agents on the system 151browser information subclass 114browser type object 114Business Objects

consulting services 11, 13documentation 10Documentation Supply Store 9monitoring use of products 183-185support services 11training services 11, 13

business questionsall 179-181Broadcast Agent category 151, 186Broadcast Agent usage 186creating 182creating reports for billing 197

detecting fraud 188document management category 141impact analysis 198information category 136least/most popular documents 194monitoring login information 190monitoring machine access 187monitoring server load 191monitoring universe usage 196monitoring user activity 191most requested documents 192system information category 153universe management category 146

BusinessObjects functionality object 92BusinessQuery functionality object 92

Ccategory

Broadcast Agent 151-152description 20document management 141-143system information 153-157universe management 146-150user information 136-140

category creator object 82, 93category name object 82, 93category path object 82, 93change list display and default home page

command set 67change password command set 67change viewing and editing technology options

command set 67class

actions 109-122audit BCA measures 88, 89batch information 78-81BCA information 76-77class details 102, 108condition details 104, 108connection 99, 100contexts 106, 108document information 82-83documents 93-96, 100hierarchies 107, 108joins 106, 108



Index

object details 103, 108recipient information 85session analysis (actions) 123-125site log info 126submitter information 84time frame 86-87universe 98, 100universe parameters 101-102universe tables 105, 108user 90-92

class description object 102incompatibilities 108

class details class 102incompatibilities 108

class hidden object 102class id object 102class name (with label) object 102class name object 102client ip object 114client os object 114cluster id object 109, 123, 126cluster monitoring 57cluster name object 109, 123, 126cluster nodes 157command set

change list display and default home page 67change password 67change viewing and editing technology options

67create indicators 68definition 65edit indicators 68formatting toolbar 68refresh lists of values 68run and refresh documents 69use list of values 69view SQL 69

command set familydocument 66options 67query and report panel 68

condition description object 104condition details class 104

incompatibilities 108condition hidden object 104

condition id object 104condition name object 104

incompatibilities 108condition position object 104condition table name(s) object 104condition WHERE clause object 104connection class 99

incompatibilities 100connection name object 99

incompatibilities 100connection RDBMS object 99

incompatibilities 100connection type object 99

incompatibilities 100consultants

Business Objects 11context id object 106

incompatibilities 108context join id object 106context join sql object 106context join table 1 name object 106context join table 2 name object 106context name object 106contexts class 106

incompatibilities 108corporate indicators

publishing to 164count BCA jobs object 88, 89count job expired object 88, 89count job failed object 88, 89count job running object 88count job success object 88, 89count job suspended object 88, 89count job waiting object 88, 89count object 117count recipients object 85create indicators command set 68creating

billing reports 197business questions 182database views 48indicators 163-164

creation date object 101customer support 11custom-made universes 75



Index

Ddata object 79data provider name object 96data provider source object 96data providers subclass 96

incompatibilities 100database mode 22database views

creating manually 48removing 60

date format 76days of the month object 80days of the week object 80deactivated users 139deleting

indicators 172universes 59

demo materials 9Designer functionality object 92Designer user

setting privileges 35destination universe domain 44detail objects 73detecting fraud 188Developer Suite 10, 12dimensions 73distribution path object 85distribution system object 85document age (hour) object 93document age (min) object 93document age (sec) object 93document category object 82, 93, 115document command set

publish document 66read corporate documents 66save document 66

document creation date object 93document description object 115document domain creation date object 95document domain creator object 95document domain object 93, 95document domain subclass 95

Document Exporteraccessing in UNIX 49exporting documents 50-51removing documents with 61-62

document id object 82, 93, 115document information class 82-83document information detail 142document information summary 142document management category 141-143

analysis subcategory 142-143business questions 141properties subcategory 148-149top 10 & bottom 10 subcategory 144usage subcategory 145

document name & type object 82, 94document name (with label) object 115document name and type object 115document name object 82, 93document persistent object 82, 94document popularity tracking 192, 194document repository id object 82document repository name object 82document size in repository 143document size object 82, 94, 117document subclass 115document type (picture) object 83, 94document type object 82, 94, 115, 116document usage 145documentation

CD 9feedback on 10on the web 9printed, ordering 9roadmap 9search 9

Documentation Supply Store 9documents

removing 61-62tracking least/most popular 193-194tracking most requested 192



Index

documents class 93-96data provider subclass 96document domain subclass 95incompatibilities 100received by subclass 96universe domain subclass 97

documents never read 143domains

audit database 161predefined universes 75, 161security 161universe 161

duration object 96

Eedit indicators command set 68education see trainingend date object 87end date time frame subclass 87end user process id object 78expiration date object 87expiration date time frame subclass 87export tab 44-45exporting

documents 50-51documents manually 52-56predefined indicators 49-56universes 36-47universes manually 47using Document Exporter 50-51

Ffailed logins object 90feedback

on documentation 10file mode 22file name object 98

incompatibilities 100filename (with label) object 101filename object 101first author object 101formatting toolbar command set 68

fraud detection 188business questions 188

frequency object 80

Gglobal console subcategory 151

Broadcast Agents on the system 151group name (administration) object 112group name object 77, 90group recipient name object 85group submit name (with label) object 84group submit name object 84

Hhidden object object 103hierarchies class 107

incompatibilities 108number of objects in hierarchies subclass 107

hierarchy id object 107hierarchy name (with label) object 107hierarchy name object 107hierarchy position in universe object 107

Iidentification strategy object 90impact analysis 147, 198

business questions 198impact analysis subcategory

impact analysis 147predefined indicators 147

incompatibilitiesaction measures subclass 127action time subclass 127advanced subclass 108alias table id object 108audit BCA measures class 89averages subclass 127, 128avg actions per day object 127avg actions per hour object 127avg actions per month object 127avg document size object 127avg rows retrieved object 127avg session duration (min) object 127avg session duration (sec) object 127, 128



Index

avg users per day object 127, 128avg users per hour object 127, 128avg users per month object 127Broadcast Agent analysis 89class description object 108class details class 108condition details class 108condition name object 108connection class 100connection name object 100connection RDBMS object 100connection type object 100context id object 108contexts class 108data providers subclass 100documents class 100file name object 100hierarchies class 108joins class 108last action date object 100last action type object 100number of log offs object 127number of session users object 127, 128number of sessions object 127, 128object details class 108object position object 108object security access level object 108repository analysis 100session duration (min) object 127, 128session duration (sec) object 127, 128session measures subclass 127, 128status object 100system information universe 127table name (with label) object 108table/alias name object 108universe class 100universe domain 100universe domain analysis 108universe name object 100universe tables class 108

incompatible table object 103, 104

indicatorsaccess rights 162creating 163-164deleting 172description 20exporting 50-51list of all 133-135modifying 165-166predefined

exporting 49-56exporting manually 52-56

publishing 167-169publishing to corporate 164restoring 58saving 170-171saving as personal 164

inheritance rights object 90interface impact

document command sets 66options command sets 67query panel command sets 68report panel command sets 68

ip addresses accessing my audited clusters 154, 187, 188

Jjob description object 78job duration max object 86job duration min object 86job duration object 86job error code object 81job error warning or text object 81job information subcategory 152

job success rate 152job summary 152jobs per BCA 152jobs per frequency 152jobs per user 152

job platform object 78job state object 81job status object 81job success rate 152job summary 152jobs per BCA 152jobs per frequency 152



Index

jobs per user 152join id object 106join sql object 106joins class 106

incompatibilities 108joins per universe 148

Kkeyword object 115Knowledge Base 12

Llast action date object

connection class 99document class 94document domain subclass 95document information class 83incompatibilities 100universe domain subclass 97user class 90

last action object 83last action start time object 121last action type object

connection class 99document class 94document domain subclass 95document information class 83incompatibilities 100universe domain subclass 97user class 90

last author object 101last login for user 137last modify date object 101last refresh date object 96last update time object 98linked universe id object 101linked universe name object 101log files 22log host object 126log id object 126log info object 126log level object 126log module object 126log PID object 126

log time object 126login information

business questions 190monitoring 189-190

login usersmonitoring daily amount 189

Mmax number of columns object 101max number of lines object 101max query time object 101measures 73modifying indicators 165-166monitoring

average duration of user sessions 190daily amount of login users 189login information 189-190

business questions 190machine access business questions 187machines accessing the system 187multiple clusters 57server load 191universe usage 195-196use of Business Objects projects 183-185user activity 191

monitoring job information subclass 81most active users 140most popular actions 137most popular actions per document 143most popular universes 150, 195multimedia quick tours 10multiple cluster monitoring 57

Nnumber of action details object 117number of actions object 117number of classes object 102number of conditions object 104number of contexts object 106number of documents object 83number of documents used object 117number of elements object 111number of hierarchies object 107number of joins object 106



Index

number of linked universes object 101number of log offs object 117

incompatibilities 127number of logins object 117number of object instances object 107number of objects in hierarchies subclass 107number of objects object 103, 107number of objects per universe 148number of rows object 96, 111number of rows retrieved object 117number of session users object 124

incompatibilities 127, 128number of sessions object 117, 124

incompatibilities 127, 128number of tables object 105number of universes object 102number of user sessions 137number of users in the repository 137number of users object 117

Oobject description object 103object details class 103

advanced subclass 103incompatibilities 108

object id object 103object name (with label) object 103, 111object name in hierarchy object 107object name object 103, 111object position in hierarchy object 107object position object 103

incompatibilities 108object properties object 103object security access level object 103

incompatibilities 108object security level object 112object table name(s) object 103object type object 103objects assessed 150objects filter object 98objects used in documents 143Online Customer Support 11options command set family 67

original database table name object 105overwrite mode object 78overwrite object 115owner/sender object 94

Ppage information subclass 116page range object 116parameters for export of universes 44parent group name (administrator) 112partial indicator object 96particular conditions object 79password can change object 112password checking object 112password limited validity object 113password must change object 113password object 112password periodic validity object 113password status object 113password validity period object 114peak usage 157, 191periodicity detail object 80periodicity object 80personal indicators

saving as 164predefined indicators

activity subcategory 137analysis subcategory

document management category 142-143description 20exporting 49-56exporting manually 52-56global console subcategory

Broadcast Agent category 151impact analysis subcategory 147job information subcategory

Broadcast Agent category 152list of all 133-135properties subcategory

document management category 148-149restoring 58security subcategory

system information category 154user information category 139



Index

top 10 & bottom 10user information category 140

top 10 & bottom 10 subcategorydocument management category 144

traffic subcategorysystem information category 155-156

usage subcategorydocument management category 145system information category 157universe management category 150

predefined universes 75, 161activity.unv 161bca.unv 161description 21domains 75, 161security.unv 161universe.unv 161

priority (picture) object 78priority object 78privileges for Auditor-dedicated Designer user 35profile name object 114properties subcategory 148-149

joins per universe 148number of objects per universe 148universe information detail 148universe information summary 149

publish document command set 66publishing

indicators 167-169to corporate indicators 164

Qquery and report panel command set family 68

Rread corporate documents command set 66received by subclass 96recipient function object 96recipient information class 85recipient name (with label) object 96recipient name object 85, 96recipient status object 85recipient user type object 85refresh and edit activity 138

refresh lists of values command set 68refresh options object 115removing

Auditor 59-62database views 60documents 61-62

report bursting feature object 79report name object 116reports for billing purposes 197repository action analysis 197repository analysis

analytical categories 74connection class 99documents class 93-96domain 75incompatibilities 100predefined universes 75security.unv 161universe 90-100universe class 98user class 90-92

repository analysis universe 161repository name object 111resource object 90resource status object 91restoring predefined indicators 58row restriction object 98run and refresh documents command set 69

Ssave document command set 66saving

as personal indicators 164indicators 170-171

scheduling information subclass 80script options object 79search documentation 9security commands subclass 92security configuration object 92security domain 161security domain connection 44security family object 92security functionality object 92security status object 92



Index

security subcategorydeactivated users 139ip addresses accessing my audited clusters

154system information category 154user information category 139user information detail 139user information summary 139user profiles in the repository 139

security tab 41security.unv 161SELECT clause object 103server load monitoring 191

business questions 191sesn host (user ip) object 123sesn user (no ’unknown’ users) object 123sesn user object 123session analysis (no actions) class 123-125

session measures subclass 124session time subclass 125

session day object 125session duration (1 min intervals) object 125session duration (5 min intervals) object 125session duration (hour) object 118session duration (min) object 118, 124

incompatibilities 127, 128session duration (sec) object 124

incompatibilities 127, 128session end time object 121, 123session hour object 125session id object 110, 123session measures subclass 124

incompatibilities 127, 128session minutes object 125session MM object 125session quarter object 125session start object 125session start time object 121, 123session time subclass 125session week object 125session YYYY object 125session YYYY-MM object 125session YYYY-MM-DD object 125

setting upaudit database 32privileges for Auditor-dedicated Designer user

35site log info class 126sql file database scripts

location 48names 48

SQL value object 111start date object 86start date time frame subclass 86status object 94, 98

incompatibilities 100submit date time frame subclass 86submit datetime object 86submit name & user profile (label) object 84submit name & user profile object 84submitter information class 84sum document size object 118supervisor functionality object 92support

customer 11system information category 153-157

business questions 153security subcategory 154traffic subcategory 155-156usage subcategory 157

system information universe 109-128, 161actions class 109-122activity.unv 161analytical categories 74domain 75incompatibilities 127predefined universes 75session analysis (actions) class 123-125site log info class 126

system monitoring 187

Ttable 1 name object 106table 2 name object 106table id object 105table mapping object 98table name (with label) object 105




Index

table/alias name object 105incompatibilities 108

table/alias properties object 105time format 76time frame class 86-87

begin date time frame subclass 87end date time frame subclass 87expiration date time frame subclass 87start date time frame subclass 86submit date time frame subclass 86

Tips & Tricks 10top 10 & bottom 10 subcategory

10 least accessed documents 14410 least exported documents 14410 most accessed documents 14410 most exported documents 144document management category 144most active users 140user information category 140

total size of elements in list object 111total users concurrently logged in by day 156, 189tracking

least/most popular documents 194most requested documents 192the least/most popular documents 193-194use of Broadcast Agent 186

traffic subcategory 155-156average number of users concurrently logged

in 156average session duration 156average session duration per cluster 155average session duration per user 155total users concurrently logged in by day 156

training on Business Objects products 11types of browsers in use 157

Uuninstalling

Auditor files 62universe class 98

incompatibilities 100universe description object 98universe domain 161


universe domain analysisanalytical categories 74domain 75incompatibilities 108predefined universes 75universe 101-108universe.unv 161

universe domain analysis universe 161class details class 102condition details class 104contexts class 106hierarchies class 107joins class 106object details class 103universe parameters class 101-102universe tables class 105

universe domain connection 44universe domain creation date object 97universe domain creator object 97universe domain object 97, 98universe domain subclass 97Universe Exporter

audit tab 43export tab 44-45removing database views 60security tab 41tabs 37universe tab 42using 36-45

universe help text object 102universe id object 98, 102universe information detail 148universe information summary 149universe management category 146-150

business questions 146impact analysis subcategory 147usage subcategory 150

universe name (with id) object 102universe name (with label) object 102, 111universe name object 98, 102, 111

incompatibilities 100universe parameters class 101-102universe revision object 98universe tab 42



Index

universe tables class 105alias information subclass 105incompatibilities 108

universe usage 150business questions 196

universe.unv 161universes

analytical categories 74Broadcast Agent analysis 76-89

incompatibilities 89custom-made 75deleting 59description 21exporting 36-47

suggested connections 47exporting manually 47monitoring usage 195-196predefined 75, 161

domains 75repository analysis 90-100

incompatibilities 100structure 73system information 109-128

incompatibilities 127universe domain analysis 101-108

incompatibilities 108usage

Broadcast Agent 186usage subcategory

average refresh time 145cluster nodes 157document management category 145document usage 145most popular actions per document 143most popular universes 150objects accessed 150peak usage 157system information category 157types of browsers in use 157universe management category 150universe usage 150

use list of values command set 69user activity 138

monitoring 191business questions 191

user activity per session 138user class 90-92

security commands subclass 92user group (with label) object 91user group object 91user information category 136-140

activity subcategory 137business questions 136security subcategory 139top 10 & bottom 10 140

user information detail 139user information summary 139user level object 91user name (administration) object 114user name (target) option 115user name (with label) object 91, 110user name object 91, 110user profile object 91user profiles in the repository 139user sessions

monitoring average duration 190user status (picture) object 91user status object 91user submit name object 84user submit type object 84users who logged off incorrectly 138Using 131

Vversion object 102view SQL command set 69

Wweb

customer support 11getting documentation via 9useful addresses 12

WebIntelligence functionality object 92WHERE clause object 103



Index


auditor

Documents

auditor chapter

auditor components

copyright business objects

business objects tagline

business objects logo

business problems

business examples

system information category