User Guide Usig Caliber Datamart 11.1.0
Copyright 2013 Micro Focus. All Rights Reserved. Portios Copyright 1998-2009 Borlad Software Corporatio (a Micro Focus compay). All other marks are the property of their respective owers. CRM06-DMUG February 2012
Table of Cotets Chapter 1 Itroductio 1 Overview....................... 1 Micro Focus Support................. 1 Chapter 2 Cofigurig Databases ad Data Source Names 3 Cofigurig Microsoft Access............. 3 Cofigurig Microsoft SQL Server.......... 4 Cofigurig a Userid ad Password i Caliber.. 4 Cofigurig MS SQL Server............ 4 Cofigurig a System Data Source Name (DSN). 5 Cofigurig Oracle Server.............. 6 Multi-Extractio Namig Covetios......... 6 Chapter 3 Datamart 7 Overview....................... 7 Datamart Cofigurator................ 8 Datamart Extractor.................. 9 Datamart Extractor Recommedatios...... 11 Schedulig Datamart Extractios......... 11 Datamart Sychroizer................ 12 Chapter 4 Usig BusiessObjects 15 Overview....................... 15 Cofigurig the BusiessObjects DSN........ 15 For Microsoft Access............... 15 For Microsoft SQL Server............. 16 Cofigurig the Datamart Uiverse Locatio..... 17 Ruig a Simple Report............... 17 Chapter 5 Reports 19 Overview....................... 19 Attribute Distributio................. 19 Impact Aalysis.................... 20 Project Scorecard................... 20 Requiremet Volatility................. 20 Status Summary................... 20 Traceability Complexity................ 21 User Deploymet................... 21 Appedix A Uiverse Parameters 23 Requiremet Reports Class.............. 23 Admiistratio Reports Class............. 26 Glossary Class.................... 28 Appedix B Report Samples 29 Appedix C Datamart Restrictios 33 Documet Refereces................ 33 Reportig Domais................. 33 List of Values.................... 34 Requiremet Types ad Projects.......... 35 Security o Groups................. 35 Users i Groups................... 35 Relatioal Database Restrictios.......... 35 User-Defied Attributes.............. 36 Appedix D Glossary 37 Idex 39 i
ii
Chapter Chapter 1Itroductio Overview Micro Focus Support Datamart is a requiremets-based decisio support system that extracts data from the Caliber operatioal repository ito a relatioal database, trasforms that data, ad loads it ito a relatioal database. The robust query ad aalysis capabilities of Datamart are compatible with various reportig tools from leadig busiess itelligece software vedors (for example, BusiessObjects, Crystal Reports). The Datamart icludes the Datamart Extractor, the Datamart Cofigurator, ad the Datamart Sychroizer. It also provides three BusiessObjects uiverses ad two templates. You ca use this reportig tool or aother reportig tool. Datamart extracts data from the Caliber operatioal database, trasforms the data, ad the loads it ito a relatioal database where you ca access it usig a reportig tool. Micro Focus offers a variety of support optios. These iclude free services o the Iteret, where you ca search our extesive iformatio base ad coect with other users of Micro Focus products. I additio, you ca choose from several categories of support, ragig from istallatio support to fee-based cosultat-level support ad extesive assistace. For more iformatio about Micro Focussupport services, go to http://supportlie.microfocus.com. Whe cotactig support, be prepared to provide complete iformatio about your eviromet, the versio of the product you are usig, ad a detailed descriptio of the problem. For support o third-party tools or documetatio, please cotact the vedor of the tool. I additio to this documet, you ca fid more detailed iformatio o how to create reports i your reportig tool documetatio. Chapter 1: Itroductio 1
2 CaliberRM Datamart User Guide
Chapter 2Cofigurig Databases ad Chapter Data Source Names Before you ca begi usig the Datamart, you must first create ad cofigure a data source ame (DSN) ad a database o the server the Datamart resides, if: durig the istallatio process, you chose ot to create a MS Access DSN ad database, you eed to create aother MS Access database ad DSN, you wat to use a Microsoft SQL Server database, or you wat to use a Oracle database. Cofigurig Microsoft Access There are two steps to cofigurig Microsoft Access: creatig a DSN, which also selects or creates the database To cofigure MS Access: 1 O the machie that will ru the extractio program, select Start > Settigs > Cotrol Pael>Admiistrative Tools from the Widows Start meu. 2 Double-click o Data Sources (ODBC). Note: Skip Cotrol Pael for Widows 2003; skip Settigs for Widows XP. 3 Select the System DSN tab. 4 Click Add. The Create New Data Source dialog box is displayed. 5 Select Microsoft Access Driver (*.mdb) from the list ad click Fiish. The ODBC Microsoft Access Setup dialog box is displayed. 6 Eter a ame ad descriptio for the DSN. Note: Borlad recommeds RMMSA. See the sectio Multi-Extractio Namig Covetios o Datamart o Page 7 for iformatio o structure ad amig covetios for multiple extractios. Chapter 2: Cofigurig Databases ad Data Source Names 3
7 To create a ew database, click Create. The New Database dialog box is displayed. Go to Step 8. OR To ope a existig database, click Select. The Select Database dialog box is displayed. Select the MS Access file ad click OK. Go to Step 10. 8 Eter a ame for the.mdb file ad avigate to the locatio you wat to save the file. Note: Borlad recommeds you save it i a sub-folder i the Datamart directory. 9 Click OK to exit the New Database dialog box. 10 Click OK to exit the ODBC Microsoft Access Setup dialog box. 11 Click OK to exit the Create New Data Source dialog box. Your DSN ad database are created. Proceed to page 7 for iformatio o cofigurig the Datamart. Cofigurig Microsoft SQL Server There are three steps to cofigurig Datamart for Microsoft SQL server: cofigurig a user id ad password i the Caliber Admiistrator, cofigurig the MS SQL server, ad cofigurig the data source ame (DSN). Cofigurig a Userid ad Password i Caliber 1 I the Caliber Admiistrator, create a ew user specific to Datamart. Note: The User ID ad Password eed to match the user id ad password i the MS SQL server exactly. 2 O the Group Membership tab, assig the user to a group. 3 O the Password tab, assig the user a password. Note: The User ID ad Password are case sesitive. 4 Select View > Projects to display project iformatio. O the Group Assigmet tab, assig the user to the group(s) ad project(s) that you are goig to extract. 5 Click the Save butto to save the project. For more detailed istructios for creatig a Caliber user, see Caliber User Guide. Cofigurig MS SQL Server 1 Select Start > Programs > Microsoft SQL Server from the Widows Start meu to ope the Eterprise Maager. 2 Create a database i MS SQL Server. Note: If you are usure about how to create a SQL Server database, cosult your Microsoft SQL Server documetatio or SQL Server Admiistrator. 3 Create a SQL Server Logi (user) i SQL Server that matches the user created i Caliber (same User ID ad Password). Note: If you are usure about how to create a MS SQL Server Logi, cosult your Microsoft SQL Server documetatio or MS SQL Server Admiistrator. 4 CaliberRM Datamart User Guide
Note: The User ID ad Password are case sesitive. 4 O the Database Access tab, esure that the MS SQL Server user has public ad db_ower access i the Database roles for sectio. Note: For more detailed istructios for creatig a MS SQL Server user, see your Microsoft documetatio or MS SQL Server Admiistrator. 5 Click OK. The user ad database are created. 6 Exit the MS SQL Server Eterprise Maager. Cofigurig a System Data Source Name (DSN) The system Data Source Name selects which database Caliber extracts. To create a system DSN: 1 O the machie that will ru the extractio program, select Start > Settigs > Cotrol Pael>Admiistrative Tools from the Widows Start meu. 2 Double-click o Data Sources (ODBC). Note: Skip Cotrol Pael for Widows 2003; skip Settigs for Widows XP. 3 Select the System DSN tab. 4 Click Add. The Create New Data Source dialog box is displayed. 5 Select SQL Server from the list ad click Fiish. The Create a New Data Source to SQL Server scree is displayed. 6 Eter a Name, Descriptio ad select the SQL Server to which you wat to coect. This should be the server that cotais the SQL database. Note: Borlad recommeds RMMSSQL as a ame. See the sectio Multi-Extractio Namig Covetios for iformatio o structure ad amig covetios for multiple extractios. Note: For MS SQL Server, the DSN ame must iclude the letters SQL. 7 Click Next. 8 Select the With SQL Server autheticatio... optio butto. 9 Click the Cliet Cofiguratio butto. The Add Network Library Cofiguratio dialog box is displayed. 10 I the Network libraries sectio, make sure the TCP/IP optio butto is selected. 11 Click OK. 12 Eter the userid ad password that you created for Caliber ad the MS SQL Server. 13 Click Next. 14 Select the Chage the default database to check box, ad select the SQL database from the list. 15 Click Next. 16 Click Fiish. The ODBC Microsoft SQL Server Setup dialog box is displayed. 17 Click Test Data Source. Whe the test is complete, click OK. Note: If the test does ot respod, check with your MS SQL Server admiistrator to esure the SQL Server is set up properly. 18 At the last setup box select OK, ad at the ODBC box, select OK. Your system DSN is created. See Datamart o page 7 for iformatio o cofigurig the Datamart. Chapter 2: Cofigurig Databases ad Data Source Names 5
Cofigurig Oracle Server Sice Datamart accesses Oracle server usig a TNS service ame that specifies the locatio of the Oracle database, o special cofiguratio from Datamart is required. You eed to istall ad cofigure a Oracle cliet o the machie where Datamart is already istalled. Note: It is importat that you specify the correct TNS ame durig the Oracle cliet istallatio. Refer to your Oracle documetatio or cotact your system admiistrator for support. After the istallatio is complete, you eed to obtai a valid user ame ad password from your system admiistrator to access the Oracle server. Multi-Extractio Namig Covetios It is recommeded that you follow the followig structure ad amig covetios for multiple Datamart extractios. First Extractio Secod Extractio Third Extractio Extractio Name Access SQL Access SQL Access SQL Access SQL *.ii file RMMSA RMMSSQL RMMSA2 RMMSSQL2 RMMSA3 RMMSSQL3 RMMSA RMMSSQL System DSN RMMSA RMMSSQL RMMSA2 RMMSSQL2 RMMSA3 RMMSSQL3 RMMSA RMMSSQL Uiverse file RMMSA.uv RMMSSQL.uv RMMSA2.uv RMMSSQL2.uv RMMSA3.uv RMMSSQL3.uv RMMSA.uv RMMSSQL.uv First Extractio Secod Extractio Third Extractio Extractio Name Access SQL Access SQL Access SQL Access SQL *.mdb file RMMSA.mdb N/A RMMSA2.mdb N/A RMMSA3.mdb N/A RMMSA.mdb N/A SQL database.bat file (commad file)* Coectio Name (i Uiverse) N/A RMMSSQL N/A RMMSSQL2 N/A RMMSSQL3 N/A RMMSSQL RMMSA RMMSSQL RMMSA2 RMMSSQL2 RMMSA3 RMMSSQL3 RMMSA RMMSSQL RMMSA RMMSSQL RMMSA2 RMMSSQL2 RMMSA3 RMMSSQL3 RMMSA RMMSSQL 6 CaliberRM Datamart User Guide
Chapter Chapter 3Datamart Overview The Datamart extracts data from a Caliber repository, trasforms that data ad loads it ito a relatioal database. You ca ru the Datamart program from a commad prompt or usig a batch file. The Datamart is comprised of three compoets: Datamart Cofigurator: a wizard that eables you to create or edit a cofiguratio file for the Datamart Extractor to use Datamart Extractor: the compoet of the Datamart that extracts the data Datamart Sychroizer: a behid-the-scees module of the Datamart that keeps the objects i the Datamart uiverse sychroized with the user-defied attributes (UDAs) i Caliber. Program Datamart Cofigurator Type of Program Iput Output Wizard-based Selectio: Caliber projects, A *.ii file (* = the file ame) baselie iformatio, choice to extract history, traceability or discussios Datamart Extractor Commad-lie 1. The file ame.ii, the Data Source Name (DSN) that poits to the database ad the server that holds the database (MS Access ad SQL Server specific) 2. The file ame.ii, the TNS service ame that poits to the locatio of the Oracle database ad the server that holds the database (Oracle specific) A loaded MS Access, SQL Server, or Oracle database Chapter 3: Datamart 7
Program Datamart Sychroizer Type of Program Iput Output Commad-lie 1. The uiverse ame ad the DSN (MS Access ad SQL Server specific) 2. The uiverse ame ad the TNS service ame (Oracle specific) A updated uiverse with UDAs from Caliber (RMMSA.uv, RMMSSQL.uv, or RMORA.uv) Datamart Cofigurator To to create or edit a cofiguratio file: 1 Select Start > Programs > Borlad Caliber > Admiistratio > Datamart. The first step of the Caliber Datamart Cofiguratio Wizard displays. To create a ew cofiguratio file, select the Create a ew cofiguratio file optio butto. OR To ope a existig cofiguratio file, select the Ope a existig cofiguratio file optio butto. Click the Browse butto to avigate to the locatio of the file you wat to use. Click Next. 2 Eter the Caliber server Host that cotais the iformatio you wat to export, your User ame ad Password. Click Next. Note: Click Back to chage ay optios o the previous scree if ecessary. Click Cacel to ed the process without savig ay chages. 3 Select the check box beside the baselies you wat to export. If you chose to create a ew file, the curret baselie versios are selected. If you chose to use a existig cofiguratio file, the baselies icluded i that file are automatically selected. Click Next. Note: Select All Projects if you wat to export the curret baselies of all projects. 4 Select the check box ext to the objects you wat to export. If you chose to use a existig cofiguratio file, the objects icluded i that file are automatically selected. Click Next. 5 Step 5 of the Datamart Cofiguratio Wizard provides a preview of the cofiguratio file you are about to create. 6 Click Fiish. I the Save As dialog box, avigate to the locatio i which you wat to save the cofiguratio file. Eter a ame for your file. Note: Please read the sectio Multi-Extractio Namig Covetios o page 6 for iformatio o structure ad amig covetios for more tha oe extractio. 7 Click Save. The cofiguratio file is saved as a *.ii. file. Note: It is recommeded that you save it i a subfolder i the Datamart directory. 8 CaliberRM Datamart User Guide
Datamart Extractor The Datamart Extractor is the program that exports the data. It is a commad lie executable that accepts argumets for specifyig a cofiguratio file, loggig optios, a data source ame, server ame or sytax help. The Extractor program loads plai text ito the database s descriptio field. The Extractor program ca export icremetal chages sice the last extractio. This requires that a full extractio has to have bee performed o the database first. Oce a full extractio has bee performed, a idicator is added to the cofigfile.ii to show the last date ad time that the extractio was ru o that database. This allows you to use differet cofigfile.ii files to retrieve data from differet projects ad baselies ad still keep track of the last updated date ad times for the differet extractios. You ca also copy the.ii file to a differet computer to perform the extractio ad keep track of the last update date ad times o differet machies. The sytax is: Extractor.exe [parameters] -c cofigfile.ii specifies the cofiguratio file; required -l turs o loggig; optioal -d 1. dsame specifies data source ame for MS Access ad SQL Server 2. TNS ame specifies Oracle server locatio for Oracle; required -s 1. server ame cotaiig the MS SQL Server database; required 2. oracle specifies Oracle as a database server; required -? displays the sytax -log extracts text fields o-trucated; optioal, for Oracle oly -dbu -dbp -oextraces -update specifies the Oracle user ame; optioal, applies oly if Oracle user ame differs from Caliber user ame specified i the *.ii file specifies the Oracle user password; optioal; applies oly if Oracle user password differs from Caliber user password specified i the *.ii file turs off extractig exteral traces icremetally extracts data modified sice the last date of the last extractio; Note: cofigfile.ii is required to perform icremetal updates. Chapter 3: Datamart 9
The sytax is: -depth Specifies the depth of direct ad implied traces to be extracted. Set this parameter to a umerical value. The followig example shows three requiremets traced to each other. ReqA > ReqB > ReqC Settig the depth parameter affects the types of traces extracted, as the followig list shows: 1 = Oly direct traces are extracted (ReqA>ReqB, ReqB>ReqC). 2 = Direct ad implied traces are extracted (ReqA>ReqB, ReqB>ReqC, ReqA>ReqC) Note: The default value for this parameter is 0. All direct ad implied traces are extracted by default. Importat! Whe usig MS SQL database, the Caliber user that extracts the data must have a idetical userid with permit i database: public, db_ower, ad bulkadmi roles i the MS SQL Server. MS SQL Server has a limit of how much data ca be iserted ito a row. The followig registry keys are available to cotrol the row size. The keys are placed o the server ruig the Datamart Extractor uder \HKEY_CURRENT_USER\Software\Borlad\ Extractor\Settigs. These keys are for MS SQL Server ad MS Access. Registry Keys Type Default Fuctio MultiSelectColumSize DWORD 128 Cotrols the amout of data iserted i the UDAs MSL, MSGL & MSUL. DescriptioColumSize DWORD 4000 (also the maximum) Cotrols the amout of data iserted i the descriptio field. MultiLieColumSize DWORD 2048 Cotrols the amout of data i the UDA MLTF. ValidatioColumSize DWORD 512 Cotrols the amout of data iserted i the validatio field. Importat! Whe usig Oracle database, Caliber RM Datamart requires that you specify the Oracle value for the -s parameter. There is a limit to how may symbols you ca isert ito a text field. By default all text fields are trucated by 1999 characters uless you use the -log parameter. Note that usig the -log parameter is ot recommeded if you pla to use a reportig tool that does ot support NCLOB data type (for example, BusiessObjects). Examples of Datamart Extractor Commad Lie Iterface EXTRACTOR -c cofigfile.ii -d RMMSA EXTRACTOR -c cofigfile.ii -l -d RMMSA Extractor -? EXTRACTOR -c cofigfile.ii -l -d RMMSSQL -s sqlserver EXTRACTOR -c cofigfile.ii -log -d oracletsame -s oracleserver -dbu oracle userame -dbp oracle userpassword Rus Extractor.exe ad reads the cofiguratio from the file cofigfile.ii. Rus Extractor.exe ad reads the cofiguratio from the file cofigfile.ii. Turs o loggig. Uses the data source amed RMMSA. Displays the Extractor.exe sytax. Rus Extractor.exe ad reads the cofiguratio from the file cofigfile.ii; loggig is o ad the server is specified. Rus Extractor.exe ad reads the cofiguratio from the file cofigfile.ii. Fields are extracted o-trucated. Uses the Oracle et service amed oracletsame, the server, user, ad password specified. 10 CaliberRM Datamart User Guide
Examples of Datamart Extractor Commad Lie Iterface EXTRACTOR -c cofigfile.ii -d RMMSA -oextraces EXTRACTOR -c cofigfile.ii -d RMMSA -update Rus Extractor.exe, reads the cofiguratio from the file cofigfile.ii ad does ot extract ay exteral traces. Rus Extractor.exe, reads the cofiguratio from the file cofigfile.ii ad performs icremetal update. Datamart Extractor Recommedatios Borlad recommeds the followig to optimize your extractor performace ad usage: Extract requiremets or requiremets with traces data oly ad tur loggig off to icrease the speed of the extractio. If History ad Discussio are eeded, cosider a less frequet separate extractio (ito aother database) cotaiig data from those optios. Place the output database (MS Access, MS SQL Server, or Oracle) o the Caliber server machie ad ru the extractio durig off peak hours to avoid etwork traffic. Review the sectio System Requiremets i the Caliber Release Notes for server recommedatios for this cofiguratio. Use MS Access to optimize the display (up to 8,000 characters ca be stored i the descriptio ad multi-lie text attribute fields.) Do ot extract projects that are empty. The extractio time is impacted by the umber of projects extracted iclude those with o requiremets. Extract icremetal chages oly provided the list of UDA types is preserved. Datamart performace ca be ehaced by usig temporary text files to load iformatio ito the relatioal databases. The size of the files is approximately equal to the size of the extracted database. You must esure you have eough hard drive space for the temporary files. The files are created i the directory from which you ru the extractor. Upo successful extractio, the files are automatically removed. To leverage this Microsoft ad Oracle recommeded optio: For Oracle: Iclude the -sqlldr commad optio. If you do ot iclude this optio, Datamart will ot use the temporary files. For Microsoft SQL Server: Esure that you grat the Datamart user the bulkadmi role i additio to the public ad db_ower roles. If the Microsoft SQL Server database ad Datamart reside o differet machies, you must complete the followig steps: 1 The perso resposible for the etwork security must create a shared folder o the computer where Datamart is istalled ad esure that the Microsoft SQL Server user is grated read-oly access rights to this folder. 2 Add the -path optio to the commad specifyig the path to the folder created i Step 1. For example, -path "C:\Program Files\bulkdata". The temporary files will be placed i this folder. 3 Add the -share optio to the commad specifyig the same folder i UNC format. For example, -share "\\MyComputer\bulkdata" where MyComputer is the computer ame where the shared folder is located ad bulkdata is the ame of the share. Schedulig Datamart Extractios To schedule the extractios usig stadard Widows Scheduled Task Wizard, perform the followig: Chapter 3: Datamart 11
1 Start Scheduled Task Wizard from the Start meu. Click Next o the first scree. 2 O the ext scree, click Browse ad locate the Datamart Extractor Executable (Extractor.exe). 3 Specify the ame of the scheduled task ad ru iterval. Click Next. 4 Select the start time ad date. Click Next. 5 Specify the autheticatio iformatio for the task. Click Next. 6 Select Ope advaced properties for this task whe I click Fiish ad click Fiish. 7 I the Ru field of the tasks advaced properties dialog box, specify ecessary parameters for the Extractor.exe file. For example: "C:\Program Files\Borlad\Caliber\extractor.exe" -c "C:\Program Files\Borlad\Caliber\ Datamart\CofiguratioFile.ii" -s oracle -d dmart4rm.itra.serverexact.com -sqlldr - dbu DatabaseUser -dbp DatabasePassword -l -oextraces Alteratively, you ca create a batch file with ecessary parameters for Extractor.exe ad schedule batch file executio. Notes: If the data you wat to extract cotais traces to or from StarTeam, Caliber tries to log o to the ecessary StarTeam server usig credetials stored o the curret computer. Make sure the StarTeam Toolbar is ruig or log o at least oce to your StarTeam server to acquire a trace i the Caliber to store logo iformatio o the computer. To perform silet extractio of traces to or from Quality Ceter, select the Make default credetials optio while loggig o to Quality Ceter. To chage the default credetial, delete the HKEY_CURRENT_USER\Software\ Borlad\Caliber\qc_auth" registry key ad log agai i Quality Ceter. Datamart Sychroizer The Datamart Sychroizer keeps the user-defied attribute (UDA) objects i the Datamart uiverse sychroized with the UDAs i Caliber. The Datamart Sychroizer is a behid-the-scees program that you should ru after the Datamart is ru. You should ru it oce, ad the oly after a user-defied attribute is created, modified or deleted i Caliber. The Datamart Sychroizer rus idepedetly usig the commad prompt. The sytax is: Sychroizer.exe [parameters] -u Uiverse Name specifies which BusiessObjects uiverse to sychroize if you selected BusiessObjects as a reportig tool -d 1. DSN specifies the data source ame to the database with which it is sychroized for MS Access ad SQL Server 2. TNS specifies the TNS service ame to the database with which it is sychroized for Oracle - User Name your reportig tool (for example, BusiessObjects) user ame; the default user ame is (CaliberPRO User); optioal; oly used whe a BusiessObjects security model is used 12 CaliberRM Datamart User Guide
The sytax is: -p Password your reportig tool (for example, BusiessObjects) password; default is (Aalytics); optioal, oly used whe a BusiessObjects security model is used -? Displays the sytax -s Server type specifies the Oracle database (the oracle value); required, for Oracle oly -dbu -dbp Oracle user ame; reqiured whe usig a Oracle database (for Oracle oly Oracle user password; reqiured whe usig a Oracle database (for Oracle oly) Examples of Datamart Sychroizer Commad Lie Iterface SYNCHRONIZER -u RMMSA -d RMMSA SYNCHRONIZER -u RMMSSQL -d DSN=RMMSSQL;UID=userame;p wd=password SYNCHRONIZER -u RMORA -s oracle -d ts_ame -dbu oracleuser -dbp oraclepassword MS Access example; sychroizes the uiverse RMMSA ad specifies the data source RMMSA. MS SQL Server example; sychroizes the uiverse RMMSSQL ad specifies the data source RMMSSQL, the user ame UID, ad the password. Note that spaces are ot allowed withi the value specified (for example, the optio -d is followed by a space while o spaces are allowed withi the DSN=RMMSSQL;UID=userame;pwd=password value) Oracle example; sychroizes the uiverse RMORA ad specifies the server oracle, the oracle TNS service ame ts_ame, the user ame for Oracle oracle User, ad the password for Oracle oraclepassword Importat! Whe usig BusiessObjects as a reportig tool, you must complete the followig steps oce for each uiverse file before ruig the Datamart Sychroizer. 1 Select Start > Programs > Busiess Objects > Desiger to Lauch BusiessObjects Desiger. Note: If the Desiger Wizard lauches, click Cacel. 2 Select File > Ope. The Ope dialog box is displayed. Navigate to where you istalled BusiessObjects ad select the uiverse you wat to work with (RMSSA for MS Access, RMMSSQL for MS SQL Server, or RMORA for Oracle). 3 Click Ope. The uiverse is displayed. 4 Select File > Parameters. O the Defiitio tab, locate ad ote the Coectio ame. The click the Edit butto ad locate ad ote the Data Source Name for MS Access ad MS SQL Server, or the User ame, Password, ad Service for Oracle. 5 Click OK. 6 If you wat to do a multi-extractio that Datamart supports for MS Access ad MS SQL Server, chage the coectio ame ad select the correspodig DSN. Otherwise, click OK agai. Note: See the sectio Multi-Extractio Namig Covetios o page 6 for more iformatio o structure ad amig covetios for multi-extractios. Note: If the coectio user ame ad password are filled i, take ote of them. You will eed them i Step 10. Chapter 3: Datamart 13
7 Select Tools > Coectios. The Coectios dialog box is displayed. Note: If the coectio ame oted i Step 4 appears i the Coectios dialog box, go to Step 14. 8 Click Add. The New Coectio Wizard lauches. 9 Click Next. Select the Data Access Driver. 10 Click Next. Specify the logi parameters to access your middleware. 11 Click Next. The Perform a test step of the Wizard is displayed. Review all the coectio details. 12 Click Next. Specify the advaced parameters to access your middleware. 13 Click Next. Defie the custom parameters to access your middleware. 14 Click Fiish. The Coectios List step of the Wizard is displayed. 15 Click Fiish. You may ow ru the Datamart Sychroizer. 14 CaliberRM Datamart User Guide
Chapter 4Usig BusiessObjects Chapter Overview Importat! BusiessObjects is a reportig tool that eables you to create queries based o Caliber uiverses that are cotaied o the product CD ad loaded with the product. Before ruig BusiessObjects, you must: cofigure the BusiessObjects DSN for MS Access ad MS SQL Server Note: For Oracle oly. You do ot eed a DSN cofigured for a Oracle database. Oly a ew coectio is required so that BusiessObjects ca access the Oracle database. Go to page 11 for more detailed istructios for creatig a coectio i BusiessObjects Desiger. cofigure the BusiessObjects Uiverse locatio ru a Simple Test Report read the followig istructios. Note: The user must be a member of the Power User or Admiistrator s group to ru Datamart. Note: For details o how to use BusiessObjects, please refer to your BusiessObjects documetatio. Cofigurig the BusiessObjects DSN For Microsoft Access The system DSN allows BusiessObjects to access the data i the MS Access database. 1 O the machie that will ru the extractio program, select Start > Settigs > Cotrol Pael>Admiistrative Tools from the Widows Start meu. 2 Double-click o Data Sources (ODBC). Chapter 4: Usig BusiessObjects 15
Note: Skip Cotrol Pael for Widows 2003; skip Settigs for Widows XP. 1 Select the System DSN tab. 2 Click Add. 3 Select Microsoft Access Driver (*.mdb) from the list. 4 Click Fiish. The ODBC Microsoft Access Setup dialog box is displayed. 5 Cotact your Datamart Admiistrator for the DSN ame used o the Datamart machie. Eter that as the Data Source Name. Note: Borlad recommeds RMMSA. See the sectio Multi-Extractio Namig Covetios o page 6 for iformatio o structure ad amig covetios for multiple extractios. 6 Click Select. The Select Database widow is displayed. 7 I the Directories sectio, avigate to the MS Access database. Select it from the list ad click OK. Note: This may require that you map a etwork drive to the Datamart machie. 8 Click OK to exit the ODBC Microsoft Access Setup dialog box. 9 Click OK to exit the ODBC Data Source Admiistrator dialog box. The DSN is created. Proceed to the sectio Cofigurig the Datamart Uiverse Locatio o page 17. For Microsoft SQL Server The system DSN allows BusiessObjects to access the data i the MS SQL Server database. 1 O the machie that will ru the extractio program, select Start > Settigs > Cotrol Pael>Admiistrative Tools from the Widows Start meu. 2 Double-click o Data Sources (ODBC). Note: Skip Cotrol Pael for Widows 2003; skip Settigs for Widows XP. 3 Select the System DSN tab. 4 Click Add. 5 Select SQL Server from the list. Click Fiish. The Create a New Data Source to SQL Server wizard is displayed. 6 Cotact your Datamart Admiistrator for the DSN ame used o the Datamart machie. Eter that as the Data Source Name. Note: Borlad recommeds RMMSASQL. See the sectio Multi-Extractio Namig Covetios o page 6 for iformatio o structure ad amig covetios for multiple extractios. For MS SQL Server, the DSN ame must iclude the letters SQL. Example: RMMSSQL 7 If you wat, eter a Descriptio for the data source. 8 Select the server that cotais the SQL database. 9 Click Next. The ext wizard scree is displayed. 10 Select the With SQL Server autheticatio... optio butto. 11 Click the Cliet Cofiguratio butto. The Add Network Library Cofiguratio dialog box is displayed. 12 Verify that the TCP/IP optio butto is selected ad click OK. 16 CaliberRM Datamart User Guide
13 Eter the user id ad password created for Caliber ad SQL Server. Note: If you do ot kow the user id ad password, ask your Datamart Admiistrator. 14 Click Next. The ext wizard scree is displayed. 15 Select the Chage the default database to: check box ad select the SQL database from the list. 16 Click Next. The ext wizard scree is displayed. 17 Click Fiish. A scree is displayed idicatig your cofiguratio settigs. 18 Click Test Data Source. Whe the test is complete, click OK. Note: If the test does ot respod, check with your SQL Server admiistrator to esure the SQL Server is set up properly. 19 Click OK to exit the cofiguratio settigs widow. 20 Click OK to exit the ODBC Data Source Admiistrator dialog box. The DSN is created. Go to Cofigurig the Datamart Uiverse Locatio that follows. Cofigurig the Datamart Uiverse Locatio You must cofigure BusiessObjects to poit to the uiverse folder that cotais the BusiessObjects uiverses. The uiverses are istalled with the Datamart. To cofigure the uiverse locatio: 1 Select Start > Programs > Busiess Objects > BusiessObjects from the Widows Start meu, to lauch BusiessObjects. Note: If the New Report Wizard is displayed, click Cacel. 2 Select Tools > Optios. 3 Select the File Locatio tab. 4 Select Uiverses from the File Types list. 5 Click Chage. 6 Navigate to the folder that cotais the BusiessObjects uiverses. The uiverses are istalled with Datamart. The default is (C:\Program Files\Borlad\Caliber Datamart\Uiverses\Busiess Objects). 7 Click OK. 8 Click OK to exit the Optios dialog box. BusiessObjects is ready to ru reports. However, you may wat to ru a simple report to verify everythig is cofigured properly. Ruig a Simple Report To ru a simple report: 1 I BusiessObjects, select File > New. The New Report Wizard is displayed. 2 Click Begi. 3 I the Specify Data Access scree, verify that the Uiverse optio butto is selected, ad click Next. 4 I the Available Uiverses list, select either MS Access, MS SQL Server, or Oracle Server. 5 Click Fiish. The Query Pael opes. Chapter 4: Usig BusiessObjects 17
6 Ope the Requiremets Reports folder. 7 Ope the Projects folder. 8 Refer to your BusiessObjects olie Help for further istructios. 18 CaliberRM Datamart User Guide
Chapter Chapter 5Reports Overview Attribute Distributio There is a series of pre-defied report templates that are icluded whe you istall the product. These report templates are iteded for use as the startig poit for developig more complete ad detailed reports. The stadard queries are defied below ad detailed further i the followig sectios. See Appedix B: Report Samples o page 29 for examples of these reports. Attribute Distributio: shows the way attributes are distributed throughout the repository Impact Aalysis: shows the umber of traces, both direct ad implied, related to a set of requiremets Project Scorecard: a umber-focused report that gives idicators to the overall soudess of a project(s) Requiremet Volatility: shows the umber of chages that are made to a requiremet withi a project(s) over time Status Summary: shows the umber of requiremets broke dow by project, baselie, requiremet type, status ad priority Traceability Complexity: shows the umber of traces that lik a user-defied umber of Top 10 requiremets withi projects ad Automated Software Quality (ASQ) applicatios User Deploymet: shows users assiged to a specific project(s) The Attribute Distributio report is primarily desiged for Caliber admiistrators. This report details the way attributes are distributed throughout the repository. It shows both the distributio of a attribute across projects as well as the attributes cotaied i each project. The data is broke dow by attribute, requiremet type ad project. The report shows a tabular ad a graphical represetatio of the data ad presets differet levels of detail o several differet tabs. It also shows which UDAs are ot used i ay of your projects. Chapter 5: Reports 19
Impact Aalysis Project Scorecard The Impact Aalysis report is primarily desiged for Project Maagers, Quality Maagers ad Chage Maagemet Assessors. This report shows the umber of traces, both direct ad implied, related to a set of requiremets both upstream ad dowstream. It also shows the types of elemets that the traces relate. The umber of traces are broke dow by project, baselie, requiremet type, status ad priority. Suspect traces are flagged ad the average depth of traces are show. The report presets the differet levels of detail of several tabs. The Project Scorecard report is a umbers-focused report that gives several idicators to the overall well-beig of your project(s). This report is desiged for Project Maagers ad Project Team Members. Data is available by project ad requiremet type ad is ru for the curret versio s baselie or other baselies, depedig o the data. This report cotais the followig idicators: Legth of trace chais (maximum, average) Number of requiremets broke dow by status ad total Number of requiremets broke dow by ower Number of requiremets broke dow by resposible perso Average legth of time from creatio to curret status broke dow by status. Total umber of suspect liks Requiremet Volatility Status Summary Total umber of requiremet s growth time, broke dow by year, moth ad week The Requiremet Volatility report is desiged primarily for Project Maagers ad Project Team Members. This report shows the umber of mior ad major chages that are made to a requiremet withi a project or projects over time. It shows the rate of chage as well as the cumulative total umber of chages. The data is broke dow by project, curret baselie, requiremet type, status, priority, ower ad requiremet ID. The data is further broke dow by year, moth, week ad day. The report shows a tabular ad a graphical represetatio of the data ad presets differet levels of detail o several differet tabs. The Status Summary report is desiged primarily for Developmet Maagers. This report shows the umber of requiremets broke dow by project, baselie, requiremet type, status ad priority. It shows the percetage of total requiremets represeted by each status i each project ad requiremet type. Its iformatio is preseted o several differet tabs. 20 CaliberRM Datamart User Guide
Traceability Complexity User Deploymet The Traceability Complexity report is desiged primarily for Project Maagers ad Project Team Members. It shows the umber of traces that lik to a user-defied umber of most frequetly observed requiremets withi ad betwee projects ad ASQ applicatios. It icludes upstream ad dowstream traces, as well as direct ad implied traces. It shows the type of object to or from which a requiremet traces. All data is grouped by project. The User Deploymet report is desiged for Project Maagers ad Caliber Admiistrators. It shows the users that are assiged to a specified project. The report also shows which users are assiged to a group ad the security profiles for each user, group ad project. Chapter 5: Reports 21
22 CaliberRM Datamart User Guide
Appedix AUiverse Parameters Appedix This appedix details the uiverse objects, icludig the object descriptio ad type, as they appear i the BusiessObjects query pael. Requiremet Reports Class These objects give iformatio about requiremet-cetric data. You must break dow the iformatio by project ad baselie if the Datamart has multiple projects ad baselies. The iformatio i these folders caot be combied i a queries with iformatio from the Admiistratio Reports or Glossary folders. Projects Class Object Descriptio Type / Qualificatio Project Name The ame of the Caliber project Character; Dimesio Descriptio The project's descriptio Log text; Detail TestDirector Itegratio Eabled Select Itegratio Eabled SCM Itegratio Eabled Security Eforced Requiremets Mapped Eabled Requiremets Shared Eabled A flag sigifyig whether the TestDirector itegratio is tured o or off (O=Eabled) A flag sigifyig whether the Select Eterprise itegratio is tured o or off (O=Eabled) A flag sigifyig whether the Source Code Maagemet itegratio is tured o or off (O=Eabled) A flag sigifyig whether security is tured o or off for the project (O=Eabled) A flag sigifyig whether a requiremet ca be mapped for the project (Yes=Mapped) A flag sigifyig whether a requiremet ca be shared for the project (Yes=Mapped) Character; Dimesio Character; Dimesio Character; Dimesio Character; Dimesio Character; Dimesio Character; Dimesio Number of Projects A cout of the umber of projects Number; Measure Appedix A: Uiverse Parameters 23
Baselies Class Object Descriptio Type / Qualificatio Baselie Name The baselie ame withi a Caliber project Character; Dimesio Descriptio The baselie's descriptio Log text; Detail Baselie locked A flag sigifyig whether the baselie is Character; Dimesio locked or ulocked Number of Baselies A cout of the umber of baselies Number; Measure Requiremet Types Class Object Descriptio Type / Qualificatio Requiremet Type Name The requiremet type ame withi a Character; Dimesio Caliber project Descriptio The requiremet type's descriptio Log text; Detail Tag The tag is a short ame of the requiremet Character; Dimesio type (6 character max) Number of Requiremet Types A cout of the umber of requiremet types Number; Measure Requiremets Class Object Descriptio Type / Qualificatio Hierarchy Caliber hierarchy umber. (1.0, 1.1, etc.) Character; Dimesio Hierarchy Idex A object that properly sorts the Hierarchy Number; Dimesio umber Requiremet Name The ame of the requiremet Character; Dimesio Requiremet ID The requiremet's uique umber Number; Dimesio Tag ID The combiatio of the Requiremet Type Character; Dimesio Tag ad Requiremet Uique Number Versio The actual versio of the requiremet Character; Dimesio Ower The perso that is defied i Caliber as the ower (last ame, first ame) of the requiremet Character; Dimesio Ower s User Name The ower s Caliber user ame Character; Dimesio Ower s Locatio The locatio of the ower Character; Dimesio Status The Status of the requiremet (System Character; Dimesio Attribute) Priority The Priority of the requiremet (System Character; Dimesio Attribute) Descriptio The Descriptio of the requiremet Log text; Dimesio Validatio A requiremet's validatio Log text; Dimesio Shared A flag sigifyig whether the requiremet is mapped from aother requiremet (Yes=Mapped) Character; Dimesio Shared From The requiremet is shared from this Number; Dimesio requiremet ID Number of requiremets A cout of uique requiremets Number; Measure Requiremet Traces Class Object Descriptio Type / Qualificatio Root ID The root requiremet's idetificatio Number; Dimesio umber Root Project Name The root requiremet's project ame Character; Dimesio Requiremet Traces Class, cot. 24 CaliberRM Datamart User Guide
Object Descriptio Type / Qualificatio Root Name The root requiremet's ame Character; Dimesio Root Descriptio The root requiremet's descriptio Log text; Dimesio Root Type The root requiremet's type (Requiremet, Character; Dimesio TestDirector, StarTeam, other, etc.) Root Ower The root requiremet's ower Character; Dimesio Root Test Status The root requiremet's status for Character; Dimesio Mercury's TestDirector Tests Trace ID The trace requiremet's idetificatio Number; Dimesio umber Trace Project Name The trace requiremet's project ame Character; Dimesio Trace Name The trace requiremet's ame Character; Dimesio Trace Descriptio The trace requiremet's descriptio Log text; Dimesio Trace Type The type of trace Character; Dimesio Trace Ower The trace requiremet's ower Character; Dimesio Trace Priority The trace requiremet's priority Character; Dimesio Trace Status The trace requiremet's status Character; Dimesio Trace Test Status The requiremet's status for Mercury's Character; Dimesio TestDirector Tests Directio The directio of the root/trace (to or from) Character; Dimesio Direct or Implied Sigifies whether the trace is direct or Character; Dimesio implied Circular A flag set that idicates a root/trace is i a Character; Dimesio circular path Suspect A flag set that idicates a root/trace is Character; Dimesio suspect Depth The total umber of direct ad idirect Number; Measure traces Number of Traces A cout of the umber of traces Number; Measure Number of Direct Traces A cout of the umber of direct traces Number; Measure Number of Circular Traces A cout of the umber of circular traces Number; Measure Number of No-suspect Traces A cout of the umber of o-suspect Number; Measure traces Number of Suspect Traces A cout of the umber of suspect traces Number; Measure Requiremet Discussios Class Object Descriptio Type / Qualificatio Subject The subject of the discussio Log text; Dimesio Discussio Date The date ad time the discussio was Date; Dimesio posted Day of Week The day of the week the discussio was Character; Dimesio posted Discussio Week The week the discussio was posted Number; Dimesio Object Descriptio Type / Qualificatio Discussio Moth The moth the discussio was posted Character; Dimesio Discussio Year The year the discussio was posted Number; Dimesio Discussio Posted By The perso who posted the discussio Character; Dimesio User Name The user ame of the perso who posted Character; Dimesio the discussio Locatio The locatio of the perso who posted the Character; Dimesio discussio Body The cotet of the discussio Log Text; Dimesio Discussio Depth The depth of the discussio Number; Measure Requiremet Discussios Class, cot. Appedix A: Uiverse Parameters 25
Object Descriptio Type / Qualificatio Number of Total Discussios A cout of the umber of discussios Number; Measure Requiremet Resposibility Class Object Descriptio Type / Qualificatio Resposible Member The ame of the resposible user Character; Dimesio Resposible User Name The user ame of the resposible perso Character; Detail Locatio The locatio of the resposible perso Character; Detail Number of Resposible Members A cout of the umber of resposible members Number; Measure Requiremet Versio Class Object Descriptio Type / Qualificatio Requiremet ID The requiremet s ID Number; Dimesio Versio Actual The actual versio of the requiremet Character; Dimesio Major or Mior chage Idicates whether the chage is a major or Character; Dimesio mior chage Versio Chage Date The date the versio chaged Date; Dimesio Chage Ower The ower of the requiremet chage Character; Dimesio Day of Week The day of the week the versio chaged Character; Dimesio Versio Chage Week The week the versio chaged Number; Dimesio Versio Chage Moth The moth the versio chaged Character; Dimesio Versio Chage Year The year the versio chaged Number; Dimesio Commet A commet about the chage Log text; Dimesio Field Chaged The field to which a chage was made Character; Dimesio Old Value The old value of the field chaged Log text; Dimesio New Value The ew value of the field chaged Log text; Dimesio Requiremet Day Age Shows the age of the requiremet from v1.0 to the max versio (USE ONLY WITH OBJECTS IN THE REQUIREMENT VERSION CLASS FOLDER) Number; Dimesio Number of Chages A cout of the total umber of chages (ot by versio) Number; Measure Project Discussio Class Object Descriptio Type / Qualificatio Project Name Use this project ame object whe ruig Character; Dimesio reports o project discussio Posted By The user who posted the discussio Character; Dimesio Subject of Project Discussio The subject of the discussio Log text; Dimesio Body of Project Discussio The cotet of the discussio Log text; Dimesio Discussio Depth The depth of the discussio Number; Dimesio Project Discussio Date The date the discussio was posted Date; Dimesio Number of Project Discussios A cout of the total umber of discussios Number; Measure Admiistratio Reports Class These objects give iformatio about o requiremet-cetric data that is beeficial to a Admiistrator. Caliber User Class Object Descriptio Type / Qualificatio 26 CaliberRM Datamart User Guide
User Name The Caliber userid Character, Dimesio First Name Caliber user's first ame Character; Dimesio Object Descriptio Type / Qualificatio Last Name Caliber user's last ame Character; Dimesio Email Address Caliber user's Email address Character; Dimesio Locatio Caliber user's locatio Character; Dimesio Phoe Number Caliber user's phoe umber Character; Dimesio Fax Number Caliber user's fax umber Character; Dimesio Pager Number Caliber user's pager umber Character; Dimesio Departmet Name Caliber user's departmet Character; Dimesio Must Chage Password A flag set o the user s accout so he/she Character; Dimesio must chage the password Caot Chage Password A flag set o the user s accout so he/she Character; Dimesio caot chage the password Password Never Expires A flag set o the user s accout allowig a Character; Dimesio password that ever expires Accout Disabled A flag set o the user s accout that Character; Dimesio disables the accout Number of Caliber Users A cout of the total umber of Caliber users Number; Measure Caliber Groups Class Object Descriptio Type / Qualificatio Group Name The Caliber group ame Character; Dimesio Descriptio The Caliber group's descriptio Log text; Dimesio Group Email Address The Caliber group's Email address Character; Dimesio Number of Groups A cout of the total umber of groups Number; Measure Project Security Admi Class Object Descriptio Type / Qualificatio Project Name The Caliber project Character; Dimesio Project Descriptio The Caliber project descriptio Log text; Detail Security Profile Name The Caliber security profile ame Character; Dimesio Security Profile Descriptio The Caliber security profile descriptio Log text; Detail Group Name The Caliber group ame Character; Dimesio Full Name The Caliber user Character; Dimesio User Name The Caliber user ame Character; Detail Departmet Name The Caliber departmet ame Character; Dimesio Number of Security Profiles A cout of the total umber of security profiles Number; Measure Requiremet Type Security Admi Class Object Descriptio Type / Qualificatio Security Profile Name The Caliber security profile ame Character; Dimesio Security Profile Descriptio The Caliber security profile descriptio Log text; Detail Requiremet Type Security Admi Class, cot. Object Descriptio Type / Qualificatio Requiremet Type Name The requiremet type ame withi a Character; Dimesio Caliber project Requiremet Type Access The security access for the requiremet type (Noe, Read, Create) Character; Dimesio Appedix A: Uiverse Parameters 27
Requiremet Type Delete Permissio UDA Name UDA Access The security delete access for the requiremet type (Noe, Owed, Ay) The ame of the UDAs i the requiremet type The security access for the UDA (Noe, Owed, Ay) Character; Dimesio Character; Dimesio Character; Dimesio Requiremet Types Admi Class Object Descriptio Type / Qualificatio Project Name The ame of the Caliber project Character; Dimesio Project Descriptio The project's descriptio Log text; Detail Requiremet Type Name The requiremet type ame withi a Character; Dimesio Caliber project Tab Name The ame of the tab withi a Caliber Character; Dimesio project UDA Name The ame of the UDAs i the requiremet Character; Dimesio type UDA Descriptio The descriptio of the UDA Log text; Detail UDA Type The type of the UDA Character; Dimesio System Attribute A flag set that idicates the attribute as a Character; Dimesio system attribute Causes Versio Chage A flag set to chage the versio to a major Character; Dimesio icremet Chage Makes Trace Liks A flag set to make the trace suspect Character; Dimesio Suspect Iherit From Paret A flag set for the UDAs to iherit the Character; Dimesio default value from the paret Madatory Set o Create A flag set for the UDAs to make the default Character; Dimesio value madatory Accept Default Settig A flag set for the UDAs to accept a default value Character; Dimesio Glossary Class This class remembers Glossary Terms that are global to all projects. Object Descriptio Type / Qualificatio Glossary Word The glossary word Character; Dimesio Glossary Defiitio The defiitio of the glossary word Character; Dimesio Number of Glossary Words A cout of the umber of glossary words Number; Measure 28 CaliberRM Datamart User Guide
Appedix 5Report Samples Chapter This appedix cosists of examples of data geerated usig BusiessObjects reports. There are seve reports: Attribute Distributio: shows the way attributes are distributed throughout the repository Impact Aalysis: shows the umber of traces, both direct ad implied, related to a set of requiremets Project Scorecard: a umber-focused report that gives idicators to the overall soudess of a project(s) Requiremet Volatility: shows the umber of chages that are made to a requiremet withi a project(s) over time Status Summary: shows the umber of requiremets broke dow by project, baselie, requiremet type, status ad priority Traceability Complexity: shows the umber of traces that lik a user-defied umber of Top 10 requiremets withi projects ad Automated Software Quality (ASQ) applicatios User Deploymet: shows users assiged to a specific project(s) Appedix B: Report Samples 29
Attribute Distributio.rep Impact Aalysis.rep 30 CaliberRM Datamart User Guide
Project Scorecard.rep Status Summary.rep Appedix B: Report Samples 31
Traceability Complexity.rep User Deploymet.rep 32 CaliberRM Datamart User Guide