Businessobjects Auditor Guide: Ewboa60.Book Page 1 Tuesday, August 19, 2003 10:52 Am

ewboa60.
book Page 1 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide
BusinessObjects Auditor 6.1
Windows and UNIX

ewboa60.book Page 2 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
documentation@businessobjects.com.
Business 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
Preface Maximizing Your Information Resources 7
Information resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Useful addresses at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Part I Administering Auditor
Chapter 1 Introducing BusinessObjects Auditor 17

What you can do with Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Auditor components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
The Audit facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 2 Setting Up and Removing Auditor 23

Installing Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Configuring Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Setting privileges for an Auditor-dedicated Designer user . . . . . . . . . . . . . . 35
Exporting universes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Exporting predefined indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Monitoring multiple clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Restoring predefined indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Removing Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Chapter 3 Setting Access Rights 63

Access rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Contents
Chapter 4 Universes, Classes and Objects 71

Universe structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Universes and analytical categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Predefined vs. custom-made universes . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Broadcast Agent analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Repository analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Universe domain analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
System information universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Part II Using Auditor
Chapter 5 Using Predefined Indicators 131

Predefined indicators available with Auditor . . . . . . . . . . . . . . . . . . . . . . . 133
User Information category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Document Management category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Universe Management category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Broadcast Agent category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
System Information category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Chapter 6 Creating, Modifying, and Publishing Indicators 159

Universes, classes, and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Access rights for indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Creating indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Modifying indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Publishing indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Saving indicators in Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Deleting indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Exercise: Creating a new indicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Contents
Chapter 7 Using Auditor to Solve Business Problems 177

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

Resources
preface
Overview
Information, 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.
Maximizing Your Information Resources

Information resources
Whatever 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 Roadmap
The 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 products

You 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 web

The 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 documentation

You 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 CD

Search 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.
Information resources
Multimedia
Are 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 & Tricks

Open 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 documentation
We 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 Online

Developer 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 feedback

Do 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: documentation@businessobjects.com
NOTE
If 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

Services
A 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 Support

Our 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
Services
Useful addresses at a glance
Address Content
Business Objects Documentation Overview of Business Objects documentation. Links
to Online Customer Support, Documentation Supply
www.businessobjects.com/services/ Store, Documentation Roadmap, Tips & Tricks,
documentation.htm Documentation mailbox.
Business Objects Documentation Feedback or questions about documentation.

mailbox
documentation@businessobjects.com
Product documentation The latest Business Objects product
documentation, to download or view online.
www.businessobjects.com/services/
support.htm
Business Objects product information Information about the full range of Business
Objects products.
www.businessobjects.com
Developer Suite Online Available to customers with a valid maintenance
agreement and a Developer Suite license via the
Online Customer Support (OCS) website. Provides
www.techsupport.businessobjects.com
all the documentation, latest samples, kits and tips.
Knowledge Base (KB) Technical articles, documents, case resolutions.
Also, use the Knowledge Exchange to learn what
www.techsupport.businessobjects.com 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 Practical business-focused examples.
www.businessobjects.com/forms/
tipsandtricks_login.asp

Address Content
Online Customer Support
www.techsupport.businessobjects.com Starting point for answering questions, resolving

issues.
www.businessobjects.com/services Information about registering with Worldwide

Customer Support.
Business Objects Education Services The range of Business Objects training options and
modules.
education.htm
Business Objects Consulting Services Information on how Business Objects can help
maximize your business intelligence investment.
consulting.htm
Useful addresses at a glance

About this guide

This 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.
NOTE
This guide replaces the BusinessObjects Auditor Administrator’s Guide and the
BusinessObjects Auditor User’s Guide.
Conventions used in this guide

The conventions used in this guide are described in the table below.
Convention Indicates
This 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 Placed at the end of a line of code, the symbol ( )
more code 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.

Administering Auditor
part
Introducing BusinessObjects
Auditor
chapter
Overview
BusinessObjects 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.
Introducing BusinessObjects Auditor

What you can do with Auditor

Auditor 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 queries
Auditor can help identify situations where aggregate tables or additional
indexes can be used.
• generate new billing opportunities by highlighting the most popular reports
What you can do with Auditor

Auditor components
Auditor 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
Indicators
Auditor 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 object
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.
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.
Categories
The 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 Information
Each category has a number of subcategories, which further organize indicators
for ease of access, pointing you directly to the information you want.

Universes
Auditor 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.
Auditor components
The Audit facility

A 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 mode
Business 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.

Setting Up and Removing

Auditor
chapter
Overview
This 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 Auditor
For the first five sections you should have the following guides close by for
reference:
• Designer’s Guide
• Installation and Configuration for UNIX
or
Installation and Configuration for Windows
• Supervisor’s Guide
• WebIntelligence User’s Guide
• installation and configuration documentation for the application server
• readme for BusinessObjects Enterprise 6
NOTE
If you are migrating Auditor to a new version of BusinessObjects, see Migrating
from a Previous Version.
For deployment information, see the Deployment Guide.
Setting Up and Removing Auditor

Installing Auditor
To install Auditor you need to complete the following steps:
1. Requesting a connection to a database server
2. Installing the application and web servers
3. Installing the BusinessObjects Enterprise 6 product suite
Requesting a connection to a database server

The 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 servers

If 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 Objects

You 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.
Installing Auditor
Configuring Auditor
You need to complete the following steps to configure Auditor:
1. Configuring the web and application servers
2. Creating a data source for the Audit database
3. Creating the Audit repository
4. Setting up the Audit database
Configuring the web and application servers

Configuring 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>/wiadmin
the Administrative Console.
• http://<hostname>:<portname>/auditor
Auditor.
For complete configuration instructions, see the Business Objects installation
and configuration guides for Windows and UNIX.

Creating a data source for the Audit database

If 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.
Configuring Auditor
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.

Creating the Audit repository

You 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.
Configuring Auditor
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.

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.
NOTE
You need to copy the .key file from:
Business Objects\BusinessObjects Enterprise 6\locdata
to the following location:
Business Objects\BusinessObjects Enterprise 6\nodes\<hostname>\
mycluster\locdata
12. Click Finish.

Supervisor opens.
Configuring Auditor
Setting up the Audit database

Auditor 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 database

1. 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.

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.
NOTE
If you need to create other connections:
1. In the Connections dialog box, click Add
2. Select the correct network layer and click OK.
3. Repeat steps 2 through 6.
Configuring Auditor
Creating tables in the Audit database

1. 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>/wiadmin
The 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
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:
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 documents
The following user rights need to be disabled:
- Do not delete other users’ corporate documents
Setting privileges for an Auditor-dedicated Designer user

Exporting universes
The 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
NOTE
You 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 Exporter

To launch the Universe Exporter:
1. Click Start, Business Objects, 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.
The Universe Exporter contains the following tabs.
Page name Description

Welcome 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
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.
Exporting universes
Creating a connection to the domain

The 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.
This user name must have at least one Designer profile, because you need
to export universes and create connections.
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.
NOTE
For 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.

6. In the Name field, enter a unique name for the connection.

7. In the Data Source text box, enter:
For... Data source

Oracle Net Service Name
IBM DB2 Database Alias
SQL Server Database Name
NOTE
For 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.
NOTE
If 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.
Exporting universes
12. To add these views to the database, click Create.

All the views for the security domain are marked Yes in the Views area.

Using the Security tab to manage database connections

To launch the Universe Exporter:
A user identification panel appears.
The user name must have at least one Designer profile for you to be able to
export universes.
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.
NOTE
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.
Exporting universes
Using the Universe tab to manage connections to universes

The user name must have at least one Designer profile, because you need to
export universes and create connections.
3. Click the Universe tab in the Universe Exporter window.
The Universe tab appears.
the Views area.
NOTE

6. Click Next to go to the Audit tab, or Finish to save your modifications.

Using the Audit tab to manage connections to the Audit database

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

6. Click Next to go to the Export tab, or Finish to save your modifications.
Exporting universes
Using the Export tab to manage the export of specific universes

From 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 domain
Once you’ve defined these settings, the Export tab lets you trigger the export
itself.
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.

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.
TIP
To 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.
Exporting universes
Adding a new connection in the Export tab

1. 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.

Manually exporting universes

To 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 Database

Broadcast Agent Analysis Security Corporate repository
Repository Analysis Security Corporate repository
Universe Domain Analysis Universe Corporate repository
System Information Audit database Audit database
Exporting universes
Manually creating the database views

If 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 names

Oracle $INSTALLDIR\ creviews_activity_ora.sql
Universes\auditorData\ creviews_security_bca_ora.sql
Views\ Oracle\
creviews_universe_ora.sql
IBM DB2 $INSTALLDIR\ creviews_activity_db2udb.sql
Universes\auditorData\ creviews_security_bca_db2udb.sql
Views\IBMDB2\
creviews_universe_db2udb.sql

Exporting predefined indicators

The Document Exporter enables you to automatically export the Auditor
documents (predefined indicators) to the corporate repository.
NOTE
The 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 UNIX

1. 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 Exporter

1. 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 indicators

To 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\Documents
3. 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.
TIP
Select 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

You 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.
EXAMPLE
Setting up the monitoring of multiple clusters
You 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.
Monitoring multiple clusters

Restoring predefined indicators

If 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 Manually
The indicator is refreshed only when a user refreshes it manually.
- Scheduled Refresh
Select 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
To remove Auditor from the server, there is a procedure to follow. The following
sections must be completed in this sequence:
1. Deleting the universes
2. Removing the database views
3. Removing the documents
4. Removing the Auditor files
Deleting the universes

To delete the universes:
2. Select Tools, Delete Universe.
The Delete Universes dialog box appears.
3. Select the Auditor universes, and then click OK.
Removing Auditor
Removing the database views

To 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 the documents

To 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.
Removing Auditor
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 files

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

Setting Access Rights
chapter
Overview
Auditor 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
In 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
Access rights
Command set family: Document

The following table shows which command sets to choose in order to restrict
Document functionality.
I don’t want my group/user to... So I disable or hide command set

Publish indicators to the repository Publish Document
Save indicators Save Document
See the list of indicators Read Corporate Documents
Interface impact
The following table shows the impact on the user interface of disabling or hiding
Document command sets.
Disabling or hiding command Has this impact on the interface

set...
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

Command set family: Options

The following table shows which command sets to choose in order to restrict
Options functionality.

See document list options or change the Change List Display and Default
default home page Home Page
Change their own password Change Password
Change the viewing and editing of Change Viewing and Editing
technology options (applets and Technology Options
technology options on the Options page)
Interface impact
Options command sets.
Disabling or hiding command Has this impact on the interface

set...
Change List Display and Default Removes the Start Page tab from
Home Page Options
Change Password Removes the Password tab from Options
Change Viewing and Editing Removes the Create and Edit Indicators
Technology Options tab from Options
Access rights
Command set family: Query and Report Panel

The following table shows which command sets to choose to restrict Query Panel
and Report Panel functionality.

Create 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
Interface impact
Query and Report Panel command sets.
Disabling or hiding Has this impact on the interface

command set...
Create Indicators Removes the Add a New Indicator tab
Edit Indicators Removes the Edit button from indicators
Removes 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

Disabling or hiding Has this impact on the interface

command set...
Run and Refresh The user can modify the document but cannot run
Documents 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 document
2. drags an object from the Classes and Objects
Panel to the Conditions tab
3. clicks on the operand of the object
then the Show Values From List and Prompt Values
From List options are unavailable.
If the user:
1. opens an expanded documents page
2. clicks Edit underneath a document, then
3. 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.
Access rights

Universes, Classes and Objects
chapter
Overview
This 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
Universes 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).
• Detail
A 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).
• Measure
A 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).
Universe structure
Universes and analytical categories

Universes correspond approximately to the various analytical categories in
Auditor. The universe/analytical category mapping is shown in the following
table.
This universe... Is used by indicators in these categories

Broadcast Agent Analysis: Broadcast Agent
Security
Repository Analysis: Security Document Management
User Information
Broadcast Agent
Universe Domain Analysis: Universe Management
Universe
System Information: Audit System Information
User Information
Document Management
Universe Management
NOTE
This 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.

Predefined vs. custom-made universes

With 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 universes
Auditor comes with the following predefined universes:
Universe name File name

Broadcast Agent Analysis: Security BCA.unv
Repository Analysis: Security SECURITY.unv
Universe Domain Analysis: Universe UNIVERSE.unv
System Information: Audit ACTIVITY.unv
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.

Broadcast 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
Custom-made universes
In Auditor, you can access universes that you:
• created in Designer
• exported to the repository
• made accessible to users via Supervisor
The 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).
Predefined vs. custom-made universes

Broadcast Agent analysis universe

This 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.
NOTE
Because 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 class

This 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... Returns

BCA & BO Two server names, or Not Processed.
Server Names The first name is the server on which Broadcast Agent is
(D) 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 Name of the monitored Broadcast Agent, preceded by the
(label) (D) text string “Broadcast Agent.”


BCA Server Name of the machine on which the Broadcast Agent server
Name (D) 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 Name of the Business Objects server that sent the job to
(D) Broadcast Agent (that is, the server machine running
BOManager).
For a task that has not been executed, the object returns
The object can be seen from any console, and is updated
after a task is processed.
BO Server Name Name of the Business Objects server that sent the job to
(with label) (D) Broadcast Agent, preceded by the text string “WebI Server
Name.”
For a task that has not been executed, the object returns
The object can be seen from any console and is updated
after a task is processed.

Batch information class

This class provides Broadcast Agent system information. The following table lists
Panel.

Batch ID (D) ID of the pending Broadcast Agent job.
End User The end-user module process ID launched on the server.
Process ID (D)
Job Description Job description initially completed by the user submitting the
(D) 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
Overwrite Mode With or without, depending on whether the Broadcast Agent
(D) job was submitted with the overwrite option turned on.
Priority (D) High, Normal, or Low
Priority (picture) A graphical indicator of the job’s priority: High, Normal, or
(De) Low (Auditor interface only).

Actions subclass
This 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.

Action 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 Details of the Broadcast Agent action, such as:
Conditions (D) • 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 Mode used to refresh the document, such as Refresh with
feature (D) Profile of Each Recipient, Refresh with Profile of the
Submitter.
Script Options Broadcast Agent script options that the user selected and
(D) sent with the document.
The values are separated by commas:
Refresh Document = 1, Print Document = 2, Web
Server = 3, Custom Macro, = 4, Condition = 5, Channel = 6,
Save as RTF = 7, Save as TXT = 8, Save as PDF = 9

Scheduling Information subclass

This 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.

Begin 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 Days selected for monthly tasks.
Month (D) The information appears in the following form: “2nd 3rd 4th
26th and last day of the month.”
Days of the Days selected for daily, monthly interval, and user-defined
Week (D) 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 Day scheduling for monthly interval tasks and the
(D) scheduling details for user-defined tasks.
The information appears in the following form: “Every 2nd
business day.”

Monitoring Job Information subclass

This is a subclass of the Batch Information class that provides job status

Job Error Code Broadcast Agent job error code, if there is one.
(De) Make a note of the code so that you can use it when referring
to the Error Message Guide.
Job Error or Full error description, with the error code that relates to the
Warning Text (D) 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 class

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

Category Name of the user who created the document category.
Creator (De)
Category Name Document's category name.
(De)
Category Path Hierarchical path of the document category if there is one.
(De)
Document List of document categories with the hierarchical path if
Category (D) there is one.
Document ID (D) Document ID
Document Name Name of a document sent to Broadcast Agent.
(D)
Document Name Complete document name with its type.
& Type (D)
Document Persistent if a document is published to the corporate
Persistent (D) repository, or Not Persistent if the document is automatically
deleted when retrieved by the last user.
Document ID of the document repository.
Repository ID
(De)
Document Name of the repository where a document is stored.
Repository
Name (D)
Document Size Size of a sent document, in bytes.
(M) 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 The WebIntelligence or BusinessObjects document.
(D) The file extension type is .rep, .bqy, .wqy, .wid, or .rea;
otherwise, it is Unknown.


Document Type Graphical image representing the WebIntelligence or
(Picture) (De) 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 Most recent, date of a change to a referenced document.
(D)
Last Action Type Last type of action performed on a referenced document.
(D) Values that can be returned include: Unchanged, Inserted,
Updated, or Moved.
Number of Number of documents sent to Broadcast Agent.
documents (M)

Submitter information class

This 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.

BO Version of Version number of the end-user module that submitted the
the Submitter (D) job to Broadcast Agent.
This object value is updated only at the time of document
submission.
Group Submit Group receiving the user’s submitted document.
Name (D)
Group Submit Group receiving the user’s submitted document, preceded
Name (with by the text string “Group Submit Name”.
label) (D)
Submit name & The submit name and user profile, as defined in Supervisor.
User Profile (D)
Submit name & The submit name and user profile as defined in Supervisor,
User Profile preceded by the appropriate text string.
(label) (D)
User Submit Name of the user who submitted the job to Broadcast Agent.
Name (D)
User Submit User type or user profile, as defined in Supervisor.
Type (D)

Recipient information class

This class provides data on document recipients. The following table lists the

Count Recipients Total number of recipients of a document.
(M)
Distribution Path Values of the distribution path.
(De)
Distribution Distributed via Web Server, or Distributed via Server File
System (D) System, to indicate how the processed Broadcast Agent
document is to be distributed.
Also returns information on the concatenated path.
Group Recipient Group Name receiving the document.
Name (D)
Recipient Name Name of the recipient.
(D)
Recipient Status Enabled, Disabled, or “Exceeded number of logins allowed.”
(D)
Recipient User User profile, as set in Supervisor.
Type (D) Possible values are: General Supervisor, Supervisor,
Designer, Supervisor-Designer, User, Broadcast Agent, or
Versatile.

Time frame class

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

Average 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.
Submit Date Time Frame subclass

This 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.

Submit Datetime Date on which the task was submitted on the client machine.
(D)
Start Date Time Frame subclass

This 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.

Start 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 subclass

This 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

End 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.
Expiration Date Time Frame subclass

This 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

Expiration Date Date on which a task expired.
(D)
Begin Date Time Frame subclass

This 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

Begin 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 class

This class provides various Broadcast Agent job counts. The following table lists
Panel.
NOTE
You cannot use more than one object from the Audit BCA Measures Class in a
single indicator.

Count 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 Number of suspended jobs.
(M)
Count Job Waiting (M) Number of waiting jobs.

Broadcast Agent analysis incompatibilities

The following table lists the objects in the Broadcast Agent Analysis universe that
are known to be incompatible with each other.
This object... in Class... is incompatible in Class

with...*
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 Audit BCA Measures the other objects Audit BCA
Success Measures
Count Job Audit BCA Measures the other objects Audit BCA
Suspended Measures
Count Job Waiting Audit BCA Measures the other objects Audit BCA
Measures
* This incompatibility can be caused by one of two factors:

• Incompatibility of WHERE clauses
• Use of the “Count” operator

Repository analysis universe

This section lists the classes in the Repository Analysis universe, and the objects
that are available for selection within each class.
NOTE
Because 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 class
This 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.

Failed 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 No Password Checking or Full Password Checking.
Strategy (D)
Inheritance Group from which rights were inherited.
Rights (De)
Last Action Date Most recent date of a change of the user.
(D)
Last Action Type The last type of action to be associated with the user.
(D) Values that can be returned include: Unchanged, Inserted,
Updated, or Moved.
Resource (D) Supervisor, Designer, Agent, Query, Reporter,
WebReporter, or Unknown.


Resource Status Disabled or Enabled.
(D)
User Group (D) Name of the user group.
User Group (with Name of the user group, preceded by the text string “User
label) (D) 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 The list of user names from the repository, preceded by the
label) (D) 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 A graphical representation of user status (WebIntelligence
(picture) (De) only).

Security Commands subclass

This 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.

Security Name of the Business Objects product on which the
Configuration (D) restrictions are placed.
These products include Designer, InfoView, Supervisor,
BusinessObjects, and WebIntelligence.
Security Family Functionality family on which the restriction is placed.
(D)
Security Status Status of the restriction: Enabled, Disabled, Inherited, or
(D) Hidden.
Security Name of the functionality on which the restriction is placed
Functionality (D) for Designer, BusinessObjects, Supervisor, InfoView, or
WebIntelligence.
Designer Name of the functionality on which the restriction is placed
Functionality (D) for Designer.
BusinessObjects Name of the functionality on which the restriction is placed
Functionality (D) for BusinessObjects.
Supervisor Name of the functionality on which the restriction is placed
Functionality (D) for Supervisor.
BusinessQuery Name of the functionality on which the restriction is placed
Functionality (D) for BusinessQuery.
WebIntelligence Name of the functionality on which the restriction is placed
Functionality (D) for WebIntelligence.

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

Category 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) Document age, in hours.
(D)
Document Age (min) Document age, in minutes.
(D)
Document Age (sec) Document age, in seconds.
(D)
Document Category (D) A list of document categories with hierarchical path if
one exists.
Document Creation Document creation date.
Date (D)
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).


Document Name & Document name, along with its type.
Type (D)
Document Persistent “Persistent” if a document is published to the
(D) 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 HTML hyperlink to a graphical image of the document
(picture) (De) 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).
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 Domain subclass

This 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

Document Domain (D) The list of document domain names.
Document Domain The name of the user who created the document
Creator (D) domain.
Document Domain The date that the domain was created.
Creation Date (D)
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.
NOTE
If 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.

Data Providers subclass

This 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.

Data Provider Name of the data provider.
Name (D)
Data Provider Information about the origin of the data in the data provider:
Source (D) 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 Last refresh date of the data provider.
Date (D)
Number of Rows Number of rows in the query.
(D)
Partial Indicator Information on the data provider, indicating whether the
(D) results are Partial or Total.
Received By subclass
This is a subclass of the Documents class that provides information on the users
receiving documents from the corporate repository. The following table lists the
Panel.

Recipient User profile as set in Supervisor: General Supervisor,
Function (D) Supervisor, Designer, Supervisor-Designer, User,
Broadcast Agent, or Versatile.
Recipient Name User name of the recipient.
(D)
Recipient Name User name of the recipient, preceded by the text string
(with label) (D) “Recipient Name.”

Universe Domain subclass

This 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

Universe Domain (D) The list of universe domain names.
Universe Domain The name of the user who created the universe
Creator (D) domain.
Universe Domain The date that the domain was created.
Creation Date (D)
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.
NOTE
If 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.

Universe class
This class provides universe setup information. The following table lists the
This Object... Returns

File 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 The first 256*2 characters of the universe description.
(De)
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 class
This class provides universe connection data. The following table lists the objects
that you can select from this class in the BusinessObjects Query Panel.

Connection Name of the universe connection.
Name (D)
Connection ID of the database middleware.
RDBMS (D)
Connection Type Connection type: Document Domain, Universe Domain, or
(D) Secured.
Last Action Date Date on which the universe connection was most recently
(D) changed.
Last Action Type The last type of action to be associated with the universe
(D) connection.
Values that can be returned include: Unchanged, Deleted,

Repository Analysis incompatibilities

The 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 in Class

with this object...
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

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

This 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.

Creation Date Date on which a universe was created.
(D)
Filename (D) The eight-byte name of the universe file. The downloaded
universe file is stored locally as a *.unv file.
Filename (with The eight-byte name of the universe file, preceded by the
label) (D) 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 Date on which a universe was last modified.
(D)
Linked Universe ID of the linked universe, if applicable.
ID (D)
Linked Universe Name of the linked universe, if applicable.
Name (D) This object applies only to linked universes, and not to
classes and objects in the current universe
Max Number Of Maximum number of columns allowed in queries for the
Columns (D) selected universe.
Max Number of Maximum number of rows that can be returned for the
Lines (D) selected universe.
Max Query Time Maximum query time, in seconds, allowed by the selected
(D) universe.
Number of Number of other universes to which the selected universe is
Linked linked in the repository.
Universes (M)


Number of Number of universes in the repository.
Universes (M)
Universe Help Help text available when selecting and opening a universe.
Text (D) 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 Name of a universe.
(D)
Universe Name Name of a universe, preceded by the text string “Universe
(with label) (D) Name”.
Universe Name Name of a universe, with its internal ID.
(with ID) (D)
Version (D) Version number of a universe.
This object does not apply to linked universes, only to the
current universe.
Class details class

This class provides information on universe classes. The following table lists the

Class 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) Name of a class, preceded by the text string “Class
(D) Name.”
Number of Classes (M) Number of unique universe classes.

Object details class

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

Hidden 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 Name of an object, preceded by the text string
label) (D) “Object Name.”
Object Position (D) Numerical position of an object within its class.
Object Table Name(s) Table names referenced by an object.
(D)
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.
Advanced subclass
This 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.

Incompatible A list of incompatible table names specified by Designer for
Table (D) proper hierarchy navigation.
Object The properties of an object.
Properties (D)
Object Security Public, Controlled, Restricted, Confidential, Private, or
Access Level (D) Unknown.
These values are set individually in Designer.

Condition details class

This class provides information on universe conditions. The following table lists
Panel.

Condition Description Description of the condition.
(D)
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 A list of table names used in the condition.
Name(s) (D)
Condition WHERE The Where clause associated with a condition, if
Clause (D) applicable.
Incompatible Table (D) A list of incompatible table names, specified in
Designer, for proper hierarchy navigation.
Number of Conditions Total number of conditions.
(M)

Universe tables class

This class provides information on universe tables. The following table lists the

Number 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.
Alias Information subclass

This is a subclass of the Universe Tables class that provides table alias

Alias 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 Base table name for an alias.
Name (D)

Joins class
This class provides information on universe joins. The following table lists the

Join 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.
Contexts class
This class provides data relating to universe contexts. The following table lists the

Context 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 class
This class provides information on universe hierarchies. The following table lists
Panel.

Hierarchy ID (D) ID of a hierarchy.
Hierarchy Name (D) Name of a hierarchy.
Hierarchy Name (with Name of a hierarchy, preceded by the text string
label) (D) “Hierarchy Name”.
Hierarchy Position in Position of a hierarchy in its universe.
Universe (D)
Number of Hierarchies (M) Total number of hierarchies.
Object Name in Hierarchy Name of an object in a hierarchy.
(D)
Object Position in Position of an object in a hierarchy.
Hierarchy (D)
Number of Objects in Hierarchies subclass

This 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

Number of Objects (M) Number of distinct objects in hierarchies.
Number of Object Number of object appearances (instances) in
Instances (M) hierarchies.

Universe Domain Analysis incompatibilities

The following table lists the objects in the Universe Domain Analysis universe
that are known to be incompatible.
This object... in Class... is incompatible in Classes

with this object...
Object Security Advanced All objects Joins, Contexts
Access Level and Hierarchies
Class Description Class Details All objects Joins, Contexts
and Hierarchies
Condition Name Condition All objects Joins, Contexts
Details and Hierarchies
Context Id Contexts All objects Hierarchies
Object Position Object Details All objects Joins, Contexts
and Hierarchies
Table/Alias Name Universe Table Name Universe Tables
Tables
Table/Alias Name Universe Table Name (with Universe Tables
Tables label)
Table/Alias Name Universe Alias Table ID Universe Tables
Tables

System information universe

This section lists the classes in the System Information universe, and the objects
that are available for selection within each class.
Actions class
This class provides specific data on user actions. The following table lists the

Action 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 ID of the event name.
(D)
Action Time (D) Action’s date and time.
Action Type (D) Type of action, such as Repository Name.
Action Type Detail A breakdown of Action Type, such as “Document” within
(De) Repository Name.
Action Type Detail A text string in front of Action Type Detail, such as “Object
(with label) (De) 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.


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 Name of the user who generated the event, preceded by
label) (D) the text string “User Name.”
NOTE
When 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'.

Action Details subclass

This 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

Number of Elements Number of items in the Inbox, Corporate or Personal
(D) 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 Name of the object, preceded by the text string
label) (D) “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 Total size of documents in the Inbox, Corporate or
in List (D) Personal document list.
This size is logged when a “Get list” event occurs.
Universe Name (D) Universe name.
Universe Name (with Universe name, preceded by the text string “Universe
label) (D) Name.”

Administration SDK subclass

This 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

Group Name Name of the group which was created or deleted
(Administration) (D) from the Administration SDK.
Object Security Level (D) The security level property of the user:
• private
• confidential
• restricted
• controlled
• public
Parent Group Name Name of the group of the user who had
(Administrator) (D) 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.
have to check his password. Otherwise the value
is 'FALSE' and no check will be asked again.


Password Limited Validity Three event details logged when the user
(D) password periodicity property has been changed:
• password limited validity
• validity is periodic
• validity period (days)
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 User password event logged when the user
(D) password property has been changed.
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 Three event details logged when the user
(D) password periodicity property has been changed:
• password limited validity
• validity is periodic
• validity period (days)
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.


Password Validity Period User password property: number of days that can
(Days) (D) elapse before the user is required to change their
password.
Profile Name (D) User profile setting:
• private
• confidential
• restricted
• controlled
• public
User Name Name of the user who had Administration SDK
(Administration) (D) security updates, for example, when if a user was
created or their profile set.
Browser information subclass
This 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
Panel.

Browser 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 subclass
This is a subclass of the Action Details subclass. The following table lists the
Panel.

Document Category (D) Category of the document.
Document Description (D) Document description.
Document ID (D) Document ID.
Document Name and Type Document name and type.
(D)
Document Name (with Name of the document, preceded by the text
label) (D) 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 subclass

This 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.

Document 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 subclass

This 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

Action Duration (sec) Total duration of an event, in seconds. Actual action
(M) 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 Total number of items associated with each user
Details (M) action.
Number of Actions (M) A count of the number of actions recorded
Number of Documents Number of documents that have been accessed.
Used (M)
Number of Log Offs (M) Number of log offs.
Number of Logins (M) Number of attempted logins.
Number of Rows Number of rows retrieved from a document.
Retrieved (M)
Number of Sessions Number of complete user sessions.
(M)
Number of Users (M) Number of user sessions opened so far.


Session Duration (hour) Total duration of a complete session, in hours.
(M) 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) Total duration of a complete session, in minutes.
(M) 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 Total size of a document, in bytes.
(M) Use this object in conjunction with the Document
Name object (Actions class on page 109) to return
bytes per document.

Averages subclass
This 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.

Avg Action Duration Average duration of an event, in seconds.
(sec) (M)
Avg Actions per Day (M) Average number of actions over a month, divided by
30.
Avg Actions per Hour Average number of actions over a day, divided by 24.
(M)
Avg Actions per Month Average number of annual actions, divided by 12.
(M)
Avg Document Size (M) Average document size, in bytes.
Avg Rows Retrieved Average number of rows retrieved via user queries.
(M)
Avg Session Duration Total session time over a day, divided by 24.
(hour) (M) 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 Total session time over a month, divided by 30.
(month) (M) You must use this object with the Session ID object
Avg Session Duration Total session time over a week, divided by 7.
(week) (M) You must use this object with the Session ID object
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 Average number of user sessions that were started
(M) per month.

Action Time subclass

This is a subclass of the Actions class that provides the timing of user actions.

Action 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 Name of the month in which an action took place.
(De)
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 Year (YYYY), month (MM), and day (DD) on which an
(D) action took place, such as 2001-01-25 for January
25, 2001.
Action YYYY-MM-DD Start time (to the second) of the event, in the format
HHMISS (D) 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 Start time (to the second) of the event for a given
(D) 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) subclass

This 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

Action Day (with label) Text string for the day on which an action took place,
(D) such as “Day: 28”.
Action DD/MM (with Text string “Action Start Time” preceding the day and
label) (D) month in which an action took place, such as “Action
Start Time: 25/09”.
Action Hour (with label) Text string for the hour in which an action took place,
(D) such as “Hour: 03”.
Action Minutes (with Text string for the minutes past the hour in which an
label) (D) action took place, such as “Minutes: 46”.
Action MM/DD (with Text string “Action Start Time” preceding the month
label) (D) and day on which an action took place, such as
“Action Start Time: 09/25”.
Action Month (with The month.
label) (D)
Action Month Name Text string for the month in which an action took
(with label) (De) place, such as “Month: 12”.
Action Quarter (with Text string for the quarter in which an action took
label) (D) place, such as “Quarter: Q4”.
Action Seconds (with Text string for the seconds after a minute in which an
label) (D) action took place, such as “Seconds: 50”.
Action Week (with label) Text string for the week in which an action took place,
(D) such as “Week: 51”.
Action Year (with label) Text string for the year in which an action took place,
(D) such as “Year: 2001”.

Session analysis (no actions) class

This 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.
NOTE
The 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.

Cluster 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) IP address of the session host.
(D)
Session User (D) Session user name.
Session User (no Session user name, if known.
'unknown' users) (D) 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
NOTE

Session Measures subclass

This is a subclass of the Session Analysis (No Actions) class that allows you to
measure the number and duration of sessions.
NOTE
The 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.

Number 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 subclass

This is a subclass of the Session Analysis (No Actions) class that enables you to
view the times at which sessions took place.
NOTE
The 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.

Session Day (D) The day number, such as 05 for the fifth day.
Session Duration (1 min Time blocks of one minute.
intervals) (D) 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 Time blocks of five minutes. Used as the default
intervals) (D) 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 class

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

Cluster 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.
NOTE

System information incompatibilities

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

with this object...
Number of Log Action All objects Action Measures,
Offs Measures Averages, Action Time
Number of Action Avg Document Averages
Sessions Measures Size
Number of Action Avg Rows Averages
Sessions Measures Retrieved
Number of Action All objects Session Measures
Sessions Measures
Avg Users per Averages Avg Users per Day Averages
Month
Avg Users per Averages Avg Users per Averages
Month Hour
Avg Actions per Averages Avg Actions per Averages
Month Day
Avg Actions per Averages Avg Actions per Averages
Month Hour
Avg Actions per Averages Number of Session Measures
Month Sessions
Month Session Users
Avg Actions per Averages Session Duration Session Measures
Month (sec)
Month (min)
Avg Actions per Averages Avg Session Session Measures
Month Duration (sec)
Month Duration (min)


with this object...
Day Sessions
Day Session Users
Day (sec)
Day (min)
Day Duration (sec)
Day Duration (min)
Hour Sessions
Hour Session Users
Hour (sec)
Hour (min)
Hour Duration (sec)
Hour Duration (min)

Using Auditor
part
Using Predefined Indicators
chapter
Overview
This 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 object
For monitoring and analysis that is even more finely tuned to your particular
system, you can create your own indicators.

Predefined indicators available with Auditor

The following table lists all the predefined indicators provided with Auditor.
Indicator Category Subcategory

10 Least Read Documents Document Management Top 10 & Bottom 10
10 Least Exported Document Management Top 10 & Bottom 10
Documents
10 Most Read Documents Document Management Top 10 & Bottom 10
10 Most Exported Document Management Top 10 & Bottom 10
Documents
Average Number of Users System Information Traffic
Concurrently Logged in
Average Refresh Time Document Management Usage
Average Session Duration System Information Traffic
per Cluster
per User
Broadcast Agents on the Broadcast Agent Global Console
System
Cluster Nodes System Information Usage
Deactivated Users User Information Security
Document Information Detail Document Management Analysis
Document Information Document Management Analysis
Summary
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 System Information Security
Audited Clusters


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 Management Analysis
Document
Most Popular Universes Universe Management Usage
Number of Objects per Universe Management Properties
Universe
Number of Users in the User Information Activity
Repository
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 System Information Traffic
Logged in by Day
Types of Browsers in Use System Information Usage
Universe Information Detail Universe Management Properties
Universe Information Universe Management Properties
Summary
Universe Usage Universe Management Usage
User Activity User Information Activity


User Activity per Session User Information Activity
User Information Detail User Information Security
User Information Summary User Information Security
User Profiles in the User Information Security
Repository
Users Who Logged Off User Information Activity
Incorrectly

User Information category

The 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 Questions
The 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 indicator

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 Refresh and Edit Activity
them?

Activity
Auditor provides the following predefined indicators for the Activity subcategory
within the User Information category.
This indicator... Provides... Via these reports

Last Login for Last date and time to the second • Last Login for User
User that a given user logged in to the
system.
Most Popular Quantity of the most popular • Most Popular Actions
Actions actions during a given time per Year
period. • Most Popular Actions
per Quarter
• Most Popular Actions
per Month
per Week
per Day
Number of Users Number of users in the • Number of Users in
in the Repository repository, along with the the Repository
following information about • Number of Instances
them: per User
• how many have logged in at • Active and Inactive
least once Users
• how many occurrences for
each user
• how many users have never
logged in
Number of User Total number of user sessions • Number of Sessions
Sessions by cluster, year, month, week, Per Month
and day. • Number of Sessions
Per Week
• Number of Sessions
Per Day


Refresh and Edit Number of edit and refresh • Refresh Actions per
Activity actions per document trace, per User
cluster and per selected user
over the whole period edited in
the audit database.
User Activity Number of users using the • User Activity per
system, for each month, week, Month
or day within a given time period. • User Activity per
You are prompted for the start Week
and end dates of the time period. • User Activity per Day
User Activity per Analyzes user activity for the N/A
Session whole content of the audit
database per cluster, session,
action and date.
Users Who Of the users who logged in • Statistics
Logged Off during a given year: • Users Who Logged
Incorrectly • total number of users Off Incorrectly
• 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

Security
Auditor provides the following predefined indicators for the Security subcategory
within the User Information category.
This Provides... Via these reports

indicator...
Deactivated List of deactivated users and • Deactivated Users
Users their profiles. • Disabled Logins
• Users Not Active in Last
30 Days
User List of users and the groups to • User Instance Status
Information which they belong. • User Instance Security
Detail For each separate membership Commands
instance, the following are
shown:
• user profile
• user status
• failed logins
• user level
• identification strategy
The security commands for a
given user are classified by
command sets.
User Users in each user group. Users and Groups
Information For each user, the following are
Summary shown:
• user name
• user profile
• status
User Profiles in • of the total number of users • User Profiles
the Repository in the repository, the • Deactivated Users
percentage in each profile • User Names per Profile
• a list of deactivated users
• total number and names of
users for each profile

Top 10 & Bottom 10

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

Most Active Users Number of logins and • Top 10 Users by Number of
refreshes for each of the Logins
top ten users. • Top 10 Users by Number of
Refresh Actions

Document Management category

The 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 questions
indicators they open in the Document Management category.

What 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 Documents Never Read
inbox?
What are the 10 most frequently exported 10 Most Exported Documents
documents?
What is the average time needed for reports to Average Refresh Time
refresh?

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

indicator...
Document • total number of documents past and • Document
Information present in the repository Information
Detail • alphabetical list of documents and their • Document
types. Usage
• actions performed on a given document, • Batch Usage
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 For each document domain: • Document
Information • total size in KB of all documents, by type Domain
Summary • number and percentage of documents for • Top 10
each document type Document
• list of analytical categories, showing for Owners
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 user
For 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


indicator...
Documents List of documents for which there are no • Documents
Never Read events “read corporate document” or “read Never Read in
inbox document” in the audit database. Corporate
• Documents
Never Read in
User Inbox
Document total space used by all: • Document Size
Size in • inbox documents in Corporate
Repository • corporate documents • Document Size
in User Inbox
Most Most popular actions taken for a given N/A
Popular document by:
Actions per • user
Document • session
• action name
• date
Objects • average number of objects for each type • Average
Used in of document Number of
Documents • list of objects contained in each Objects per
document, with the total number of Document
objects Type
• 20 most and least frequently used objects • Objects Used
for each type of document. Objects are per Document
listed in order of rank • 20 Most Used
Objects per
Document
Type
• 20 Least Used
Objects per
Document
Type

Top 10 & Bottom 10

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

indicator...
10 Least List of documents for which there are • 10 Least
Exported the least number of respective converted to CSV
Documents events: • 10 Least Sent to
• download documents Users
• send to users • 10 Least
• get a CSV document Downloaded
10 Least Read Number of times: • 10 Least Read
Documents • the 10 least read documents were • 10 Least
read Refreshed
• the 10 least refreshed documents • 10 Least Edited
were refreshed
• the 10 least edited documents
were edited
10 Most List of documents for which there are • 10 Most Converted
Exported the most respective events: to CVS
Documents • download documents • 10 Most Sent to
• send to users Users
• get a CSV document • 10 Most
Downloaded
10 Most Read Number of times: • 10 Most Read
Documents • the 10 most read documents were • 10 Most Refreshed
read • 10 Most Edited
• the 10 most refreshed documents
were refreshed
• the 10 most edited documents
were edited

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

Average Refresh The average refresh time per • Average Refresh
Time document, user, or cluster over Time per Document
the whole period covered in the • Average Refresh
audit database. Time per User
• Average Refresh
Time per Cluster
Document Usage Lists: • Documents Never
• the repository documents for Accessed
which there are no events in • Documents Deleted
the audit database from Repository
• the documents for which • Most Accessed
events were audited but that Documents
are no longer referenced in • Least Accessed
the repository Documents
• the most accessed • Document Usage
documents
• the least accessed
documents
• audit actions distribution for
each document

Universe Management category

The 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 system
In 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 questions
indicators they open in the Universe Management category.

How many universes do I have? Universe Information
Summary
How many documents do I have in each Impact Analysis
universe?
Which documents (already in use) are Impact Analysis
impacted if I modify an object?
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

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

indicator...
Impact • number of documents in • Number of Documents per
Analysis each universe Universe
• number of objects in each • Number of Objects per
document Document
• list of all the objects used in • Objects Used in
each document Documents

Properties
Auditor provides the following predefined indicators for the Properties
subcategory within the Universe Management category.
This Provides... Via these

indicator... reports
Joins per Joins for the currently selected universe. Joins by
Universe A join is a relational operation causing two Universe
or more tables with a common domain to
be combined into a single table.
For each join:
• join ID
• associated tables
• join SQL string
Number of Number of objects in each universe. • Universe
Objects per Filters are available for: Classes
Universe • Universe
• universe
Objects
• class
• object
Universe Prompt on the universe name. • Universe
Information Tables
Detail • Classes and
Objects
• Conditions
• Contexts
• Hierarchies

This Provides... Via these

indicator... reports
Universe • number of universes in the current • Universe
Information domain, and in all the domains in the Summary
Summary repository. • Universe
For each universe: Usage
- 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

Usage
within the Universe Management category.

indicator...
Most Number of actions for each universe, by • Most Popular
Popular month or week, during a given year. Universes per
Universes Universes are listed in order of rank. Month
• Most Popular
Universes per Week
Objects List of all objects used in the universe • Objects Accessed
Accessed showing: per Month
• the documents they appeared in • Objects Accessed
• the number of times the object was per Day
accessed
Universe Universe usage since a chosen date. • Universes Never
Usage Accessed
• Universes Deleted
from Repository
• Universe Usage

Broadcast Agent category

The 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 questions
indicators they open in the Broadcast Agent category.

How 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 Job Summary
Agent jobs?
Global console
Auditor provides the following predefined indicators for the Global Console
subcategory within the Broadcast Agent category.

Broadcast Correspondence between • Broadcast Agents and
Agents on the Broadcast Agents and cluster Cluster Node Locations
System nodes, along with the duration • Broadcast Agents and
of jobs per Broadcast Agent. Duration of Jobs (sec)
Broadcast Agent category

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

Job Success Analysis per error code, job • Failure Distribution
Rate frequency, document, and • Failure per BCA Error
current connection of the • Failure per Frequency
universe on which the document
• Failure per Document
is based.
Job Summary Job status per Broadcast Agent. • Jobs per Status
• Pending Jobs
• Successful Jobs
• Failed Jobs
Jobs per BCA Job status per Broadcast Agent. • Jobs per Broadcast
For each job, these details are Agent – Summary
shown: • Jobs per Broadcast
• user name Agent
• job description • Jobs per Node
Location
• job platform
• priority
• frequency
• begin time
• job status (success or failed)
Jobs per User Breakdown of Broadcast Agent • Jobs per User –
jobs according to user. Summary
• Jobs per User
• Job Duration per User
(sec)
• Job Failure per User
Jobs per Analysis of Broadcast Agent • Frequency
Frequency jobs by frequency. Distribution
• Frequency Detail

System Information category

The 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 questions
indicators they open in the System Information category.

What is the average session duration? Average Session Duration per User
Which types of browser are being Types of Browsers in Use
used?
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 IP Addresses Accessing my Audited
access my BI server solution and how Clusters
often?
How many users are accessing my Average Number of Users
system daily and when is the most Concurrently Logged In
popular time?

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

IP Addresses During a given time period: • IP Addresses
Accessing my • list of the IP addresses Accessing my
Audited Clusters accessing the clusters, with Audited Clusters
the total number of addresses per Year
• number of actions performed • IP Addresses
on each IP address Accessing my
Audited Clusters
per Month

Traffic
Auditor provides the following predefined indicators for the Traffic subcategory

indicator...
Average For each cluster or host • Average Session Duration
Session machine during a given year or in Minutes over the Period
Duration per set of years, the average • Average Session Duration
Cluster session duration (in minutes) in Minutes per Week
per time period. • Average Session Duration
The information is aggregated in Minutes per Day
for the selected years in the
Average Session Duration in
Minutes over the Period report.
Average For each user during a given • Average Session Duration
Session year, the average session in Minutes Over the Year
Duration per duration (in minutes) per time • Average Session Duration
User period. in Minutes per Month per
User
• Average Session Duration
in Minutes per Week per
User


indicator...
Average For any selected group of N/A
Session users, the average session
Duration duration per user by:
• year
• quarter
• month
• week
• day
• hour
Average For a given month: • Average Number of
Number of • average number of Concurrent Logged In
Users concurrent sessions during Sessions
Concurrently each hour • Users Concurrently Logged
Logged In • names and number of In
users concurrently logged • Average Users
in during each hour Concurrently Logged In
Total Users For a given day: • Total Number of
Concurrently • total number of concurrent Concurrent Logged In
Logged In by sessions during each hour Sessions
Day • names and total number of • Users Concurrently Logged
users concurrently logged In
in during each hour

Usage

Types of • types of browser being used • Types of Browser
Browsers in Use and the percentage for each • Number of Logins per
one Browser
• number of logins for each
type of browser
Cluster Nodes • for each cluster, the number • Servers in the Cluster
of nodes and the number of • Module’s Last Known
active modules Status
• for each module, the last
known status and the date
and time of the last update
Peak Usage An aggregate for a set of • User Login Peaks
selected years and the model of • Session Login Peaks
a "typical day" for logins, • Number of Action
sessions, and number of actions Peaks
No for a specified time period.


Creating, Modifying, and

Publishing Indicators
chapter
Overview
This 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.
Creating, Modifying, and Publishing Indicators

Universes, classes, and objects

Knowledge 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.
Universe File name

Broadcast Agent Analysis BCA.unv
Repository Analysis SECURITY.unv
Universe Domain Analysis UNIVERSE.unv
System Information ACTIVITY.unv
The predefined universes are attached to different domains. These domains are
connected to databases during installation, prior to export of the universes.

Broadcast Agent Analysis Security Corporate repository
Repository Analysis Security Corporate repository
Universe Domain Analysis Universe Corporate repository
System Information Audit database Audit database
Each universe provides an interface for different classes of database objects,

permitting compatible objects to be used in building queries using the
The Query Panel is displayed in Auditor following the selection of either:
• the Add a New Indicator command
• the Edit option for an existing indicator
The 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.
Universes, classes, and objects

Access rights for indicators

The 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 documents
Edit 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
Before 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.
Creating indicators
Publish to Corporate Indicators

1. Save the report to the default directory:
\Business Objects\BusinessObjects Enterprise 6\UserDocs
2. If you want to assign a subcategory, choose File, Properties, and enter the
subcategory name in the Keywords field.
NOTE
The 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.
8. Click OK.
Save to Personal Indicators

1. 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
You can add or remove objects, change the formatting and layout, or modify the
conditions of an existing indicator.
To modify an existing indicator

1. Log in to the Auditor site: http://<hostname>:<portname>/auditor
2. 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.
click Edit
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.
Modifying indicators
Publish to Corporate Indicators

1. Save the report to the default directory:
\Business Objects\BusinessObjects Enterprise 6\UserDocs
2. If you want to assign a subcategory, select File, Properties, and enter the
subcategory name in the Keywords field.
NOTE
The 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 Indicators

1. 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
When 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.
NOTE
When 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.

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.
11. Click Publish.
Auditor publishes the indicator.
Saving indicators in Auditor

When 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.
NOTE
When 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.

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.
Saving indicators in Auditor

Deleting indicators
If 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.
REMINDER
You 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

In 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.

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.
click the Refresh icon if the newly-published indicator
does not appear
16. View and test the new indicator.


Using Auditor to Solve Business

Problems
chapter
Overview
This 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 question
It is assumed that you already know how to use Auditor, as explained in the
previous chapters of this guide.
Using Auditor to Solve Business Problems

Business questions
Each 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 Indicator

User What is the total number of users? Number of Users in the
Information Repository
What are my user profiles? User Profiles in the
Repository
What is my user activity by month, User Activity
week, day?
Whose passwords have been Deactivated Users
deactivated?
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 Last Login for User
logged in?
Are my users editing reports or only Refresh and Edit Activity
refreshing them?
Document What are my 10 most popular 10 Most Read
Management documents? Documents
What are my 10 least popular 10 Least Read
documents? Documents
Which documents have never been Documents Never Read
opened?
What is my average document size? Document Size in
Repository

How many objects are in each Objects Used in
document? Documents
How many users have unread Documents Never Read
reports in their inbox?
What are the 10 most frequently 10 Most Exported
exported documents? Documents
What is the average time needed for Average Refresh Time
reports to refresh?
Universe How many universes do I have? Universe Information
Management Summary
How many documents do I have in Impact Analysis
each universe?
Which documents (already in use) Impact Analysis
are impacted if I modify an object?
Which joins are used in my Joins by Universe
universes?
Which connections are my Universe Information
universes using? Summary
Which are the most popular Most Popular Universes
universes?
Broadcast How many Broadcast Agents do I Broadcast Agents on the
Agent have? System
How many tasks were processed by Jobs per Broadcast Agent
Broadcast Agent?
How many tasks are pending on Job Summary
Broadcast Agent?
What is the success rate of Job Summary
Broadcast Agent jobs?
System What is the average session Average Session
Information duration? Duration per User
Which types of browser are being Types of Browsers in Use
used?


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 IP Addresses Accessing
to access my BI server solution and my Audited Clusters
how often?
How many users are accessing my Average Number of
system daily and when is the most Users Concurrently
popular time? Logged In
Creating a business question

You 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.
NOTE
To 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.
- Generate a standard report
- Universe
- System Information: Audit universe
4. Click Finish.
How do I monitor the use of Business Objects products?

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 monitor the use of Business Objects products?

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 Summary
Using 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 questions
The 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 Broadcast Agent Broadcast Agents on
I have? the System
How many tasks were Broadcast Agent Jobs per Broadcast
processed by Broadcast Agent? Agent
How many tasks are pending on Broadcast Agent Job Summary
Broadcast Agent?
What is the success rate of Broadcast Agent Job Summary
Broadcast Agent jobs?

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 period
Because 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:
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 questions
The following preset business questions are designed to help you find out which
machines are being used to access your system.

Which IP addresses are being System Information IP Addresses
used to access my BI server Accessing my Audited
solution and how often? Clusters
How do I find out which machines are accessing my system?

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:
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 questions
The following preset business questions are designed to help you detect fraud.

Whose passwords have been User Information Deactivated Users
deactivated?
Who does not log out correctly? User Information Users Who Logged Off
Incorrectly
Which IP addresses are being System IP Addresses
used to access my BI server Information Accessing my Audited
solution and how often? Clusters

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 users

To see the number of concurrent logged-in users:
2. Click the Refresh option for the Total Users Concurrently Logged in by Day
indicator.
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.
How do I monitor login information?

Monitoring the average duration of user sessions

The 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:
2. Select the Traffic subcategory.
3. Click the Refresh option for the Average Session Duration per User indicator.
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 questions
The following preset business questions are designed to help you monitor login
information.

Who does not log out User Information Users Who Logged Off
correctly? Incorrectly
When was the last time User Information Last Login for Users
users logged in?
What is the average System Average Session Duration
session duration? Information per User
How many users are on my System Average Number of Users
system? Information Concurrently Logged In

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:
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 questions
The following preset business questions are designed to help you monitor the
load on your server.

What are the most popular User Information Most Popular Actions
actions?
What is the average time Document Average Refresh Time
needed for reports to refresh? Management
How do I monitor the load on my server?

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 documents

To 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 spreadsheet

The 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:
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 questions
The following preset business questions are designed to help you track the most
requested documents.

What are my 10 most popular Document 10 Most Read
documents? Management Documents
What are the 10 most frequently Document 10 Most Exported
exported documents? Management 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 Edited
The 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 Edited
To track the least read documents:
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.
How do I track the least/most popular documents?

Business questions
The following preset business questions are designed to help you track the least/
most popular documents.

What are my 10 most popular Document 10 Most Read
What are my 10 least popular Document 10 Least Read
Which documents have never Document Documents Never Read
been opened? Management
How many users have unread Document Documents Never Read
documents in their inbox? Management
What are the 10 most frequently Document 10 Most Exported
exported documents? Management Documents

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:
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.
- Generate a Standard Report
- Universe
- System Information universe
4. Click Finish.
How do I monitor universe hits?

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 questions
The following preset business questions are designed to help you monitor
universe hits.

Which are the most popular Universe Most Popular Universes
universes? Management

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 questions
The following preset business questions are designed to help you use Auditor for
billing.

How many users are accessing System Average Number of
my system daily and when is the Information Users Concurrently
most popular time? Logged In
Who uses my system the most? System Refresh and Edit
Information Activity
How do I use Auditor for billing?

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 Documents
This 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.
NOTE
Only documents that have already been used appear in these reports.
To access the Impact Analysis group of reports:

2. Click the Refresh option for the Impact Analysis indicator.
Business questions
The following preset business questions are designed to help you perform impact
analysis.

How many objects are in each Document Objects Used in
document? Management Documents
How many documents do I have Universe Impact Analysis
in each universe? Management
Which documents (already in Universe Impact Analysis
use) are impacted if I modify an Management
object?

Index
Symbols action name object 109
10 least accessed documents 144 action quarter (with label) object 122
10 least exported documents 144 action quarter object 120
10 least read documents 193 action seconds (with label) object 122
10 most accessed documents 144 action seconds object 120
10 most exported documents 144, 192 action time frame (with label) subclass 122
10 most read documents 193 action time object 109
action time subclass 120-121
incompatibilities 127
A action type detail (with label) object 109
access rights for indicators 162 action type detail object 109
action app id object 109 action type object 109
action app object 109 action week (with label) object 122
action day (with label) object 122 action week object 120
action day object 120 action year (with label) object 122
action DD/MM (with label) object 122 action YYYY object 120
action details subclass 111-116 action YYYY-MM object 120
administration SDK subclass 112-114 action YYYY-MM-DD HHMISS object 120
browser information subclass 114 action YYYY-MM-DD object 120
document subclass 115 actions class 109-122
page information subclass 116 action details subclass 111-116
action duration object 117 action measures subclass 117-118
action error id object 109 action time frame (with label) subclass 122
action HHMISS object 120 action time subclass 120-121
action host object 109 averages subclass 119
action hour (with label) object 122 actions subclass 79
action hour am/pm object 120 actions type object 79
action hour object 120 activity subcategory 137
action id object 109 last login for user 137
action measures subclass 117-118 most popular actions 137
incompatibilities 127 number of user sessions 137
action minutes (with label) object 122 number of users in the repository 137
action minutes object 120 refresh and edit activity 138
action MM/DD (with label) object 122 user activity 138
action month (with label) object 122 user activity per session 138
action month name (with label) object 122 users who logged off incorrectly 138
action month name object 120 activity.unv 161
action month object 120 administration SDK subclass 112-114
action name id object 109
Index
advanced subclass 103 averages subclass 119

incompatibilities 108 incompatibilities 127, 128
alias (y or n) object 105 avg action duration (sec) object 119
alias information subclass 105 avg actions per day object 119
alias table id object 105 incompatibilities 127
incompatibilities 108 avg actions per hour object 119
analysis subcategory 142-143 incompatibilities 127
document information detail 142 avg actions per month object 119
document information summary 142 incompatibilities 127
document size in repository 143 avg document size object 119
documents never read 143 incompatibilities 127
objects used in documents 143 avg rows retrieved object 119
analytical categories incompatibilities 127
Broadcast Agent analysis 74 avg session duration (hour) object 119
description 20 avg session duration (min) object 124
repository analysis 74 incompatibilities 127
system information universe 74 avg session duration (month) object 119
universe domain analysis 74 avg session duration (sec) object 124
assigned user groups 44 incompatibilities 127, 128
audit BCA measures class 88 avg session duration (week) object 119
incompatibilities 89 avg users per day object 119
audit database incompatibilities 127, 128
connecting 44 avg users per hour object 119
setting up 32 incompatibilities 127, 128
audit database domain 161 avg users per month object 119
audit facility incompatibilities 127
database mode 22
description 22 B
file mode 22
batch id object 78
audit tab 43
batch information class 78-81
Auditor
actions subclass 79
components 20-21
monitoring job information subclass 81
monitoring multiple clusters 57
scheduling information subclass 80
removing 59-62
BCA & BO server names object 76
uses 19
BCA id object 76
Auditor files
BCA information class 76-77
uninstalling 62
BCA name (label) object 76
average duration object 86
BCA name object 76
average number of users concurrently logged in
BCA server name object 77
156
BCA status object 77
average refresh time 145
bca.unv 161
average session duration 156
begin date object 87
average session duration per cluster 155, 190
begin date time frame subclass 87
average session duration per user 155, 190
begin time object 80
Index
billing reports detecting fraud 188

business questions 197 document management category 141
creating 197 impact analysis 198
BO server name (with label) object 77 information category 136
BO server name object 77 least/most popular documents 194
BO version of the submitter object 84 monitoring login information 190
Broadcast Agent monitoring machine access 187
tracking usage 186 monitoring server load 191
Broadcast Agent analysis monitoring universe usage 196
analytical categories 74 monitoring user activity 191
audit BCA measures class 88 most requested documents 192
batch information class 78-81 system information category 153
BCA information class 76-77 universe management category 146
bca.unv 161 BusinessObjects functionality object 92
document information class 82-83 BusinessQuery functionality object 92
domain 75
incompatibilities 89 C
predefined universes 75
category
recipient information class 85
Broadcast Agent 151-152
submitter information class 84
description 20
time frame class 86-87
document management 141-143
universe 76-89
system information 153-157
Broadcast Agent analysis universe 161
universe management 146-150
Broadcast Agent category 151-152
user information 136-140
business questions 151, 186
category creator object 82, 93
global console subcategory 151
category name object 82, 93
job information subcategory 152
category path object 82, 93
Broadcast Agent usage
change list display and default home page
business questions 186
command set 67
Broadcast Agents on the system 151
change password command set 67
browser information subclass 114
change viewing and editing technology options
browser type object 114
command set 67
Business Objects
class
consulting services 11, 13
actions 109-122
documentation 10
audit BCA measures 88, 89
Documentation Supply Store 9
batch information 78-81
monitoring use of products 183-185
BCA information 76-77
support services 11
class details 102, 108
training services 11, 13
condition details 104, 108
business questions
connection 99, 100
all 179-181
contexts 106, 108
Broadcast Agent category 151, 186
document information 82-83
Broadcast Agent usage 186
documents 93-96, 100
creating 182
hierarchies 107, 108
creating reports for billing 197
joins 106, 108
Index
object details 103, 108 condition id object 104

recipient information 85 condition name object 104
session analysis (actions) 123-125 incompatibilities 108
site log info 126 condition position object 104
submitter information 84 condition table name(s) object 104
time frame 86-87 condition WHERE clause object 104
universe 98, 100 connection class 99
universe parameters 101-102 incompatibilities 100
universe tables 105, 108 connection name object 99
user 90-92 incompatibilities 100
class description object 102 connection RDBMS object 99
incompatibilities 108 incompatibilities 100
class details class 102 connection type object 99
incompatibilities 108 incompatibilities 100
class hidden object 102 consultants
class id object 102 Business Objects 11
class name (with label) object 102 context id object 106
class name object 102 incompatibilities 108
client ip object 114 context join id object 106
client os object 114 context join sql object 106
cluster id object 109, 123, 126 context join table 1 name object 106
cluster monitoring 57 context join table 2 name object 106
cluster name object 109, 123, 126 context name object 106
cluster nodes 157 contexts class 106
command set incompatibilities 108
change list display and default home page 67 corporate indicators
change password 67 publishing to 164
change viewing and editing technology options count BCA jobs object 88, 89
67 count job expired object 88, 89
create indicators 68 count job failed object 88, 89
definition 65 count job running object 88
edit indicators 68 count job success object 88, 89
formatting toolbar 68 count job suspended object 88, 89
refresh lists of values 68 count job waiting object 88, 89
run and refresh documents 69 count object 117
use list of values 69 count recipients object 85
view SQL 69 create indicators command set 68
command set family creating
document 66 billing reports 197
options 67 business questions 182
query and report panel 68 database views 48
condition description object 104 indicators 163-164
condition details class 104 creation date object 101
incompatibilities 108 customer support 11
condition hidden object 104 custom-made universes 75
Index
D Document Exporter
data object 79 accessing in UNIX 49
data provider name object 96 exporting documents 50-51
data provider source object 96 removing documents with 61-62
data providers subclass 96 document id object 82, 93, 115
incompatibilities 100 document information class 82-83
database mode 22 document information detail 142
database views document information summary 142
creating manually 48 document management category 141-143
removing 60 analysis subcategory 142-143
date format 76 business questions 141
days of the month object 80 properties subcategory 148-149
days of the week object 80 top 10 & bottom 10 subcategory 144
deactivated users 139 usage subcategory 145
deleting document name & type object 82, 94
indicators 172 document name (with label) object 115
universes 59 document name and type object 115
demo materials 9 document name object 82, 93
Designer functionality object 92 document persistent object 82, 94
Designer user document popularity tracking 192, 194
setting privileges 35 document repository id object 82
destination universe domain 44 document repository name object 82
detail objects 73 document size in repository 143
detecting fraud 188 document size object 82, 94, 117
Developer Suite 10, 12 document subclass 115
dimensions 73 document type (picture) object 83, 94
distribution path object 85 document type object 82, 94, 115, 116
distribution system object 85 document usage 145
document age (hour) object 93 documentation
document age (min) object 93 CD 9
document age (sec) object 93 feedback on 10
document category object 82, 93, 115 on the web 9
document command set printed, ordering 9
publish document 66 roadmap 9
read corporate documents 66 search 9
save document 66 Documentation Supply Store 9
document creation date object 93 documents
document description object 115 removing 61-62
document domain creation date object 95 tracking least/most popular 193-194
document domain creator object 95 tracking most requested 192
document domain object 93, 95
document domain subclass 95
Index
documents class 93-96 fraud detection 188

data provider subclass 96 business questions 188
document domain subclass 95 frequency object 80
received by subclass 96 G
universe domain subclass 97
global console subcategory 151
documents never read 143
Broadcast Agents on the system 151
domains
group name (administration) object 112
audit database 161
group name object 77, 90
predefined universes 75, 161
group recipient name object 85
security 161
group submit name (with label) object 84
universe 161
group submit name object 84
duration object 96
E H
hidden object object 103
edit indicators command set 68
hierarchies class 107
education see training
end date object 87
number of objects in hierarchies subclass 107
end date time frame subclass 87
hierarchy id object 107
end user process id object 78
hierarchy name (with label) object 107
expiration date object 87
hierarchy name object 107
expiration date time frame subclass 87
hierarchy position in universe object 107
export tab 44-45
exporting
documents 50-51 I
documents manually 52-56 identification strategy object 90
predefined indicators 49-56 impact analysis 147, 198
universes 36-47 business questions 198
universes manually 47 impact analysis subcategory
using Document Exporter 50-51 impact analysis 147
predefined indicators 147
incompatibilities
F
action measures subclass 127
failed logins object 90
action time subclass 127
feedback
advanced subclass 108
on documentation 10
alias table id object 108
file mode 22
audit BCA measures class 89
file name object 98
averages subclass 127, 128
avg actions per day object 127
filename (with label) object 101
avg actions per hour object 127
filename object 101
avg actions per month object 127
first author object 101
avg document size object 127
formatting toolbar command set 68
avg rows retrieved object 127
avg session duration (min) object 127
avg session duration (sec) object 127, 128
Index
avg users per day object 127, 128 indicators

avg users per hour object 127, 128 access rights 162
avg users per month object 127 creating 163-164
Broadcast Agent analysis 89 deleting 172
class description object 108 description 20
class details class 108 exporting 50-51
condition details class 108 list of all 133-135
condition name object 108 modifying 165-166
connection class 100 predefined
connection name object 100 exporting 49-56
connection RDBMS object 100 exporting manually 52-56
connection type object 100 publishing 167-169
context id object 108 publishing to corporate 164
contexts class 108 restoring 58
data providers subclass 100 saving 170-171
documents class 100 saving as personal 164
file name object 100 inheritance rights object 90
hierarchies class 108 interface impact
joins class 108 document command sets 66
last action date object 100 options command sets 67
last action type object 100 query panel command sets 68
number of log offs object 127 report panel command sets 68
number of session users object 127, 128 ip addresses accessing my audited clusters 154,
number of sessions object 127, 128 187, 188
object details class 108
object position object 108 J
object security access level object 108
job description object 78
repository analysis 100
job duration max object 86
session duration (min) object 127, 128
job duration min object 86
session duration (sec) object 127, 128
job duration object 86
session measures subclass 127, 128
job error code object 81
status object 100
job error warning or text object 81
system information universe 127
job information subcategory 152
table name (with label) object 108
job success rate 152
table/alias name object 108
job summary 152
universe class 100
jobs per BCA 152
universe domain 100
jobs per frequency 152
universe domain analysis 108
jobs per user 152
universe name object 100
job platform object 78
universe tables class 108
job state object 81
incompatible table object 103, 104
job status object 81
job success rate 152
job summary 152
jobs per BCA 152
jobs per frequency 152
Index
jobs per user 152 log time object 126

join id object 106 login information
join sql object 106 business questions 190
joins class 106 monitoring 189-190
incompatibilities 108 login users
joins per universe 148 monitoring daily amount 189
K M
keyword object 115 max number of columns object 101
Knowledge Base 12 max number of lines object 101
max query time object 101
L measures 73
modifying indicators 165-166
last action date object
monitoring
connection class 99
average duration of user sessions 190
document class 94
daily amount of login users 189
login information 189-190
document information class 83
machine access business questions 187
machines accessing the system 187
user class 90
multiple clusters 57
last action object 83
server load 191
last action start time object 121
universe usage 195-196
last action type object
use of Business Objects projects 183-185
connection class 99
user activity 191
document class 94
monitoring job information subclass 81
most active users 140
document information class 83
most popular actions 137
most popular actions per document 143
most popular universes 150, 195
user class 90
multimedia quick tours 10
last author object 101
multiple cluster monitoring 57
last login for user 137
last modify date object 101
last refresh date object 96 N
last update time object 98 number of action details object 117
linked universe id object 101 number of actions object 117
linked universe name object 101 number of classes object 102
log files 22 number of conditions object 104
log host object 126 number of contexts object 106
log id object 126 number of documents object 83
log info object 126 number of documents used object 117
log level object 126 number of elements object 111
log module object 126 number of hierarchies object 107
log PID object 126 number of joins object 106
Index
number of linked universes object 101 original database table name object 105
number of log offs object 117 overwrite mode object 78
incompatibilities 127 overwrite object 115
number of logins object 117 owner/sender object 94
number of object instances object 107
number of objects in hierarchies subclass 107 P
number of objects object 103, 107
page information subclass 116
number of objects per universe 148
page range object 116
number of rows object 96, 111
parameters for export of universes 44
number of rows retrieved object 117
parent group name (administrator) 112
number of session users object 124
partial indicator object 96
incompatibilities 127, 128
particular conditions object 79
number of sessions object 117, 124
password can change object 112
incompatibilities 127, 128
password checking object 112
number of tables object 105
password limited validity object 113
number of universes object 102
password must change object 113
number of user sessions 137
password object 112
number of users in the repository 137
password periodic validity object 113
number of users object 117
password status object 113
password validity period object 114
O peak usage 157, 191
object description object 103 periodicity detail object 80
object details class 103 periodicity object 80
advanced subclass 103 personal indicators
incompatibilities 108 saving as 164
object id object 103 predefined indicators
object name (with label) object 103, 111 activity subcategory 137
object name in hierarchy object 107 analysis subcategory
object name object 103, 111 document management category 142-143
object position in hierarchy object 107 description 20
object position object 103 exporting 49-56
incompatibilities 108 exporting manually 52-56
object properties object 103 global console subcategory
object security access level object 103 Broadcast Agent category 151
incompatibilities 108 impact analysis subcategory 147
object security level object 112 job information subcategory
object table name(s) object 103 Broadcast Agent category 152
object type object 103 list of all 133-135
objects assessed 150 properties subcategory
objects filter object 98 document management category 148-149
objects used in documents 143 restoring 58
Online Customer Support 11 security subcategory
options command set family 67 system information category 154
user information category 139
Index
top 10 & bottom 10 refresh lists of values command set 68

user information category 140 refresh options object 115
top 10 & bottom 10 subcategory removing
document management category 144 Auditor 59-62
traffic subcategory database views 60
system information category 155-156 documents 61-62
usage subcategory report bursting feature object 79
document management category 145 report name object 116
system information category 157 reports for billing purposes 197
universe management category 150 repository action analysis 197
predefined universes 75, 161 repository analysis
activity.unv 161 analytical categories 74
bca.unv 161 connection class 99
description 21 documents class 93-96
domains 75, 161 domain 75
security.unv 161 incompatibilities 100
universe.unv 161 predefined universes 75
priority (picture) object 78 security.unv 161
priority object 78 universe 90-100
privileges for Auditor-dedicated Designer user 35 universe class 98
profile name object 114 user class 90-92
properties subcategory 148-149 repository analysis universe 161
joins per universe 148 repository name object 111
number of objects per universe 148 resource object 90
universe information detail 148 resource status object 91
universe information summary 149 restoring predefined indicators 58
publish document command set 66 row restriction object 98
publishing run and refresh documents command set 69
indicators 167-169
to corporate indicators 164 S
save document command set 66
Q saving
query and report panel command set family 68 as personal indicators 164
indicators 170-171
R scheduling information subclass 80
script options object 79
read corporate documents command set 66
search documentation 9
received by subclass 96
security commands subclass 92
recipient function object 96
security configuration object 92
recipient information class 85
security domain 161
recipient name (with label) object 96
security domain connection 44
recipient name object 85, 96
security family object 92
recipient status object 85
security functionality object 92
recipient user type object 85
security status object 92
refresh and edit activity 138
Index
security subcategory setting up

deactivated users 139 audit database 32
ip addresses accessing my audited clusters privileges for Auditor-dedicated Designer user
154 35
system information category 154 site log info class 126
user information category 139 sql file database scripts
user information detail 139 location 48
user information summary 139 names 48
user profiles in the repository 139 SQL value object 111
security tab 41 start date object 86
security.unv 161 start date time frame subclass 86
SELECT clause object 103 status object 94, 98
server load monitoring 191 incompatibilities 100
business questions 191 submit date time frame subclass 86
sesn host (user ip) object 123 submit datetime object 86
sesn user (no ’unknown’ users) object 123 submit name & user profile (label) object 84
sesn user object 123 submit name & user profile object 84
session analysis (no actions) class 123-125 submitter information class 84
session measures subclass 124 sum document size object 118
session time subclass 125 supervisor functionality object 92
session day object 125 support
session duration (1 min intervals) object 125 customer 11
session duration (5 min intervals) object 125 system information category 153-157
session duration (hour) object 118 business questions 153
session duration (min) object 118, 124 security subcategory 154
incompatibilities 127, 128 traffic subcategory 155-156
session duration (sec) object 124 usage subcategory 157
incompatibilities 127, 128 system information universe 109-128, 161
session end time object 121, 123 actions class 109-122
session hour object 125 activity.unv 161
session id object 110, 123 analytical categories 74
session measures subclass 124 domain 75
incompatibilities 127, 128 incompatibilities 127
session minutes object 125 predefined universes 75
session MM object 125 session analysis (actions) class 123-125
session quarter object 125 site log info class 126
session start object 125 system monitoring 187
session start time object 121, 123
session time subclass 125 T
session week object 125
table 1 name object 106
session YYYY object 125
table 2 name object 106
session YYYY-MM object 125
table id object 105
session YYYY-MM-DD object 125
table mapping object 98
table name (with label) object 105
Index
table/alias name object 105 universe domain analysis

incompatibilities 108 analytical categories 74
table/alias properties object 105 domain 75
time format 76 incompatibilities 108
time frame class 86-87 predefined universes 75
begin date time frame subclass 87 universe 101-108
end date time frame subclass 87 universe.unv 161
expiration date time frame subclass 87 universe domain analysis universe 161
start date time frame subclass 86 class details class 102
submit date time frame subclass 86 condition details class 104
Tips & Tricks 10 contexts class 106
top 10 & bottom 10 subcategory hierarchies class 107
10 least accessed documents 144 joins class 106
10 least exported documents 144 object details class 103
10 most accessed documents 144 universe parameters class 101-102
10 most exported documents 144 universe tables class 105
document management category 144 universe domain connection 44
most active users 140 universe domain creation date object 97
user information category 140 universe domain creator object 97
total size of elements in list object 111 universe domain object 97, 98
total users concurrently logged in by day 156, 189 universe domain subclass 97
tracking Universe Exporter
least/most popular documents 194 audit tab 43
most requested documents 192 export tab 44-45
the least/most popular documents 193-194 removing database views 60
use of Broadcast Agent 186 security tab 41
traffic subcategory 155-156 tabs 37
average number of users concurrently logged universe tab 42
in 156 using 36-45
average session duration 156 universe help text object 102
average session duration per cluster 155 universe id object 98, 102
average session duration per user 155 universe information detail 148
total users concurrently logged in by day 156 universe information summary 149
training on Business Objects products 11 universe management category 146-150
types of browsers in use 157 business questions 146
impact analysis subcategory 147
U usage subcategory 150
universe name (with id) object 102
uninstalling
universe name (with label) object 102, 111
Auditor files 62
universe name object 98, 102, 111
universe class 98
universe parameters class 101-102
universe description object 98
universe revision object 98
universe domain 161
universe tab 42
Index
universe tables class 105 user activity per session 138

alias information subclass 105 user class 90-92
incompatibilities 108 security commands subclass 92
universe usage 150 user group (with label) object 91
business questions 196 user group object 91
universe.unv 161 user information category 136-140
universes activity subcategory 137
analytical categories 74 business questions 136
Broadcast Agent analysis 76-89 security subcategory 139
incompatibilities 89 top 10 & bottom 10 140
custom-made 75 user information detail 139
deleting 59 user information summary 139
description 21 user level object 91
exporting 36-47 user name (administration) object 114
suggested connections 47 user name (target) option 115
exporting manually 47 user name (with label) object 91, 110
monitoring usage 195-196 user name object 91, 110
predefined 75, 161 user profile object 91
domains 75 user profiles in the repository 139
repository analysis 90-100 user sessions
incompatibilities 100 monitoring average duration 190
structure 73 user status (picture) object 91
system information 109-128 user status object 91
incompatibilities 127 user submit name object 84
universe domain analysis 101-108 user submit type object 84
incompatibilities 108 users who logged off incorrectly 138
usage Using 131
Broadcast Agent 186
usage subcategory V
average refresh time 145
version object 102
cluster nodes 157
view SQL command set 69
document management category 145
document usage 145
most popular actions per document 143 W
most popular universes 150 web
objects accessed 150 customer support 11
peak usage 157 getting documentation via 9
system information category 157 useful addresses 12
types of browsers in use 157 WebIntelligence functionality object 92
universe management category 150 WHERE clause object 103
universe usage 150
use list of values command set 69
user activity 138
monitoring 191
Index
Index

Businessobjects Auditor Guide: Ewboa60.Book Page 1 Tuesday, August 19, 2003 10:52 Am

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Businessobjects Auditor Guide: Ewboa60.Book Page 1 Tuesday, August 19, 2003 10:52 Am

Uploaded by

Copyright:

Available Formats

ewboa60.

book Page 1 Tuesday, August 19, 2003 10:52 AM

BusinessObjects Auditor Guide

BusinessObjects Auditor 6.1

Windows and UNIX

2 BusinessObjects Auditor Guide

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

Part I Administering Auditor

Chapter 1 Introducing BusinessObjects Auditor 17

Chapter 2 Setting Up and Removing Auditor 23

Chapter 3 Setting Access Rights 63

4 BusinessObjects Auditor Guide

Chapter 4 Universes, Classes and Objects 71

Part II Using Auditor

Chapter 5 Using Predefined Indicators 131

Chapter 6 Creating, Modifying, and Publishing Indicators 159

BusinessObjects Auditor Guide 5

Chapter 7 Using Auditor to Solve Business Problems 177

6 BusinessObjects Auditor Guide

Maximizing Your Information

8 BusinessObjects Auditor Guide

Maximizing Your Information Resources

BusinessObjects Auditor Guide 9

Documentation from the products

Documentation on the web

Buy printed documentation

Search the Documentation CD

10 BusinessObjects Auditor Guide

How can I get the most recent documentation?

Tips & Tricks

Developer Suite Online

Send us your feedback

Maximizing Your Information Resources

BusinessObjects Auditor Guide 11

How we can support you?

Online Customer Support

Having an issue with the product?

Looking for the best deployment solution for your company?

Looking for training options?

12 BusinessObjects Auditor Guide

Useful addresses at a glance

Business Objects Documentation Feedback or questions about documentation.

Maximizing Your Information Resources

BusinessObjects Auditor Guide 13

www.techsupport.businessobjects.com Starting point for answering questions, resolving

www.businessobjects.com/services Information about registering with Worldwide

Useful addresses at a glance

14 BusinessObjects Auditor Guide

About this guide

Conventions used in this guide

Maximizing Your Information Resources

18 BusinessObjects Auditor Guide

Auditor is built on the existing Business Objects technology and server

Introducing BusinessObjects Auditor

BusinessObjects Auditor Guide 19

What you can do with Auditor

What you can do with Auditor

20 BusinessObjects Auditor Guide

Introducing BusinessObjects Auditor

BusinessObjects Auditor Guide 21

22 BusinessObjects Auditor Guide