auditor
TRANSCRIPT
BusinessObjects Auditor Guide
BusinessObjects Auditor 6.1
Windows and UNIX
ewboa60.book Page 1 Tuesday, August 19, 2003 10:52 AM
2 BusinessObjects Auditor Guide
Copyright No part of the computer software or this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or by any information storage and retrieval system, without permission in writing from Business Objects S.A.The information in this document is subject to change without notice. If you find any problems with this documentation, please report them to Business Objects S.A. in writing at [email protected] Objects S.A. does not warrant that this document is error free.Copyright © Business Objects S.A. 2003. All rights reserved.Printed in France.
Trademarks The Business Objects logo, WebIntelligence, BusinessQuery, the Business Objects tagline, BusinessObjects, BusinessObjects Broadcast Agent, Rapid Mart, Set Analyzer, Personal Trainer, and Rapid Deployment Template are trademarks or registered trademarks of Business Objects S.A. in the United States and/or other countries.Contains IBM Runtime Environment for AIX(R), Java(TM) 2 Technology Edition Runtime Modules (c) Copyright IBM Corporation 1999, 2000. All Rights Reserved.This product includes code licensed from RSA Security, Inc. Some portions licensed from IBM are available at http://oss.software.ibm.com/icu4j.All other company, product, or brand names mentioned herein, may be the trademarks of their respective owners.
Use restrictions This software and documentation is commercial computer software under Federal Acquisition regulations, and is provided only under the Restricted Rights of the Federal Acquisition Regulations applicable to commercial computer software provided at private expense. The use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in subdivision (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013.
Patents U.S. Patent Numbers 5,555,403, 6,247,008, and 6,578,027.
Part Number 397-50-610-01
ewboa60.book Page 2 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 3
Contents
ContentsPreface Maximizing Your Information Resources 7
Information resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Useful addresses at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Part I Administering Auditor
Chapter 1 Introducing BusinessObjects Auditor 17What you can do with Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Auditor components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20The Audit facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 2 Setting Up and Removing Auditor 23Installing Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Configuring Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Setting privileges for an Auditor-dedicated Designer user . . . . . . . . . . . . . . 35Exporting universes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Exporting predefined indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Monitoring multiple clusters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Restoring predefined indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Removing Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Chapter 3 Setting Access Rights 63Access rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
ewboa60.book Page 3 Tuesday, August 19, 2003 10:52 AM
4 BusinessObjects Auditor Guide
Contents
Chapter 4 Universes, Classes and Objects 71Universe structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Universes and analytical categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Predefined vs. custom-made universes . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Broadcast Agent analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Repository analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Universe domain analysis universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101System information universe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Part II Using Auditor
Chapter 5 Using Predefined Indicators 131Predefined indicators available with Auditor . . . . . . . . . . . . . . . . . . . . . . . 133User Information category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Document Management category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Universe Management category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146Broadcast Agent category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151System Information category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Chapter 6 Creating, Modifying, and Publishing Indicators 159Universes, classes, and objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Access rights for indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Creating indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Modifying indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Publishing indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Saving indicators in Auditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Deleting indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Exercise: Creating a new indicator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
ewboa60.book Page 4 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 5
Contents
Chapter 7 Using Auditor to Solve Business Problems 177How do I monitor the use of Business Objects products? . . . . . . . . . . . . . 183How do I track Broadcast Agent usage? . . . . . . . . . . . . . . . . . . . . . . . . . . 186How do I find out which machines are accessing my system? . . . . . . . . . 187Can I detect fraud with Auditor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188How do I monitor login information? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189How do I monitor the load on my server? . . . . . . . . . . . . . . . . . . . . . . . . . 191How do I track the most requested documents? . . . . . . . . . . . . . . . . . . . . 192How do I track the least/most popular documents? . . . . . . . . . . . . . . . . . . 193How do I monitor universe hits? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195How do I use AUDITOR for billing? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197How do I perform impact analysis? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Index 199
ewboa60.book Page 5 Tuesday, August 19, 2003 10:52 AM
6 BusinessObjects Auditor Guide
Contents
ewboa60.book Page 6 Tuesday, August 19, 2003 10:52 AM
preface
Maximizing Your Information Resources
ewboa60.book Page 7 Tuesday, August 19, 2003 10:52 AM
8 BusinessObjects Auditor Guide
Maximizing Your Information Resources
OverviewInformation, services, and solutions
The Business Objects business intelligence solution is supported by thousands of pages of documentation, available from the products, on the Internet, on CD, and by extensive online help systems and multimedia. Packed with in-depth technical information, business examples, and advice on troubleshooting and best practices, this comprehensive documentation set provides concrete solutions to your business problems. Business Objects also offers a complete range of support and services to help maximize the return on your business intelligence investment. See in the following sections how Business Objects can help you plan for and successfully meet your specific technical support, education, and consulting requirements.
ewboa60.book Page 8 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 9
Information resources
Information resourcesWhatever your Business Objects profile, we can help you quickly access the documentation and other information you need.
Where do I start? Below are a few suggested starting points; there is a summary of useful web addresses on page 12.
Documentation RoadmapThe Documentation Roadmap references all Business Objects guides and multimedia, and lets you see at a glance what information is available, from where, and in what format. View or download the Business Objects Documentation Roadmap at www.businessobjects.com/services/documentation.htm
Documentation from the productsYou can access electronic documentation at any time from the product you are using. Online help, multimedia, and guides in Adobe PDF format are available from the product Help menus.
Documentation on the webThe full electronic documentation set is available to customers with a valid maintenance agreement on the Online Customer Support (OCS) website at www.businessobjects.com/services/support.htm
Buy printed documentationYou can order printed documentation through your local sales office, or from the online Business Objects Documentation Supply Store at www.businessobjects.com/services/documentation.htm
Search the Documentation CDSearch across the entire documentation set on the Business Objects Documentation CD shipped with our products. This CD brings together the full set of documentation, plus tips, tricks, multimedia tutorials, and demo materials.Order the Documentation CD online, from the Business Objects Documentation Supply Store, or from your local sales office.
ewboa60.book Page 9 Tuesday, August 19, 2003 10:52 AM
10 BusinessObjects Auditor Guide
Maximizing Your Information Resources
MultimediaAre you new to Business Objects? Are you upgrading from a previous release or expanding, for example, from our desktop to our web solution? Try one of our multimedia quick tours or Getting Started tutorials. All are available via the Online Customer Support (OCS) website or on the Documentation CD.
How can I get the most recent documentation?You can get our most up-to-date documentation via the web. Regularly check the sites listed below for the latest documentation, samples, and tips.
Tips & TricksOpen to everyone, this is a regularly updated source of creative solutions to any number of business questions. You can even contribute by sending us your own tips.www.businessobjects.com/forms/tipsandtricks_login.asp
Product documentationWe regularly update and expand our documentation and multimedia offerings. With a valid maintenance agreement, you can get the latest documentation – in seven languages – on the Online Customer Support (OCS) website.
Developer Suite OnlineDeveloper Suite Online provides documentation, samples, and tips to those customers with a valid maintenance agreement and a Developer Suite license via the Online Customer Support (OCS) website.
Send us your feedbackDo you have a suggestion on how we can improve our documentation? Is there something you particularly like or have found useful? Drop us a line, and we will do our best to ensure that your suggestion is included in the next release of our documentation: [email protected]
NOTEIf your issue concerns a Business Objects product and not the documentation, please contact our Customer Support experts. For information about Customer Support visit: www.businessobjects.com/services/support.htm
ewboa60.book Page 10 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 11
Services
ServicesA global network of Business Objects technology experts provides customer support, education, and consulting to ensure maximum business intelligence benefit to your business.
How we can support you?Business Objects offers customer support plans to best suit the size and requirements of your deployment. We operate three global customer support centers:• Americas: San Jose, California and Atlanta, Georgia• Europe: Maidenhead, United Kingdom• Asia: Tokyo, Japan and Sydney, Australia
Online Customer SupportOur Customer Support website is open to all direct customers with a current maintenance agreement, and provides the most up-to-date Business Objects product and technical information. You can log, update, and track cases from this site using the Business Objects Knowledge Base.
Having an issue with the product?Have you exhausted the troubleshooting resources at your disposal and still not found a solution to a specific issue? For support in deploying Business Objects products, contact Worldwide Customer Support at: www.businessobjects.com/services/support.htm
Looking for the best deployment solution for your company?Business Objects consultants can accompany you from the initial analysis stage to the delivery of your deployment project. Expertise is available in relational and multidimensional databases, in connectivities, database design tools, customized embedding technology, and more.For more information, contact your local sales office, or contact us at: www. businessobjects.com/services/consulting.htm
Looking for training options? From traditional classroom learning to targeted e-learning seminars, we can offer a training package to suit your learning needs and preferred learning style. Find more information on the Business Objects Education website: www.businessobjects.com/services/education.htm
ewboa60.book Page 11 Tuesday, August 19, 2003 10:52 AM
12 BusinessObjects Auditor Guide
Maximizing Your Information Resources
Useful addresses at a glance
Address ContentBusiness Objects Documentation
www.businessobjects.com/services/documentation.htm
Overview of Business Objects documentation. Links to Online Customer Support, Documentation Supply Store, Documentation Roadmap, Tips & Tricks, Documentation mailbox.
Business Objects Documentation mailbox
Feedback or questions about documentation.
Product documentation
www.businessobjects.com/services/support.htm
The latest Business Objects product documentation, to download or view online.
Business Objects product information
www.businessobjects.com
Information about the full range of Business Objects products.
Developer Suite Online
www.techsupport.businessobjects.com
Available to customers with a valid maintenance agreement and a Developer Suite license via the Online Customer Support (OCS) website. Provides all the documentation, latest samples, kits and tips.
Knowledge Base (KB)
www.techsupport.businessobjects.com
Technical articles, documents, case resolutions.Also, use the Knowledge Exchange to learn what challenges other users – both customers and employees – face and what strategies they find to address complex issues. From the Knowledge Base, click the Knowledge Exchange link.
Tips & Tricks
www.businessobjects.com/forms/tipsandtricks_login.asp
Practical business-focused examples.
ewboa60.book Page 12 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 13
Useful addresses at a glance
Online Customer Support
www.techsupport.businessobjects.com
www.businessobjects.com/services
Starting point for answering questions, resolving issues.
Information about registering with Worldwide Customer Support.
Business Objects Education Services
www.businessobjects.com/services/education.htm
The range of Business Objects training options and modules.
Business Objects Consulting Services
www.businessobjects.com/services/consulting.htm
Information on how Business Objects can help maximize your business intelligence investment.
Address Content
ewboa60.book Page 13 Tuesday, August 19, 2003 10:52 AM
14 BusinessObjects Auditor Guide
Maximizing Your Information Resources
About this guideThis guide describes BusinessObjects Auditor.The first part of this guide, Administering Auditor, describes how to set up, configure and administer an Auditor deployment. It is designed for Business Objects system administrators and supervisors.The second part of the guide, Using Auditor, describes how to use Auditor to analyze Business Objects user and system activity. It is designed for the IT administrators in charge of monitoring and tuning the Business Objects deployment.
NOTEThis guide replaces the BusinessObjects Auditor Administrator’s Guide and the BusinessObjects Auditor User’s Guide.
Conventions used in this guideThe conventions used in this guide are described in the table below.
Convention IndicatesThis font Code, SQL syntax, computer programs. For
example: @Select(Country\Country Id). This font is also used for all paths, directories, scripts, commands and files for UNIX.
Some code more code
Placed at the end of a line of code, the symbol ( ) indicates that the next line should be entered continuously with no carriage return.
$DIRECTORYPATHNAME The path to a directory in the Business Objects installation/configuration directory structure. For example:• $INSTALLDIR refers to the Business Objects
installation directory.• $LOCDATADIR refers to a subdirectory of the
BusinessObjects installation directory called locData.
ewboa60.book Page 14 Tuesday, August 19, 2003 10:52 AM
part
Administering Auditor
ewboa60.book Page 15 Tuesday, August 19, 2003 10:52 AM
ewboa60.book Page 16 Tuesday, August 19, 2003 10:52 AM
chapter
Introducing BusinessObjects Auditor
ewboa60.book Page 17 Tuesday, August 19, 2003 10:52 AM
18 BusinessObjects Auditor Guide
Introducing BusinessObjects Auditor
OverviewBusinessObjects Auditor is a web-based product that allows you to monitor and analyze user and system activity for WebIntelligence, InfoView, BusinessObjects in 3-tier mode and Broadcast Agent, then display the results on a user-friendly web interface. This information provides valuable insight into your Business Objects deployment, enabling you to optimize your Business Intelligence solution.
NOTE
In this guide, “Auditor” is a shortened form of the full product name, BusinessObjects Auditor.
Auditor is built on the existing Business Objects technology and server infrastructure, taking advantage of their ease of use, security, scalability, and extensibility.
ewboa60.book Page 18 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 19
What you can do with Auditor
What you can do with AuditorAuditor enables you to determine which users are using a particular Business Objects system, how often they are using it, and what data they are accessing.You can use Auditor to:• monitor your Business Intelligence system by examining user activity, access
rights, resource information pertaining to the use of documents and universes, as well as system information such as response time, Broadcast Agent details, and server load
• analyze system trends over daily, weekly, and monthly periods• delete or modify unused objects and reports, in order to provide users with
easier and quicker access to essential information• accelerate analysis by using the Favorites and Dashboard features, which
give you direct access to the queries you want to see• optimize your data warehouse and speed up refresh actions by tracking
frequently-used queriesAuditor can help identify situations where aggregate tables or additional indexes can be used.
• generate new billing opportunities by highlighting the most popular reports
ewboa60.book Page 19 Tuesday, August 19, 2003 10:52 AM
20 BusinessObjects Auditor Guide
Introducing BusinessObjects Auditor
Auditor componentsAuditor contains the following components:• indicators that enable you to monitor and analyze• analytical categories (and subcategories) by which indicators are classified• universes on top of which indicators are built
IndicatorsAuditor uses predefined indicators to give you quick access to the information you need in order to monitor, analyze, and optimize your Business Objects deployment. These indicators are delivered as part of the Auditor package.Predefined indicators cover a wide range of useful data. They are your key to information such as: • which users are accessing and utilizing your system• the most popular reports and universes• reports impacted by changing an objectEach indicator contains one or more reports that focus on a very specific area of analysis; for example, the Average Refresh Time indicator, which shows the average refresh time (in seconds) for all documents, broken down by document name, user, document type, and node.You can modify the existing indicators, and then save the modified indicators. For monitoring and analysis that is even more finely tuned to your unique system, you can create your own indicators.
CategoriesThe analytical categories organize the Business Objects deployment into practical areas of analysis. There are five categories:• User Information• Document Management• Universe Management• Broadcast Agent• System InformationEach category has a number of subcategories, which further organize indicators for ease of access, pointing you directly to the information you want.
ewboa60.book Page 20 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 21
Auditor components
UniversesAuditor is delivered with a set of predefined universes that facilitate monitoring and analysis activities. These universes are designed and tested to provide you with an effective set of reporting options.Each universe provides an interface for different classes of database objects, permitting compatible objects to be used in building queries.For more information about universes and the classes and objects of which they are composed, see Universes, Classes and Objects on page 71.
ewboa60.book Page 21 Tuesday, August 19, 2003 10:52 AM
22 BusinessObjects Auditor Guide
Introducing BusinessObjects Auditor
The Audit facilityA key component in the Auditor environment is the Audit facility, which tracks crucial information relating to user and system activity. Each time any of 42 predefined events occurs, a record of the event is created and stored by the Audit facility. You can then retrieve and analyze the individual events.The Audit facility is part of the Business Objects system. You activate and administer it using the Administration Console.
The Audit facility has two modes for gathering and storing event records:• File mode
Business Objects stores the user or system information in flat (*.log) files, which are saved to a directory of your choice. These text files can be viewed in the Administration Console or in a simple text editor, such as Notepad.
• Database modeBusiness Objects stores the user or system information in the Audit database. Because of its complexity, information in Database mode normally is viewed and analyzed through the use of indicators in Auditor. However, this can also be performed in SQL, if no other solution is available.
Auditor can access and present audited data only when Database mode is activated.
ewboa60.book Page 22 Tuesday, August 19, 2003 10:52 AM
chapter
Setting Up and Removing Auditor
ewboa60.book Page 23 Tuesday, August 19, 2003 10:52 AM
24 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
OverviewThis chapter describes:• Installing Auditor• Configuring Auditor• Setting privileges for an Auditor-dedicated Designer user• Exporting universes• Exporting predefined indicators• Monitoring multiple clusters• Restoring predefined indicators• Removing AuditorFor the first five sections you should have the following guides close by for reference:• Designer’s Guide• Installation and Configuration for UNIX
orInstallation and Configuration for Windows
• Supervisor’s Guide• WebIntelligence User’s Guide• installation and configuration documentation for the application server• readme for BusinessObjects Enterprise 6
NOTEIf you are migrating Auditor to a new version of BusinessObjects, see Migrating from a Previous Version.For deployment information, see the Deployment Guide.
ewboa60.book Page 24 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 25
Installing Auditor
Installing AuditorTo install Auditor you need to complete the following steps:1. Requesting a connection to a database server2. Installing the application and web servers3. Installing the BusinessObjects Enterprise 6 product suite
Requesting a connection to a database serverThe Audit database is located on the database server, and so you need a connection created. Only your database system administrator can do this for you, along with providing you user names and passwords that allow access to the database server.You will need this information for the section Configuring Auditor on page 26.
Installing the application and web serversIf you have a JSP deployment, you must install Java SDK, Tomcat, and Apache, before installing the BusinessObjects Enterprise 6 product suite.You can download the Java Development Kit (JDK), Apache, and Tomcat software from the Sun website: http://java.sun.com.
Finding the latest news on versions supported by Business ObjectsYou can find an up-to-date list of the application and web server versions supported by Business Objects in the Products Availability Report (PAR). To find this:1. Go to www.techsupport.businessobjects.com.
The Online Customer Support page appears.2. Log in to the site.3. In the Products tab, click the PAR link.
ewboa60.book Page 25 Tuesday, August 19, 2003 10:52 AM
26 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Configuring AuditorYou need to complete the following steps to configure Auditor:1. Configuring the web and application servers2. Creating a data source for the Audit database3. Creating the Audit repository4. Setting up the Audit database
Configuring the web and application serversConfiguring the web and application servers on the host creates the following virtual directories for the applications:• http://<hostname>:<portname>/wijsp
When the complete setup of Auditor is complete, this link provides access to the InfoView portal.
• http://<hostname>:<portname>/wiadminWhen the complete setup of Auditor is complete, this link provides access to the Administrative Console.
• http://<hostname>:<portname>/auditorWhen the complete setup of Auditor is complete, this link provides access to Auditor.
For complete configuration instructions, see the Business Objects installation and configuration guides for Windows and UNIX.
ewboa60.book Page 26 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 27
Configuring Auditor
Creating a data source for the Audit databaseIf you have not already created a data source, you must do so using the ODBC Administrator so that you can access your repository and audit database.To create a data source for the repository:1. Select Start, Programs, Administrative Tools, Data Sources (ODBC).
The ODBC Data Source Administrator dialog box appears.2. Click the System DSN tab.
3. Click Add.The Create New Data Source dialog box appears.
ewboa60.book Page 27 Tuesday, August 19, 2003 10:52 AM
28 BusinessObjects Auditor Guide
Setting Up and Removing 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.
ewboa60.book Page 28 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 29
Configuring Auditor
Creating the Audit repositoryYou need to create a separate repository for the Audit database.Creating a separate Audit repository database is important for the following reasons:• Data from auditor reports will not be included in general usage reports.• Auditor activity will not slow down the repository used for other system
activities.To use the Audit feature, various clusters can write to the same database and not share the same repository. However, for most Auditor predefined indicators, the audit data is analyzed against the repository data. For more information on repositories, see the Supervisor’s Guide.To create the Audit repository:1. Click Start, Programs, Business Objects, Supervisor.
The User ID dialog box appears.
2. Click Admin.The Administration Setup Wizard opens.
ewboa60.book Page 29 Tuesday, August 19, 2003 10:52 AM
30 BusinessObjects Auditor Guide
Setting Up and Removing 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.
ewboa60.book Page 30 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 31
Configuring Auditor
7. From the Database engine drop-down menu select the engine for your connection.
8. Enter the user name, password, and database. Click Test.9. If the test is not successful, verify that you have entered in the correct user,
password, and database name.10. If the test is successful, click OK, then Next.
The Build the Repository dialog box appears if you are creating a new repository. Click Next. The Repository Access dialog box appears.If you are running a safe recovery, the Repository Access dialog box appears.
11.Select the location for the key file and either enter a new name or leave the default key name and click Next.If you are running a safe recovery, a dialog box may appear asking if you want to overwrite the existing key. Click Yes.
NOTEYou need to copy the .key file from:
Business Objects\BusinessObjects Enterprise 6\locdatato the following location:
Business Objects\BusinessObjects Enterprise 6\nodes\<hostname>\ mycluster\locdata
12.Click Finish.Supervisor opens.
ewboa60.book Page 31 Tuesday, August 19, 2003 10:52 AM
32 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Setting up the Audit databaseAuditor delivers reports based on the system and user activity data stored in the Business Objects system’s Audit database and the repository. In order to be able to use the system’s audit information from Auditor, you must:• use Supervisor to set up a secured connection to an Audit-dedicated
database• use the Administration Console to make sure that the system writes its audit
information to that audit database
Creating a secured connection for the Audit-dedicated database1. In Supervisor, select Tools, Connections from the menu.2. In the Name text box, type a name for the connection.
3. From the Database engine drop-down menu, select the database engine you are using.
4. In the Login Parameters section, enter the user name, password, and Audit database name. The user name and password are created for you by the system administrator for the server on which the Audit database is located.
ewboa60.book Page 32 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 33
Configuring Auditor
5. Click Test, to test the connection.6. If the test is not successful, check that you entered in the correct information.
If the test is successful, click OK.
The connection is listed in the Connections dialog box.
NOTEIf you need to create other connections:1. In the Connections dialog box, click Add2. Select the correct network layer and click OK.3. Repeat steps 2 through 6.
ewboa60.book Page 33 Tuesday, August 19, 2003 10:52 AM
34 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Creating tables in the Audit database1. Start the BusinessObjects server, Tomcat, and Apache.2. To open the Administrative Console, do one of the following:
- Click Start, Programs, Business Objects, Administrative Console 6.1.- Log in to http://<hostname>:<port number>/wiadminThe BusinessObjects Administrative Console login dialog box appears.
3. Log in using the user name and password that have access to the Audit database.The Business Objects Administrator Console page appears.
4. Click Audit.5. From the Audit database connection drop-down menu select the secured
connection you just created in Supervisor.
6. If necessary, set the maximum audit information cache size and regularity with which the cache is emptied into the Audit database.For information on setting the cache parameters, see the System Administrator’s Guide.
7. Click Apply.The system verifies that the database tables exist. If they do not, an SQL script is executed to create them.
For complete information about the Audit facility and how to configure it for use with Auditor, see the System Administrator’s Guides.
ewboa60.book Page 34 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 35
Setting privileges for an Auditor-dedicated Designer user
Setting privileges for an Auditor-dedicated Designer user
Once you have set up the Audit database, you may want to allow another user, perhaps as your backup, the permission to export universes and predefined indicators.To create users with a Designer profile and the specific privileges required to export the universes and predefined indicators required for your Auditor deployment:1. Click Start, Programs, Business Objects, Supervisor.2. Create a new user and assign a profile.
The following user rights need to be enabled:- Manage All corporate categories- Save to corporate documents- Manage personal categories- Save and read personal documentsThe following user rights need to be disabled:- Do not delete other users’ corporate documents
ewboa60.book Page 35 Tuesday, August 19, 2003 10:52 AM
36 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Exporting universesThe Universe Exporter allows you to easily create domain connections and database views, and export the Auditor universes to your corporate repository.If you need to do these actions manually, the following sections can help you:• Manually exporting universes• Manually creating the database views
NOTEYou must:• be using Microsoft Office 2000 in order to use Universe Exporter. If you are
not using Microsoft Office 2000, you need to export universes manually. See page 47.
• have Designer installed on your machine in order to export the universes you require for using Auditor with your system.
Using the Universe ExporterTo launch the Universe Exporter:1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.
A user identification dialog box appears.
ewboa60.book Page 36 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 37
Exporting universes
2. Enter the user name and password that have access rights to the Audit database, and click OK. This user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.
The Universe Exporter contains the following tabs.
Each tab corresponds to a specific stage or procedure that is described in the following sections. These procedures can be performed in any order, but you need to create the database views in the Security, Universe, and Audit tabs before you can successfully export documents.
Page name DescriptionWelcome Explains what the Universe Exporter does
Security Creates an OLEDB/ODBC connection for the Security domain, and creates the database views
Universe Creates an OLEDB/ODBC connection for the universe domain, and creates the database views
Audit Creates an OLEDB/ODBC connection for the Audit domain, and creates the database views
Export For automatic export of the Auditor universes
ewboa60.book Page 37 Tuesday, August 19, 2003 10:52 AM
38 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Creating a connection to the domainThe first time you use Universe Exporter you need to create a connection to the database, or perhaps you need to create a connection to a new Audit domain. This procedure applies in the Security, Universe, and Audit tabs.To create a connection to the database:1. Click Start, Auditor 6.1., Universe Exporter.
A user identification dialog box appears.2. Enter the user name and password that have access rights to the Audit
database, and click OK. This user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.
3. Click the tab for the domain requiring a domain connection.4. In the Data Source Name section, click New.
The Data Source Connection Editor dialog box appears.
5. Click the tab that corresponds to your type of database.
NOTEFor Sybase, use the ODBC tab and then select Sybase as the database. You can use the ODBC tab when you need to create an Oracle or IBM DB2 connection on a client that does not have OLE DB Oracle or IBM DB2.
ewboa60.book Page 38 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 39
Exporting universes
6. In the Name field, enter a unique name for the connection.7. In the Data Source text box, enter:
NOTEFor SQL Server, the server is the name of the machine that contains the database.
8. In the User ID text box, type the user name that has access rights to the Audit database.This user name must have at least one Designer profile for you to be able to create connections.
9. In the Password text box, type the password.10.Click Test.
If you do not receive notice that the server is responding, verify that you typed in the correct parameters and that the User ID has the permission in Supervisor to create this sort of connection.
11.Click OK. The tab reappears. In the Views section, a list of views is now available, with the Already in database? status of No.
NOTEIf you have migrated from a previous version of Business Objects, you need to delete any remaining views by selecting them in the Views list and clicking Delete and then recreating the views by clicking Create.
For... Data sourceOracle Net Service Name
IBM DB2 Database Alias
SQL Server Database Name
ewboa60.book Page 39 Tuesday, August 19, 2003 10:52 AM
40 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
12.To add these views to the database, click Create.All the views for the security domain are marked Yes in the Views area.
ewboa60.book Page 40 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 41
Exporting universes
Using the Security tab to manage database connectionsTo launch the Universe Exporter:1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.
A user identification panel appears.2. Enter the user name and password that have access rights to the Audit
database, and click OK. The user name must have at least one Designer profile for you to be able to export universes.The Universe Exporter appears.
3. Click the Security tab or Next on the Welcome page.The Security tab appears.
4. In the Data Source Name list, select a connection to your database. If you do not have a connection, see Creating a connection to the domain on page 38.Any views that already exist for the selected connection are marked Yes in the Views area.
NOTEIf you have migrated from a previous version of Business Objects, you need to delete any remaining views by selecting them in the Views list and clicking Delete and then recreating the views by clicking Create.
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.
ewboa60.book Page 41 Tuesday, August 19, 2003 10:52 AM
42 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Using the Universe tab to manage connections to universes1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.
A user identification panel appears.2. Enter the user name and password that have access rights to the Audit
database, and click OK. The user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.
3. Click the Universe tab in the Universe Exporter window.The Universe tab appears.
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.
NOTEIf you have migrated from a previous version of Business Objects, you need to delete any remaining views by selecting them in the Views list and clicking Delete and then recreating the views by clicking Create.
5. If you want to delete a view, select a view and click Delete.6. Click Next to go to the Audit tab, or Finish to save your modifications.
ewboa60.book Page 42 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 43
Exporting universes
Using the Audit tab to manage connections to the Audit database1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.
A user identification panel appears.2. Enter the user name and password that have access rights to the Audit
database, and click OK. The user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.
3. Click the Audit tab in the Universe Exporter window. The Audit 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.
NOTEIf you have migrated from a previous version of Business Objects, you need to delete any remaining views by selecting them in the Views list and clicking Delete and then recreating the views by clicking Create.
5. If you want to delete a view, select a view and click Delete.6. Click Next to go to the Export tab, or Finish to save your modifications.
ewboa60.book Page 43 Tuesday, August 19, 2003 10:52 AM
44 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Using the Export tab to manage the export of specific universesFrom this tab, you can set the parameters to export the specific universes you wish to use with Auditor. These parameters include the universe’s:• security domain connection• universe domain connection• audit database connection• assigned user groups• destination universe domainOnce you’ve defined these settings, the Export tab lets you trigger the export itself.1. Click Start, Business Objects, Auditor 6.1., Universe Exporter.
A user identification panel appears.2. Enter the user name and password that have access rights to the Audit
database, and click OK. The user name must have at least one Designer profile, because you need to export universes and create connections.The Universe Exporter appears.
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.
ewboa60.book Page 44 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 45
Exporting universes
4. Select a connection from the drop-down menu in the domain section for the domain that you want to use.If you need to add a connection, see Adding a new connection in the Export tab on page 46.
TIPTo hide other connections that you did not create for the three domains, select the Filter BusinessObjects connections for previously defined connections box.
5. In the lower right corner of the Export tab, select the user group and domain to which the universes will be exported.
6. Click Export Universes.A summary of the universe export appears.
7. Click OK, then Finish.
NOTE
You can confirm that the universes have been exported by viewing the Universe page in Supervisor.
ewboa60.book Page 45 Tuesday, August 19, 2003 10:52 AM
46 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Adding a new connection in the Export tab1. To add a new connection in the Export tab, click Add Connection.
The Add a connection dialog box appears.
2. Select a network layer, then click OK.3. Click the Login tab and enter the parameters for the new connection.4. Click the Advanced tab and select Disconnect After Each Transaction.
5. Click OK.The connection is now available in the Export tab.
ewboa60.book Page 46 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 47
Exporting universes
Manually exporting universesTo manually export the Auditor universes:1. Do either of the following:
- Copy the *.unv files (BCA.unv, SECURITY.unv, UNIVERSE.unv and ACTIVITY.unv) to the machine running Designer.- Make them available to this machine by sharing them
The files are located at: $INSTALLDIR\auditorData\Universes\Universes
2. Start Designer.3. Enter your user name and password.Perform the remaining steps below for each universe:4. Open a universe (*.unv) file.5. Click File, Parameters.6. In the Definition section, do either of the following:
- Assign one of the existing secured connections to the universe.- Create a new secured connection (you must do this if there is no existing secured connection available).
7. Click OK.8. Click File, Export. If you are prompted to save the universe before exporting
it, click Continue.The Export Universe dialog box appears.
9. Select the relevant domain and group, and then click OK.If you previously exported this universe, you are prompted to overwrite the previous version.The suggested connections for the universes are:
Universe Domain DatabaseBroadcast Agent Analysis Security Corporate repository
Repository Analysis Security Corporate repository
Universe Domain Analysis Universe Corporate repository
System Information Audit database Audit database
ewboa60.book Page 47 Tuesday, August 19, 2003 10:52 AM
48 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Manually creating the database viewsIf you do not want to automatically create the database views by using the Universe Exporter, follow the procedures below for creating them manually.The objects used in the universes are based on the views, and not directly on the repository or the Audit database tables.For each database, you must create five sets of views. A view is created by executing the script contained in an *.sql file.To create the database views:1. Open an SQL session.2. Execute the five scripts for your particular database.
- For the xxx_activity_xxx.sql files, use the audit database.- For the xxx_bca_xxx.sql and xxx_security_xxx.sql files, use the security domain.- For the xxx_universe_xxx.sql files, use the universe domain.The following table shows the location and names of the *.sql files containing the scripts.
Database Location of files File namesOracle $INSTALLDIR\
Universes\auditorData\ Views\ Oracle\
creviews_activity_ora.sqlcreviews_security_bca_ora.sqlcreviews_universe_ora.sql
IBM DB2 $INSTALLDIR\ Universes\auditorData\ Views\IBMDB2\
creviews_activity_db2udb.sqlcreviews_security_bca_db2udb.sqlcreviews_universe_db2udb.sql
ewboa60.book Page 48 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 49
Exporting predefined indicators
Exporting predefined indicatorsThe Document Exporter enables you to automatically export the Auditor documents (predefined indicators) to the corporate repository.
NOTEThe Business Objects server and Business Objects 6.1 must be running before you start the Document Exporter.
If you cannot run Document Explorer, you can export these indicators manually. For instructions, see Manually exporting predefined indicators on page 52.
Accessing the Document Exporter in UNIX1. At the command prompt, go to:
<$INSTALLDIR>/tools/With a standard Business Objects deployment the path would be:BOBJ/Enterprise6/tools/
2. To open document explorer type:./DocumentExporter.sh
ewboa60.book Page 49 Tuesday, August 19, 2003 10:52 AM
50 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Exporting documents with the Document Exporter1. Click Start, Programs, Business Objects, Auditor 6.1, Document
Exporter. The Document Exporter login dialog box appears.
2. Enter the Auditor user name and password.To export documents, you must ensure that the Auditor user name and password have the correct privileges. See Setting privileges for an Auditor-dedicated Designer user on page 35.
3. Click OK.The BusinessObjects Auditor 6.1 Document Exporter dialog box appears.
The Document Name column shows all the documents that are delivered with Auditor. Documents already exported to the Corporate and Personal areas are marked “Y” in the In Corporate and In Personal columns, respectively.
ewboa60.book Page 50 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 51
Exporting predefined indicators
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.
ewboa60.book Page 51 Tuesday, August 19, 2003 10:52 AM
52 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Manually exporting predefined indicatorsTo manually export the Auditor predefined indicators:1. Create a temporary folder on your computer.2. Copy into this folder all of the documents in:
$INSTALLDIR\auditorData\Documents3. Select all of the documents.4. Click File, Properties.
5. De-activate the Read-only attribute and click OK.
ewboa60.book Page 52 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 53
Exporting predefined indicators
6. Refer to the file input.txt located in the Documents file for the correct document category and keyword.
The input.txt document lists the information in the following sequence:<document name>, <keyword>, <category>
7. Select Start, Programs, Business Objects, BusinessObjects Enterprise 6.The BusinessObjects panel opens. If the New Report Wizard dialog box appears, click Cancel.
8. Select File, Open. Select all of the documents in the temporary report folder then click OK.
TIPSelect all of the documents in a specific category. That way you publish all of the se documents at the same time to Corporate Documents.
ewboa60.book Page 53 Tuesday, August 19, 2003 10:52 AM
54 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
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.
ewboa60.book Page 54 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 55
Exporting predefined indicators
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.
ewboa60.book Page 55 Tuesday, August 19, 2003 10:52 AM
56 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
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.
ewboa60.book Page 56 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 57
Monitoring multiple clusters
Monitoring multiple clustersYou can use Auditor to monitor multiple clusters, with no administrative overhead. To set up the system to do this, you connect to the Administration Console for each cluster to be monitored, and set the Audit database connection to the same database in the Audit page.
EXAMPLESetting up the monitoring of multiple clustersYou want Auditor to monitor oracleCluster1, oracleCluster2 and db2Cluster1. Having already set up the Audit database and its connection:1. Click Start, Programs, Business Objects, Administration Console 6.1
The Administration Console appears.2. In the Administration Console on Cluster1’s primary node, click Audit.3. Click Log to database.
A login panel appears.4. Enter the user name and password with access to the Audit database.5. From the Audit database connection drop-down menu select oracleCluster1.6. Click Apply.
7. Repeat steps 5 and 6 for oracleCluster2 and db2Cluster1.The audit information for all three clusters are now recorded in the same database. The Administration Console for each cluster initializes the database and registers the new cluster.
ewboa60.book Page 57 Tuesday, August 19, 2003 10:52 AM
58 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Restoring predefined indicatorsIf a user mistakenly deletes a predefined indicator, you need to republish the indicator back to the corporate repository. The replacement indicator is found in the personal documents’ area of the user with which Auditor was originally installed. To restore an indicator, you can use the Document Exporter or the following procedure:1. Log into InfoView using the user name and password with access to the Audit
database at: http://<hostname>:<portname>/wijsp.2. Click Personal Documents.
The indicators in the Personal area are displayed.3. Click the indicator you want to restore.
The associated document appears.4. Click Publish.
The Publish as Corporate Document page appears.5. Verify that the document’s name, description, and category are the same as
those of the original indicator.6. Verify that the document keyword corresponds to the indicator’s subcategory
in Auditor.7. Click No for the Overwrite if Document Exists option.
The original document was presumably deleted.8. Select the Refresh option:
- Refreshed ManuallyThe indicator is refreshed only when a user refreshes it manually.
- Scheduled RefreshSelect this option if you want to schedule a refresh using Broadcast Agent.
The Scheduling Options page appears. 9. Set the refresh frequency you want, and then click OK.
For information on the refresh frequency, see the InfoView User’s Guide.10.Click Publish.
If the name already exists, a message appears at the bottom of the page. You must either return to step 5 to change the name, or to step 7 to select Yes.
11.Log into Auditor, and you see the indicator under the specified category and subcategory.
ewboa60.book Page 58 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 59
Removing Auditor
Removing AuditorTo remove Auditor from the server, there is a procedure to follow. The following sections must be completed in this sequence:1. Deleting the universes2. Removing the database views3. Removing the documents4. Removing the Auditor files
Deleting the universesTo delete the universes:1. Click Start, Programs, Business Objects, Supervisor.2. Select Tools, Delete Universe.
The Delete Universes dialog box appears.
3. Select the Auditor universes, and then click OK.
ewboa60.book Page 59 Tuesday, August 19, 2003 10:52 AM
60 BusinessObjects Auditor Guide
Setting Up and Removing Auditor
Removing the database viewsTo remove the database views:1. Open the Universe Exporter.2. Click the Security tab.
The Security page appears.
3. In the Data Source Name area, select the connection to the security domain.4. Click Delete near the bottom of the dialog box.
All the views for the security domain are marked “No” in the Views area.5. Repeat the previous two steps for the Universe and Audit tabs.6. Click Finish.
ewboa60.book Page 60 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 61
Removing Auditor
Removing the documentsTo remove the documents:1. Open the Document Exporter:
- Under UNIX – at the command prompt, type ./DocumentExporter.sh This file is usually located in $AUDITORINSTALLDIR/DocumentExporter/.
- In Windows click Start, Programs, Business Objects, Auditor 6.1, Document Exporter.The Log In dialog box appears.
2. Enter the Auditor user name and password.Use the same Business Objects user name that you originally used to export the documents during installation.
3. Click OK.The main window of the Document Exporter appears.
4. Select the document domain in the drop-down list near the top of the dialog box.
ewboa60.book Page 61 Tuesday, August 19, 2003 10:52 AM
62 BusinessObjects Auditor Guide
Setting Up and 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 filesTo remove the Auditor software from the server, follow the instructions in the Installation and Configuration Guides for Windows or Unix.
ewboa60.book Page 62 Tuesday, August 19, 2003 10:52 AM
chapter
Setting Access Rights
ewboa60.book Page 63 Tuesday, August 19, 2003 10:52 AM
64 BusinessObjects Auditor Guide
Setting Access Rights
OverviewAuditor runs in a secure environment, using a repository to store all security information. Auditor inherits the access rights functionality of Supervisor for *.rep documents. You therefore modify access rights for Auditor using Supervisor. In addition, Auditor adds a layer of Form Authentication architecture using Java Server Page (JSP) technology.This chapter explains how to set access rights for Auditor using Supervisor. For complete information about setting access rights for Business Objects users, see the Supervisor’s Guide.
ewboa60.book Page 64 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 65
Access rights
Access rightsIn Supervisor, access rights are organized into command sets. A command set contains related menu commands, toolbar buttons, and other interface elements. Access rights usually are controlled by enabling or disabling command sets.Command sets, in turn, are grouped into families. The command set families are:• Document
Document handling; analytical categories• Options
Options for list display, home page, password, editing, and technology• Query and Report Panels
BusinessObjects Query Panel and WebIntelligence Report Panel functionality
ewboa60.book Page 65 Tuesday, August 19, 2003 10:52 AM
66 BusinessObjects Auditor Guide
Setting Access Rights
Command set family: DocumentThe following table shows which command sets to choose in order to restrict Document functionality.
Interface impactThe following table shows the impact on the user interface of disabling or hiding Document command sets.
I don’t want my group/user to... So I disable or hide command setPublish indicators to the repository Publish Document
Save indicators Save Document
See the list of indicators Read Corporate Documents
Disabling or hiding command set...
Has this impact on the interface
Publish Document Removes the Publish command under the indicator name.
Save Document Removes the Save command under the indicator name.
Read Corporate Documents Removes the following tabs:• Dashboard• Customize Dashboard• Favorites• Options
ewboa60.book Page 66 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 67
Access rights
Command set family: OptionsThe following table shows which command sets to choose in order to restrict Options functionality.
Interface impactThe following table shows the impact on the user interface of disabling or hiding Options command sets.
I don’t want my group/user to... So I disable or hide command setSee document list options or change the default home page
Change List Display and Default Home Page
Change their own password Change Password
Change the viewing and editing of technology options (applets and technology options on the Options page)
Change Viewing and Editing Technology Options
Disabling or hiding command set...
Has this impact on the interface
Change List Display and Default Home Page
Removes the Start Page tab from Options
Change Password Removes the Password tab from Options
Change Viewing and Editing Technology Options
Removes the Create and Edit Indicators tab from Options
ewboa60.book Page 67 Tuesday, August 19, 2003 10:52 AM
68 BusinessObjects Auditor Guide
Setting Access Rights
Command set family: Query and Report PanelThe following table shows which command sets to choose to restrict Query Panel and Report Panel functionality.
Interface impactThe following table shows the impact on the user interface of disabling or hiding Query and Report Panel command sets.
I don’t want my group/user to... So I disable or hide command setCreate a new indicator Download 3-Tier BusinessObjects
Modify an existing indicator Edit Documents
Use the formatting toolbar Formatting Toolbar
Refresh lists of values Refresh Lists of Values
Run and refresh indicators Run and Refresh Documents
Use or refresh lists of values Use List of Values
View the SQL of a query View SQL
Disabling or hiding command set...
Has this impact on the interface
Create Indicators Removes the Add a New Indicator tab
Edit Indicators Removes the Edit button from indicatorsRemoves the Add a New Indicator tab
Formatting Toolbar Removes the formatting commands from the Report Panel
Refresh Lists of Values Does not show the Refresh button when a choice of values is displayed for a document
ewboa60.book Page 68 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 69
Access rights
Run and Refresh Documents
The user can modify the document but cannot run the associated query (that is, the Run button is removed from the applet).The Add a New Indicator, Dashboard, and Customize Dashboard tabs are removed.If a report is published with a manual Refresh, the user can open and modify it, but cannot run or refresh it.If a report is published with the Refresh on Open option, the user cannot open, modify, or refresh it.
Use List of Values If the user: 1. creates a document2. drags an object from the Classes and Objects
Panel to the Conditions tab3. clicks on the operand of the objectthen the Show Values From List and Prompt Values From List options are unavailable.If the user:1. opens an expanded documents page2. clicks Edit underneath a document, then3. creates or edits an object using a List of Values
in the Conditions tab of the WebIntelligence Report Panel
then Refresh is unavailable in the List of Values dialog boxes.
View SQL If the user creates a new indicator, or opens an existing indicator, then the SQL button is not available in the WebIntelligence Report Panel.
Disabling or hiding command set...
Has this impact on the interface
ewboa60.book Page 69 Tuesday, August 19, 2003 10:52 AM
70 BusinessObjects Auditor Guide
Setting Access Rights
ewboa60.book Page 70 Tuesday, August 19, 2003 10:52 AM
chapter
Universes, Classes and Objects
ewboa60.book Page 71 Tuesday, August 19, 2003 10:52 AM
72 BusinessObjects Auditor Guide
Universes, Classes and Objects
OverviewThis chapter describes the universes that are provided with Auditor, as well as the objects that can be selected from the universes to create and edit indicators.Knowledge of universes is important for understanding the elements used in creating and modifying indicators. For example, the BusinessObjects Query Panel is displayed following the selection of either Add a New Indicator or the Edit option for an existing indicator. It is the universe that determines the objects that are available in the panel for building the new query.
ewboa60.book Page 72 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 73
Universe structure
Universe structureUniverses are composed of objects and classes. Objects are elements that map to a set of data from a relational database. Objects allow you to retrieve data for your queries. Classes are logical groupings of objects.Universes permit mutually compatible objects to be used in queries by means of the BusinessObjects Query Panel. Objects are classified as one of the following types:• Dimension
A dimension retrieves the data that provides the basis for analysis. This data is usually character-type data or dates. In the following universe sections the names of objects that are dimensions are followed by (D).
• DetailA Detail object is always associated with a specific Dimension object, in order to provide additional information. In the following universe sections the names of objects that are detail objects are followed by (De).
• MeasureA measure retrieves numeric information that is the result of calculations on data in the database. In the following universe sections the names of objects that are measures are followed by (M).
ewboa60.book Page 73 Tuesday, August 19, 2003 10:52 AM
74 BusinessObjects Auditor Guide
Universes, Classes and Objects
Universes and analytical categoriesUniverses correspond approximately to the various analytical categories in Auditor. The universe/analytical category mapping is shown in the following table.
NOTEThis table and the ones following show the full names of the universes. The part of the name after the colon shows the domain to which the universe is attached. In the remainder of this document, the shorter name (such as Repository Analysis) is used.
This universe... Is used by indicators in these categoriesBroadcast Agent Analysis: Security
Broadcast Agent
Repository Analysis: Security Document ManagementUser InformationBroadcast Agent
Universe Domain Analysis: Universe
Universe Management
System Information: Audit System InformationUser InformationDocument ManagementUniverse Management
ewboa60.book Page 74 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 75
Predefined vs. custom-made universes
Predefined vs. custom-made universesWith Auditor, you can use either a set of predefined universes delivered with the product, or any other universes available to you through the Business Objects system.
Predefined universesAuditor comes with the following predefined universes:
They allow you to carry out monitoring and analysis activities immediately after installation.These predefined universes are attached to different domains. These domains are connected to databases during installation, prior to export of the universes.
Custom-made universesIn Auditor, you can access universes that you:• created in Designer• exported to the repository• made accessible to users via SupervisorThe universes that you create appear in the list of default universes. This list is automatically presented to users when they create a new indicator without having selected a default universe (see Creating indicators on page 163).
Universe name File nameBroadcast Agent Analysis: Security BCA.unv
Repository Analysis: Security SECURITY.unv
Universe Domain Analysis: Universe UNIVERSE.unv
System Information: Audit ACTIVITY.unv
Universe Domain DatabaseBroadcast Agent Analysis: Security Security Corporate repository
Repository Analysis: Security Security Corporate repository
Universe Domain Analysis: Universe Universe Corporate repository
System Information: Audit Audit database Audit database
ewboa60.book Page 75 Tuesday, August 19, 2003 10:52 AM
76 BusinessObjects Auditor Guide
Universes, Classes and Objects
Broadcast Agent analysis universeThis section lists the classes in the Broadcast Agent Analysis universe, and the objects that are available for selection within each class.Objects in each class are listed alphabetically, and not in the order in which they appear in the user interface.
NOTEBecause the security domain handles international date and time operations, dates may be displayed in Greenwich mean time (GMT) format, which is the time zone reference for the repository. For more information, see the Broadcast Agent Administrator’s Guide.
BCA information classThis class provides Broadcast Agent system information. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsBCA & BO Server Names (D)
Two server names, or Not Processed.The first name is the server on which Broadcast Agent is running; the second name is the Business Objects server on which the task was processed (the machine running BOManager).For a task that has not been executed, the column returns “Not Processed.”The column is updated after a task is processed.
BCA ID (De) Broadcast Agent server IDs.Each Broadcast Agent server is assigned a unique ID.
BCA Name (D) Name of the monitored Broadcast Agent.
BCA Name (label) (D)
Name of the monitored Broadcast Agent, preceded by the text string “Broadcast Agent.”
ewboa60.book Page 76 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 77
Broadcast Agent analysis universe
BCA Server Name (D)
Name of the machine on which the Broadcast Agent server is running, or Not Processed.For a task that has never been executed, the object has no value.The value is updated after a task is processed.
BCA Status (D) Enabled, Disabled, or “Exceeded number of logins allowed.”
Group Name (D) Broadcast Agent group names
BO Server Name (D)
Name of the Business Objects server that sent the job to Broadcast Agent (that is, the server machine running BOManager).For a task that has not been executed, the object returns “Not Processed.”The object can be seen from any console, and is updated after a task is processed.
BO Server Name (with label) (D)
Name of the Business Objects server that sent the job to Broadcast Agent, preceded by the text string “WebI Server Name.”For a task that has not been executed, the object returns “Not Processed.”The object can be seen from any console and is updated after a task is processed.
This object... Returns
ewboa60.book Page 77 Tuesday, August 19, 2003 10:52 AM
78 BusinessObjects Auditor Guide
Universes, Classes and Objects
Batch information classThis class provides Broadcast Agent system information. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsBatch ID (D) ID of the pending Broadcast Agent job.
End User Process ID (D)
The end-user module process ID launched on the server.
Job Description (D)
Job description initially completed by the user submitting the document.The description can be modified.
Job Platform (D) All Platforms, Windows Platform, Windows Platform (BusinessObjects 4.1 task), UNIX Platform, New attempt on a UNIX platform, All attempts failed on UNIX platforms, or “Not Processed.”
Overwrite Mode (D)
With or without, depending on whether the Broadcast Agent job was submitted with the overwrite option turned on.
Priority (D) High, Normal, or Low
Priority (picture) (De)
A graphical indicator of the job’s priority: High, Normal, or Low (Auditor interface only).
ewboa60.book Page 78 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 79
Broadcast Agent analysis universe
Actions subclassThis is a subclass of the Batch Information class that provides information on Broadcast Agent batch job actions. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsAction Type (De) One of the following Broadcast Agent action types:
• First Begin Date• Distributed via Web Server• Distributed via Server File System• File Watcher Detection.
Data (De) Value of the condition associated with the batch job.
Particular Conditions (D)
Details of the Broadcast Agent action, such as: • First Begin Date, if distributed via a web server• Web Server name, if distributed via a server file system• Server File System, File Watcher detection on file named
Report Bursting feature (D)
Mode used to refresh the document, such as Refresh with Profile of Each Recipient, Refresh with Profile of the Submitter.
Script Options (D)
Broadcast Agent script options that the user selected and sent with the document.The values are separated by commas: Refresh Document = 1, Print Document = 2, WebServer = 3, Custom Macro, = 4, Condition = 5, Channel = 6,Save as RTF = 7, Save as TXT = 8, Save as PDF = 9
ewboa60.book Page 79 Tuesday, August 19, 2003 10:52 AM
80 BusinessObjects Auditor Guide
Universes, Classes and Objects
Scheduling Information subclassThis is a subclass of the Batch Information class that provides job frequency information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsBegin Time (D) Start time of the pending Broadcast Agent job.
For hourly tasks, it displays the information in the following form: “30 minutes after the hour from 9 to 11.”
Days of the Month (D)
Days selected for monthly tasks.The information appears in the following form: “2nd 3rd 4th 26th and last day of the month.”
Days of the Week (D)
Days selected for daily, monthly interval, and user-defined tasks.The information appears in the following form: “Monday Wednesday Friday.”
Frequency (D) One of the following: • Once (4,6)• Hourly (8,10)• Daily (16,18)• Weekly (32,34)• Monthly (64,66)• Monthly interval (128, 130)• User defined (256, 258).
Periodicity (D) Scheduling for daily, weekly, and monthly tasks.The information appears in the following form: “Every 6 week(s).”
Periodicity Detail (D)
Day scheduling for monthly interval tasks and the scheduling details for user-defined tasks.The information appears in the following form: “Every 2nd business day.”
ewboa60.book Page 80 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 81
Broadcast Agent analysis universe
Monitoring Job Information subclassThis is a subclass of the Batch Information class that provides job status information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsJob Error Code (De)
Broadcast Agent job error code, if there is one.Make a note of the code so that you can use it when referring to the Error Message Guide.
Job Error or Warning Text (D)
Full error description, with the error code that relates to the Error Message Guide.
Job State (D) Indication of whether a job is still running.
Job Status (D) Text description of a job’s current status.
ewboa60.book Page 81 Tuesday, August 19, 2003 10:52 AM
82 BusinessObjects Auditor Guide
Universes, Classes and Objects
Document information classThis class provides Broadcast Agent document data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsCategory Creator (De)
Name of the user who created the document category.
Category Name (De)
Document's category name.
Category Path (De)
Hierarchical path of the document category if there is one.
Document Category (D)
List of document categories with the hierarchical path if there is one.
Document ID (D) Document ID
Document Name (D)
Name of a document sent to Broadcast Agent.
Document Name & Type (D)
Complete document name with its type.
Document Persistent (D)
Persistent if a document is published to the corporate repository, or Not Persistent if the document is automatically deleted when retrieved by the last user.
Document Repository ID (De)
ID of the document repository.
Document Repository Name (D)
Name of the repository where a document is stored.
Document Size (M)
Size of a sent document, in bytes.The object does not represent the size of a document when it is stored in the document domain; rather, it represents the initial size of the document (the size of the document when it was submitted).
Document Type (D)
The WebIntelligence or BusinessObjects document.The file extension type is .rep, .bqy, .wqy, .wid, or .rea; otherwise, it is Unknown.
ewboa60.book Page 82 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 83
Broadcast Agent analysis universe
Document Type (Picture) (De)
Graphical image representing the WebIntelligence or BusinessObjects document type.
Last Action (D) Last action performed on a document, and the date of the action.Values that can be returned include: Unchanged, Deleted, Inserted, Updated, Moved, or Other.
Last Action Date (D)
Most recent, date of a change to a referenced document.
Last Action Type (D)
Last type of action performed on a referenced document.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.
Number of documents (M)
Number of documents sent to Broadcast Agent.
This object... Returns
ewboa60.book Page 83 Tuesday, August 19, 2003 10:52 AM
84 BusinessObjects Auditor Guide
Universes, Classes and Objects
Submitter information classThis class provides information on the users and user groups submitting documents. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsBO Version of the Submitter (D)
Version number of the end-user module that submitted the job to Broadcast Agent.This object value is updated only at the time of document submission.
Group Submit Name (D)
Group receiving the user’s submitted document.
Group Submit Name (with label) (D)
Group receiving the user’s submitted document, preceded by the text string “Group Submit Name”.
Submit name & User Profile (D)
The submit name and user profile, as defined in Supervisor.
Submit name & User Profile (label) (D)
The submit name and user profile as defined in Supervisor, preceded by the appropriate text string.
User Submit Name (D)
Name of the user who submitted the job to Broadcast Agent.
User Submit Type (D)
User type or user profile, as defined in Supervisor.
ewboa60.book Page 84 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 85
Broadcast Agent analysis universe
Recipient information classThis class provides data on document recipients. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsCount Recipients (M)
Total number of recipients of a document.
Distribution Path (De)
Values of the distribution path.
Distribution System (D)
Distributed via Web Server, or Distributed via Server File System, to indicate how the processed Broadcast Agent document is to be distributed.Also returns information on the concatenated path.
Group Recipient Name (D)
Group Name receiving the document.
Recipient Name (D)
Name of the recipient.
Recipient Status (D)
Enabled, Disabled, or “Exceeded number of logins allowed.”
Recipient User Type (D)
User profile, as set in Supervisor.Possible values are: General Supervisor, Supervisor, Designer, Supervisor-Designer, User, Broadcast Agent, or Versatile.
ewboa60.book Page 85 Tuesday, August 19, 2003 10:52 AM
86 BusinessObjects Auditor Guide
Universes, Classes and Objects
Time frame classThis class provides job duration data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
Submit Date Time Frame subclassThis is a subclass of the Time Frame class that provides job submission dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.
Start Date Time Frame subclassThis is a subclass of the Time Frame class that provides system start dates for jobs. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsAverage Duration (M) Average duration of a job, in seconds.
Job Duration (M) Duration of a job, in seconds.
Job Duration Max (M) Maximum duration of a job, in seconds.
Job Duration Min (M) Minimum duration of a job, in seconds.
This object... ReturnsSubmit Datetime (D)
Date on which the task was submitted on the client machine.
This object... ReturnsStart Date (D) Date on which the task started on the server.
This is the start time for waiting tasks; it is a system parameter that is used until the task is completed. Note: You may receive the value “Friday 06 February 2037 6:28:16 AM.
ewboa60.book Page 86 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 87
Broadcast Agent analysis universe
End Date Time Frame subclassThis is a subclass of the Time Frame class that provides job end dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.
Expiration Date Time Frame subclassThis is a subclass of the Time Frame class that provides job expiry dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.
Begin Date Time Frame subclassThis is a subclass of the Time Frame class that is used to control job start dates. The following table shows the object that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsEnd Date (D) Date on which a task ended on the server.
This is the end time for waiting tasks; it is a system parameter that is used until the task is completed.Note: You may receive the value “Friday 06 February 2037 6:28:16 AM.
This object... ReturnsExpiration Date (D)
Date on which a task expired.
This object... ReturnsBegin Date (D) Date from which a job is considered valid.
• Set this date in the Conditions tab if you want to control the execution date.
• When a job is run, the task is duplicated, its status is set to Running (for the duplicated task), and the execution date of the original task is computed.
ewboa60.book Page 87 Tuesday, August 19, 2003 10:52 AM
88 BusinessObjects Auditor Guide
Universes, Classes and Objects
Audit BCA measures classThis class provides various Broadcast Agent job counts. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
NOTEYou cannot use more than one object from the Audit BCA Measures Class in a single indicator.
This object... ReturnsCount BCA Jobs (M) Number of batch jobs submitted.
Count Job Expired (M) Number of jobs that were retried but not ultimately executed.
Count Job Failed (M) Number of failed jobs.
Count Job Running (M) Number of jobs currently running.
Count Job Success (M) Number of successful jobs.
Count Job Suspended (M)
Number of suspended jobs.
Count Job Waiting (M) Number of waiting jobs.
ewboa60.book Page 88 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 89
Broadcast Agent analysis universe
Broadcast Agent analysis incompatibilitiesThe following table lists the objects in the Broadcast Agent Analysis universe that are known to be incompatible with each other.
* This incompatibility can be caused by one of two factors:• Incompatibility of WHERE clauses• Use of the “Count” operator
This object... in Class... is incompatible with...*
in Class
Count BCA Jobs Audit BCA Measures the other objects Audit BCA Measures
Count Job Expired Audit BCA Measures the other objects Audit BCA Measures
Count Job Failed Audit BCA Measures the other objects Audit BCA Measures
Count Job Success
Audit BCA Measures the other objects Audit BCA Measures
Count Job Suspended
Audit BCA Measures the other objects Audit BCA Measures
Count Job Waiting Audit BCA Measures the other objects Audit BCA Measures
ewboa60.book Page 89 Tuesday, August 19, 2003 10:52 AM
90 BusinessObjects Auditor Guide
Universes, Classes and Objects
Repository analysis universeThis section lists the classes in the Repository Analysis universe, and the objects that are available for selection within each class.
NOTEBecause the security domain handles international date and time operations, dates may be displayed in GMT format, which is the time zone reference for the repository. For more information, see the Broadcast Agent Administrator’s Guide.
User classThis class provides information on the people who want to access your business intelligence system. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsFailed Logins (D) Number of times that a user tried to log in, without success.
Group Name (D) Existing group names “the list of” or “group names from the repository.”Do not use with User Name, use instead User Group.Note: The Status object in the Document class can only be used with the Document Name and User Name (or Group Name) objects to query the documents that are enabled or diabled for a user (or group).
Identification Strategy (D)
No Password Checking or Full Password Checking.
Inheritance Rights (De)
Group from which rights were inherited.
Last Action Date (D)
Most recent date of a change of the user.
Last Action Type (D)
The last type of action to be associated with the user. Values that can be returned include: Unchanged, Inserted, Updated, or Moved.
Resource (D) Supervisor, Designer, Agent, Query, Reporter, WebReporter, or Unknown.
ewboa60.book Page 90 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 91
Repository analysis universe
Resource Status (D)
Disabled or Enabled.
User Group (D) Name of the user group.
User Group (with label) (D)
Name of the user group, preceded by the text string “User Group.”
User Level (D) Security level for an individual end-user object: Public, Controlled, Restricted, Confidential, or Private.
User Name (D) The list of user names from the repository.Note: The Status object in the Document class can only be used with the Document Name and User Name (or Group Name) objects to query the documents that are enabled or diabled for a user (or group).
User Name (with label) (D)
The list of user names from the repository, preceded by the text string “User Name.”
User Profile (D) User profile, as stored in the repository.
User Status (D) Disabled, Enabled, or “Exceeded number of logins allowed.”
User Status (picture) (De)
A graphical representation of user status (WebIntelligence only).
This object... Returns
ewboa60.book Page 91 Tuesday, August 19, 2003 10:52 AM
92 BusinessObjects Auditor Guide
Universes, Classes and Objects
Security Commands subclassThis is a subclass of the User class that provides information on the command restrictions applied to groups or individual users. It also shows their access rights to the functionality in Business Objects products. The following table shows the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsSecurity Configuration (D)
Name of the Business Objects product on which the restrictions are placed. These products include Designer, InfoView, Supervisor, BusinessObjects, and WebIntelligence.
Security Family (D)
Functionality family on which the restriction is placed.
Security Status (D)
Status of the restriction: Enabled, Disabled, Inherited, or Hidden.
Security Functionality (D)
Name of the functionality on which the restriction is placed for Designer, BusinessObjects, Supervisor, InfoView, or WebIntelligence.
Designer Functionality (D)
Name of the functionality on which the restriction is placed for Designer.
BusinessObjects Functionality (D)
Name of the functionality on which the restriction is placed for BusinessObjects.
Supervisor Functionality (D)
Name of the functionality on which the restriction is placed for Supervisor.
BusinessQuery Functionality (D)
Name of the functionality on which the restriction is placed for BusinessQuery.
WebIntelligence Functionality (D)
Name of the functionality on which the restriction is placed for WebIntelligence.
ewboa60.book Page 92 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 93
Repository analysis universe
Documents classThis class provides information on documents in the corporate repository. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsCategory Creator (De) Name of the user who created the document
category.
Category Name (De) Document’s category name.
Category Path (De) Hierarchical path of the document category if one exists.
Document Age (hour) (D)
Document age, in hours.
Document Age (min) (D)
Document age, in minutes.
Document Age (sec) (D)
Document age, in seconds.
Document Category (D) A list of document categories with hierarchical path if one exists.
Document Creation Date (D)
Document creation date.
Document Domain (D) The list of document domain names.Note: The Status object cannot be associated directly to the Document Domain object without the Document Name object.
Document ID (D) Document ID.
Document Name (D) Document name. Note: The Status object cannot be associated directly to the Document Domain object without the Document Name object. The Status object can only be used with the Document Name object and User Name (or Group Name) objects in the User Class to query the documents that are enabled or diabled for a user (or group).
ewboa60.book Page 93 Tuesday, August 19, 2003 10:52 AM
94 BusinessObjects Auditor Guide
Universes, Classes and Objects
NOTE
It is not possible to retrieve inherited values of the rights on documents, and it is necessary to look at the rights on each group and domain access to verify if a user or group has the rights to use a document.
Document Name & Type (D)
Document name, along with its type.
Document Persistent (D)
“Persistent” if a document is published to the corporate repository, or Not Persistent if the document is automatically deleted when retrieved by the last user.
Document Size (M) Document size, in bytes.
Document Type (D) Document type: .rep, .bqy, .wid, .wqy, or .rea.
Document Type (picture) (De)
HTML hyperlink to a graphical image of the document type (Auditor interface only).
Last Action Date (D) Date on which the document was most recently changed.
Last Action Type (D) The last type of action to be associated with the document.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.
Owner/Sender (D) Owner/Sender of the document.
Status (D) Document status: Enabled, Hidden, Inherited, Disabled.This object cannot be associated directly to the Document Domain object without the Document Name object. This object can only be used with the Document Name object and User Name (or Group Name) objects in the User Class to query the documents that are enabled or diabled for a user (or group).
This object... Returns
ewboa60.book Page 94 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 95
Repository analysis universe
Document Domain subclassThis is a subclass of the Documents class that provides information on the domain that contains the documents. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
NOTEIf the Document Domain Creator object is used in a query with other objects from the Document classes, a blank cell appears for the creator name for the following reasons:• the initial system supervisor ID that was used to create the two first domains
is no longer available• the supervisor who created the domain has been deleted from the repository To retrieve creator names, you need to keep all the supervisors who created the document and universe domains in the repository. You cannot display the creator name of the initial domains.
This object... ReturnsDocument Domain (D) The list of document domain names.
Document Domain Creator (D)
The name of the user who created the document domain.
Document Domain Creation Date (D)
The date that the domain was created.
Last Action Date (D) Date on which the document was most recently changed.
Last Action Type (D) The last type of action to be associated with the document domain.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.
ewboa60.book Page 95 Tuesday, August 19, 2003 10:52 AM
96 BusinessObjects Auditor Guide
Universes, Classes and Objects
Data Providers subclassThis is a subclass of the Documents class that is used to supply information on the provision of data. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
Received By subclassThis is a subclass of the Documents class that provides information on the users receiving documents from the corporate repository. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsData Provider Name (D)
Name of the data provider.
Data Provider Source (D)
Information about the origin of the data in the data provider: universe name, file path, or name of query.No values are shown for third-party documents
Duration (D) Time, in seconds, that it took to run the query.
Last Refresh Date (D)
Last refresh date of the data provider.
Number of Rows (D)
Number of rows in the query.
Partial Indicator (D)
Information on the data provider, indicating whether the results are Partial or Total.
This object... ReturnsRecipient Function (D)
User profile as set in Supervisor: General Supervisor, Supervisor, Designer, Supervisor-Designer, User, Broadcast Agent, or Versatile.
Recipient Name (D)
User name of the recipient.
Recipient Name (with label) (D)
User name of the recipient, preceded by the text string “Recipient Name.”
ewboa60.book Page 96 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 97
Repository analysis universe
Universe Domain subclassThis is a subclass of the Documents class that provides information on the domain that contains the universes. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
NOTEIf the Universe Domain Creator object is used in a query with other objects from the Universe classes, a blank cell appears for the creator name for the following reasons:• the initial system supervisor ID that was used to create the two first domains
is no longer available• the supervisor who created the domain has been deleted from the repository To retrieve creator names, you need to keep all the supervisors who created the document and universe domains in the repository. You cannot display the creator name of the initial domains.
This object... ReturnsUniverse Domain (D) The list of universe domain names.
Universe Domain Creator (D)
The name of the user who created the universe domain.
Universe Domain Creation Date (D)
The date that the domain was created.
Last Action Date (D) Date on which the universe domain was most recently changed.
Last Action Type (D) The last type of action to be associated with the universe domain.Values that can be returned include: Unchanged, Inserted, Updated, or Moved.
ewboa60.book Page 97 Tuesday, August 19, 2003 10:52 AM
98 BusinessObjects Auditor Guide
Universes, Classes and Objects
Universe classThis class provides universe setup information. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This Object... ReturnsFile Name (D) The eight-byte name of the universe file (the
downloaded universe file is stored locally as a *.unv file).
Last Update Time (M) Time of the last universe update.
Objects Filter (De) Objects filter for the universe, set in Supervisor.
Row Restriction (De) Row restriction for the universe, set in Supervisor.
Status (M) Universe status: Enabled, Hidden, Inherited, or Disabled.
Table Mapping (De) Table mapping for the universe, set in Supervisor.
Universe Description (De)
The first 256*2 characters of the universe description.
Universe Domain (D) Name of the universe domain.
Universe ID (D) Universe ID.
Universe Name (D) Name of the universe.
Universe Revision (De) Revision number of the universe.
ewboa60.book Page 98 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 99
Repository analysis universe
Connection classThis class provides universe connection data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsConnection Name (D)
Name of the universe connection.
Connection RDBMS (D)
ID of the database middleware.
Connection Type (D)
Connection type: Document Domain, Universe Domain, or Secured.
Last Action Date (D)
Date on which the universe connection was most recently changed.
Last Action Type (D)
The last type of action to be associated with the universe connection.Values that can be returned include: Unchanged, Deleted, Inserted, Updated, or Moved.
ewboa60.book Page 99 Tuesday, August 19, 2003 10:52 AM
100 BusinessObjects Auditor Guide
Universes, Classes and Objects
Repository Analysis incompatibilitiesThe following table lists the objects in the Repository Analysis universe that are known to be incompatible with each other:
This object... in Class... is incompatible with this object...
in Class
Data Provider Universe Data Providers Universe Domain Universe
Data Provider Universe Data Providers Universe Name Universe
Data Provider Universe Data Providers File Name Universe
Data Provider Universe Data Providers Status Universe
Data Provider Universe Data Providers Connection Name Universe
Data Provider Universe Data Providers Connection RDBMS Universe
Data Provider Universe Data Providers Connection Type Universe
Data Provider Universe Data Providers Last Action Date Universe
Data Provider Universe Data Providers Last Action Type Universe
Status Documents Universe Domain Universe
Status Documents Universe Name Universe
Status Documents File Name Universe
Status Documents Status Universe
Status Documents Connection Name Connection
Status Documents Connection RDBMS Connection
Status Documents Connection Type Connection
Status Documents Last Action Date Connection
Status Documents Last Action Type Connection
ewboa60.book Page 100 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 101
Universe domain analysis universe
Universe domain analysis universeThis section lists the classes in the Universe Domain Analysis universe, and the objects that are available for selection within each class.
Universe parameters classThis class provides information on the maintenance of universes. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsCreation Date (D)
Date on which a universe was created.
Filename (D) The eight-byte name of the universe file. The downloaded universe file is stored locally as a *.unv file.
Filename (with label) (D)
The eight-byte name of the universe file, preceded by the text string “Filename”.
First Author (D) Original creator, user ID, of a universe.
Last Author (D) ID of the user who last updated a universe.
Last Modify Date (D)
Date on which a universe was last modified.
Linked Universe ID (D)
ID of the linked universe, if applicable.
Linked Universe Name (D)
Name of the linked universe, if applicable.This object applies only to linked universes, and not to classes and objects in the current universe
Max Number Of Columns (D)
Maximum number of columns allowed in queries for the selected universe.
Max Number of Lines (D)
Maximum number of rows that can be returned for the selected universe.
Max Query Time (D)
Maximum query time, in seconds, allowed by the selected universe.
Number of Linked Universes (M)
Number of other universes to which the selected universe is linked in the repository.
ewboa60.book Page 101 Tuesday, August 19, 2003 10:52 AM
102 BusinessObjects Auditor Guide
Universes, Classes and Objects
Class details classThis class provides information on universe classes. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
Number of Universes (M)
Number of universes in the repository.
Universe Help Text (D)
Help text available when selecting and opening a universe.This object does not apply to linked universes, but rather only to the current universe.
Universe ID (D) Internal ID associated with a universe.
Universe Name (D)
Name of a universe.
Universe Name (with label) (D)
Name of a universe, preceded by the text string “Universe Name”.
Universe Name (with ID) (D)
Name of a universe, with its internal ID.
Version (D) Version number of a universe.This object does not apply to linked universes, only to the current universe.
This object... Returns
This object... ReturnsClass Description (D) Description of a class.
Class Hidden (D) Yes for a hidden class, or No for a visible, user-enabled class.All the classes listed in this guide have a Class Hidden value of No.
Class ID (D) ID of a class.
Class Name (D) Name of a class.
Class Name (with label) (D)
Name of a class, preceded by the text string “Class Name.”
Number of Classes (M) Number of unique universe classes.
ewboa60.book Page 102 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 103
Universe domain analysis universe
Object details classThis class provides universe object data. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
Advanced subclassThis is a subclass of the Object Details class that provides further information on objects, particularly relating to security. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsHidden Object (D) Yes for a hidden object, or No for a user-enabled
object.
Number of Objects (M) Number of distinct objects.
Object Description (D) Help text for an object.
Object ID (D) ID of an object.
Object Name (D) Name of an object.
Object Name (with label) (D)
Name of an object, preceded by the text string “Object Name.”
Object Position (D) Numerical position of an object within its class.
Object Table Name(s) (D)
Table names referenced by an object.
Object Type (D) The type of the object: Dimension, Detail, or Measure.
SELECT Clause (D) SQL Select clause for the selected object.
WHERE Clause (D) SQL Where clause for the selected object.
This object... ReturnsIncompatible Table (D)
A list of incompatible table names specified by Designer for proper hierarchy navigation.
Object Properties (D)
The properties of an object.
Object Security Access Level (D)
Public, Controlled, Restricted, Confidential, Private, or Unknown.These values are set individually in Designer.
ewboa60.book Page 103 Tuesday, August 19, 2003 10:52 AM
104 BusinessObjects Auditor Guide
Universes, Classes and Objects
Condition details classThis class provides information on universe conditions. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsCondition Description (D)
Description of the condition.
Condition Hidden (D) Yes for a hidden condition, No for a user-enabled condition, or Unknown.
Condition ID (D) Condition ID.
Condition Name (D) Condition name.
Condition Position (D) Position of the condition within the universe.
Condition Table Name(s) (D)
A list of table names used in the condition.
Condition WHERE Clause (D)
The Where clause associated with a condition, if applicable.
Incompatible Table (D) A list of incompatible table names, specified in Designer, for proper hierarchy navigation.
Number of Conditions (M)
Total number of conditions.
ewboa60.book Page 104 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 105
Universe domain analysis universe
Universe tables classThis class provides information on universe tables. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
Alias Information subclassThis is a subclass of the Universe Tables class that provides table alias information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsNumber of Tables (M) Total number of unique tables.
Table Name (with label) (D) Name of a table, preceded by the text string “Table Name.”
Table/Alias Name (D) Name of a table (original or alias).
Table/Alias Properties (D) Table/alias properties.
Table ID (D) Table ID.
This object... ReturnsAlias Table ID (D) Alias table ID.
Alias (Y or N) (D) Y (yes) if the table is an alias; otherwise, N (no).
Original Database Table Name (D)
Base table name for an alias.
ewboa60.book Page 105 Tuesday, August 19, 2003 10:52 AM
106 BusinessObjects Auditor Guide
Universes, Classes and Objects
Joins classThis class provides information on universe joins. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
Contexts classThis class provides data relating to universe contexts. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsJoin ID (D) Join ID.
Join SQL (D) Join SQL.
Number of Joins (M) Number of joins in the universe.
Table 1 Name (D) Name of the first table in the join.
Table 2 Name (D) Name of the second table in the join.
This object... ReturnsContext ID (D) Context ID.
Context Join ID (D) Context join ID.
Context Join SQL (D) Context join SQL.
Context Join Table 1 Name (D) Name of the first table of the context join.
Context Join Table 2 Name (D) Name of the second table of the context join.
Context Name (D) Context name.
Number of Contexts (M) Number of contexts.
ewboa60.book Page 106 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 107
Universe domain analysis universe
Hierarchies classThis class provides information on universe hierarchies. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
Number of Objects in Hierarchies subclassThis is a subclass of the Hierarchies class that provides counts of objects used in hierarchies. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsHierarchy ID (D) ID of a hierarchy.
Hierarchy Name (D) Name of a hierarchy.
Hierarchy Name (with label) (D)
Name of a hierarchy, preceded by the text string “Hierarchy Name”.
Hierarchy Position in Universe (D)
Position of a hierarchy in its universe.
Number of Hierarchies (M) Total number of hierarchies.
Object Name in Hierarchy (D)
Name of an object in a hierarchy.
Object Position in Hierarchy (D)
Position of an object in a hierarchy.
This object... ReturnsNumber of Objects (M) Number of distinct objects in hierarchies.
Number of Object Instances (M)
Number of object appearances (instances) in hierarchies.
ewboa60.book Page 107 Tuesday, August 19, 2003 10:52 AM
108 BusinessObjects Auditor Guide
Universes, Classes and Objects
Universe Domain Analysis incompatibilitiesThe following table lists the objects in the Universe Domain Analysis universe that are known to be incompatible.
This object... in Class... is incompatible with this object...
in Classes
Object Security Access Level
Advanced All objects Joins, Contexts and Hierarchies
Class Description Class Details All objects Joins, Contexts and Hierarchies
Condition Name Condition Details
All objects Joins, Contexts and Hierarchies
Context Id Contexts All objects Hierarchies
Object Position Object Details All objects Joins, Contexts and Hierarchies
Table/Alias Name Universe Tables
Table Name Universe Tables
Table/Alias Name Universe Tables
Table Name (with label)
Universe Tables
Table/Alias Name Universe Tables
Alias Table ID Universe Tables
ewboa60.book Page 108 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 109
System information universe
System information universeThis section lists the classes in the System Information universe, and the objects that are available for selection within each class.
Actions classThis class provides specific data on user actions. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
This object... ReturnsAction App (D) Name of the application that generated the event.
Action App ID (D) The ID of the application that generated the event.This object provides a better compatibility than Action App Name, which may change between different versions of the Business Objects suite.
Action Error ID (D) Error ID (if applicable).This object is used by the Broadcast Agent Analysis universe to record error codes. See Monitoring Job Information subclass on page 81.
Action Host (D) Business Objects server that generated the event.
Action ID (D) Internal ID used to trace events.
Action Name (D) Name of the event, for example, “Get list of Corporate Documents” or Login.
Action Name ID (D)
ID of the event name.
Action Time (D) Action’s date and time.
Action Type (D) Type of action, such as Repository Name.
Action Type Detail (De)
A breakdown of Action Type, such as “Document” within Repository Name.
Action Type Detail (with label) (De)
A text string in front of Action Type Detail, such as “Object Name: Document”.
Cluster ID (D) Internal ID of the cluster in which the event occurs.
Cluster Name (D) Name of the cluster in which the event occurs.
ewboa60.book Page 109 Tuesday, August 19, 2003 10:52 AM
110 BusinessObjects Auditor Guide
Universes, Classes and Objects
NOTEWhen you migrate from a previous version of BusinessObjects to BusinessObjects 6.1 the object Cluster ID=0, and Cluster Name='WebIntelligence 2.x Cluster' are not in the audit database. They are generated into virtual views as null values shown as 0 in the 'Cluster ID' objects. This also applies to Cluster Name objects set to 'WebIntelligence 2.x Cluster'.
Session ID (D) InfoView session ID.This can be used to generate traces of the first and last events, and to break down reports by session generated by a user.
User Name (D) Name of the user who generated the event.
User Name (with label) (D)
Name of the user who generated the event, preceded by the text string “User Name.”
This object... Returns
ewboa60.book Page 110 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 111
System information universe
Action Details subclassThis is a subclass of the Actions class that provides a variety of information. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsNumber of Elements (D)
Number of items in the Inbox, Corporate or Personal document list, or number of universes.This number is logged when a “Get list” event occurs.
Number of Rows (D) Number of rows retrieved back for each action.For each action name, see the “Number of Rows Retrieved” measure in the Action Measure subclass.
Object Name (D) Name of the object.
Object Name (with label) (D)
Name of the object, preceded by the text string “Object Name.”
Repository Name (D) Repository name.
SQL Value (D) SQL statement sent by the system whenever a result is computed or generated.
Total Size of Elements in List (D)
Total size of documents in the Inbox, Corporate or Personal document list.This size is logged when a “Get list” event occurs.
Universe Name (D) Universe name.
Universe Name (with label) (D)
Universe name, preceded by the text string “Universe Name.”
ewboa60.book Page 111 Tuesday, August 19, 2003 10:52 AM
112 BusinessObjects Auditor Guide
Universes, Classes and Objects
Administration SDK subclassThis is a subclass of the Action Details subclass that provides security information from Administration SDK. When a security property on a user or a group is modified by Administration SDK, an event occurs. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsGroup Name (Administration) (D)
Name of the group which was created or deleted from the Administration SDK.
Object Security Level (D) The security level property of the user:• private• confidential• restricted• controlled• public
Parent Group Name (Administrator) (D)
Name of the group of the user who had Administration SDK security updates, for example, when if a user was created or their profile set.
Password (D) Encrypted value of the User password set by the Administration SDK.
Password Can Change (D) User password event logged when the user password property has been changed.When this parameter is set to 'TRUE', the user will be able to change his password. Otherwise the value is 'FALSE' and the password remains the same.
Password Checking (D) User password event logged when the user password property has been changed.When this parameter is set to 'TRUE', the user will have to check his password. Otherwise the value is 'FALSE' and no check will be asked again.
ewboa60.book Page 112 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 113
System information universe
Password Limited Validity (D)
Three event details logged when the user password periodicity property has been changed:• password limited validity• validity is periodic• validity period (days)When this parameter is set to 'TRUE', the user will have to change his assigned password after a specified fixed number of days (retrieved in Password Validity Period (Days) object).Otherwise the value is 'FALSE', and the validity period is removed.
Password Must Change (D)
User password event logged when the user password property has been changed.When this parameter is set to 'TRUE', the user will have to change his password at the first login. Otherwise the value is 'FALSE' and the password can remain the initial assigned password.
Password Periodic Validity (D)
Three event details logged when the user password periodicity property has been changed:• password limited validity• validity is periodic• validity period (days)When this parameter is set to 'TRUE', the user will have to change his assigned password after a specified number of days (retrieved in Password Limited Validity object) on a cyclic mode. Otherwise the value is 'FALSE', and the periodic property is removed
Password Status (D) User password enabled or not by the Administration SDK.
This object... Returns
ewboa60.book Page 113 Tuesday, August 19, 2003 10:52 AM
114 BusinessObjects Auditor Guide
Universes, Classes and Objects
Browser information subclassThis is a subclass of the Action Details subclass that provides information about the client’s browser when a login event occurs. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
Password Validity Period (Days) (D)
User password property: number of days that can elapse before the user is required to change their password.
Profile Name (D) User profile setting:• private• confidential• restricted• controlled• public
User Name (Administration) (D)
Name of the user who had Administration SDK security updates, for example, when if a user was created or their profile set.
This object... ReturnsBrowser Type (D) Version and type of Internet browser.
Client IP (D) Internet Protocol (IP) address of the client.
Client OS (D) Version and type of operating system.
This object... Returns
ewboa60.book Page 114 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 115
System information universe
Document subclassThis is a subclass of the Action Details subclass. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsDocument Category (D) Category of the document.
Document Description (D) Document description.
Document ID (D) Document ID.
Document Name and Type (D)
Document name and type.
Document Name (with label) (D)
Name of the document, preceded by the text string “Document Name.”
Document Type (D) Three-character document suffix, such as .rep, .wid and .wqy.
Keyword (D) Keyword entered when a Publish/Send/Save event occurs.
Overwrite (D) Option selected when a Publish/Save event occurs.Values are “True” or “False.”
Refresh Options (D) Refresh options entered when a Publish/Send/ Save event occurs.Values for third-party documents are:• “Refresh on open”• “Refresh manually”• “Scheduled refresh”• “None”
User Name (Target) (D) Distinct destination groups when a Publish/Save event occurs.There is one row generated for each target entered.
ewboa60.book Page 115 Tuesday, August 19, 2003 10:52 AM
116 BusinessObjects Auditor Guide
Universes, Classes and Objects
Page information subclassThis is a subclass of the Action Details subclass that provides page information when a Get Page event occurs or when an Apply Format event occurs (Report Name detail only). The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsDocument Type (D) Three characters document extensions, for example
.xls, .pdf, and .xml, when a Get Page event occurs.
Page Range (D) Page Range when a Get Page event occurs.
Report Name (D) Report Name when a Get Page or an Apply Format event occurs.
ewboa60.book Page 116 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 117
System information universe
Action Measures subclassThis is a subclass of the Actions class that is used to quantify user actions. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsAction Duration (sec) (M)
Total duration of an event, in seconds. Actual action durations are stored in milliseconds, and any unknown action values are returned as NULL.
Count (M) A generic count. Use this object in combination with another object to count the number of occurrences. It is not specific to a particular data type.
Document Size (M) Document size in bytes. This is a non-aggregate object, returning all sizes individually without adding them together.
Number of Action Details (M)
Total number of items associated with each user action.
Number of Actions (M) A count of the number of actions recorded
Number of Documents Used (M)
Number of documents that have been accessed.
Number of Log Offs (M) Number of log offs.
Number of Logins (M) Number of attempted logins.
Number of Rows Retrieved (M)
Number of rows retrieved from a document.
Number of Sessions (M)
Number of complete user sessions.
Number of Users (M) Number of user sessions opened so far.
ewboa60.book Page 117 Tuesday, August 19, 2003 10:52 AM
118 BusinessObjects Auditor Guide
Universes, Classes and Objects
Session Duration (hour) (M)
Total duration of a complete session, in hours.Use this object in conjunction with:• the Session ID object (see Actions class on
page 109). Otherwise, action times, and not session times, are returned.
• the User Name object to return session times by user.
Session Duration (min) (M)
Total duration of a complete session, in minutes.Use this object in conjunction with:• the Session ID object (see Actions class on
page 109). Otherwise, action times, and not session times, will be returned.
• the User Name object to return session times by user.
Sum Document Size (M)
Total size of a document, in bytes.Use this object in conjunction with the Document Name object (Actions class on page 109) to return bytes per document.
This object... Returns
ewboa60.book Page 118 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 119
System information universe
Averages subclassThis is a subclass of the Action Measures subclass that provides data based on a series of actions over time. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsAvg Action Duration (sec) (M)
Average duration of an event, in seconds.
Avg Actions per Day (M) Average number of actions over a month, divided by 30.
Avg Actions per Hour (M)
Average number of actions over a day, divided by 24.
Avg Actions per Month (M)
Average number of annual actions, divided by 12.
Avg Document Size (M) Average document size, in bytes.
Avg Rows Retrieved (M)
Average number of rows retrieved via user queries.
Avg Session Duration (hour) (M)
Total session time over a day, divided by 24.You must use this object with the Session ID object (Actions class on page 109). Otherwise, your results may not be accurate.
Avg Session Duration (month) (M)
Total session time over a month, divided by 30.You must use this object with the Session ID object (Actions class on page 109). Otherwise, your results may not be accurate.
Avg Session Duration (week) (M)
Total session time over a week, divided by 7.You must use this object with the Session ID object (Actions class on page 109). Otherwise, your results may not be accurate.
Avg Users per Day (M) Number of unique user sessions, divided by 30.
Avg Users per Hour (M) Average number of user sessions that were started per hour.
Avg Users per Month (M)
Average number of user sessions that were started per month.
ewboa60.book Page 119 Tuesday, August 19, 2003 10:52 AM
120 BusinessObjects Auditor Guide
Universes, Classes and Objects
Action Time subclassThis is a subclass of the Actions class that provides the timing of user actions. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsAction Day (D) Day on which an action took place.
Action Hour AM/PM (D) Hour in which an action took place, in AM/PM format.
Action Hour (D) Hour in which an action took place, in 24-hour format.
Action HHMISS (D) Hour in which an action took place, in 24-hour format and in minutes and seconds.Example: 17:53:59 = 5:53 pm and 59 seconds
Action Minutes (D) Number of minutes past the hour in which an action took place.
Action Month (D) Number of the month in which an action took place.
Action Month Name (De)
Name of the month in which an action took place.
Action Quarter (D) The quarter in which an action took place, such as Q4.
Action Seconds (D) Number of seconds after the minute in which an action took place.
Action Week (D) Number of the week in which an action took place.
Action YYYY (D) Year (YYYY) in which an action took place.
Action YYYY-MM (D) Year (YYYY) and month (MM) in which an action took place, such as 2001-01 for January 2001.
Action YYYY-MM-DD (D)
Year (YYYY), month (MM), and day (DD) on which an action took place, such as 2001-01-25 for January 25, 2001.
Action YYYY-MM-DD HHMISS (D)
Start time (to the second) of the event, in the format YYYY/MM/DD HH:MM:SS; for example, 2001/09/25 17:35:59 for 5:35 pm and 59 seconds on September 25, 2001.
ewboa60.book Page 120 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 121
System information universe
Last Action Start Time (D)
Start time (to the second) of the event for a given event type.For example, it is used to retrieve the last time a refresh was performed.
Session End Time (D) Time at which a user’s session ended, in the format YYYY/MM/DD HH:MM:SS.Use this object in conjunction with the Session ID object (Actions class on page 109). Otherwise, action times, and not session times, will be returned.
Session Start Time (D) Time at which a user’s session started, in the format YYYY/MM/DD HH:MM:SS.Use this object in conjunction with the Session ID object (Actions class on page 109). Otherwise, action times, and not session times, will be returned.
This object... Returns
ewboa60.book Page 121 Tuesday, August 19, 2003 10:52 AM
122 BusinessObjects Auditor Guide
Universes, Classes and Objects
Action Time Frame (with label) subclassThis is a subclass of the Action Time class that enables you to return text strings for action times. The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsAction Day (with label) (D)
Text string for the day on which an action took place, such as “Day: 28”.
Action DD/MM (with label) (D)
Text string “Action Start Time” preceding the day and month in which an action took place, such as “Action Start Time: 25/09”.
Action Hour (with label) (D)
Text string for the hour in which an action took place, such as “Hour: 03”.
Action Minutes (with label) (D)
Text string for the minutes past the hour in which an action took place, such as “Minutes: 46”.
Action MM/DD (with label) (D)
Text string “Action Start Time” preceding the month and day on which an action took place, such as “Action Start Time: 09/25”.
Action Month (with label) (D)
The month.
Action Month Name (with label) (De)
Text string for the month in which an action took place, such as “Month: 12”.
Action Quarter (with label) (D)
Text string for the quarter in which an action took place, such as “Quarter: Q4”.
Action Seconds (with label) (D)
Text string for the seconds after a minute in which an action took place, such as “Seconds: 50”.
Action Week (with label) (D)
Text string for the week in which an action took place, such as “Week: 51”.
Action Year (with label) (D)
Text string for the year in which an action took place, such as “Year: 2001”.
ewboa60.book Page 122 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 123
System information universe
Session analysis (no actions) classThis class provides session data that is not action-related. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
NOTEThe objects in the Session Analysis (No Actions) subclass are not designed to be used with objects of the Actions class. The two sets of objects should not be mixed when creating and editing indicators.
NOTEWhen you migrate from a previous version of BusinessObjects to BusinessObjects 6.1 the object Cluster ID=0, and Cluster Name='WebIntelligence 2.x Cluster' are not in the audit database. They are generated into virtual views as null values shown as 0 in the 'Cluster ID' objects. This also applies to Cluster Name objects set to 'WebIntelligence 2.x Cluster'.
This object... ReturnsCluster ID (D) Internal ID of the cluster in which the session occurs.
Cluster Name (D) Name of the cluster in which the session occurs.
Session Host (user IP) (D)
IP address of the session host.
Session User (D) Session user name.
Session User (no 'unknown' users) (D)
Session user name, if known.This object filters out “unknown” users.
Session End Time (D) Session end time, in the format YYYY/MM/DD HH:MM:SS, for example, 2001/09/25 17:35:59 for 5:35pm and 59 seconds on September 25, 2001
Session ID (D) Session ID.
Session Start Time (D) Session start time, in the format YYYY/MM/DD HH:MM:SS, for example, 2001/09/25 16:30:29 for 4:30 pm and 29 seconds on September 25, 2001
ewboa60.book Page 123 Tuesday, August 19, 2003 10:52 AM
124 BusinessObjects Auditor Guide
Universes, Classes and Objects
Session Measures subclassThis is a subclass of the Session Analysis (No Actions) class that allows you to measure the number and duration of sessions.
NOTEThe objects in the Session Measures subclass are not designed to be used with objects of the Actions class. The two sets of objects should not be mixed when creating and editing indicators.
The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsNumber of Sessions (M) Number of completed user sessions.
Number of Session Users (M) Number of users who opened sessions.
Session Duration (sec) (M) Total session duration, in seconds.
Session Duration (min) (M) Total session duration, in minutes.
Avg Session Duration (sec) (M) Average session duration, in seconds.
Avg Session Duration (min) (M) Average session duration, in minutes.
ewboa60.book Page 124 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 125
System information universe
Session Time subclassThis is a subclass of the Session Analysis (No Actions) class that enables you to view the times at which sessions took place.
NOTEThe objects in the Session Time subclass are not designed to be used with objects of the Actions class. The two sets of objects should not be mixed when creating and editing indicators.
The following table lists the objects that you can select from this subclass in the BusinessObjects Query Panel.
This object... ReturnsSession Day (D) The day number, such as 05 for the fifth day.
Session Duration (1 min intervals) (D)
Time blocks of one minute.Can be used by the Visit Duration indicator to divide session times into intervals of one minute, instead of the default five minutes
Session Duration (5 min intervals) (D)
Time blocks of five minutes. Used as the default setting by the Visit Duration indicator to divide session times into five minute intervals.
Session Hour (D) Time of a session in 24-hour format.
Session Minutes (D) Minutes past the hour in which a session took place.
Session MM (D) Month in which a session took place, such as 03 for March.
Session Quarter (D) The quarter in which a session took place, such as Q2.
Session Start (D) Unformatted session start time.
Session Week (D) Week in which a session took place, such as 52 for the last week of the year.
Session YYYY (D) Year in which a session took place.
Session YYYY-MM (D) Year and month of a session.
Session YYYY-MM-DD (D) Year, month, and day of a session.
ewboa60.book Page 125 Tuesday, August 19, 2003 10:52 AM
126 BusinessObjects Auditor Guide
Universes, Classes and Objects
Site log info classThis class provides you with process logging. The following table lists the objects that you can select from this class in the BusinessObjects Query Panel.
NOTEWhen you migrate from a previous version of BusinessObjects to BusinessObjects 6.1 the object Cluster ID=0, and Cluster Name='WebIntelligence 2.x Cluster' are not in the audit database. They are generated into virtual views as null values shown as 0 in the 'Cluster ID' objects. This also applies to Cluster Name objects set to 'WebIntelligence 2.x Cluster'.
This object... ReturnsCluster ID (D) Internal ID of the cluster in which the site log
occurs.
Cluster Name (D) Name of the cluster in which the site log occurs.
Log Host (D) The host a user is logged onto.
Log ID (D) ID of the log file.
Log Info (D) Information on the log file.
Log Level (D) Level of the log file.
Log Module (D) The log module.
Log PID (D) The log Personal Identifier.
Log Time (D) Time of the log creation.
ewboa60.book Page 126 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 127
System information universe
System information incompatibilitiesThe following table lists the objects in the System Information universe that are known to be incompatible.
This object... in Class... is incompatible with this object...
in Classes
Number of Log Offs
Action Measures
All objects Action Measures, Averages, Action Time
Number of Sessions
Action Measures
Avg Document Size
Averages
Number of Sessions
Action Measures
Avg Rows Retrieved
Averages
Number of Sessions
Action Measures
All objects Session Measures
Avg Users per Month
Averages Avg Users per Day Averages
Avg Users per Month
Averages Avg Users per Hour
Averages
Avg Actions per Month
Averages Avg Actions per Day
Averages
Avg Actions per Month
Averages Avg Actions per Hour
Averages
Avg Actions per Month
Averages Number of Sessions
Session Measures
Avg Actions per Month
Averages Number of Session Users
Session Measures
Avg Actions per Month
Averages Session Duration (sec)
Session Measures
Avg Actions per Month
Averages Session Duration (min)
Session Measures
Avg Actions per Month
Averages Avg Session Duration (sec)
Session Measures
Avg Actions per Month
Averages Avg Session Duration (min)
Session Measures
ewboa60.book Page 127 Tuesday, August 19, 2003 10:52 AM
128 BusinessObjects Auditor Guide
Universes, Classes and Objects
Avg Actions per Day
Averages Number of Sessions
Session Measures
Avg Actions per Day
Averages Number of Session Users
Session Measures
Avg Actions per Day
Averages Session Duration (sec)
Session Measures
Avg Actions per Day
Averages Session Duration (min)
Session Measures
Avg Actions per Day
Averages Avg Session Duration (sec)
Session Measures
Avg Actions per Day
Averages Avg Session Duration (min)
Session Measures
Avg Actions per Hour
Averages Number of Sessions
Session Measures
Avg Actions per Hour
Averages Number of Session Users
Session Measures
Avg Actions per Hour
Averages Session Duration (sec)
Session Measures
Avg Actions per Hour
Averages Session Duration (min)
Session Measures
Avg Actions per Hour
Averages Avg Session Duration (sec)
Session Measures
Avg Actions per Hour
Averages Avg Session Duration (min)
Session Measures
This object... in Class... is incompatible with this object...
in Classes
ewboa60.book Page 128 Tuesday, August 19, 2003 10:52 AM
part
Using Auditor
ewboa60.book Page 129 Tuesday, August 19, 2003 10:52 AM
ewboa60.book Page 130 Tuesday, August 19, 2003 10:52 AM
chapter
Using Predefined Indicators
ewboa60.book Page 131 Tuesday, August 19, 2003 10:52 AM
132 BusinessObjects Auditor Guide
Using Predefined Indicators
OverviewThis chapter provides a detailed review of the predefined indicators. The content is divided into two parts:• an alphabetical list of all indicators• a detailed description of the indicators, divided into analytical categories.
Each category has a number of subcategories, which further organize indicators for ease of access.
Indicators access full-client (*.rep) documents.
Why are predefined indicators important?Auditor uses predefined indicators to give you access to the information you need in order to monitor, analyze, and optimize your Business Objects deployment. These indicators are delivered as part of the Auditor package.Each indicator contains one or more reports that focus on a very specific area of analysis; for example, the Average Refresh Time indicator, which shows the average refresh time (in seconds) for all documents, broken down by document name, user, document type, and node.Predefined indicators are your key to information such as: • the users accessing and utilizing your system• the most popular reports and universes• the number of reports that are impacted by changing an objectFor monitoring and analysis that is even more finely tuned to your particular system, you can create your own indicators.
ewboa60.book Page 132 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 133
Predefined indicators available with Auditor
Predefined indicators available with AuditorThe following table lists all the predefined indicators provided with Auditor.
Indicator Category Subcategory10 Least Read Documents Document Management Top 10 & Bottom 10
10 Least Exported Documents
Document Management Top 10 & Bottom 10
10 Most Read Documents Document Management Top 10 & Bottom 10
10 Most Exported Documents
Document Management Top 10 & Bottom 10
Average Number of Users Concurrently Logged in
System Information Traffic
Average Refresh Time Document Management Usage
Average Session Duration per Cluster
System Information Traffic
Average Session Duration per User
System Information Traffic
Average Session Duration System Information Traffic
Broadcast Agents on the System
Broadcast Agent Global Console
Cluster Nodes System Information Usage
Deactivated Users User Information Security
Document Information Detail Document Management Analysis
Document Information Summary
Document Management Analysis
Document Size in Repository Document Management Analysis
Document Usage Document Management Usage
Documents Never Read Document Management Analysis
Impact Analysis Universe Management Impact Analysis
IP Addresses Accessing my Audited Clusters
System Information Security
ewboa60.book Page 133 Tuesday, August 19, 2003 10:52 AM
134 BusinessObjects Auditor Guide
Using Predefined Indicators
Job Success Rate Broadcast Agent Job Information
Job Summary Broadcast Agent Job Information
Jobs per BCA Broadcast Agent Job Information
Jobs per Frequency Broadcast Agent Job Information
Jobs per User Broadcast Agent Job Information
Joins per Universe Universe Management Properties
Last Login for User User Information Activity
Most Active Users User Information Top 10 & Bottom 10
Most Popular Actions User Information Activity
Most Popular Actions per Document
Document Management Analysis
Most Popular Universes Universe Management Usage
Number of Objects per Universe
Universe Management Properties
Number of Users in the Repository
User Information Activity
Number of User Sessions User Information Activity
Objects Accessed Universe Management Usage
Objects Used in Documents Document Management Analysis
Peak Usage System Information Usage
Refresh and Edit Activity User Information Activity
Total Users Concurrently Logged in by Day
System Information Traffic
Types of Browsers in Use System Information Usage
Universe Information Detail Universe Management Properties
Universe Information Summary
Universe Management Properties
Universe Usage Universe Management Usage
User Activity User Information Activity
Indicator Category Subcategory
ewboa60.book Page 134 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 135
Predefined indicators available with Auditor
User Activity per Session User Information Activity
User Information Detail User Information Security
User Information Summary User Information Security
User Profiles in the Repository
User Information Security
Users Who Logged Off Incorrectly
User Information Activity
Indicator Category Subcategory
ewboa60.book Page 135 Tuesday, August 19, 2003 10:52 AM
136 BusinessObjects Auditor Guide
Using Predefined Indicators
User Information categoryThe User Information category provides analysis of user activity, enabling you to monitor resource usage and examine security-related details. For example, you can track session duration, or view a detailed breakdown of user actions per time period.The User Information predefined indicators are divided into the following subcategories:• activity• security• top 10 & bottom 10
Business QuestionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the User Information category.
This business question... Opens this indicatorWhat is the total number of users? Number of Users in the
Repository
What are my user profiles? User Profiles in the Repository
What is my user activity by month, week, day? User Activity
Whose passwords have been deactivated? Deactivated Users
What are the most popular actions? Most Popular Actions
Who does not log out correctly? Users Who Logged Off Incorrectly
When was the last time users logged in? Last Login for User
Are my users editing reports or only refreshing them?
Refresh and Edit Activity
ewboa60.book Page 136 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 137
User Information category
ActivityAuditor provides the following predefined indicators for the Activity subcategory within the User Information category.
This indicator... Provides... Via these reportsLast Login for User
Last date and time to the second that a given user logged in to the system.
• Last Login for User
Most Popular Actions
Quantity of the most popular actions during a given time period.
• Most Popular Actions per Year
• Most Popular Actions per Quarter
• Most Popular Actions per Month
• Most Popular Actions per Week
• Most Popular Actions per Day
Number of Users in the Repository
Number of users in the repository, along with the following information about them:• how many have logged in at
least once• how many occurrences for
each user• how many users have never
logged in
• Number of Users in the Repository
• Number of Instances per User
• Active and Inactive Users
Number of User Sessions
Total number of user sessions by cluster, year, month, week, and day.
• Number of Sessions Per Month
• Number of Sessions Per Week
• Number of Sessions Per Day
ewboa60.book Page 137 Tuesday, August 19, 2003 10:52 AM
138 BusinessObjects Auditor Guide
Using Predefined Indicators
Refresh and Edit Activity
Number of edit and refresh actions per document trace, per cluster and per selected user over the whole period edited in the audit database.
• Refresh Actions per User
User Activity Number of users using the system, for each month, week, or day within a given time period.You are prompted for the start and end dates of the time period.
• User Activity per Month
• User Activity per Week
• User Activity per Day
User Activity per Session
Analyzes user activity for the whole content of the audit database per cluster, session, action and date.
N/A
Users Who Logged Off Incorrectly
Of the users who logged in during a given year:• total number of users• total number of logins• number of log off actions• number of users who logged
off incorrectly• percentage of users who
logged off incorrectly• breakdown of above
information by user
• Statistics• Users Who Logged
Off Incorrectly
This indicator... Provides... Via these reports
ewboa60.book Page 138 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 139
User Information category
SecurityAuditor provides the following predefined indicators for the Security subcategory within the User Information category.
This indicator...
Provides... Via these reports
Deactivated Users
List of deactivated users and their profiles.
• Deactivated Users• Disabled Logins• Users Not Active in Last
30 Days
User Information Detail
List of users and the groups to which they belong.For each separate membership instance, the following are shown:• user profile• user status• failed logins• user level• identification strategyThe security commands for a given user are classified by command sets.
• User Instance Status• User Instance Security
Commands
User Information Summary
Users in each user group.For each user, the following are shown:• user name• user profile• status
Users and Groups
User Profiles in the Repository
• of the total number of users in the repository, the percentage in each profile
• a list of deactivated users• total number and names of
users for each profile
• User Profiles• Deactivated Users• User Names per Profile
ewboa60.book Page 139 Tuesday, August 19, 2003 10:52 AM
140 BusinessObjects Auditor Guide
Using Predefined Indicators
Top 10 & Bottom 10Auditor provides the following predefined indicators for the Top 10 & Bottom 10 subcategory within the User Information category.
This indicator... Provides... Via these reportsMost Active Users Number of logins and
refreshes for each of the top ten users.
• Top 10 Users by Number of Logins
• Top 10 Users by Number of Refresh Actions
ewboa60.book Page 140 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 141
Document Management category
Document Management categoryThe Document Management category provides analysis of document use, as well as information about the documents themselves. For example, you can monitor the most popular and least popular documents, or find out which documents have never been read.Document Management is divided into the following subcategories:• analysis• top 10 & bottom 10• usage
Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the Document Management category.
This business question... Opens this indicatorWhat are my 10 most popular documents? 10 Most Read Documents
What are my 10 least popular documents? 10 Least Read Documents
Which documents have never been opened? Documents Never Read
What is my average document size? Document Size in Repository
How many objects are in each document? Objects Used in Documents
How many users have unread reports in their inbox?
Documents Never Read
What are the 10 most frequently exported documents?
10 Most Exported Documents
What is the average time needed for reports to refresh?
Average Refresh Time
ewboa60.book Page 141 Tuesday, August 19, 2003 10:52 AM
142 BusinessObjects Auditor Guide
Using Predefined Indicators
AnalysisAuditor provides the following predefined indicators for the Analysis subcategory within the Document Management category.
This indicator...
Provides... Via these reports
Document Information Detail
• total number of documents past and present in the repository
• alphabetical list of documents and their types.
• actions performed on a given document, classified by type of action.
• batch jobs performed per document. Overall number (and percentage) of successes and failures for each Broadcast Agent is shown.
• Document Information
• Document Usage
• Batch Usage
Document Information Summary
For each document domain:• total size in KB of all documents, by type• number and percentage of documents for
each document type• list of analytical categories, showing for
each category the creator, total size in KB and number of all documents, and the percentage of documents in each type
• document name, type, ID, and size• percentage and total size in KB of
documents held by each userFor each document owner:• total number and size of documents• a list of documents classified by type,
showing document name, domain, creation date, and size in KB
• Document Domain
• Top 10 Document Owners
ewboa60.book Page 142 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 143
Document Management category
Documents Never Read
List of documents for which there are no events “read corporate document” or “read inbox document” in the audit database.
• Documents Never Read in Corporate
• Documents Never Read in User Inbox
Document Size in Repository
total space used by all:• inbox documents• corporate documents
• Document Size in Corporate
• Document Size in User Inbox
Most Popular Actions per Document
Most popular actions taken for a given document by:• user• session• action name• date
N/A
Objects Used in Documents
• average number of objects for each type of document
• list of objects contained in each document, with the total number of objects
• 20 most and least frequently used objects for each type of document. Objects are listed in order of rank
• Average Number of Objects per Document Type
• Objects Used per Document
• 20 Most Used Objects per Document Type
• 20 Least Used Objects per Document Type
This indicator...
Provides... Via these reports
ewboa60.book Page 143 Tuesday, August 19, 2003 10:52 AM
144 BusinessObjects Auditor Guide
Using Predefined Indicators
Top 10 & Bottom 10Auditor provides the following predefined indicators for the Top 10 & Bottom 10 subcategory within the Document Management category.
This indicator...
Provides... Via these reports
10 Least Exported Documents
List of documents for which there are the least number of respective events:• download documents• send to users• get a CSV document
• 10 Least converted to CSV
• 10 Least Sent to Users
• 10 Least Downloaded
10 Least Read Documents
Number of times:• the 10 least read documents were
read• the 10 least refreshed documents
were refreshed• the 10 least edited documents
were edited
• 10 Least Read• 10 Least
Refreshed• 10 Least Edited
10 Most Exported Documents
List of documents for which there are the most respective events:• download documents• send to users• get a CSV document
• 10 Most Converted to CVS
• 10 Most Sent to Users
• 10 Most Downloaded
10 Most Read Documents
Number of times:• the 10 most read documents were
read• the 10 most refreshed documents
were refreshed• the 10 most edited documents
were edited
• 10 Most Read• 10 Most Refreshed• 10 Most Edited
ewboa60.book Page 144 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 145
Document Management category
UsageAuditor provides the following predefined indicators for the Usage subcategory within the Document Management category.
This indicator... Provides... Via these reportsAverage Refresh Time
The average refresh time per document, user, or cluster over the whole period covered in the audit database.
• Average Refresh Time per Document
• Average Refresh Time per User
• Average Refresh Time per Cluster
Document Usage Lists:• the repository documents for
which there are no events in the audit database
• the documents for which events were audited but that are no longer referenced in the repository
• the most accessed documents
• the least accessed documents
• audit actions distribution for each document
• Documents Never Accessed
• Documents Deleted from Repository
• Most Accessed Documents
• Least Accessed Documents
• Document Usage
ewboa60.book Page 145 Tuesday, August 19, 2003 10:52 AM
146 BusinessObjects Auditor Guide
Using Predefined Indicators
Universe Management categoryThe Universe Management category provides detailed analysis of universe structures, such as tables, joins, classes, and objects. This information enables you to analyze the potential impact of:• database schema modifications on universes• universe modifications on your Business Intelligence systemIn addition, universe and object hit information allows you to bill extranet users according to the repositories and objects they access.Universe Management is divided into the following subcategories:• impact analysis• properties• usage
Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the Universe Management category.
This business question... Opens this indicatorHow many universes do I have? Universe Information
Summary
How many documents do I have in each universe?
Impact Analysis
Which documents (already in use) are impacted if I modify an object?
Impact Analysis
Which joins are used in my universes? Joins by Universe
Which connections are my universes using? Universe Information Summary
Which are the most popular universes? Most Popular Universes
ewboa60.book Page 146 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 147
Universe Management category
Impact analysisAuditor provides the following predefined indicators for the Impact Analysis subcategory within the Universe Management category.
This indicator...
Provides... Via these reports
Impact Analysis
• number of documents in each universe
• number of objects in each document
• list of all the objects used in each document
• Number of Documents per Universe
• Number of Objects per Document
• Objects Used in Documents
ewboa60.book Page 147 Tuesday, August 19, 2003 10:52 AM
148 BusinessObjects Auditor Guide
Using Predefined Indicators
PropertiesAuditor provides the following predefined indicators for the Properties subcategory within the Universe Management category.
This indicator...
Provides... Via these reports
Joins per Universe
Joins for the currently selected universe. A join is a relational operation causing two or more tables with a common domain to be combined into a single table.For each join: • join ID• associated tables• join SQL string
Joins by Universe
Number of Objects per Universe
Number of objects in each universe.Filters are available for:• universe• class• object
• Universe Classes
• Universe Objects
Universe Information Detail
Prompt on the universe name. • Universe Tables
• Classes and Objects
• Conditions• Contexts• Hierarchies
ewboa60.book Page 148 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 149
Universe Management category
Universe Information Summary
• number of universes in the current domain, and in all the domains in the repository.For each universe:- domain- number of revisions- status (enabled/disabled)- time of last update- description- whether there is a filter- row restrictions- table mapping- connection name, database, and type- last action date and type- file name- creation date- first and last authors- maximum number of lines and columns- maximum query time (in seconds)
• number of times each universe was accessed, per quarter.
• for each universe, a list of documents classified by document domain. For each document:- Document name and type- Document category and size (in KB)- Creation date
• Universe Summary
• Universe Usage
This indicator...
Provides... Via these reports
ewboa60.book Page 149 Tuesday, August 19, 2003 10:52 AM
150 BusinessObjects Auditor Guide
Using Predefined Indicators
UsageAuditor provides the following predefined indicators for the Usage subcategory within the Universe Management category.
This indicator...
Provides... Via these reports
Most Popular Universes
Number of actions for each universe, by month or week, during a given year. Universes are listed in order of rank.
• Most Popular Universes per Month
• Most Popular Universes per Week
Objects Accessed
List of all objects used in the universe showing:• the documents they appeared in • the number of times the object was
accessed
• Objects Accessed per Month
• Objects Accessed per Day
Universe Usage
Universe usage since a chosen date. • Universes Never Accessed
• Universes Deleted from Repository
• Universe Usage
ewboa60.book Page 150 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 151
Broadcast Agent category
Broadcast Agent categoryThe Broadcast Agent category provides an overview of how Broadcast Agent is used, including job scheduling, success rate, and sender/receiver details. The Broadcast Agent category in Auditor is divided into the following subcategories:• global console• job information
Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the Broadcast Agent category.
Global consoleAuditor provides the following predefined indicators for the Global Console subcategory within the Broadcast Agent category.
This business question... Opens this indicatorHow many Broadcast Agents do I have? Broadcast Agents on the System
How many tasks were processed by BCA? Jobs per BCA
How many tasks are pending on BCA? Job Summary
What is the success rate of Broadcast Agent jobs?
Job Summary
This indicator... Provides... Via these reportsBroadcast Agents on the System
Correspondence between Broadcast Agents and cluster nodes, along with the duration of jobs per Broadcast Agent.
• Broadcast Agents and Cluster Node Locations
• Broadcast Agents and Duration of Jobs (sec)
ewboa60.book Page 151 Tuesday, August 19, 2003 10:52 AM
152 BusinessObjects Auditor Guide
Using Predefined Indicators
Job informationAuditor provides the following predefined indicators for the Job Information subcategory within the Broadcast Agent category.
This indicator... Provides... Via these reportsJob Success Rate
Analysis per error code, job frequency, document, and current connection of the universe on which the document is based.
• Failure Distribution• Failure per BCA Error• Failure per Frequency• Failure per Document
Job Summary Job status per Broadcast Agent. • Jobs per Status• Pending Jobs• Successful Jobs• Failed Jobs
Jobs per BCA Job status per Broadcast Agent.For each job, these details are shown: • user name• job description• job platform• priority• frequency• begin time• job status (success or failed)
• Jobs per Broadcast Agent – Summary
• Jobs per Broadcast Agent
• Jobs per Node Location
Jobs per User Breakdown of Broadcast Agent jobs according to user.
• Jobs per User – Summary
• Jobs per User• Job Duration per User
(sec)• Job Failure per User
Jobs per Frequency
Analysis of Broadcast Agent jobs by frequency.
• Frequency Distribution
• Frequency Detail
ewboa60.book Page 152 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 153
System Information category
System Information categoryThe System Information category provides analysis of trends in BusinessObjects usage. For example, you can check the number of connected users, average session duration, or the number of rows retrieved. This category is also useful for the detection of fraud.The System Information indicators are divided into the following subcategories:• security• traffic• usage
Business questionsThe category start page contains several preset business questions, taking you straight to the relevant indicator. The following table shows the questions and the indicators they open in the System Information category.
This business question... Opens this indicatorWhat is the average session duration? Average Session Duration per User
Which types of browser are being used?
Types of Browsers in Use
How many servers do I have? Cluster Nodes
How many users are on my system? Average Number of Users Concurrently Logged In
Who uses my system the most? Refresh and Edit Activity
Which IP addresses are being used to access my BI server solution and how often?
IP Addresses Accessing my Audited Clusters
How many users are accessing my system daily and when is the most popular time?
Average Number of Users Concurrently Logged In
ewboa60.book Page 153 Tuesday, August 19, 2003 10:52 AM
154 BusinessObjects Auditor Guide
Using Predefined Indicators
SecurityAuditor provides the following predefined indicators for the Security subcategory within the System Information category.
This indicator... Provides... Via these reportsIP Addresses Accessing my Audited Clusters
During a given time period:• list of the IP addresses
accessing the clusters, with the total number of addresses
• number of actions performed on each IP address
• IP Addresses Accessing my Audited Clusters per Year
• IP Addresses Accessing my Audited Clusters per Month
ewboa60.book Page 154 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 155
System Information category
TrafficAuditor provides the following predefined indicators for the Traffic subcategory within the System Information category.
This indicator...
Provides... Via these reports
Average Session Duration per Cluster
For each cluster or host machine during a given year or set of years, the average session duration (in minutes) per time period.The information is aggregated for the selected years in the Average Session Duration in Minutes over the Period report.
• Average Session Duration in Minutes over the Period
• Average Session Duration in Minutes per Week
• Average Session Duration in Minutes per Day
Average Session Duration per User
For each user during a given year, the average session duration (in minutes) per time period.
• Average Session Duration in Minutes Over the Year
• Average Session Duration in Minutes per Month per User
• Average Session Duration in Minutes per Week per User
ewboa60.book Page 155 Tuesday, August 19, 2003 10:52 AM
156 BusinessObjects Auditor Guide
Using Predefined Indicators
Average Session Duration
For any selected group of users, the average session duration per user by:• year• quarter• month• week• day• hour
N/A
Average Number of Users Concurrently Logged In
For a given month:• average number of
concurrent sessions during each hour
• names and number of users concurrently logged in during each hour
• Average Number of Concurrent Logged In Sessions
• Users Concurrently Logged In
• Average Users Concurrently Logged In
Total Users Concurrently Logged In by Day
For a given day:• total number of concurrent
sessions during each hour• names and total number of
users concurrently logged in during each hour
• Total Number of Concurrent Logged In Sessions
• Users Concurrently Logged In
This indicator...
Provides... Via these reports
ewboa60.book Page 156 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 157
System Information category
UsageAuditor provides the following predefined indicators for the Usage subcategory within the System Information category.
This indicator... Provides... Via these reportsTypes of Browsers in Use
• types of browser being used and the percentage for each one
• number of logins for each type of browser
• Types of Browser• Number of Logins per
Browser
Cluster Nodes • for each cluster, the number of nodes and the number of active modules
• for each module, the last known status and the date and time of the last update
• Servers in the Cluster• Module’s Last Known
Status
Peak Usage An aggregate for a set of selected years and the model of a "typical day" for logins, sessions, and number of actions No for a specified time period.
• User Login Peaks• Session Login Peaks• Number of Action
Peaks
ewboa60.book Page 157 Tuesday, August 19, 2003 10:52 AM
158 BusinessObjects Auditor Guide
Using Predefined Indicators
ewboa60.book Page 158 Tuesday, August 19, 2003 10:52 AM
chapter
Creating, Modifying, and Publishing Indicators
ewboa60.book Page 159 Tuesday, August 19, 2003 10:52 AM
160 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
OverviewThis chapter explains how to create, modify, and publish indicators in Auditor. In Auditor, you can modify a predefined indicator, and then save it under a new name. For monitoring and analysis that is even more finely tuned to your particular system, you can create your own, entirely new indicators.
ewboa60.book Page 160 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 161
Universes, classes, and objects
Universes, classes, and objectsKnowledge of universes is important for understanding the elements used in creating and modifying indicators. For example, it is the universe that determines the objects that are available for building a new indicator.Auditor is delivered with the following predefined universes that enable you to immediately carry out monitoring and analysis activities.
The predefined universes are attached to different domains. These domains are connected to databases during installation, prior to export of the universes.
Each universe provides an interface for different classes of database objects, permitting compatible objects to be used in building queries using the BusinessObjects Query Panel.The Query Panel is displayed in Auditor following the selection of either:• the Add a New Indicator command• the Edit option for an existing indicatorThe objects available in the selected universe are listed in the BusinessObjects Query Panel.If you are modifying an existing indicator, one or more universes are already associated with the query. If you are creating a new indicator, you can choose the universe that is associated with the query.
Universe File nameBroadcast Agent Analysis BCA.unv
Repository Analysis SECURITY.unv
Universe Domain Analysis UNIVERSE.unv
System Information ACTIVITY.unv
Universe Domain DatabaseBroadcast Agent Analysis Security Corporate repository
Repository Analysis Security Corporate repository
Universe Domain Analysis Universe Corporate repository
System Information Audit database Audit database
ewboa60.book Page 161 Tuesday, August 19, 2003 10:52 AM
162 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
Access rights for indicatorsThe options displayed for a given indicator depend on the user’s access rights in Business Objects. For example, a user can have the right to refresh an indicator but not to modify it.
For this action... You need these access rights in Business Objects...
Creating indicators Create documentsEdit documents
Modifying indicators Edit documents
Publishing indicators Publish documents
Saving indicators Save documents
Reading indicators Read corporate documents
Refreshing indicators Run and refresh
Deleting indicators Do not delete other user’s corporate documents (must be disabled)
ewboa60.book Page 162 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 163
Creating indicators
Creating indicatorsBefore you create an indicator, you must select a universe.To create a new indicator:1. In the Auditor main window, click the analytical category in which you want to
create the new indicator.The Category start page appears.
2. Click Add a New Indicator.The main window of BusinessObjects appears.The New Report wizard also is displayed if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.
3. Use the wizard to create a standard BusinessObjects document based on a universe, for example Broadcast Agent Analysis: Security.The BusinessObjects Query Panel appears, displaying the classes and objects available in the universe.
4. Build the indicator query using the universe’s classes and objects.5. Test the query by clicking Run.
The indicator you created is displayed.If you want to preserve the new indicator, you can publish or save it directly from BusinessObjects, without returning to Auditor.
ewboa60.book Page 163 Tuesday, August 19, 2003 10:52 AM
164 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
Publish to Corporate Indicators1. Save the report to the default directory:
\Business Objects\BusinessObjects Enterprise 6\UserDocs2. If you want to assign a subcategory, choose File, Properties, and enter the
subcategory name in the Keywords field.
NOTEThe field is case-sensitive.
3. On the File menu, choose Publish To, Corporate Documents.The Send dialog box appears.
4. If the report does not appear in the Documents to send area, click Browse.5. If you want to change the analytical category, click Categories.6. If you want to schedule a refresh using Auditor, click Schedule.
The Scheduling Options page appears. 7. Set the refresh frequency you want, and then click OK. 8. Click OK.
Save to Personal Indicators1. On the File menu, choose Send To, Personal Documents.
The Send Personal Document dialog box appears.2. Fill in the required information, and then click Save. 3. If you want to change the analytical category, select the category from the
Categories list.
ewboa60.book Page 164 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 165
Modifying indicators
Modifying indicatorsYou can add or remove objects, change the formatting and layout, or modify the conditions of an existing indicator.
To modify an existing indicator1. Log in to the Auditor site: http://<hostname>:<portname>/auditor2. In the Auditor main window, click the category containing the indicator you
want to modify.3. Under the name of the indicator, click the Edit option.
The BusinessObjects Query Panel opens and the indicator’s classes and objects are available.
If you want to preserve the new indicator, you can publish or save it directly from BusinessObjects, without returning to Auditor.
click Edit
ewboa60.book Page 165 Tuesday, August 19, 2003 10:52 AM
166 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
Publish to Corporate Indicators1. Save the report to the default directory:
\Business Objects\BusinessObjects Enterprise 6\UserDocs2. If you want to assign a subcategory, select File, Properties, and enter the
subcategory name in the Keywords field.
NOTEThe field is case-sensitive.
3. On the File menu, choose Publish To, Corporate Documents.The Send dialog box appears.
4. If the report does not appear in the Send Documents area, click Browse.5. If you want to change the analytical category, click Categories.6. If you want to schedule a refresh using Auditor, click Schedule.
The Scheduling Options page appears. Set the refresh frequency you want, and then click OK.
7. Click OK.
Save to Personal Indicators1. On the File menu, choose Send To, Personal Documents.
The Send Personal Document dialog box appears.2. Fill in the required information, and then click OK. 3. If you want to change the analytical category, select the category from the
Categories list.
ewboa60.book Page 166 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 167
Publishing indicators
Publishing indicatorsWhen you publish an indicator in Auditor, it is saved as a corporate indicator in a document domain in the corporate repository. This allows other users to access the same indicator.
NOTEWhen you save an indicator, it is maintained as a personal indicator. The indicator will be available only to you. (See Saving indicators in Auditor on page 170.)
The indicator is published in the analytical category and subcategory of your choice. It then appears in the list of indicators, under Corporate, for the selected category and subcategory.This section covers publishing that is performed from the list of indicators in Auditor.
ewboa60.book Page 167 Tuesday, August 19, 2003 10:52 AM
168 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
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.
ewboa60.book Page 168 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 169
Publishing indicators
7. Select the destination user group(s) for which you want to make the indicator available.
8. Click Yes or No for the Overwrite if indicator exists option:- If you select Yes, this indicator replaces any other indicator in the same document domain with the same name.- If you select No, and another indicator exists in the same document domain with the same name, Auditor prompts you to change the name of your indicator.
9. Choose a refresh option:- Refreshed manually
The indicator is refreshed only when a user refreshes it manually.- Scheduled Refresh
If you want to schedule a refresh using Auditor, choose this option.The Scheduling Options page appears.
10.Set the refresh frequency you want, and then click OK. 11.Click Publish.
Auditor publishes the indicator.
ewboa60.book Page 169 Tuesday, August 19, 2003 10:52 AM
170 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
Saving indicators in AuditorWhen you save an indicator, it is maintained as a personal indicator. Personal indicators are stored in a given user’s file in the BusinessObjects installation directory, which by default is:
Program Files\Business Objects\BusinessObjects Enterprise 6\nodes\ <hostname>\auditorData\Documents\mycluster\Storage\user\<username>
They are accessible only by the user or an administrator with rights to access the user’s files.
NOTEWhen you publish an indicator in Auditor, it is saved as a corporate indicator to a document domain in the corporate repository. This allows other users to access the same indicator. (See Publishing indicators on page 167.)
The indicator is saved in the analytical category and subcategory of your choice. It then appears in the list of indicators, under Personal, for the selected category and subcategory.This section covers saving that is performed from the list of indicators in Auditor. The saving of indicators in BusinessObjects has a different procedure; see Creating indicators on page 163.To save an indicator in Auditor:1. Select an analytical category.2. Locate the name of the indicator in the list of indicators.3. Click the arrow next to the name of the indicator to display the available
options.
ewboa60.book Page 170 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 171
Saving indicators in Auditor
4. Click the Save option.The Save as Personal Document page appears.
The name of the indicator defaults to the current indicator name, or, if it is a new indicator, to “undefined.”
5. Enter a new name for the indicator (optional).It is best to enter a new, unique name, even if you have refreshed or edited an existing indicator. This preserves the original set of predefined indicators supplied with Auditor.
6. Select the indicator’s category and subcategory.7. Click Yes or No for the Overwrite if indicator exists option.
- If you select Yes, this indicator replaces any other indicator in the same document domain with the same name.- If you select No, and another indicator exists in the same document domain with the same name, Auditor stores your indicator in the document domain with a different indicator ID, and both indicators become available.
8. Click OK.Auditor saves the indicator.
ewboa60.book Page 171 Tuesday, August 19, 2003 10:52 AM
172 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
Deleting indicatorsIf you have the required access rights, you can delete an indicator.To delete an indicator:1. In the Auditor main window, click the analytical category containing the
indicator you want to delete.2. Under the name of the indicator, click Delete.
A confirmation message appears.3. Click OK.
REMINDERYou can delete any of the predefined indicators if you have been granted the necessary access rights in Supervisor. However, if you delete a predefined indicator by mistake, and have no backup (for example, in your personal documents area), you must reexport the document using Document Exporter. For more information see Exporting predefined indicators on page 49.
ewboa60.book Page 172 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 173
Exercise: Creating a new indicator
Exercise: Creating a new indicatorIn the following procedure, we create an indicator that displays the users who accessed documents on a particular day.To create the indicator:1. In the Auditor main window, select the User Information category.
2. Click Add a New Indicator.
BusinessObjects opens. The New Report wizard also opens if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.
3. Using the New Report wizard, select:- Generate a Standard Report- Universe- System Information: Audit universe
4. Click Finish.The BusinessObjects Query Panel appears.
5. Drag the following objects to the Result Objects pane:- Action YYYY-MM-DD (Actions folder, Action Time subfolder)- User Name (Actions folder)- Document Name & Type (Actions folder, Action Details subfolder, Document subfolder)
6. Right-click the Action YYYY-MM-DD object, and point to Apply Simple Condition.
7. From the list of values, select the day for which you want to run the report.8. Click Run.
The new report appears in BusinessObjects.9. Name the report “Usage for a Day,” and add any formatting changes you
want.
ewboa60.book Page 173 Tuesday, August 19, 2003 10:52 AM
174 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
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.
ewboa60.book Page 174 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 175
Exercise: Creating a new indicator
15.Click the User Information category, and then verify that the newly-published indicator appears under Corporate indicators. If it does not appear, refresh the list.
16.View and test the new indicator.
click the Refresh icon if the newly-published indicator does not appear
ewboa60.book Page 175 Tuesday, August 19, 2003 10:52 AM
176 BusinessObjects Auditor Guide
Creating, Modifying, and Publishing Indicators
ewboa60.book Page 176 Tuesday, August 19, 2003 10:52 AM
chapter
Using Auditor to Solve Business Problems
ewboa60.book Page 177 Tuesday, August 19, 2003 10:52 AM
178 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
OverviewThis chapter focuses on specific applications of Auditor. These applications simulate many of the situations faced by users of the product.For each situation, the discussion includes one or more of the following ways to solve the problem:• use an existing indicator• modify an existing indicator• create a new indicator• select a business questionIt is assumed that you already know how to use Auditor, as explained in the previous chapters of this guide.
ewboa60.book Page 178 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 179
Business questionsEach category start page contains several preset business questions, taking you straight to the relevant indicator. This helps you to quickly find the information you are looking for. When you click a question, the first report of the associated indicator appears. If there are business questions relevant to the subject being discussed, they are listed at the end of the section.The following table shows all the business questions and the indicators they open.
Category Business question IndicatorUser Information
What is the total number of users? Number of Users in the Repository
What are my user profiles? User Profiles in the Repository
What is my user activity by month, week, day?
User Activity
Whose passwords have been deactivated?
Deactivated Users
What are the most popular actions? Most Popular Actions
Who does not log out correctly? Users Who Logged Off Incorrectly
When was the last time users logged in?
Last Login for User
Are my users editing reports or only refreshing them?
Refresh and Edit Activity
Document Management
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
ewboa60.book Page 179 Tuesday, August 19, 2003 10:52 AM
180 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
How many objects are in each document?
Objects Used in Documents
How many users have unread reports in their inbox?
Documents Never Read
What are the 10 most frequently exported documents?
10 Most Exported Documents
What is the average time needed for reports to refresh?
Average Refresh Time
Universe Management
How many universes do I have? Universe Information Summary
How many documents do I have in each universe?
Impact Analysis
Which documents (already in use) are impacted if I modify an object?
Impact Analysis
Which joins are used in my universes?
Joins by Universe
Which connections are my universes using?
Universe Information Summary
Which are the most popular universes?
Most Popular Universes
Broadcast Agent
How many Broadcast Agents do I have?
Broadcast Agents on the System
How many tasks were processed by Broadcast Agent?
Jobs per Broadcast Agent
How many tasks are pending on Broadcast Agent?
Job Summary
What is the success rate of Broadcast Agent jobs?
Job Summary
System Information
What is the average session duration?
Average Session Duration per User
Which types of browser are being used?
Types of Browsers in Use
Category Business question Indicator
ewboa60.book Page 180 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 181
How many servers do I have? Cluster Nodes
How many users are on my system? Average Number of Users Concurrently Logged In
Who uses my system the most? Refresh and Edit Activity
Which IP addresses are being used to access my BI server solution and how often?
IP Addresses Accessing my Audited Clusters
How many users are accessing my system daily and when is the most popular time?
Average Number of Users Concurrently Logged In
Category Business question Indicator
ewboa60.book Page 181 Tuesday, August 19, 2003 10:52 AM
182 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
Creating a business questionYou can also create your own business questions:1. Open the file BusinessQuestionsEN.txt, located in the folder in which the
Auditor .war files were deployed. For example, for the Tomcat application server, the BusinessQuestionsEN.txt file should be located in: $TOMCATINSTALLDIR\webapps\auditor
2. Find the section for the category in which you want the question to appear. 3. After the last indicator in the list (in the example above Average Number of
Users Concurrently Logged In), add the following lines:BQNumber=<number of last BQNumber + 1>BQuestions<number of last question + 1>=<name of new question>IndName<number of last question + 1>=<name of indicator opened by the question>ReportName<number of last question + 1>=<name of report opened by the question>
4. Save and close the BusinessQuestionsEN.txt file.
NOTETo delete a business question, delete the three lines mentioned in Step 3.
ewboa60.book Page 182 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 183
How do I monitor the use of Business Objects products?
How do I monitor the use of Business Objects products?
In Auditor, you can use certain objects to determine which Business Objects products and versions are being used.You can use this kind of information for building a profile of your customer base, and for monitoring user preferences. Then, you can better allocate resources to the products that are most heavily used, and more efficiently balance the load on your servers.To monitor the products in use, create a new indicator:1. In Auditor click the System Information category.
2. Click the Add a New Indicator command.
BusinessObjects opens.The New Report wizard also opens if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.
3. Using the New Report wizard, select:- Generate a standard report- Universe- System Information: Audit universe
4. Click Finish.The BusinessObjects Query Panel appears.
ewboa60.book Page 183 Tuesday, August 19, 2003 10:52 AM
184 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
5. Drag the Action App object (Actions folder) to the Result Objects pane.
6. Click Run.
ewboa60.book Page 184 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 185
How do I monitor the use of Business Objects products?
The new indicator appears in BusinessObjects.
The indicator displays the products in use. By adding extra dimensions, you can generate more detailed usage statistics.
ewboa60.book Page 185 Tuesday, August 19, 2003 10:52 AM
186 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
How do I track Broadcast Agent usage?Auditor provides a number of predefined indicators associated with Broadcast Agent, including job scheduling and success rate information. For example, you can find out the number of successful jobs, or obtain a list of submitted documents.The following predefined indicators are available:• Broadcast Agents on the System• Jobs per Broadcast Agent• Jobs per User• Job SummaryUsing this information, you can troubleshoot Broadcast Agent errors, analyze usage patterns, and then use the Administration Console to balance the allocation of system resources accordingly.
Business questionsThe following business questions are designed to help you track Broadcast Agent usage.
This business question... In this category... Opens this indicator...How many Broadcast Agents do I have?
Broadcast Agent Broadcast Agents on the System
How many tasks were processed by Broadcast Agent?
Broadcast Agent Jobs per Broadcast Agent
How many tasks are pending on Broadcast Agent?
Broadcast Agent Job Summary
What is the success rate of Broadcast Agent jobs?
Broadcast Agent Job Summary
ewboa60.book Page 186 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 187
How do I find out which machines are accessing my system?
How do I find out which machines are accessing my system?
Through the use of the predefined indicator IP Addresses Accessing my Audited Clusters in the System Information category, Auditor allows you to view:• IP addresses of successfully logged-in clients• number of logins per IP address during a given reporting periodBecause the IP address is linked to the client machine rather than to the actual user, this information can be used to monitor the various machines—and the number of users logged in to those machines—within a given reporting period.To find out which machines are being used:1. In Auditor click the System Information category.2. Click the IP Addresses Accessing My Audited Clusters indicator.3. Click the Refresh option under the name of the indicator.
A date selection box appears.4. Enter or browse for the year or years that you want. Hold down the CTRL key,
to select multiple years.5. Click Run Query.
Auditor runs the query and displays the following report.
Business questionsThe following preset business questions are designed to help you find out which machines are being used to access your system.
This business question... In this category... Opens this indicator...Which IP addresses are being used to access my BI server solution and how often?
System Information IP Addresses Accessing my Audited Clusters
ewboa60.book Page 187 Tuesday, August 19, 2003 10:52 AM
188 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
Can I detect fraud with Auditor?Yes, Auditor is an efficient tool for detecting fraud.Because you can use Auditor to monitor both the client IP address and the user login name, you can determine whether two physical users are using the same login name. If you are charging extranet users by login name, this allows you to identify breaches of extranet user contract.One way to do this is to modify the IP Addresses Accessing my Audited Clusters indicator (see previous section) by adding the User Name object to the table.To modify the IP Addresses Accessing my Audited Clusters indicator:1. In Auditor click the System Information category.2. Click the Edit option for the IP Addresses Accessing my Audited Clusters
indicator.The report appears in BusinessObjects.
3. Open the Query Panel.4. From the Actions folder, drag the User Name object to the Result Objects
pane, and drop it into the last position.5. Rerun the indicator.
In the report detail above, you can see that a single user name is being accessed from different IP addresses.
Business questionsThe following preset business questions are designed to help you detect fraud.
This business question... In this category... Opens this indicator...Whose passwords have been deactivated?
User Information Deactivated Users
Who does not log out correctly? User Information Users Who Logged Off Incorrectly
Which IP addresses are being used to access my BI server solution and how often?
System Information
IP Addresses Accessing my Audited Clusters
ewboa60.book Page 188 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 189
How do I monitor login information?
How do I monitor login information?The predefined indicators in the System Information category provide user login information that enables you to leverage optimal performance from your deployment. This includes:• the number of users who are concurrently logged on during the various hours
of a particular day, using the Total Users Concurrently Logged in by Day indicator
• the average length of time for which users are logged in, using the Average Session Duration indicator
Monitoring the daily number of logged-in usersTo see the number of concurrent logged-in users:1. In Auditor click the System Information category.2. Click the Refresh option for the Total Users Concurrently Logged in by Day
indicator.A date selection box appears.
3. Enter or browse for the day or days that you want. Select multiple days by holding down the CTRL key.
4. With the Total Number of Concurrent Log on Sessions report tab selected, click Run Query.
ewboa60.book Page 189 Tuesday, August 19, 2003 10:52 AM
190 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
Monitoring the average duration of user sessionsThe Average Session Duration per User and the Average Session Duration per Cluster indicators enable you to monitor the average length of time that users are logged on to the system.The Average Session Duration per Host indicator provides an additional piece of important information. Each time a user logs on, a WIQT instance is launched. By default, the WIQT stays in memory for one minute after the last user activity. You can set the time-out in the Administration Console.To monitor the average session duration:1. In Auditor click the System Information category.2. Select the Traffic subcategory.3. Click the Refresh option for the Average Session Duration per User indicator.
A date selection box appears.4. Select the year you want.5. Click Run Query.
Verify that the Average Session Duration in Minutes Over the Year report tab is selected.
6. Click the other report tabs to see more detailed information.
Business questionsThe following preset business questions are designed to help you monitor login information.
This business question... In this category... Opens this indicator...Who does not log out correctly?
User Information Users Who Logged Off Incorrectly
When was the last time users logged in?
User Information Last Login for Users
What is the average session duration?
System Information
Average Session Duration per User
How many users are on my system?
System Information
Average Number of Users Concurrently Logged In
ewboa60.book Page 190 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 191
How do I monitor the load on my server?
How do I monitor the load on my server?Auditor can display user activity; that is, the number of actions performed by users within a specified period. The Peak Usage indicator provides this information.The number of actions performed differs from the number of users logged in. For example, out of the users who are currently logged in, it is possible that no more than 15% of them are simultaneously performing actions.To monitor the number of actions:1. In Auditor click the System Information category.2. Select the Usage subcategory.3. Click the Refresh option for the Peak Usage indicator, then select the year
you want.4. Click the Number of Action Peaks tab.5. Click Run Query.
This shows you the peak usage times per hour over the course of the year.
Business questionsThe following preset business questions are designed to help you monitor the load on your server.
This business question... In this category... Opens this indicator...What are the most popular actions?
User Information Most Popular Actions
What is the average time needed for reports to refresh?
Document Management
Average Refresh Time
ewboa60.book Page 191 Tuesday, August 19, 2003 10:52 AM
192 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
How do I track the most requested documents?You can monitor the documents that users are downloading most frequently from Business Objects. Because the predefined indicators differentiate between BusinessObjects documents (*.rep), WebIntelligence 2.x documents (*.wqy), WebIntelligence 6.1 documents (*.wid) and third-party documents, you can see a separate summary for each document type.
Most frequently exported documentsTo monitor the most frequently exported documents:1. In Auditor click the Document Management category.2. Select the Top 10 & Bottom 10 subcategory.3. Click the Refresh option for the 10 Most Exported Documents indicator.4. Click the 10 Most Exported report tab.
Most popular documents loaded into a spreadsheetThe 10 Most Converted to Excel report (10 Most Exported Documents indicator) enables you to monitor the 10 CSV (comma-separated value) documents that users exported most frequently, during a given reporting period. Usually, the most common type of CSV format accessed in Auditor is Microsoft Excel.To monitor the most popular CSV documents:1. In Auditor click the Document Management category.2. Select the Top 10 & Bottom 10 subcategory.3. Click the Refresh option for the 10 Most Exported Documents indicator.4. Verify that the 10 Most Converted to Excel report tab is selected.
Business questionsThe following preset business questions are designed to help you track the most requested documents.
This business question... In this category... Opens this indicator...What are my 10 most popular documents?
Document Management
10 Most Read Documents
What are the 10 most frequently exported documents?
Document Management
10 Most Exported Documents
ewboa60.book Page 192 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 193
How do I track the least/most popular documents?
How do I track the least/most popular documents?
You can use the 10 Least Read Documents indicator to find the ten documents (of any type) for which there have been the least number of actions by selected users within a given period. The information is broken down into the following reports:• 10 Least Read• 10 Least Refreshed• 10 Least EditedThe 10 Least Read Documents indicator provides you with a simple way of identifying outdated or redundant documents. You can then archive these documents, thereby freeing space and speeding up the user navigation process.Similarly, the 10 Most Read Documents indicator shows the ten documents for which there have been the most number of actions by selected users within a given period. The information is broken down into the following reports:• 10 Most Read• 10 Most Refreshed• 10 Most EditedTo track the least read documents:1. In Auditor click the Document Management category.2. Select the Top 10 & Bottom 10 subcategory.3. Click the Refresh option for the 10 Least Read Documents indicators.4. Verify that the 10 Least Read tab is selected.5. Click Run Query.
ewboa60.book Page 193 Tuesday, August 19, 2003 10:52 AM
194 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
Business questionsThe following preset business questions are designed to help you track the least/most popular documents.
This business question... In this category... Opens this indicator...What are my 10 most popular documents?
Document Management
10 Most Read Documents
What are my 10 least popular documents?
Document Management
10 Least Read Documents
Which documents have never been opened?
Document Management
Documents Never Read
How many users have unread documents in their inbox?
Document Management
Documents Never Read
What are the 10 most frequently exported documents?
Document Management
10 Most Exported Documents
ewboa60.book Page 194 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 195
How do I monitor universe hits?
How do I monitor universe hits?The Most Popular Universes indicator enables you to determine which universes have received the most actions. Then, by creating a similar indicator, you can determine which types of action are being generated.To see the most popular universes:1. In Auditor click the Universe Management category.2. Select the Usage subcategory.3. Click the Refresh option for the Most Popular Universes indicator, and then
select the year.4. Make sure the Most Popular Universes by Month report tab is selected.You can now create a separate indicator for individual universes, to show a detailed breakdown of actions. As an example, we will create an indicator to measure activity in a given universe:1. In Auditor click the Universe Management category.2. Click the Add a New Indicator command.
The main window of BusinessObjects appears.The New Report wizard also is displayed, if the Run this Wizard at Startup option was selected on the first window of the wizard. If the wizard does not appear, open it by selecting File, New.
3. Using the New Report wizard, select:- Generate a Standard Report- Universe- System Information universe
4. Click Finish.The BusinessObjects Query Panel appears.
ewboa60.book Page 195 Tuesday, August 19, 2003 10:52 AM
196 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
5. Drag the following objects to the Result Objects pane:- Universe Name (Action Details subfolder). Create a condition to be equal to a universe that you want to monitor.- Action YYYY-MM (Action Time folder). Create a prompt for month.- Action Name (Actions folder)- Document Name & Type (Action Details subfolder)- Number of Actions (a measure from the Action Measures folder).- Repository Name (Action Details subfolder). Create a condition to be equal to the constant <name of your domain>.
6. Save and close the Query Panel.7. In the Slice and Dice Panel, bring the Universe Name and Action YYYY-MM
objects into the Section frame.8. Run the indicator.9. Give the indicator a name, such as “Repository Action Analysis.” 10.Make any formatting changes you want.11.Publish the new indicator. 12.Make note of where you publish it because you will need to use it in the next
example.
Business questionsThe following preset business questions are designed to help you monitor universe hits.
This business question... In this category... Opens this indicator...Which are the most popular universes?
Universe Management
Most Popular Universes
ewboa60.book Page 196 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 197
How do I use Auditor for billing?
How do I use Auditor for billing?You can use the indicators in Auditor to help you bill users of your extranet. The types of actions for which you bill depend, of course, on your particular business requirements. However, the universes, objects, and indicators provided by Auditor enable you to set up a wide variety of billing scenarios.For example, you want to charge extranet users $10 per document refresh within the eFashion universe. You can use the indicator in the previous section, Repository Analysis Actions, as a base, section it by user, and limit it to refresh actions only.To create the new report:1. Access the Repository Action Analysis indicator that you created and
published in the previous section.2. Click the Edit option for the indicator.
The indicator appears in BusinessObjects.3. Open the Query Panel, and then do the following:
- Bring in the Action Type object, Actions folder. Create a condition to be equal to the constant “Document Name.”- Bring in the User Name object, Actions folder.- For the Action Name object, already in the Query Panel, create a condition to be equal to the constant “Refresh Document.”
4. Run the indicator.5. Give the indicator a name, such as “Broadcast Agent Refresh Billing.” 6. Make any formatting changes you want.7. Publish the indicator under a new name.
Business questionsThe following preset business questions are designed to help you use Auditor for billing.
This business question... In this category... Opens this indicator...How many users are accessing my system daily and when is the most popular time?
System Information
Average Number of Users Concurrently Logged In
Who uses my system the most? System Information
Refresh and Edit Activity
ewboa60.book Page 197 Tuesday, August 19, 2003 10:52 AM
198 BusinessObjects Auditor Guide
Using Auditor to Solve Business Problems
How do I perform impact analysis?The following predefined indicators help you determine the impact of changes made to your data model:• impact Analysis• number of Objects per Document• objects Used in DocumentsThis information enables you to efficiently plan modifications and avoid lengthy investigations into system malfunctions. Examples of these modifications are changing an object name or deleting a universe.
NOTEOnly documents that have already been used appear in these reports.
To access the Impact Analysis group of reports:1. In Auditor click the Universe Management category.2. Click the Refresh option for the Impact Analysis indicator.
Business questionsThe following preset business questions are designed to help you perform impact analysis.
This business question... In this category... Opens this indicator...How many objects are in each document?
Document Management
Objects Used in Documents
How many documents do I have in each universe?
Universe Management
Impact Analysis
Which documents (already in use) are impacted if I modify an object?
Universe Management
Impact Analysis
ewboa60.book Page 198 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 199
Index
IndexSymbols10 least accessed documents 14410 least exported documents 14410 least read documents 19310 most accessed documents 14410 most exported documents 144, 19210 most read documents 193
Aaccess rights for indicators 162action app id object 109action app object 109action day (with label) object 122action day object 120action DD/MM (with label) object 122action details subclass 111-116
administration SDK subclass 112-114browser information subclass 114document subclass 115page information subclass 116
action duration object 117action error id object 109action HHMISS object 120action host object 109action hour (with label) object 122action hour am/pm object 120action hour object 120action id object 109action measures subclass 117-118
incompatibilities 127action minutes (with label) object 122action minutes object 120action MM/DD (with label) object 122action month (with label) object 122action month name (with label) object 122action month name object 120action month object 120action name id object 109
action name object 109action quarter (with label) object 122action quarter object 120action seconds (with label) object 122action seconds object 120action time frame (with label) subclass 122action time object 109action time subclass 120-121
incompatibilities 127action type detail (with label) object 109action type detail object 109action type object 109action week (with label) object 122action week object 120action year (with label) object 122action YYYY object 120action YYYY-MM object 120action YYYY-MM-DD HHMISS object 120action YYYY-MM-DD object 120actions class 109-122
action details subclass 111-116action measures subclass 117-118action time frame (with label) subclass 122action time subclass 120-121averages subclass 119
actions subclass 79actions type object 79activity subcategory 137
last login for user 137most popular actions 137number of user sessions 137number of users in the repository 137refresh and edit activity 138user activity 138user activity per session 138users who logged off incorrectly 138
activity.unv 161administration SDK subclass 112-114
ewboa60.book Page 199 Tuesday, August 19, 2003 10:52 AM
200 BusinessObjects Auditor Guide
Index
advanced subclass 103incompatibilities 108
alias (y or n) object 105alias information subclass 105alias table id object 105
incompatibilities 108analysis subcategory 142-143
document information detail 142document information summary 142document size in repository 143documents never read 143objects used in documents 143
analytical categoriesBroadcast Agent analysis 74description 20repository analysis 74system information universe 74universe domain analysis 74
assigned user groups 44audit BCA measures class 88
incompatibilities 89audit database
connecting 44setting up 32
audit database domain 161audit facility
database mode 22description 22file mode 22
audit tab 43Auditor
components 20-21monitoring multiple clusters 57removing 59-62uses 19
Auditor filesuninstalling 62
average duration object 86average number of users concurrently logged in
156average refresh time 145average session duration 156average session duration per cluster 155, 190average session duration per user 155, 190
averages subclass 119incompatibilities 127, 128
avg action duration (sec) object 119avg actions per day object 119
incompatibilities 127avg actions per hour object 119
incompatibilities 127avg actions per month object 119
incompatibilities 127avg document size object 119
incompatibilities 127avg rows retrieved object 119
incompatibilities 127avg session duration (hour) object 119avg session duration (min) object 124
incompatibilities 127avg session duration (month) object 119avg session duration (sec) object 124
incompatibilities 127, 128avg session duration (week) object 119avg users per day object 119
incompatibilities 127, 128avg users per hour object 119
incompatibilities 127, 128avg users per month object 119
incompatibilities 127
Bbatch id object 78batch information class 78-81
actions subclass 79monitoring job information subclass 81scheduling information subclass 80
BCA & BO server names object 76BCA id object 76BCA information class 76-77BCA name (label) object 76BCA name object 76BCA server name object 77BCA status object 77bca.unv 161begin date object 87begin date time frame subclass 87begin time object 80
ewboa60.book Page 200 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 201
Index
billing reportsbusiness questions 197creating 197
BO server name (with label) object 77BO server name object 77BO version of the submitter object 84Broadcast Agent
tracking usage 186Broadcast Agent analysis
analytical categories 74audit BCA measures class 88batch information class 78-81BCA information class 76-77bca.unv 161document information class 82-83domain 75incompatibilities 89predefined universes 75recipient information class 85submitter information class 84time frame class 86-87universe 76-89
Broadcast Agent analysis universe 161Broadcast Agent category 151-152
business questions 151, 186global console subcategory 151job information subcategory 152
Broadcast Agent usagebusiness questions 186
Broadcast Agents on the system 151browser information subclass 114browser type object 114Business Objects
consulting services 11, 13documentation 10Documentation Supply Store 9monitoring use of products 183-185support services 11training services 11, 13
business questionsall 179-181Broadcast Agent category 151, 186Broadcast Agent usage 186creating 182creating reports for billing 197
detecting fraud 188document management category 141impact analysis 198information category 136least/most popular documents 194monitoring login information 190monitoring machine access 187monitoring server load 191monitoring universe usage 196monitoring user activity 191most requested documents 192system information category 153universe management category 146
BusinessObjects functionality object 92BusinessQuery functionality object 92
Ccategory
Broadcast Agent 151-152description 20document management 141-143system information 153-157universe management 146-150user information 136-140
category creator object 82, 93category name object 82, 93category path object 82, 93change list display and default home page
command set 67change password command set 67change viewing and editing technology options
command set 67class
actions 109-122audit BCA measures 88, 89batch information 78-81BCA information 76-77class details 102, 108condition details 104, 108connection 99, 100contexts 106, 108document information 82-83documents 93-96, 100hierarchies 107, 108joins 106, 108
ewboa60.book Page 201 Tuesday, August 19, 2003 10:52 AM
202 BusinessObjects Auditor Guide
Index
object details 103, 108recipient information 85session analysis (actions) 123-125site log info 126submitter information 84time frame 86-87universe 98, 100universe parameters 101-102universe tables 105, 108user 90-92
class description object 102incompatibilities 108
class details class 102incompatibilities 108
class hidden object 102class id object 102class name (with label) object 102class name object 102client ip object 114client os object 114cluster id object 109, 123, 126cluster monitoring 57cluster name object 109, 123, 126cluster nodes 157command set
change list display and default home page 67change password 67change viewing and editing technology options
67create indicators 68definition 65edit indicators 68formatting toolbar 68refresh lists of values 68run and refresh documents 69use list of values 69view SQL 69
command set familydocument 66options 67query and report panel 68
condition description object 104condition details class 104
incompatibilities 108condition hidden object 104
condition id object 104condition name object 104
incompatibilities 108condition position object 104condition table name(s) object 104condition WHERE clause object 104connection class 99
incompatibilities 100connection name object 99
incompatibilities 100connection RDBMS object 99
incompatibilities 100connection type object 99
incompatibilities 100consultants
Business Objects 11context id object 106
incompatibilities 108context join id object 106context join sql object 106context join table 1 name object 106context join table 2 name object 106context name object 106contexts class 106
incompatibilities 108corporate indicators
publishing to 164count BCA jobs object 88, 89count job expired object 88, 89count job failed object 88, 89count job running object 88count job success object 88, 89count job suspended object 88, 89count job waiting object 88, 89count object 117count recipients object 85create indicators command set 68creating
billing reports 197business questions 182database views 48indicators 163-164
creation date object 101customer support 11custom-made universes 75
ewboa60.book Page 202 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 203
Index
Ddata object 79data provider name object 96data provider source object 96data providers subclass 96
incompatibilities 100database mode 22database views
creating manually 48removing 60
date format 76days of the month object 80days of the week object 80deactivated users 139deleting
indicators 172universes 59
demo materials 9Designer functionality object 92Designer user
setting privileges 35destination universe domain 44detail objects 73detecting fraud 188Developer Suite 10, 12dimensions 73distribution path object 85distribution system object 85document age (hour) object 93document age (min) object 93document age (sec) object 93document category object 82, 93, 115document command set
publish document 66read corporate documents 66save document 66
document creation date object 93document description object 115document domain creation date object 95document domain creator object 95document domain object 93, 95document domain subclass 95
Document Exporteraccessing in UNIX 49exporting documents 50-51removing documents with 61-62
document id object 82, 93, 115document information class 82-83document information detail 142document information summary 142document management category 141-143
analysis subcategory 142-143business questions 141properties subcategory 148-149top 10 & bottom 10 subcategory 144usage subcategory 145
document name & type object 82, 94document name (with label) object 115document name and type object 115document name object 82, 93document persistent object 82, 94document popularity tracking 192, 194document repository id object 82document repository name object 82document size in repository 143document size object 82, 94, 117document subclass 115document type (picture) object 83, 94document type object 82, 94, 115, 116document usage 145documentation
CD 9feedback on 10on the web 9printed, ordering 9roadmap 9search 9
Documentation Supply Store 9documents
removing 61-62tracking least/most popular 193-194tracking most requested 192
ewboa60.book Page 203 Tuesday, August 19, 2003 10:52 AM
204 BusinessObjects Auditor Guide
Index
documents class 93-96data provider subclass 96document domain subclass 95incompatibilities 100received by subclass 96universe domain subclass 97
documents never read 143domains
audit database 161predefined universes 75, 161security 161universe 161
duration object 96
Eedit indicators command set 68education see trainingend date object 87end date time frame subclass 87end user process id object 78expiration date object 87expiration date time frame subclass 87export tab 44-45exporting
documents 50-51documents manually 52-56predefined indicators 49-56universes 36-47universes manually 47using Document Exporter 50-51
Ffailed logins object 90feedback
on documentation 10file mode 22file name object 98
incompatibilities 100filename (with label) object 101filename object 101first author object 101formatting toolbar command set 68
fraud detection 188business questions 188
frequency object 80
Gglobal console subcategory 151
Broadcast Agents on the system 151group name (administration) object 112group name object 77, 90group recipient name object 85group submit name (with label) object 84group submit name object 84
Hhidden object object 103hierarchies class 107
incompatibilities 108number of objects in hierarchies subclass 107
hierarchy id object 107hierarchy name (with label) object 107hierarchy name object 107hierarchy position in universe object 107
Iidentification strategy object 90impact analysis 147, 198
business questions 198impact analysis subcategory
impact analysis 147predefined indicators 147
incompatibilitiesaction measures subclass 127action time subclass 127advanced subclass 108alias table id object 108audit BCA measures class 89averages subclass 127, 128avg actions per day object 127avg actions per hour object 127avg actions per month object 127avg document size object 127avg rows retrieved object 127avg session duration (min) object 127avg session duration (sec) object 127, 128
ewboa60.book Page 204 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 205
Index
avg users per day object 127, 128avg users per hour object 127, 128avg users per month object 127Broadcast Agent analysis 89class description object 108class details class 108condition details class 108condition name object 108connection class 100connection name object 100connection RDBMS object 100connection type object 100context id object 108contexts class 108data providers subclass 100documents class 100file name object 100hierarchies class 108joins class 108last action date object 100last action type object 100number of log offs object 127number of session users object 127, 128number of sessions object 127, 128object details class 108object position object 108object security access level object 108repository analysis 100session duration (min) object 127, 128session duration (sec) object 127, 128session measures subclass 127, 128status object 100system information universe 127table name (with label) object 108table/alias name object 108universe class 100universe domain 100universe domain analysis 108universe name object 100universe tables class 108
incompatible table object 103, 104
indicatorsaccess rights 162creating 163-164deleting 172description 20exporting 50-51list of all 133-135modifying 165-166predefined
exporting 49-56exporting manually 52-56
publishing 167-169publishing to corporate 164restoring 58saving 170-171saving as personal 164
inheritance rights object 90interface impact
document command sets 66options command sets 67query panel command sets 68report panel command sets 68
ip addresses accessing my audited clusters 154, 187, 188
Jjob description object 78job duration max object 86job duration min object 86job duration object 86job error code object 81job error warning or text object 81job information subcategory 152
job success rate 152job summary 152jobs per BCA 152jobs per frequency 152jobs per user 152
job platform object 78job state object 81job status object 81job success rate 152job summary 152jobs per BCA 152jobs per frequency 152
ewboa60.book Page 205 Tuesday, August 19, 2003 10:52 AM
206 BusinessObjects Auditor Guide
Index
jobs per user 152join id object 106join sql object 106joins class 106
incompatibilities 108joins per universe 148
Kkeyword object 115Knowledge Base 12
Llast action date object
connection class 99document class 94document domain subclass 95document information class 83incompatibilities 100universe domain subclass 97user class 90
last action object 83last action start time object 121last action type object
connection class 99document class 94document domain subclass 95document information class 83incompatibilities 100universe domain subclass 97user class 90
last author object 101last login for user 137last modify date object 101last refresh date object 96last update time object 98linked universe id object 101linked universe name object 101log files 22log host object 126log id object 126log info object 126log level object 126log module object 126log PID object 126
log time object 126login information
business questions 190monitoring 189-190
login usersmonitoring daily amount 189
Mmax number of columns object 101max number of lines object 101max query time object 101measures 73modifying indicators 165-166monitoring
average duration of user sessions 190daily amount of login users 189login information 189-190
business questions 190machine access business questions 187machines accessing the system 187multiple clusters 57server load 191universe usage 195-196use of Business Objects projects 183-185user activity 191
monitoring job information subclass 81most active users 140most popular actions 137most popular actions per document 143most popular universes 150, 195multimedia quick tours 10multiple cluster monitoring 57
Nnumber of action details object 117number of actions object 117number of classes object 102number of conditions object 104number of contexts object 106number of documents object 83number of documents used object 117number of elements object 111number of hierarchies object 107number of joins object 106
ewboa60.book Page 206 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 207
Index
number of linked universes object 101number of log offs object 117
incompatibilities 127number of logins object 117number of object instances object 107number of objects in hierarchies subclass 107number of objects object 103, 107number of objects per universe 148number of rows object 96, 111number of rows retrieved object 117number of session users object 124
incompatibilities 127, 128number of sessions object 117, 124
incompatibilities 127, 128number of tables object 105number of universes object 102number of user sessions 137number of users in the repository 137number of users object 117
Oobject description object 103object details class 103
advanced subclass 103incompatibilities 108
object id object 103object name (with label) object 103, 111object name in hierarchy object 107object name object 103, 111object position in hierarchy object 107object position object 103
incompatibilities 108object properties object 103object security access level object 103
incompatibilities 108object security level object 112object table name(s) object 103object type object 103objects assessed 150objects filter object 98objects used in documents 143Online Customer Support 11options command set family 67
original database table name object 105overwrite mode object 78overwrite object 115owner/sender object 94
Ppage information subclass 116page range object 116parameters for export of universes 44parent group name (administrator) 112partial indicator object 96particular conditions object 79password can change object 112password checking object 112password limited validity object 113password must change object 113password object 112password periodic validity object 113password status object 113password validity period object 114peak usage 157, 191periodicity detail object 80periodicity object 80personal indicators
saving as 164predefined indicators
activity subcategory 137analysis subcategory
document management category 142-143description 20exporting 49-56exporting manually 52-56global console subcategory
Broadcast Agent category 151impact analysis subcategory 147job information subcategory
Broadcast Agent category 152list of all 133-135properties subcategory
document management category 148-149restoring 58security subcategory
system information category 154user information category 139
ewboa60.book Page 207 Tuesday, August 19, 2003 10:52 AM
208 BusinessObjects Auditor Guide
Index
top 10 & bottom 10user information category 140
top 10 & bottom 10 subcategorydocument management category 144
traffic subcategorysystem information category 155-156
usage subcategorydocument management category 145system information category 157universe management category 150
predefined universes 75, 161activity.unv 161bca.unv 161description 21domains 75, 161security.unv 161universe.unv 161
priority (picture) object 78priority object 78privileges for Auditor-dedicated Designer user 35profile name object 114properties subcategory 148-149
joins per universe 148number of objects per universe 148universe information detail 148universe information summary 149
publish document command set 66publishing
indicators 167-169to corporate indicators 164
Qquery and report panel command set family 68
Rread corporate documents command set 66received by subclass 96recipient function object 96recipient information class 85recipient name (with label) object 96recipient name object 85, 96recipient status object 85recipient user type object 85refresh and edit activity 138
refresh lists of values command set 68refresh options object 115removing
Auditor 59-62database views 60documents 61-62
report bursting feature object 79report name object 116reports for billing purposes 197repository action analysis 197repository analysis
analytical categories 74connection class 99documents class 93-96domain 75incompatibilities 100predefined universes 75security.unv 161universe 90-100universe class 98user class 90-92
repository analysis universe 161repository name object 111resource object 90resource status object 91restoring predefined indicators 58row restriction object 98run and refresh documents command set 69
Ssave document command set 66saving
as personal indicators 164indicators 170-171
scheduling information subclass 80script options object 79search documentation 9security commands subclass 92security configuration object 92security domain 161security domain connection 44security family object 92security functionality object 92security status object 92
ewboa60.book Page 208 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 209
Index
security subcategorydeactivated users 139ip addresses accessing my audited clusters
154system information category 154user information category 139user information detail 139user information summary 139user profiles in the repository 139
security tab 41security.unv 161SELECT clause object 103server load monitoring 191
business questions 191sesn host (user ip) object 123sesn user (no ’unknown’ users) object 123sesn user object 123session analysis (no actions) class 123-125
session measures subclass 124session time subclass 125
session day object 125session duration (1 min intervals) object 125session duration (5 min intervals) object 125session duration (hour) object 118session duration (min) object 118, 124
incompatibilities 127, 128session duration (sec) object 124
incompatibilities 127, 128session end time object 121, 123session hour object 125session id object 110, 123session measures subclass 124
incompatibilities 127, 128session minutes object 125session MM object 125session quarter object 125session start object 125session start time object 121, 123session time subclass 125session week object 125session YYYY object 125session YYYY-MM object 125session YYYY-MM-DD object 125
setting upaudit database 32privileges for Auditor-dedicated Designer user
35site log info class 126sql file database scripts
location 48names 48
SQL value object 111start date object 86start date time frame subclass 86status object 94, 98
incompatibilities 100submit date time frame subclass 86submit datetime object 86submit name & user profile (label) object 84submit name & user profile object 84submitter information class 84sum document size object 118supervisor functionality object 92support
customer 11system information category 153-157
business questions 153security subcategory 154traffic subcategory 155-156usage subcategory 157
system information universe 109-128, 161actions class 109-122activity.unv 161analytical categories 74domain 75incompatibilities 127predefined universes 75session analysis (actions) class 123-125site log info class 126
system monitoring 187
Ttable 1 name object 106table 2 name object 106table id object 105table mapping object 98table name (with label) object 105
incompatibilities 108
ewboa60.book Page 209 Tuesday, August 19, 2003 10:52 AM
210 BusinessObjects Auditor Guide
Index
table/alias name object 105incompatibilities 108
table/alias properties object 105time format 76time frame class 86-87
begin date time frame subclass 87end date time frame subclass 87expiration date time frame subclass 87start date time frame subclass 86submit date time frame subclass 86
Tips & Tricks 10top 10 & bottom 10 subcategory
10 least accessed documents 14410 least exported documents 14410 most accessed documents 14410 most exported documents 144document management category 144most active users 140user information category 140
total size of elements in list object 111total users concurrently logged in by day 156, 189tracking
least/most popular documents 194most requested documents 192the least/most popular documents 193-194use of Broadcast Agent 186
traffic subcategory 155-156average number of users concurrently logged
in 156average session duration 156average session duration per cluster 155average session duration per user 155total users concurrently logged in by day 156
training on Business Objects products 11types of browsers in use 157
Uuninstalling
Auditor files 62universe class 98
incompatibilities 100universe description object 98universe domain 161
incompatibilities 100
universe domain analysisanalytical categories 74domain 75incompatibilities 108predefined universes 75universe 101-108universe.unv 161
universe domain analysis universe 161class details class 102condition details class 104contexts class 106hierarchies class 107joins class 106object details class 103universe parameters class 101-102universe tables class 105
universe domain connection 44universe domain creation date object 97universe domain creator object 97universe domain object 97, 98universe domain subclass 97Universe Exporter
audit tab 43export tab 44-45removing database views 60security tab 41tabs 37universe tab 42using 36-45
universe help text object 102universe id object 98, 102universe information detail 148universe information summary 149universe management category 146-150
business questions 146impact analysis subcategory 147usage subcategory 150
universe name (with id) object 102universe name (with label) object 102, 111universe name object 98, 102, 111
incompatibilities 100universe parameters class 101-102universe revision object 98universe tab 42
ewboa60.book Page 210 Tuesday, August 19, 2003 10:52 AM
BusinessObjects Auditor Guide 211
Index
universe tables class 105alias information subclass 105incompatibilities 108
universe usage 150business questions 196
universe.unv 161universes
analytical categories 74Broadcast Agent analysis 76-89
incompatibilities 89custom-made 75deleting 59description 21exporting 36-47
suggested connections 47exporting manually 47monitoring usage 195-196predefined 75, 161
domains 75repository analysis 90-100
incompatibilities 100structure 73system information 109-128
incompatibilities 127universe domain analysis 101-108
incompatibilities 108usage
Broadcast Agent 186usage subcategory
average refresh time 145cluster nodes 157document management category 145document usage 145most popular actions per document 143most popular universes 150objects accessed 150peak usage 157system information category 157types of browsers in use 157universe management category 150universe usage 150
use list of values command set 69user activity 138
monitoring 191business questions 191
user activity per session 138user class 90-92
security commands subclass 92user group (with label) object 91user group object 91user information category 136-140
activity subcategory 137business questions 136security subcategory 139top 10 & bottom 10 140
user information detail 139user information summary 139user level object 91user name (administration) object 114user name (target) option 115user name (with label) object 91, 110user name object 91, 110user profile object 91user profiles in the repository 139user sessions
monitoring average duration 190user status (picture) object 91user status object 91user submit name object 84user submit type object 84users who logged off incorrectly 138Using 131
Vversion object 102view SQL command set 69
Wweb
customer support 11getting documentation via 9useful addresses 12
WebIntelligence functionality object 92WHERE clause object 103
ewboa60.book Page 211 Tuesday, August 19, 2003 10:52 AM
212 BusinessObjects Auditor Guide
Index
ewboa60.book Page 212 Tuesday, August 19, 2003 10:52 AM