businessobjects query builder xi release 2 -...

51
INTERNAL USE ONLY BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training Overview The purpose of the this document is to introduce Technical Engineers to the BusinessObjects XI Release 2 Query Builder. The Query Builder is a useful application that allows users to query the Central Management Server (CMS) for object information that may not be readily available through the default Central Management Console (CMC) or InfoView user interface. Contents PREREQUISITES .......................................................................................... 3 QUERY BUILDER ......................................................................................... 3 ACCESSING THE QUERY BUILDER ................................................................ 3 QUERY BUILDER HELP FILES....................................................................... 4 SELECT Properties...................................................................................... 5 InfoObject Properties ...................................................................................... 5 ProcessingInfo Properties .............................................................................. 6 SchedulingInfo Properties ............................................................................. 7 System Properties ........................................................................................... 8 FROM Category (Enterprise SDK Tables) ................................................. 8 CI_INFOOBJECTS .......................................................................................... 8 CI_SYSTEMOBJECTS ..................................................................................... 8 CI_APPOBJECTS............................................................................................. 9 WHERE Condition ...................................................................................... 9 CMS Performance and Processing the WHERE Condition ....................... 9 Using the TOP N function ........................................................................... 10 XI RELEASE 2 INDEXED PROPERTIES ......................................................... 10 SI_CUID ......................................................................................................... 10 SI_GUID ......................................................................................................... 10 SI_HIDDEN_OBJECT................................................................................... 11 SI_ID ............................................................................................................... 11 SI_INSTANCE_OBJECT............................................................................... 11 SI_KIND and SI_PROGID............................................................................ 11 SI_NAME ....................................................................................................... 13 6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 1

Upload: others

Post on 19-Oct-2020

6 views

Category:

Documents


1 download

TRANSCRIPT

  • INTERNAL USE ONLY

    BusinessObjects Query Builder XI Release 2

    Internal: Query Builder Training

    Overview

    The purpose of the this document is to introduce Technical Engineers to the BusinessObjects XI Release 2 Query Builder. The Query Builder is a useful application that allows users to query the Central Management Server (CMS) for object information that may not be readily available through the default Central Management Console (CMC) or InfoView user interface.

    Contents PREREQUISITES ..........................................................................................3 QUERY BUILDER .........................................................................................3 ACCESSING THE QUERY BUILDER ................................................................3 QUERY BUILDER HELP FILES.......................................................................4

    SELECT Properties......................................................................................5 InfoObject Properties...................................................................................... 5 ProcessingInfo Properties .............................................................................. 6 SchedulingInfo Properties ............................................................................. 7 System Properties ........................................................................................... 8

    FROM Category (Enterprise SDK Tables) .................................................8 CI_INFOOBJECTS .......................................................................................... 8 CI_SYSTEMOBJECTS..................................................................................... 8 CI_APPOBJECTS............................................................................................. 9

    WHERE Condition......................................................................................9 CMS Performance and Processing the WHERE Condition....................... 9 Using the TOP N function ........................................................................... 10

    XI RELEASE 2 INDEXED PROPERTIES .........................................................10 SI_CUID ......................................................................................................... 10 SI_GUID ......................................................................................................... 10 SI_HIDDEN_OBJECT................................................................................... 11 SI_ID ............................................................................................................... 11 SI_INSTANCE_OBJECT............................................................................... 11 SI_KIND and SI_PROGID............................................................................ 11 SI_NAME ....................................................................................................... 13

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 1

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_NAMEDUSER.......................................................................................... 13 SI_NEXTRUNTIME...................................................................................... 13 SI_OWNERID................................................................................................ 14 SI_PARENTID ............................................................................................... 14 SI_PLUGIN_OBJECT.................................................................................... 14 SI_RECURRING............................................................................................ 14 SI_RUID.......................................................................................................... 14 SI_RUNNABLE_OBJECT............................................................................. 14 SI_SCHEDULE_STATUS............................................................................. 14 SI_UPDATE_TS............................................................................................. 15 SI_INSTANCE............................................................................................... 15

    XI RELEASE 2 INDEXED PROPERTIES AND DATABASE EQUIVALENCIES........15 HOW AND WHEN TO USE DIRECT DATABASE QUERIES................................16

    CMS_INFOOBJECTS5.OBJECTID .............................................................. 16 CMS_INFOOBJECTS5.PARENTID ............................................................ 17 CMS_INFOOBJECTS5.OWNERID ............................................................. 19 CMS_INFOOBJECTS5.TYPEID................................................................... 20 CMS_INFOOBJECTS5.SCHEDULESTATUS ............................................ 21 CMS_INFOOBJECTS5.NEXTRUNTIME ................................................... 22 CMS_INFOOBJECTS5.LASTMODIFYTIME ............................................. 22 CMS_INFOOBJECTS5.SI_INSTANCE_OBJECT....................................... 22 CMS_INFOOBJECTS5.SI_NAMEDUSER.................................................. 23 CMS_INFOOBJECTS5.SI_RECURRING.................................................... 24

    QUERY SAMPLES ......................................................................................24 User and Group .........................................................................................25

    List All Users ................................................................................................. 25 List All Groups .............................................................................................. 25 Lists Users Currently Logged On to Enterprise System .......................... 26

    Crystal Report............................................................................................27 View Latest Instance ID of Report .............................................................. 27 Retrieve All Instances for a Report Object ................................................. 27 Counting the Number of Historical Instances for a Report..................... 28 List Report Parameter................................................................................... 29 Finding FRS Location for Report ................................................................ 29 Reporting Database Logon Information .................................................... 29

    Business View and Business View Connections .......................................30 Finding What Business View a Report is Using ....................................... 30 Listing All Business Views .......................................................................... 30 Return All Properties for a Business View by Name ............................... 31 All Reports Connected to a Specific Business View ................................. 31 All Business View Connections................................................................... 32

    Universe and Universe Connections .........................................................32 Listing All Universes and their Connection Information ........................ 32 Return Web Intelligence Reports Connected to a Specific Universe...... 33 Core and Derived Universe Information ................................................... 34

    Web Intelligence Report.............................................................................35 Web Intelligence Report Universe Connection ......................................... 35 Web Intelligence Report Parameter Information...................................... 35 Web Intelligence Report and CACHE Output .......................................... 36 View Latest Instance ID for Web Intelligence Report .............................. 37 Retrieve All Instances for Web Intelligence Report Object...................... 37 Counting the Number of Historical Instances for a Web Intelligence Report ............................................................................................................. 38 Finding FRS Location for Report ................................................................ 38

    Desktop Intelligence...................................................................................39

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 2

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Desktop Intelligence Universe Connection and Data Providers ............ 39 Desktop Intelligence Report Parameter Information ............................... 39 Desktop Intelligence Report and CACHE Output ................................... 40 View Latest Instance ID for Desktop Intelligence Report........................ 41 Retrieve All Instances for the Desktop Intelligence Report Object......... 41 Counting the Number of Historical Instances for a Desktop Intelligence Report ............................................................................................................. 42 Finding FRS Location for Report ................................................................ 42

    License Key ................................................................................................43 License Keys and Product Version ............................................................. 43 Licensing Features Unlocked by Key Code............................................... 43

    Scheduling .................................................................................................43 Determining Report Scheduling Status...................................................... 43 All Recurring Scheduled Reports ............................................................... 44 General Scheduled Report Information ..................................................... 44

    Servers .......................................................................................................46 Servers Registered with the CMS ............................................................... 46 Current CMS Load........................................................................................ 46 Listing CMS Members in the Cluster ......................................................... 47 Server IOR (Interoperable Object Reference) ............................................ 47

    Authentication...........................................................................................47 Authentication Used to Logon .................................................................... 47 Authentication Plug-in Information........................................................... 48 LDAP Configuration Information .............................................................. 48 Windows AD Configuration Information ................................................. 50

    FINDING MORE INFORMATION .....................................................................51

    Prerequisites It is recommended that you have access to a BusinessObjects XI Release 2 installation before continuing with the rest of the documentation.

    Query Builder The BusinessObjects XI Release 2 Query Builder is a sample application that enables users to submit simple SELECT statements to retrieve information from the CMS InfoStore. Although the query language is a subset of the commonly used Structured Query Language (SQL), it does not support table joins or embedded SELECT statements.

    The syntax of a typical SELECT statement follows:

    SELECT

    FROM

    WHERE

    Accessing the Query Builder The Query Builder application is located on the BusinessObjects Admin LaunchPad under Administration Tools (see Figure 1).

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 3

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Figure 1

    Once the link is clicked, the logon dialog appears (see Figure 2). Note that your query results are dependent on your user rights within the Enterprise system so you should use an Enterprise account with Administrator rights.

    Figure 2

    Query Builder Help Files The most difficult part about building a query is determining what properties are available within the BusinessObjects Enterprise XI Release 2 SDK when using the Query Builder. You may use the SELECT asterisk “*” wildcard to retrieve all of the properties for an InfoObject. However, it is more advantageous to retrieve as few properties as possible for readability and performance purposes.

    The most efficient way of determining the properties available to the Query Builder is to view the Query Language Reference section in the Online Developer Help Guide:

    http://devlibrary.businessobjects.com/BusinessObjectsXIR2/en/devsuite.htm

    Go to BusinessObjects Enterprise SDK > COM Developer guide and API reference > Query Language Reference (see Figure 3).

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 4

    bo_xi_r2_query_builder_training.pdf

    http://devlibrary.businessobjects.com/BusinessObjectsXIR2/en/devsuite.htm

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Figure 3

    SELECT Properties The Query Language Reference lists four primary property types (see Figure 4) that can be accessed from a query result. A brief definition of each is provided below.

    Figure 4

    InfoObject Properties The InfoObject contains all the properties used to describe a BusinessObjects Enterprise object that is stored in the Central Management Server (CMS) repository.

    The image below lists some of the available properties you can add to the SELECT statement (see Figure 5). The properties are logically named so finding what you need is not difficult. A brief definition of each property is also provided in the pane to the right for each property.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 5

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Figure 5

    ProcessingInfo Properties The ProcessingInfo properties contain the information related to the processing of a report object. This includes properties such as, the database logon, the report format, prompting, the selection formula, and the printer information.

    To query for processing information you must add the SI_PROCESSINFO prefix first and then the property name afterwards.

    For example, to verify if a report object contains a default database logon, parameter value and record selection formula, add the following properties to your SELECT statement:

    SELECT

    SI_PROCESSINFO.SI_DBNEEDLOGON,

    SI_PROCESSINFO.SI_LOGON_INFO,

    SI_PROCESSINFO.SI_PROMPTS,

    SI_PROCESSINFO.SI_RECORD_FORMULA

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = Report ID

    The image below lists some of the available properties you can add to your SELECT statement (see Figure 6). A brief definition of each property is also provided in the pane on the right for each property.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 6

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Figure 6

    SchedulingInfo Properties The SchedulingInfo properties are related to the scheduling of an InfoObject. These properties mostly include the how, where, and when a report will be processed.

    To query for scheduling information you must add the SI_SCHEDULEINFO prefix first and then the property name after.

    For example, if a user needs to verify the current processing state of a report and the machine the report is currently being processed on, a user can add the following properties in their SELECT statement:

    SELECT

    SI_SCHEDULEINFO.SI_PROGRESS,

    SI_SCHEDULEINFO.SI_MACHINE_USED

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = Report ID

    The image below shows some of the available properties you can add to your SELECT statement (see Figure 7). A brief definition of each property is also provided in the pane on the right for each property.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 7

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Figure 7

    System Properties System properties provide information about the system and its administrative functions such as the CMS cluster name and the CMS cluster members.

    The image below shows the available properties you can add to your SELECT statement (see Figure 8). A brief definition of each property is also provided in the pane on the right for each property.

    Figure 8

    FROM Category (Enterprise SDK Tables) The Enterprise SDK exposes three logical tables named CI_INFOOBJECTS, CI_SYSTEMOBJECTS, and CI_APPOBJECTS. It is important to note that the Enterprise SDK tables are not the same physical database tables found in the CMS database. Instead, they are logical tables created in CMS memory that enable users to query from the four property types. Some of the object types for each table are listed below.

    CI_INFOOBJECTS The info object table allows users to retrieve folder, report and report instance information from the CMS InfoStore.

    CI_SYSTEMOBJECTS The system object table allows users to retrieve information regarding servers, users, groups, destinations and events from the CMS InfoStore.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 8

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    CI_APPOBJECTS

    The application object table allows users to retrieve information regarding business views, business view connections, universe connections, universes, list of values, command objects, repository objects and Business Objects applications.

    WHERE Condition A good rule of thumb when creating queries is to use indexed properties in the WHERE clause to narrow down your result set. The more you are able to filter down the result set using indexed fields the better.

    As well, adding as many indexed fields within the same sized result set may not necessarily improve performance.

    For example, if you have the SI_SCHEDULE_STATUS condition in your predicate, adding another indexed property like SI_INSTANCE will not improve performance. If SI_SCHEDULE_STATUS is equal to 1, SI_INSTANCE must be equal to 1 so adding SI_INSTANCE will only add additional processing overhead in the query.

    CMS Performance and Processing the WHERE Condition When the query is submitted for processing, the CMS will examine the WHERE clause for indexed properties and then construct an optimized query. It is important to note the CMS processes the properties from left to right. Placing indexed properties with the smallest result set first in the WHERE clause is best policy when there are multiple properties within the clause.

    For example, the WHERE clause below shows an inefficient and an efficient query that returns the identical instance information for a particular report called “Test Report”:

    Most Inefficient: SELECT

    *

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_INSTANCE=1 AND SI_NAME='Test Report'

    In the query above, the CMS will retrieve all the instances in the system first and then search through the result set (from only those objects whose SI_INSTANCE property = 1) for the report named “Test Report.”

    More Efficient:

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 9

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SELECT

    *

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME='Test Report' AND SI_INSTANCE=1

    In the case above, the CMS will only retrieve reports named “Test Report” and then search through the result set (from only those objects whose SI_NAME = ‘Test Report’ for report instances.

    Using the TOP N function In situations where a large result set is unavoidable, users should use the TOP N function to limit the selection. If the CMS is forced to select too many objects, it may cause the system to become overloaded with requests.

    TOP N Example: SELECT

    TOP 100 *

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_KIND = 'CrystalReport'

    XI Release 2 Indexed Properties Listed below are the most commonly-used index properties provided in the Developers Help Guide. For a complete list, see Performance Issues in the Query Language Reference section.

    SI_CUID This is the unique cluster ID of the InfoObject. This property uniquely identifies objects within the Enterprise cluster. If the object is migrated to a different deployment of Enterprise, the SI_CUID remains the same so the ID reference is not corrupted.

    SI_GUID This is the unique global object ID of the InfoObject. This property is a globally-unique identifier for an object. If the object is migrated to a different deployment of Enterprise, the SI_GUID changes.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 10

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_HIDDEN_OBJECT This property indicates whether or not an object is hidden.

    To query for hidden objects, you must specify that SI_HIDDEN_OBJECT = 1 or SI_HIDDEN_OBJECT != 0; otherwise, by default, only non-hidden objects are returned.

    SI_ID This is a number that uniquely identifies an object in the Enterprise system. The number is assigned at creation time, and is never changed until the object is destroyed. No two objects have the same ID, even if they are different types of objects; that is, you will never find a report that has the same ID as a folder.

    SI_INSTANCE_OBJECT This is a boolean value specifying whether or not the Enterprise object is a report instance that is the result of a job that has already run. Instead of using SI_INSTANCE_OBJECT to determine the status of an instance, it is recommended that you use SI_SCHEDULE_STATUS Property. An instance may be runnable (it is scheduled to run and create another instance), or it may not be runnable (it is the result of a job that has already run). Use this property to retrieve only those instances that have already been run, and the SI_RUNNABLE_OBJECT Property to retrieve only those instances that are runnable.

    Values set in BOOLEAN:

    1 = True

    0 = False

    SI_KIND and SI_PROGID These are string values that identify the Enterprise Object type. These properties return a predetermined identifier for an InfoObject. Use the SI_KIND property as a replacement for the SI_PROGID property that is being deprecated.

    A comparison of the two properties: SI_PROGID = ‘CrystalEnterprise.Folder’

    SI_KIND = ‘Folder’

    Predetermined Identifier Values:

    ProgID SI_KIND

    CrystalEnterprise.AuditAdmin AuditAdmin

    CrystalEnterprise.CacheServerAdmin CacheServerAdmin

    CrystalEnterprise.Calendar Calendar

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 11

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    CrystalEnterprise.Category Category

    CrystalEnterprise.CMSAdmin CMSAdmin

    CrystalEnterprise.Connection Connection

    CrystalEnterprise.Report CrystalReport

    CrystalEnterprise.Diskunmanaged Diskunmanaged

    CrystalEnterprise.Event Event

    CrystalEnterprise.EventServerAdmin EventServerAdmin

    CrystalEnterprise.Excel Excel

    CrystalEnterprise.FavoritesFolder FavoritesFolder

    CrystalEnterprise.Folder Folder

    CrystalEnterprise.FileServerAdmin FileServerAdmin

    CrystalEnterprise.Ftp Ftp

    CrystalEnterprise.FullClient FullClient

    CrystalEnterprise.Hyperlink Hyperlink

    CrystalEnterprise.Inbox Inbox

    CrystalEnterprise.JobServerAdmin JobServerAdmin

    CrystalEnterprise.LicenseKey LicenseKey

    CrystalEnterprise.Managed Managed

    CrystalEnterprise.ObjectPackage ObjectPackage

    CrystalEnterprise.Overload Overload

    CrystalEnterprise.PageServerAdmin PageServerAdmin

    CrystalEnterprise.PersonalCategory PersonalCategory

    CrystalEnterprise.Pdf Pdf

    CrystalEnterprise.Powerpoint Powerpoint

    CrystalEnterprise.Profile Profile

    CrystalEnterprise.Program Program

    CrystalEnterprise.Publication Publication

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 12

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    CrystalEnterprise.ReportAppServerAdmin ReportAppServerAdmin

    CrystalEnterprise.Rtf Rtf

    CrystalEnterprise.Server Server

    CrystalEnterprise.Shortcut Shortcut

    CrystalEnterprise.Smtp Smtp

    CrystalEnterprise.SSOAdmin SSOAdmin

    CrystalEnterprise.Txt Txt

    CrystalEnterprise.Universe Universe

    CrystalEnterprise.User User

    CrystalEnterprise.Usergroup Usergroup

    CrystalEnterprise.Webi Webi

    CrystalEnterprise.WebiServerAdmin WebiServerAdmin

    CrystalEnterprise.Word Word

    SI_NAME This property stores the name of an object. It can be used both to display the object's name and to search for a particular object. This is not a unique value; therefore, different objects may have the same names. To list objects by a unique value use the SI_ID property.

    SI_NAMEDUSER Returns True if the license being used is a named user. If False, the license being used is a concurrent user.

    Values set in BOOLEAN:

    1 = True

    0 = False

    SI_NEXTRUNTIME This property stores the date and time when the report will next be run. The format of the date in the query string must be yyyy.mm.dd.hh.mm.ss, where you can omit anything starting from the right, and the separator can be any separator character. The time part must be in UTC time (GMT with no daylight savings) and it must use the 24 hour clock.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 13

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_OWNERID The ID of the user who owns the InfoObject. This property can be used to list all the reports, and folders, for a particular user. Similar to the SI_ID property, this value is unique.

    SI_PARENTID The SI_PARENTID property is a numeric Long value; it refers to the unique ID for a particular object's parent. It can be used to locate all the children for a particular object.

    SI_PLUGIN_OBJECT Returns True if the InfoObject is a plug-in, and False otherwise.

    Value is set as BOOLEAN:

    1 = True

    0 = False

    SI_RECURRING Returns True if the InfoObject is a recurring instance, and False otherwise. An instance that is recurring is also runnable. However, a runnable instance may not be recurring. To retrieve only runnable objects, use the SI_RUNNABLE_OBJECT Property. To check the current status of an instance, use the SI_SCHEDULE_STATUS Property

    Value is set as BOOLEAN:

    1 = True

    0 = False

    SI_RUID Returns the unique ID of the InfoObject in the object package.

    SI_RUNNABLE_OBJECT Returns True if the report object is runnable, and False otherwise.

    Value is set as BOOLEAN:

    1 = True

    0 = False

    SI_SCHEDULE_STATUS The current status of the scheduled job.

    Schedule Status Values:

    Value Description

    3 The job failed. Use error message or outcome to

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 14

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    get more information.

    8 The job is paused. Even if all dependencies are satisfied, it will not run.

    9 The job has not started because dependencies are not satisfied. Dependencies include time constraints and events.

    0 The job is currently being processed by the job server.

    1 The job completed successfully.

    SI_UPDATE_TS This is a time stamp property that stores the last time the object was modified. An object is modified when any of its properties change. Note that although the date is returned in the format MM/DD/YYYY HH:MM:SS AM/PM, the format of the date in the query string must be yyyy.mm.dd.hh.mm.ss, where you can omit anything starting from the right, and the separator can be any separator character. The time part must be in local time and it must use the 24 hour clock.

    SI_INSTANCE This property can be used to find all instances of a particular report.

    When a report is scheduled to run on a recurring basis (for example, hourly), two instances are created: a runnable instance, which is able to run and create another instance, and an instance object, which is the result of a job that has already run. Use the SI_RUNNABLE_OBJECT property to retrieve only those instances that are runnable, and use the SI_INSTANCE_OBJECT property to retrieve only those instances that have already been run.

    Values set as BOOLEAN:

    1 = True

    0 = False

    XI Release 2 Indexed Properties and Database Equivalencies Understanding the links between the Enterprise SDK properties and the physical database fields are important when troubleshooting large customer databases restored in-house. At times, it will be impossible to run an efficient query to collect the information you need when the result set is too large for the CMS in the Query Builder. The Equivalencies Table maps the Enterprise SDK properties to the CMS

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 15

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    database fields (non-binary) that you can use to query directly against the database.

    Equivalencies Table

    CMS Database Field

    Enterprise SDK Property

    CMS_INFOOBJECTS5.OBJECTID SI_ID

    CMS_INFOOBJECTS5.PARENTID SI_PARENTID

    CMS_INFOOBJECTS5.OWNERID SI_OWNERID

    CMS_INFOOBJECTS5.TYPEID SI_OBTYPE

    CMS_INFOOBJECTS5.SCHEDULESTATUS SI_SCHEDULE_STATUS

    CMS_INFOOBJECTS5.NEXTRUNTIME SI_NEXTRUNTIME

    CMS_INFOOBJECTS5.LASTMODIFYTIME SI_UPDATE_TS

    CMS_INFOOBJECTS5.SI_INSTANCE_OBJECT SI_INSTANCE_OBJECT

    CMS_INFOOBJECTS5.SI_PLUGIN_OBJECT SI_PLUGIN_OBJECT

    CMS_INFOOBJECTS5.SI_HIDDEN_OBJECT SI_HIDDEN_OBJECT

    CMS_INFOOBJECTS5.SI_NAMEDUSER SI_NAMEDUSER

    CMS_INFOOBJECTS5.SI_RECURRING SI_RECURRING

    CMS_INFOOBJECTS5.RUNNABLE_OBJECT SI_RUNNABLE_OBJECT

    How and When to use Direct Database Queries Although the database fields can help you collect the records you require, the information returned will be of little value unless you plug them back into the Query Builder. Most of the important object information is held within the binary fields; therefore you will need to use the Query Builder to translate these objects into a more useful format.

    CMS_INFOOBJECTS5.OBJECTID The main purpose of running a direct query against the database is to further narrow down your record set by collecting the OBJECTIDs (SI_IDs) necessary for your SDK query. Once the OBJECTIDs are collected you can run a more efficient query in the Query Builder using the IN operator in the WHERE clause.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 16

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    For example, to collect the OBJECTIDs for all recurring reports in the system database, run the following query:

    Direct Database SQL:

    NOTE If you do not know how to write your own SQL against the CMS database create a Crystal, Web Intelligence, or Desktop Intelligence report to filter the data.

    SELECT

    ObjectID

    FROM

    CMS_InfoObjects5

    WHERE

    (SI_RECURRING = 1) AND (SI_RUNNABLE_OBJECT = 1)

    Result Set Sample for OBJECTID = (1,2,3,4,5,6,7,8,9,10)

    The SI_RUNNABLE_OBJECT property was used to further ensure the object retrieved was not an archived instance. For more information see the CMS_INFOOBJECTS5.SI_RUNNABLE_OBJECT section.

    With the OBJECTID result set collected, run the following SDK query to return the Enterprise SDK property information for the objects:

    Query Builder SQL: SELECT

    *

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID IN (1,2,3,4,5,6,7,8,9,10)

    CMS_INFOOBJECTS5.PARENTID The PARENTID field is the best filter strategy for your WHERE clause. Every InfoObject within the CMS database will always have a PARENTID.

    If we start at the lowest level, ObjectID 11, 12, 7006, 7010,.. PARENTID will be 19 since the objects live beneath ObjectID 19 (19 – Users), and ObjectID 19 (19 – Users) PARENTID will be 4 since it lives beneath ObjectID 4 (4 – SMARTYPANTS.CRYSTALD.NET) (see Figure 9).

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 17

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Figure 9

    All InfoObjects within the system are organized in this manner so filtering objects directly against the database using PARENTID simplifies your record set substantially.

    Using the sample above you can retrieve all of the XI Release 2 users with the following database query:

    Direct Database SQL:

    SELECT

    ObjectID

    FROM

    CMS_InfoObjects5

    WHERE

    (PARENTID = 19) AND (TYPEID = 19)

    Result Set Sample for ObjectID = (11, 12, 7006, 7010, 7014, 7018, 7022, 7026)

    The TYPEID property is used to further ensure that the object retrieved is a user object. For more information on the TYPEID property see the CMS_INFOOBJECTS5.TYPEID section.

    With the result set collected, run the following SDK query in the Query Builder to translate all of the binary properties:

    Query Builder SQL:

    SELECT

    *

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_ID IN (11, 12, 7006, 7010, 7014, 7018, 7022, 7026)

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 18

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    CMS_INFOOBJECTS5.OWNERID The OWNERID field is rarely used to query the database other than to find how many objects a particular user owns within the XI Release 2 system.

    If the OWNERID information is required, use an SDK query to identify the SI_OWNERID first in order to find your information. Since the OWNERID field is stored as a number it will hold very little value until you find out the username that is assigned to the unique value.

    Run the following SDK query to get the SI_OWNERID value for a user.

    Query Builder SQL:

    SELECT

    SI_NAME, SI_OWNERID

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_NAME = ‘Username’ AND SI_KIND = ‘User’

    Sample Result Set: SI_NAME = Administrator

    SI_OWNERID = 12

    The SI_KIND property was used to ensure the SI_NAME (Username) value returned was a User account. For more information regarding the SI_KIND property, see the Predetermined Identifier Values table located in the XI Release 2 Indexed Properties section.

    Once you have obtained the SI_OWNERID value, run the following query to get a count of how many objects the user account owns:

    Direct Database SQL:

    SELECT

    COUNT(OBJECTID)

    FROM

    CMS_InfoObjects5

    WHERE

    OWNERID = 12

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 19

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    The COUNT(OBJECTID) function was used to return the aggregate count of all the objects the user owns. If you require a count of specific object types such as, reports, folders, or instances , add the TYPEID field in your WHERE clause. For more information on the TYPEID field, see the CMS_INFOOBJECTS5.TYPEID section.

    CMS_INFOOBJECTS5.TYPEID The SI_KIND and SI_PROGID SDK properties are stored in the database as binary fields; therefore, the TYPEID field must be used to filter out specific object types if required.

    The table below links the static TYPEID value for each InfoObject type available within the XI Release 2 system. Note that these values may change between Enterprise product versions. The following is a listing for XI Release 2 only:

    TYPEID ProgID SI_KIND 22 CrystalEnterprise.Calendar Calendar

    45 CrystalEnterprise.Category Category

    41 CrystalEnterprise.Connection Connection

    2 CrystalEnterprise.Report CrystalReport

    331 CrystalEnterprise.Diskunmanaged Diskunmanaged

    21 CrystalEnterprise.Event Event

    319 CrystalEnterprise.Excel Excel

    18 CrystalEnterprise.FavoritesFolder FavoritesFolder

    1 CrystalEnterprise.Folder Folder

    11 CrystalEnterprise.FullClient FullClient

    310 CrystalEnterprise.Hyperlink Hyperlink

    48 CrystalEnterprise.Inbox Inbox

    24 CrystalEnterprise.LicenseKey LicenseKey

    290 CrystalEnterprise.ObjectPackage ObjectPackage

    280 CrystalEnterprise.Overload Overload

    47 CrystalEnterprise.PersonalCategory PersonalCategory

    279 CrystalEnterprise.Pdf Pdf

    278 CrystalEnterprise.Powerpoint Powerpoint

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 20

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    277 CrystalEnterprise.Profile Profile

    276 CrystalEnterprise.Program Program

    275 CrystalEnterprise.Publication Publication

    270 CrystalEnterprise.Rtf Rtf

    16 CrystalEnterprise.Server Server

    8 CrystalEnterprise.Shortcut Shortcut

    265 CrystalEnterprise.Txt Txt

    264 CrystalEnterprise.Universe Universe

    19 CrystalEnterprise.User User

    20 CrystalEnterprise.Usergroup Usergroup

    260 CrystalEnterprise.Webi Webi

    259 CrystalEnterprise.Word Word

    The following SQL will perform a count of all the Crystal Reports owned by the Administrator account:

    Direct Database SQL: SELECT

    COUNT(OBJECTID)

    FROM

    CMS_InfoObjects5

    WHERE

    OWNERID = 12 and TYPEID = 2

    CMS_INFOOBJECTS5.SCHEDULESTATUS Be cautious when using the SCHEDULESTATUS field when directly querying the system database. Some of the values have more than one meaning.

    For example, When looking at the values available in the table, a value of 9 may mean the scheduled job is in pending state because it is waiting for a file event, schedule event, or it has not reached its next runtime.

    The most reliable values are 3 or 1 since these values do not change over time.

    Value Description 3 The job failed. Use error message or outcome to

    get more information.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 21

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    8 The job is paused. Even if all dependencies are satisfied, it will not run.

    9 The job has not started because dependencies are not satisfied. Dependencies include time constraints and events.

    0 The job is currently being processed by the job server.

    1 The job completed successfully.

    To find the number of failed jobs within the XI Release 2 system use the following SQL:

    Direct Database SQL: SELECT

    COUNT(OBJECTID)

    FROM

    CMS_InfoObjects5

    WHERE

    SCHEDULESTATUS = 3

    CMS_INFOOBJECTS5.NEXTRUNTIME Do not use this field to filter. The field is not declared as a DATETIME field but a VARCHAR. Your results will be incorrect.

    CMS_INFOOBJECTS5.LASTMODIFYTIME Do not use this field to filter. The field is not declared as a DATETIME field but a VARCHAR. Your results will be incorrect.

    CMS_INFOOBJECTS5.SI_INSTANCE_OBJECT The SI_INSTANCE_OBJECT field can be used to collect all successfully run jobs. The field can be used to distinguish between the recurring instances and archived instances within the system. If the value is True (1), the object is an archived instance and cannot be run again.

    To collect all the archived instances within the system run the following query:

    Direct Database SQL: SELECT

    ObjectID

    FROM

    CMS_InfoObjects5

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 22

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    WHERE

    SI_INSTANCE_OBJECT = 1

    Result Set Sample for ObjectID = (11, 12, 7006, 7010, 7014, 7018, 7022, 7026)

    Use the result set to run the following Enterprise SDK query:

    Query Builder SQL:

    SELECT

    *

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID IN (11, 12, 7006, 7010, 7014, 7018, 7022, 7026)

    CMS_INFOOBJECTS5.SI_NAMEDUSER The SI_NAMEDUSER field can be used to return all named or concurrent users within the XI Release 2 system.

    Set the value to True (1) for named users and False (0) for concurrent users in the WHERE clause.

    The following query will return only the named users within the system:

    Direct Database SQL:

    SELECT

    ObjectID

    FROM

    CMS_InfoObjects5

    WHERE

    SI_NAMEDUSER = 1

    Result Set Sample for ObjectID = (11, 12, 7006, 7010, 7014, 7018, 7022, 7026)

    Query Builder SQL:

    SELECT

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 23

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    *

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_ID IN (11, 12, 7006, 7010, 7014, 7018, 7022, 7026)

    CMS_INFOOBJECTS5.SI_RECURRING SI_RECURRING is another field that can be used to collect all the recurring report instances from the system.

    The following SQL will return all the Crystal report recurring instances that are owned by the Administrator within the XI Release 2 system:

    Direct Database SQL:

    SELECT

    ObjectID

    FROM

    CMS_InfoObjects5

    WHERE

    SI_RECURRING = 1 AND SI_OWNERID = 12 AND TYPEID = 2

    Query Builder SQL:

    SELECT

    *

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_RECURRING = 1 AND SI_OWNERID = 12 AND SI_KIND =

    ‘crystalreport’

    Query Samples This section provides a list of sample queries to use in the Query Builder.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 24

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    User and Group List All Users SELECT

    SI_NAME, SI_ID, SI_OWNERID, SI_KIND, SI_ALIASES, SI_NAMEDUSER, SI_CHANGEPASSWORD, SI_USERGROUPS, SI_PASSWORDEXPIRE, SI_USERFULLNAME, SI_LASTLOGONTIME

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND = 'user'

    The query above will return all users in the system specifying the following object information:

    Name Definition SI_NAME Username

    SI_ID Unique ID within Enterprise system.

    SI_OWNERID The unique value applied to objects the user owns.

    SI_KIND The Enterprise object type.

    SI_ALIASES The authentication type set for the user account.

    SI_NAMEDUSER User license type. 1 for Named and 0 for concurrent.

    SI_CHANGEPASSWORD Value shows if the user has the right to change their password.

    SI_USERGROUPS Lists the Enterprise Groups the user belongs to. The values are listed by the User Group unique SI_ID (See the User Group query for how to return group names for the associated Group SI_IDs).

    SI_PASSWORDEXPIRE Specifies if the password has expired (True or False).

    SI_USERFULLNAME Users full name.

    SI_LASTLOGONTIME The date and time the user last logged onto the system.

    List All Groups SELECT

    SI_NAME, SI_DESCRIPTION, SI_ID, SI_ALIASES, SI_GROUP_MEMBERS

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 25

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND = 'usergroup'

    The query above will return all the groups within the system specifying the following information:

    Name Definition SI_NAME Group Name

    SI_DESCRIPTION Group Description

    SI_ID The Unique ID of object within Enterprise system. This ID is added to SI_USERGROUP property for each User in Enterprise system that is part of the group.

    SI_ALIASES Specifies if the group is an Enterprise, Active Directory, LDAP, or Windows NT group.

    SI_GROUP_MEMBERS Lists all the unique user SI_IDs that belong to the group.

    Lists Users Currently Logged On to Enterprise System SELECT

    SI_APSNAME, SI_AUTHEN_METHOD, SI_NAME, SI_DESCRIPTION, SI_CREATION_TIME

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND = 'connection'

    The query above will return all currently logged on users within the Enterprise system specifying the following information:

    Name Definition SI_NAME The user account logged on.

    SI_APSNAME The CMS the user is currently logged onto.

    SI_AUTHEN_METHOD The authentication type of user.

    SI_DESCRIPTION The user description.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 26

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_CREATION_TIME The date and time of when the user logged on.

    Crystal Report View Latest Instance ID of Report SELECT

    SI_ID, SI_PARENTID, SI_NAME, SI_LAST_SUCCESSFUL_INSTANCE_ID

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = ReportID

    OR

    SELECT

    SI_ID, SI_PARENTID, SI_NAME, SI_LAST_SUCCESSFUL_INSTANCE_ID

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘Report Name’ AND SI_INSTANCE = 0 AND

    SI_KIND = ‘CrystalReport’

    The queries above will return the Last Successful Instance ID for a report object. The ID is used for the View Latest Instance link for each schedulable report in InfoView.

    The query provides the following information:

    Name Definition SI_LAST_SUCCESSFUL_INSTANCE_ID

    The SI_ID value of the latest instance scheduled.

    SI_ID This ID is used as the SI_PARENTID value for each report instance it creates beneath it.

    SI_PARENTID The parent ID of the Report. The value is usually the Folder unique SI_ID it resides in.

    SI_NAME The report name.

    Retrieve All Instances for a Report Object

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 27

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SELECT

    SI_SCHEDULEINFO.SI_STARTTIME, SI_NAME,

    SI_INSTANCE

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_PARENTID = ParentID AND SI_INSTANCE = 1

    ORDER BY SI_ID DESC

    The SI_PARENTID will be the main Report Objects SI_ID value.

    The query above will return all instances for a report object specifying the following information:

    Name Definition SI_NAME Report Instance Name

    SI_INSTANCE Used to confirm that the object is an instance rather than report template. Value should be True or 1.

    SI_SCHEDULEINFO.SI_STARTTIME

    The date and time the instance actually began being processed.

    Counting the Number of Historical Instances for a Report SELECT

    COUNT(SI_ID)

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_PARENTID = Main Report ID

    The SI_PARENTID needs to be the unique SI_ID value of the main report object.

    The query above will return the aggregate count for a report object specifying the following information:

    Name Definition Count(SI_ID) The total number of instances created

    by the report object.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 28

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    List Report Parameter SELECT

    SI_NAME, SI_PROCESSINFO.SI_PROMPTS

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = Report ID

    The query above returns the following report parameter information:

    Name Definition SI_NAME The report name.

    SI_PROCESSINFO.SI_PROMPTS

    The parameter prompt name, default parameter values, and current parameter values used to process the report.

    NOTE SI_DEFAULT_VALUES are not the parameter values that are going to be used to process the report. When the report is processed, the SI_CURRENT_VALUES property values are used instead.

    Finding FRS Location for Report SELECT

    SI_NAME, SI_FILES

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_INSTANCE = 0 AND SI_ID = Report ID

    The query above will return the physical file location of the report object in the file repository.

    Reporting Database Logon Information SELECT

    SI_NAME, SI_PROCESSINFO.SI_LOGON_INFO

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_INSTANCE = 0 AND SI_ID = Report ID

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 29

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    The query above will return the database information specifying the following information:

    Name Definition SI_NAME The report name

    SI_PROCESSINFO.SI_LOGON_INFO

    Displays the data source, database logon, and database driver name.

    Business View and Business View Connections Finding What Business View a Report is Using SELECT

    SI_NAME, SI_BUSINESSVIEWS, SI_PROCESSINFO.SI_BUSINESS_VIEW_INFO

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = Report ID

    The query above will return the Business View’s unique SI_ID and SI_CUID value that Crystal Reports is using to link back to the Business View.

    Name Definition SI_NAME The report name.

    SI_BUSINESSVIEWS The Business Views unique SI_ID value.

    SI_PROCESSINFO.SI_BUSINESS_VIEW_INFO

    The SI_CUID of the Business View used by the report.

    Listing All Business Views SELECT

    SI_ID, SI_NAME, SI_CUID,

    FROM

    CI_APPOBJECTS

    WHERE

    SI_KIND = 'MetaData.BusinessView'

    The query above will return all the Business Views within the XI Release 2 system.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 30

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    The properties specify the following information:

    Name Definition SI_ID The unique ID of the Business View. This value is

    used in Crystal Report properties SI_BUSINESSVIEWS property to link back the Business View.

    SI_NAME Business View Name

    SI_CUID The Business View cluster ID. This value is referenced in Crystal Reports SI_PROCESSINFO.SI_BUSINESS_VIEW_INFO property to maintain a link between the two objects.

    Return All Properties for a Business View by Name SELECT

    *

    FROM

    CI_APPOBJECTS

    WHERE

    SI_NAME = ‘Business View Name’

    All Reports Connected to a Specific Business View

    SELECT

    SI_NAME, SI_REPORTS

    FROM

    CI_APPOBJECTS

    WHERE

    SI_NAME = 'Business View Name'

    The query above will return all the unique report SI_IDs using the Business View as a data source.

    The property values returned specify the following information:

    Name Definition SI_NAME The name of the Business View

    SI_REPORTS

    The SI_ID of the reports connected to the Business View.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 31

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    To return the name of the reports, run a second query using the SI_IDs returned from SI_REPORTS property:

    SELECT

    SI_NAME, SI_KIND

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID IN (reportid1, reportid2, reportid3)

    The query above will return the following information:

    Name Definition SI_NAME The report name.

    SI_KIND The type of report using the Business View.

    All Business View Connections SELECT

    SI_NAME, SI_ID

    FROM

    CI_APPOBJECTS

    WHERE

    SI_KIND = 'MetaData.DataConnection'

    The query above returns all the Business View and universe connections within the XI Release 2 system. There is no predetermined identifier to separate Business View and universe connections.

    The values returned are:

    Name Definition SI_NAME The connection name.

    SI_ID The unique connection ID.

    Universe and Universe Connections Listing All Universes and their Connection Information SELECT

    SI_NAME, SI_ID, SI_FILES, SI_DATACONNECTION

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 32

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    FROM

    CI_APPOBJECTS

    WHERE

    SI_KIND = ‘universe’

    The query above lists all of the universes and their associated universe connections within the Enterprise XI Release 2 system by specifying the following information:

    Name Definition SI_NAME The name of the universe.

    SI_ID The unique ID of the universe.

    SI_FILES The physical location and name of universe file in FRS.

    SI_DATACONNECTION

    The data connections assigned to the universe object. The value listed will be the SI_ID of the universe connection.

    For property information on the connection use the following query:

    SELECT

    *

    FROM

    CI_APPOBJECTS

    WHERE

    SI_ID = ID returned in SI_DATACONNECTION

    Return Web Intelligence Reports Connected to a Specific Universe

    SELECT

    SI_NAME, SI_WEBI, SI_DATACONNECTION

    FROM

    CI_APPOBJECTS

    WHERE

    SI_KIND = ‘universe’ and SI_NAME = ‘Universe Name’

    The query above returns all the Web Intelligence documents assigned to the universe by specifying the following information:

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 33

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    Name Definition SI_NAME The name of the universe.

    SI_WEBI The list of Web Intelligence documents assigned to the universe by SI_ID.

    SI_DATACONNECTION The data connection assigned to this universe.

    To list the Web Intelligence report names run the following query:

    SELECT

    SI_NAME

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID IN (ID from SI_WEBI, ID from SI_WEBI)

    Core and Derived Universe Information SELECT

    SI_DERIVEDUNIVERSE, SI_COREUNIVERSE,

    SI_DATACONNECTION, SI_SHORTNAME, SI_NAME

    FROM

    CI_APPOBJECTS

    WHERE

    SI_KIND = 'universe' AND SI_NAME = ‘Universe Name’

    The query above returns the SI_ID of the derived or core universes by specifying the following information:

    Name Definition SI_NAME The universe name.

    SI_DERIVEDUNIVERSE The derived universes assigned to the universe object. A derived universe inherits objects and classes from core universes.

    SI_COREUNIVERSE The ID of the core universes assigned to the object. A core universe is the building block, or base, for a derived universe.

    SI_DATACONNECTION The data connections assigned to the universe object.

    SI_SHORTNAME Sets the short name for this universe object.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 34

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    To return the name of the derived or core universes run a second query using the SI_IDs returned from SI_COREUNIVERSE and SI_DERIVEDUNIVERSE.

    SELECT

    SI_NAME

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = SI_ID from SI_COREUNIVERSE OR

    SI_DERIVEDUNIVERSE

    Web Intelligence Report Web Intelligence Report Universe Connection SELECT

    SI_NAME, SI_UNIVERSE

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘webi report name’ and SI_KIND = ‘webi’

    The query above will return the Web Intelligence report’s universe connection information. The value returned will be the SI_ID of the universe.

    To return the properties for the universe run the following query:

    SELECT

    SI_NAME, SI_DATACONNECTION

    FROM

    CI_APPOBJECTS

    WHERE

    SI_ID = SI_UNIVERSE values

    Web Intelligence Report Parameter Information

    SELECT

    SI_NAME, SI_PROCESSINFO.SI_WEBI_PROMPTS,

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 35

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_PROCESSINFO.SI_HAS_PROMPTS,

    SI_PROCESSINFO.SI_PROMPT_USER_VIEWING

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘webi report name’ and SI_KIND = ‘webi’

    The query above will return the parameter prompt information within the Web Intelligence document by specifying the following information.

    Name Definition SI_NAME The Web Intelligence report name.

    SI_PROCESSINFO.SI_WEBI_PROMPTS

    The prompt names and parameter values for the Web Intelligence report.

    SI_PROCESSINFO.SI_HAS_PROMPTS

    Specifies TRUE if the Web Intelligence report has parameters.

    SI_PROCESSINFO .SI_PROMPT_USER_VIEWING

    Specifies if the Web Intelligence report will prompt the user for parameter values.

    Web Intelligence Report and CACHE Output SELECT

    SI_NAME, SI_PROCESSINFO.SI_PRECACHE_HTML,

    SI_PROCESSINFO.SI_PRECACHE_OUTPUTS

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘webi report name’ AND SI_KIND = ‘webi’

    The query above will specify if the Web Intelligence reports have pre-cached outputs turned on.

    The properties return the following information:

    Name Definition SI_NAME The Web Intelligence report name.

    SI_PROCESSINFO.SI_PRECACHE_HTML

    Indicates whether the HTML text stream that represents a Web Intelligence document will be pre-loaded into the cache.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 36

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_PROCESSINFO.SI_PRECACHE_OUTPUTS

    Contains a collection of information that represents the different output types for a Web Intelligence document.

    View Latest Instance ID for Web Intelligence Report SELECT

    SI_ID, SI_PARENTID, SI_NAME, SI_LAST_SUCCESSFUL_INSTANCE_ID

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = ReportID

    OR

    SELECT

    SI_ID, SI_PARENTID, SI_NAME, SI_LAST_SUCCESSFUL_INSTANCE_ID

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘Report Name’ AND SI_INSTANCE = 0 AND

    SI_KIND = ‘webi’

    The queries above will return the Last Successful Instance ID for a report object. The ID is used for the View Latest Instance link for each schedulable report in InfoView.

    The query provides the following information:

    Name Definition SI_LAST_SUCCESSFUL_INSTANCE_ID

    The SI_ID value of the latest instance scheduled.

    SI_ID The unique ID of object. This ID is used as the SI_PARENTID value for each report instance it created.

    SI_PARENTID The parent ID of the report. The value is usually the unique folder SI_ID the report resides in.

    SI_NAME The Web Intelligence report name

    Retrieve All Instances for Web Intelligence Report Object SELECT

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 37

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_SCHEDULEINFO.SI_STARTTIME, SI_NAME,

    SI_INSTANCE

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_PARENTID = ParentID AND SI_INSTANCE = 1

    ORDER BY SI_ID DESC

    The SI_PARENTID value will be the main Report Objects SI_ID value.

    The query above will return all instances for a report object specifying the following information:

    Name Definition SI_NAME The name of the Web Intelligence report

    instance. SI_INSTANCE This property is used to confirm that the

    object is an instance. SI_SCHEDULEINFO.SI_STARTTIME

    The date and time that the instance actually began being processed.

    Counting the Number of Historical Instances for a Web Intelligence Report SELECT

    COUNT(SI_ID)

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_PARENTID = Parent ID

    The Parent ID is the SI_ID value of the main report object.

    The query above will return the aggregate count for a report object specifying the following information:

    Name Definition Count(SI_ID) The total number of instances created by the Web

    Intelligence report object.

    Finding FRS Location for Report SELECT

    SI_NAME, SI_FILES

    FROM

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 38

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    CI_INFOOBJECTS

    WHERE

    SI_KIND = ‘webi’ AND SI_NAME = ‘webi report name’

    The query above will return the physical file location of the Web Intelligence report.

    Name Definition SI_NAME The report name.

    SI_FILES The physical directory location of report object.

    Desktop Intelligence Desktop Intelligence Universe Connection and Data Providers SELECT

    SI_NAME, SI_UNIVERSE,

    SI_PROCESSINFO.SI_FULLCLIENTDATAPROVIDERS

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘deski report name’ and SI_KIND = ‘FullClient’

    The query above will return the Desktop Intelligence reports’ universe connection and data provider information. The value returned for SI_UNIVERSE is the unique SI_ID of the universe. The SI_FULLCLIENTDATAPROVIDERS will return the universe name or the data provider name the report is using.

    To return the name of the universe run the following query:

    SELECT

    SI_NAME, SI_DATACONNECTION

    FROM

    CI_APPOBJECTS

    WHERE

    SI_ID = SI_UNIVERSE values

    Desktop Intelligence Report Parameter Information SELECT

    SI_NAME, SI_HAS_PROMPTS,

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 39

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_PROMPT_USER_VIEWING

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘deski report name’ and SI_KIND = ‘fullclient’

    The query above will return the parameter information specifying the following information.

    Name Definition SI_NAME Desktop Intelligence report name.

    SI_HAS_PROMPTS Returns TRUE if Desktop Intelligence report has parameters.

    SI_PROMPT_USER_VIEWING Returns TRUE if user is to be prompted for parameter values.

    Desktop Intelligence Report and CACHE Output SELECT

    SI_NAME, SI_PROCESSINFO.SI_PRECACHE_HTML,

    SI_PRECACHE_XLS, SI_PRECACHE_PDF,

    SI_PROCESSINFO.SI_PRECACHE_OUTPUTS

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘deski report name’ AND SI_KIND = ‘FULLCLIENT’

    The query above will return the reports pre-cache settings by specifying the following information:

    Name Definition SI_NAME The Desktop Intelligence report name.

    SI_PROCESSINFO.SI_PRECACHE_HTML

    Indicates whether the HTML text stream that represents a Desktop Intelligence document will be pre-loaded into the cache.

    SI_PROCESSINFO.SI_PRECACHE_XLS

    Indicates whether the Excel text stream that represents a Desktop Intelligence document will be pre-loaded into the cache.

    SI_PROCESSINFO.SI_PRECACHE_PDF

    Indicates whether the PDF text stream that represents a Desktop Intelligence document will be pre-loaded into the cache.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 40

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_PROCESSINFO.SI_PRECACHE_OUTPUTS

    Contains a collection of information that represents the different output types for a Desktop Intelligence document.

    View Latest Instance ID for Desktop Intelligence Report SELECT

    SI_ID, SI_PARENTID, SI_NAME, SI_LAST_SUCCESSFUL_INSTANCE_ID

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = ReportID

    OR

    SELECT

    SI_ID, SI_PARENTID, SI_NAME, SI_LAST_SUCCESSFUL_INSTANCE_ID

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_NAME = ‘Deski Report Name’ AND SI_INSTANCE = 0 AND

    SI_KIND = ‘FULLCLIENT’

    The queries above will return the Last Successful Instance ID for a report object. The ID is used for the View Latest Instance link for each schedulable report object in InfoView.

    The query properties provide the following information:

    Name Definition SI_LAST_SUCCESSFUL_INSTANCE_ID

    The SI_ID value of the latest instance scheduled.

    SI_ID The unique ID of object report object. This value will be the SI_PARENTID for each instance the report creates.

    SI_PARENTID The parent ID of the report. The value is the unique SI_ID of the folder the report resides in.

    SI_NAME The Desktop Intelligence report name.

    Retrieve All Instances for the Desktop Intelligence Report Object SELECT

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 41

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_SCHEDULEINFO.SI_STARTTIME, SI_NAME,

    SI_INSTANCE

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_PARENTID = ParentID AND SI_INSTANCE = 1

    ORDER BY SI_ID DESC

    The SI_PARENTID will be the main Report Objects SI_ID value.

    The query above will return all instances for a report object.

    The properties will specify the following information:

    Name Definition SI_NAME The Desktop Intelligence report instance name.

    SI_INSTANCE This value is used to confirm that the object is an instance. Value of 1 ensures it is a report instance.

    SI_SCHEDULEINFO.SI_STARTTIME

    The date and time that the instance actually began being processed.

    Counting the Number of Historical Instances for a Desktop Intelligence Report SELECT

    COUNT(SI_ID)

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_PARENTID = Parent ID

    The Parent ID is the SI_ID value of the main report object.

    The query above will return the aggregate count for a report object by specifying the following information:

    Name Definition Count(SI_ID) The total number of instances created by the

    Desktop Intelligence report object.

    Finding FRS Location for Report

    SELECT

    SI_NAME, SI_FILES

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 42

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_KIND = ‘FULLCLIENT’ AND SI_NAME = ‘deski report name’

    The query above will return the physical file location of the Desktop Intelligence report object by specifying the following information:

    Name Definition SI_NAME The report name.

    SI_FILES The physical location of the report object.

    License Key License Keys and Product Version

    SELECT

    SI_LICENSE_KEY, SI_PRODUCT_VERSION

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND ='LicenseKey'

    The query above will return the Enterprise XI Release 2 license key and the product version.

    Licensing Features Unlocked by Key Code SELECT

    SI_SYSTEM_INFO

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_ID = 4

    The query above will return the “unlocked” Enterprise features the license key allows for.

    Scheduling Determining Report Scheduling Status SELECT

    SI_SCHEDULEINFO.SI_PROGRESS, SI_NAME

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 43

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_SCHEDULE_STATUS = 0

    The SI_SCHEDULEINFO.SI_PROGRESS will return a numeric value specifying the current state of the report instance. The value definitions are described below:

    Value Definition 0 New

    1 Outstanding

    2 Running

    3 Complete

    All Recurring Scheduled Reports SELECT

    SI_NAME, SI_SCHEDULEINFO.SI_STARTTIME

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_RECURRING = 1

    The query above will return all the recurring reports within the XI Release 2 system by specifying the following properties:

    Name Definition SI_NAME The recurring report name.

    SI_SCHEDULEINFO.SI_STARTTIME The date and time the report is scheduled to run next.

    General Scheduled Report Information

    SELECT

    SI_NAME, SI_SCHEDULEINFO.SI_SUBMITTER,

    SI_PARENTID, SI_KIND, SI_NEXTRUNTIME,

    SI_PROCESSINFO.SI_DBNEEDLOGON,

    SI_PROCESSINFO.SI_LOGON_INFO,

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 44

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_PROCESSINFO.SI_PROMPTS,

    SI_PROCESSINFO.SI_RECORD_FORMULA,

    SI_FORMAT_INFO, SI_DEPENDENCIES

    FROM

    CI_INFOOBJECTS

    WHERE

    SI_ID = Report ID

    The query above returns the most common properties for a scheduled report.

    Name Definition SI_NAME The scheduled report name.

    SI_SCHEDULEINFO.SI_SUBMITTER

    The user who submitted the scheduled report.

    SI_PARENTID The reports parent SI_ID.

    SI_KIND The export format the report is to be scheduled to.

    SI_NEXTRUNTIME The date and time the report will run next.

    SI_PROCESSINFO.SI_DBNEEDLOGON

    Returns True if the reporting database requires a database logon.

    SI_PROCESSINFO.SI_LOGON_INFO

    Lists the database logon information as well as the database driver used to process the report.

    SI_PROCESSINFO.SI_PROMPTS

    Lists the report parameter information.

    SI_PROCESSINFO.SI_RECORD_FORMULA

    This property is a text value that stores the selection formula used to retrieve, and filter, records from the database.

    SI_FORMAT_INFO The options that have been set in the report for exporting to different format types.

    SI_DEPENDENCIES The collection of dependency events that the object waits for before being triggered. Values returned are the unique SI_ID values of the events the report depends upon.

    To return the names of the events, run the following query using the SI_DEPENDENCIES values.

    SELECT

    SI_NAME

    FROM

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 45

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND = ‘event’

    Servers Servers Registered with the CMS SELECT

    SI_DISABLED, SI_NAME, SI_SERVER_KIND,

    SI_SERVER_IS_ALIVE, SI_FRIENDLY_NAME,

    SI_SERVER_NAME, SI_NTSERVICE_NAME,

    SI_REGISTER_TO_APS

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND = 'server'

    The query above will return the current status of all the Enterprise XI Release 2 Servers registered with the CMS by specifying the following information:

    Name Definition SI_NAME The name of the XI Release 2 Server.

    SI_DISABLED Returns FALSE if the server is enabled.

    SI_SERVER_KIND Specifies the type of server that is registered with the CMS.

    SI_SERVER_IS_ALIVE Returns True if server is alive (running).

    SI_FRIENDLY_NAME The servers friendly name as specified in the Command line –name switch for each server in the Central Configuration Manager.

    SI_SERVER_NAME The name of the host (machine) where the server is running.

    SI_NTSERVICE_NAME The Windows NT operating system's service name.

    SI_REGISTER_TO_APS Returns True if the server has successfully registered with the CMS name service, and False otherwise.

    Current CMS Load SELECT

    SI_APS_LOAD

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 46

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND='Server' and SI_SERVER_KIND = 'APS'

    The query above returns the current number of users connected to the CMS.

    Listing CMS Members in the Cluster SELECT

    SI_CLUSTER_MEMBERS

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_ID = 4

    Server IOR (Interoperable Object Reference) SELECT

    SI_NAME, SI_SERVER_KIND, SI_SERVER_IOR

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND ='server'

    The above query returns the IOR (Interoperable Object Reference) for each server. The CMS keeps track of each registered server IOR for communication. In general terms, the IOR is a data structure associated with a CORBA object that contains enough information to locate that object from anywhere on the network. For XI Release 2 servers the IOR includes, among other things, the port and host name of the server.

    The encrypted string can be decrypted through an internal command line utility.

    Authentication Authentication Used to Logon SELECT

    SI_NAME, SI_AUTHEN_METHOD

    FROM

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 47

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    CI_SYSTEMOBJECTS

    WHERE

    SI_KIND='Connection'

    The query above returns the currently logged on users in the Enterprise system and the authentication type used.

    Name Definition SI_NAME The user name.

    SI_AUTHEN_METHOD The authentication type used to logon to the Enterprise system.

    Authentication Plug-in Information

    SELECT

    SI_NAME, SI_MAPPED_GROUPS, SI_DEFAULT_DOMAIN,

    SI_AVAIL, SI_SSO_ENABLED

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_NAME IN ('secWinAD', 'secEnterprise', 'secLDAP', 'secWindowsNT')

    The query above will return the authentication groups mapped into the Enterprise system.

    Name Definition SI_NAME The authentication type.

    SI_MAPPED_GROUPS Returns the SIDs of the mapped in AD or NT groups. LDAP groups return the LDAP group name.

    SI_DEFAULT_DOMAIN The default domain specified in the authentication tab of the CMC.

    SI_AVAIL Indicates whether the authentication plug-in is available or not.

    SI_SSO_ENABLED Returns TRUE if Single Sign-On is enabled.

    LDAP Configuration Information

    SELECT

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 48

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_NAME, SI_MAPPED_GROUPS, SI_HOST_AND_PORT,

    SI_APS_ADMIN_DN, SI_BASE_DN, SI_AVAIL,

    SI_SSL_SERVER_AUTH_STRENGTH, SI_SSO_ENABLED,

    SI_LDAP_SERVER_TYPE

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_NAME = 'secLDAP'

    The query above will return the configuration settings for the LDAP server.

    Name Definition SI_NAME The LDAP plug-in name

    SI_AVAIL Indicates whether or not LDAP authentication is available.

    SI_MAPPED_GROUPS Returns the mapped in LDAP group names.

    SI_HOST_AND_PORT The host and port numbers used to connect to the LDAP server.

    SI_APS_ADMIN_DN The LDAP server administration distinguished name.

    SI_BASE_DN The Base LDAP distinguished name.

    SI_SSO_ENABLED Returns True if enabled.

    SI_LDAP_SERVER_TYPE The LDAP server yype.

    SI_SSL_SERVER_AUTH_STRENGTH

    Indicates the server-side SSL strength. See available values and definitions in table below.

    Server-side SSL strength values table: Member Name Value Description

    ceWEAK 0 Accept the server's certificate.

    ceCert 1 Accept the server's certificate only if we trust the Certificate Authority who issued the certificate.

    ceCNCHECK 2 Accept the certificate only if we trust the Certificate Authority that issued the certificate, and the value of the CN attribute in the certificate is the DNS hostname of the server.

    ceNONE 3 SSL is not being used.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 49

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    The authentication strength options are:

    • ceWEAK

    • ceCert

    • ceCNCHECK

    • ceNONE

    CeWEAK does not require the client to trust the LDAP server's certificate authority (CA). Therefore, no configuration is needed for the cert7.db database. In the ceCert scenario, the client must trust the CA of the LDAP server's certificate. This requires that the LDAP server CA's certificate is added to the cert7.db database. The ceCNCHECK option requires that the client must trust the CA of the LDAP server's certificate, and the CN attribute of the LDAP server's certificate matches its DNS hostname. In order to accomplish this, the LDAP server CA's must be added to the cert7.db, and the LDAP server must trust the client's certificate.

    Windows AD Configuration Information SELECT

    SI_NAME,SI_AVAIL, SI_MAPPED_GROUPS,

    SI_DEFAULT_DOMAIN, SI_APS_ADMIN_DN,

    SI_SSO_ENABLED, SI_KERBEROS_ENABLED,

    SI_CACHE_SECCONTEXT, SI_SERVER_SSPI_SPN

    FROM

    CI_SYSTEMOBJECTS

    WHERE

    SI_NAME = 'secWinAD'

    The query above returns the Windows AD configuration within the XI Release 2 system by specifying the following information:

    Name Description SI_NAME Windows AD plug-in name.

    SI_AVAIL Indicates whether or not the AD plug-in is available.

    SI_MAPPED_GROUPS The SID of the mapped in AD group.

    SI_DEFAULT_DOMAIN The Default Domain as specified in the AD tab in the CMC.

    SI_APS_ADMIN_DN The AD Administration Name.

    SI_SSO_ENABLED Returns True if Single Sign-On is enabled.

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 50

    bo_xi_r2_query_builder_training.pdf

  • BusinessObjects Query Builder XI Release 2 Internal: Query Builder Training

    SI_KERBEROS_ENABLED Indicates whether kerberos single sign-on is enabled. Returns True if enabled.

    SI_CACHE_SECCONTEXT This value indicates whether the security context for Kerberos authentication is cached. Returns True if enabled.

    SI_SERVER_SSPI_SPN Returns the Server Principle Name.

    Finding more information For more information and resources, refer to the product documentation and visit the support area of the web site at

    http://www.businessobjects.com/

    6/13/2007 10:42:00 AM Copyright © 2007 Business Objects. All rights reserved. Page 51

    bo_xi_r2_query_builder_training.pdf

    http://www.businessobjects.comhttp://www.businessobjects.com/

    OverviewContentsPrerequisitesQuery BuilderAccessing the Query BuilderQuery Builder Help FilesSELECT PropertiesInfoObject PropertiesProcessingInfo PropertiesSchedulingInfo PropertiesSystem Properties

    FROM Category (Enterprise SDK Tables)CI_INFOOBJECTSCI_SYSTEMOBJECTSCI_APPOBJECTS

    WHERE ConditionCMS Performance and Processing the WHERE ConditionUsing the TOP N function

    XI Release 2 Indexed PropertiesSI_CUIDSI_GUIDSI_HIDDEN_OBJECTSI_IDSI_INSTANCE_OBJECTSI_KIND and SI_PROGIDSI_NAMESI_NAMEDUSERSI_NEXTRUNTIMESI_OWNERIDSI_PARENTIDSI_PLUGIN_OBJECTSI_RECURRINGSI_RUIDSI_RUNNABLE_OBJECTSI_SCHEDULE_STATUSSI_UPDATE_TSSI_INSTANCE

    XI Release 2 Indexed Properties and Database EquivalenciesHow and When to use Direct Database QueriesCMS_INFOOBJECTS5.OBJECTIDCMS_INFOOBJECTS5.PARENTIDCMS_INFOOBJECTS5.OWNERIDCMS_INFOOBJECTS5.TYPEIDCMS_INFOOBJECTS5.SCHEDULESTATUSCMS_INFOOBJECTS5.NEXTRUNTIMECMS_INFOOBJECTS5.LASTMODIFYTIMECMS_INFOOBJECTS5.SI_INSTANCE_OBJECTCMS_INFOOBJECTS5.SI_NAMEDUSERCMS_INFOOBJECTS5.SI_RECURRING

    Query SamplesUser and GroupList All UsersList All GroupsLists Users Currently Logged On to Enterprise System

    Crystal ReportView Latest Instance ID of ReportRetrieve All Instances for a Report ObjectCounting the Number of Historical Instances for a ReportList Report ParameterFinding FRS Location for ReportReporting Database Logon Information

    Business View and Business View ConnectionsFinding What Business View a Report is UsingListing All Business ViewsReturn All Properties for a Business View by NameAll Reports Connected to a Specific Business ViewAll Business View Connections

    Universe and Universe ConnectionsListing All Universes and their Connection InformationReturn Web Intelligence Reports Connected to a Specific UnivCore and Derived Universe Information

    Web Intelligence ReportWeb Intelligence Report Universe ConnectionWeb Intelligence Report Parameter InformationWeb Intelligence Report and CACHE OutputView Latest Instance ID for Web Intelligence ReportRetrieve All Instances for Web Intelligence Report ObjectCounting the Number of Historical Instances for a Web IntellFinding FRS Location for Report

    Desktop IntelligenceDesktop Intelligence Universe Connection and Data ProvidersDesktop Intelligence Report Parameter InformationDesktop Intelligence Report and CACHE OutputView Latest Instance ID for Desktop Intelligence ReportRetrieve All Instances for the Desktop Intelligence Report OCounting the Number of Historical Instances for a Desktop InFinding FRS Location for Report

    License KeyLicense Keys and Product VersionLicensing Features Unlocked by Key Code

    SchedulingDetermining Report Scheduling StatusAll Recurring Scheduled ReportsGeneral Scheduled Report Information

    ServersServers Registered with the CMSCurrent CMS LoadListing CMS Members in the ClusterServer IOR (Interoperable Object Reference)

    AuthenticationAuthentication Used to LogonAuthentication Plug-in InformationLDAP Configuration InformationWindows AD Configuration Information

    Finding more information