capri user manual v4.1 screen_optimized

7/31/2019 CAPRI User Manual V4.1 Screen_Optimized

1/162

CAPRI User Manual Version 4.1

ICM - 1 - Proprietary

Siemens AG

The implementation of turnkey projects for mobile

communication networks

USER MANUAL

Version 4.1

Document Version October 2003

Copyright Siemens AG 2003

Issued by Information and Communication Mobile Networks

St. Martin Strae 76

D-81541 Mnchen

Technical modifications possible.

Trademarks:

All designations used in this document can be trademarks, the use of which by thirdparties for their own purposes could violate the rights of their owners.


2/162



Siemens AG

Table of Contents

1 Introduction 4

2 CAPRI in use 62.1 Login 62.2 The User Interface 82.3 General Project Information 122.4 Calendar 132.5 Tree Views 14

2.5.1 Creating Tree Views 142.5.2 The Network Structure View 16

2.5.3 The Site Status Indicators of the Tree view (traffic lights) 172.5.4 Indicate Current Site in Tree 18

2.6 Network Structure 192.6.1 Net Elements 192.6.2 Linked and Unlinked Real Net Elements 202.6.3 OE-ID 212.6.4 Field Availability on the different Levels 22

2.7 Multiple Rollout Processes 232.8 Attach File 242.9 Creating New Objects 25

2.9.1 Search Area Maps (SAM) 252.9.2 Generic Sites 26

2.9.3 Candidates 262.9.4 Net Elements 272.9.5 Temporary Sites 29

3 Reporting 313.1 The Standard Reports, Forms and Claims 31

3.1.1 Forms 343.1.2 Claims 353.1.3 Reports 38

3.2 The Custom Report / Search Function 453.2.1 Selecting Fields and Filter for Search 453.2.2 Load Fields and Filter for Search 493.2.3 Layout Definition for Search 513.2.4 Results for Search 543.2.5 Load existing Custom Reports 553.2.6 Create new Custom Report 55

3.3 Power Profiles 563.3.1 Create a new Power Profile 563.3.2 Load existing Power Profile 57

3.4 The Charts 59

4 Interfaces 614.1 Tornado DMS Import 624.2 Tornado-N Import 664.3 Import and Mass-Replacement Function 69

4.3.1 Importing data 69


3/162



Siemens AG

4.3.2 Mass Replacement 724.4 EXtended Import 74

4.4.1 Direct Excel Import 754.5 ID-Warehouses 77

4.5.1 NE-ID Warehouse 774.5.2 OE-ID Warehouse 79

4.6 Pathloss Interface 814.7 MapInfo Export 834.8 DB Dump 87

5 Masks and Disciplines 895.1 Site Mask 895.2 Radio Planning (RP) 935.3 Transmission (TR) 995.4 Site Acquisition Report (SAR) 1075.5 Acquisition (ACQ) 1115.6 Permit & Design (P&D) 1135.7 Construction (CON) 117

5.8 Implementation (IMP) 1215.9 Acceptance (ACC) 124

5.9.1 Unit / Site Acceptance 1245.9.2 Cluster Acceptance 1265.9.3 Network Acceptance 1275.9.4 Document Control Centre 1285.9.5 Customer Acceptance Centre 129

5.10Claim 1315.10.1What is a Claim? 1315.10.2Material Claim Mask 1335.10.3General Claim Mask 140

5.11Lease 141

5.12Logistic Mask (LOG) 1485.12.1Administrating the LOG Mask 1495.12.2Using the LOG Mask 150

5.13Milestones Overview 1515.14Comments Overview 152

5.14.1Comment fields on the Masks 1525.14.2Comment Overview 152

6 Appendix 1546.1 Pathloss Interface Specifications 1546.2 FAQ Questions and Answers 1566.3 Button and Icon Description 1586.4 Contact 1596.5 Illustration Index 1596.6 Subject Catalogue 161


4/162



Siemens AG

1 Introduction

This user manual guides you through all features of CAPRI, the powerful projectimplementation tool of Siemens Mobile Network Service department. The user manual is

designed to provide the user a concise theoretical description of the features available. Itshould enable you to apply all functions and options CAPRIoffers.

The implementation of a GSM or UMTS Network requires a quick and controlled rollout ofall sites. This control includes current information about the actual status of the network atany time, the forecast of the rollout and monitoring of all project related activities.

If you have any comments or proposals for improving this user manual send an e-mail [email protected]. Finally, we hope the CAPRI user manual will satisfy yourexpectations of a state-of-the-art software documentation.

CAPRI is a project monitoring system designed for the implementation of TurnkeyProjects, Installation & Commissioning Projects and is flexible to support any other type of

project. This user-friendly tool has an interface that is easy to understand and that usesindustry standard forms and terminology as defined in the Siemens Turnkey ProcessManual. CAPRI was created with the knowledge and global experience of SiemensTurnkeyprojects. The CAPRI tool, along with the Siemens Turnkey Process Manual, helpset in place a clear sequence of steps for your project team to follow, enabling them tofocus on their particular targets.

Data Entry

CAPRI centralises critical project data and provides all departments with the requiredinformation they need, in order to make intelligent decisions. CAPRI compares the actualproject situation with the planning and shows time deviations at every stage of the projectcycle. Project delays can easily be tracked and outcomes forecasted. This allows

initiating corrective measures early in order to reach the project goals and to go on airfaster.

CAPRIs simple and effective data entry screens are designed to reduce training time,allowing for a simple training of new users. The implementation speed of the databasewill allow your project team to focus on its primary goal, which is building the network.

CAPRI data entry screens (Masks) are designed from the perspective that eachdepartment is responsible for their own data entry screen. For example, Radio Plannerswill be able to enter all Radio Planning information from one single data entry screen.Having a single data entry screen provides greater accountability and also provides aclear strategy for the completion of the data entry screen.

Reports

The most important reason for keeping track of the information in a database is to be ableto create up-to-date status reports. CAPRI can be used to create standard projectdocumentation such as Technical Site Survey Reports and Search Area Maps. Theseoutputs can be created with one simple mouse-click after the relevant data has beenentered in CAPRI.

It also features several pre-programmed standard reports that provide a comprehensiveview of the project status. Up-to-the-minute summaries and status reports can beprovided in an individual format.

A precise evaluation of the project status is extremely important as well as a preciseevaluation of what the project status will be like in the future. CAPRI helps you to makefuture planning more effective through built in functions that can be set according toproject requirements.

During the implementation of a telecommunication project, unexpected situations oftenoccur. In order to resolve these situations successfully, a strong, well informed
mailto:[email protected]:[email protected]:[email protected]


5/162



Siemens AG

management team is needed. They must have all relevant data at their disposal at once;therefore they need a strong comprehensive project-monitoring tool like CAPRI. Makingdecisions with an adequate preparation along with the implementation and analysis of theresulting effects are essential steps for controlling a project.

CAPRI standard reports will provide you with immediate information about projectprogress, leaving management more room to manoeuvre. These reports also help you

plan into the future. With the help of CAPRIsforecast, delays can be avoided, additionalpersonnel can be hired and required equipment can be ordered in time, for example. Thisin turn enables you to manage your way through the busiest part of your buildingschedule.

Besides the standard reports, CAPRI provides a powerful custom report function, whichenables you to generate any kind of report you need for your daily work. These reportscan be saved and are at your disposal with a click of a button.

Since Version 4.0 we now provide an even more convenient solution for reporting: ThePower Profiles. You can now export a predefined custom report directly into an Excel-filewith the click of a button. Or you can create any kind of report template in Excel (includingCharts, Calculations, Forms, customized Layout, etc.) and fill it with up-to-dateinformation from CAPRI.


6/162



Siemens AG

2 CAPRI in use

2.1 Login

The program can be launched using the Start menu of Windows. The program itself(CAPRI.exe) resides in the directory that is selected during set-up.

First, a login screen shows up; it asks for the Username and the Password.

The default username and password is admin. The password is case sensitive. TheCAPRI administrator should change the password immediately in order to avoidunauthorised use of the default username.

Figure 2-1: Login Screen

LoginEnter your user name. The user name has to be defined by the CAPRI administrator(ADMIN). Use the Tabulator key to proceed to the password.

Password

Enter your password. If the CAPRI administrator has not defined an initial password, youcan hit Enter. You will be prompted to set your password (at least 4 characters). If yourinitial password is provided by your administrator, it is recommended to change thepassword. After typing your initial password (be sure the CAPS-LOCK switch is off), hitthe Changebutton to enter a new password.

OK

Just hit the Enter key to confirm the login.

The default username andpassword is admin. Thepassword is case sensitive.

If your initial password isprovided by youradministrator, it is re-commended to change thepassword.

The administrator Login isADMIN


7/162



Siemens AG

Browse

Please make sure you are logging on to the right database. Check the Path that is shownunder Current Database. Hit the Browsebutton to browse for the database you want toopen. You will be prompted the standard Windows Open dialog.

Version

Click here to view the version of your Capri tool and the selected database, the durationof your current licence and the Capri hotline contact.

Cancel

Click on Cancel to abort the login procedure.

Note: The Current Databasewill always show the path ofthe last used database.


8/162



Siemens AG

2.2 The User Interface

Figure 2-2: CAPRI Window

The CAPRI screen is split into the following areas:Title Bar

The Title Bardisplays the Site or Search Area Map number of the currently selected Siteand the path of the currently used database.

Figure 2-3: The Title Bar

Menu Bar

The Menu Barprovides access to the main features of the CAPRI system.

Figure 2-4: The Menu Bar

The Menus

The Menusthat you can access through the Menu Bar in following order: File, Navigate,View, Tools and Interfaces.


9/162



Siemens AG

Figure 2-5: The Menus

Toolbar

The Toolbarprovides you direct access to frequently used functions of CAPRI.

Figure 2-6: The Toolbar

Buttons

New:Create a new Search Area Map, Candidate or Net Element

Save:Save the changes you made

DeleteDelete the current Site, Search Area Map or Generic Site

RefreshRefresh the active tree view

Find Current SiteFind the currently displayed site in the tree view

SearchOpens the Selection and Filter Dialog

Search ResultsDisplay the results of the last search

Attach FileAttach a file (digital photos, documents, ) to this site

View Attached FilesView the files, which are attached to the current site

EventsShows, that there are additional events (customised fields) created for thecurrently opened mask.

MapInfo ExportOpens the export function to MapInfo

Print (Reports)Opens the Print Reports Dialog. Access to the Standard Reports.

Load existing Custom ReportOpens the Load Custom Report Dialog.

Create new Custom Report

Opens the fields and filter for Custom Report Dialog.


10/162



Siemens AG

AboutShows you the version of your CAPRI tool and of the database, the licence expirydate and the support contact.

Tree View

The Tree view is the main navigation element in the system. The standard view in thetree is the Site Status View and will automatically be generated on program start.Additional views can be created as described in The Viewssection (see chapter 2.3).

Figure 2-7: The Tree View

Site Status HeaderThe Site Status Headerprovides general information on the currently selected site. Thisshould give you brief overall-information.

Figure 2-8: Site Status Header

You cannot make changes to any of the data displayed in the header directly. Thisinformation is gathered from the Data Entry Forms, so the values can only be changed onthe corresponding screens.

Note:

The Milestone Status field in the Site Status Header shows the latest actual milestone ina consecutive line, e.g. if milestones 1, 2, 3 and 5 are reached (actual date is provided),milestone 3 (Site Evaluated) will be displayed. If you reach milestone 4 later, then themilestone status will change to milestone 5.

Data Entry Forms (Masks)

The Data Entry Forms(Masks) are placed in a Tab-Control, which allows you to accessthe data for the section you are interested in by clicking the appropriate tab.

For each discipline of a project (Radio Planning, Acquisition, Construction, etc,) there is aseparate data entry form available. For each of these data entry forms the administratorcan assign separate view-, write- and delete-permissions to the various users.

Screens that are not relevant for you might be invisible. For more details on userpermissions see the User Permissions section in the Administrator Manual.

All fields of a Data Entry Form (Mask), for which the user is responsible, are highlightedwhite, which means that data can be entered. All the fields shaded blue display read-onlyinformation from other Data Entry Screens.

The iconsleft of the tabs caption have the following meanings:

Read, Write, Delete Access

Read, Write Access

Read Access only


11/162



Siemens AG

Note:

All the fields in the sub tables and grids (Sectors, Customer Acceptance Centre,Transmission Link grid, etc.) can now be resized manually.

Figure 2-9: The Data Entry Forms

Tool Tips

Every field in CAPRI has a comment field attached that can be filled with additionalinformation. This is especially useful for training of new staff, for explanation of certainfields in local language or just additional information on the process at a certainmilestone.

To access the comment field, move the cursor over a field and click on the right mousebutton. A yellow field with comments will appear.

The editing of the Tool tips is restricted to the Administrator (see Administrator Manual).

Figure 2-10: Tool Tips function


12/162



Siemens AG

2.3 General Project Information

The General Project Information screen provides users with general information about theproject such as project number, country code, project start and planned end dates,customer contact information and department manager names. This screen should beedited by the Administrator or Project Management and is for informational purposes for

most other users of the database.

Figure 2-11: General Project Information

Two important sections of the General Project Information screen are the check boxes in

the bottom left corner:

Pathloss in Use

This box enables the interface to the microwave-planning tool Pathloss. Microwave Linkinformation will be imported from Pathlossinto CAPRI. On the TR screen, all microwavefields with an asterisk (*) will be imported. When Pathloss is used, these fields will beread only.

Replication in Use

If this box is checked, it indicates that the project will use the CAPRI Replication Feature.Note that if you disable the replication, tracking info of changes will not be stored in thedatabase. This helps to keep your database smaller but you will not be able to replicatewith other databases. If you use the replication function, it is absolutely necessary thatyou replicate before disabling the replication because this will delete all trackinginformation in the database!

Note:

Currently the Replication function is disabled until further notice! Please contact theCAPRI-hotline for further information.

Apply User Rights on Filter Dialog

If this box is checked, the User Permissions of every individual user will be applied to theFilter Dialog of the Search/Custom Report function. This means, that the user will only beable to filter on and see the fields he is allowed to by the user permissions. This avoidsusers (external partners, subcontractors, customer) with limited access rights to be able

to see confident information.

Be careful: Disabling the

replication will delete alltracking information in thedatabase!!!


13/162



Siemens AG

2.4 Calendar

The calendar screen displays the working days, holidays and weekends for the project ina graphical view.

Figure 2-12: Calendar

The calendar is set by the administrator or project management and can be viewed by allusers of the database. The information recorded in the calendar is used by the databasewhen formulating time frames for milestones and work schedules. For instance, if a

milestone takes 10 workdays to complete, the calendar takes into account the weekendsand any holidays that occur from the first day of work performed to calculate an accuratefinish date.

To view the calendar, go to Toolson the Menu bar and then to Calendar. The calendarwill be displayed.

Holidays are shaded red.

Weekend days are shaded grey.

Regular workdays are shaded white.

When you move over a holiday field with your mouse, the description of the holiday willbe displayed on the bottom of the calendar dialog. If a holiday range consists of more

than one data, all descriptions of this range are shown.


14/162



Siemens AG

2.5 Tree Views

The Tree Views on the left hand side of the screen are used to navigate between thedifferent objects in the database. These objects can be sorted and filtered in the differentviews.

2.5.1 Creating Tree Views

CAPRI offers following different tree views:

Site Status View: sorts the sites according to their status

Search Area Map View: shows all Search Area Maps including thecorresponding Candidates.

Region View:sorts the sites according to the Region.

Phase View:sorts the sites according to the Phase.

Responsibility View:sorts the sites according to the responsible persons.

Network Structure View:shows all the objects in the database according to thehierarchical structure.

Rollout View:sorts the objects according to their rollout.

Views can be created from the Viewmenu in the Menubar:

Figure 2-13: The Views

The views will sort the entries of the database according to different criteria. E.g. TheRegion Viewwill group all sites according to the region they belong to.

Additionally, you can filteron certain criteria within the view. Selecting one of the viewtypes will display the filter dialog.

Example:

You want to sort the sites in your database by Region, but you are only interested in siteswith the Site Rank preferred. This is how you proceed:

Select the Region View in the in the Viewmenu and you will be prompted thefilter dialog (Figure 2-14).

Select Common Site Rank in the filter window and select Preferred in thecolumn Value 1.

Press Show Results. The newly created view will be placed at the end of the tree view(Figure 2-15).

TIP:

If you place the cursor on thetree view section and click the

right mouse button, you willbe prompted the viewswindow immediately.


15/162



Siemens AG

Figure 2-14: Filter Dialog for Tree View

Figure 2-15: Tree View, sorted by region, filtered by Site Rank (Preferred)

If the currently displayed site (on the right window pane) is found in the created view, thebranch of the view will be opened and the site will be highlighted.

The Grey Icon:

The Site Is Not ScheduledYet

The Green Icon:

The Site Is On Schedule

The Yellow Icon:

The Site Schedule Is Critical

The Red Icon:

The Site Is Off Schedule

The White Icon:

The Site Is Not Controlled

Automatic Refresh

When you add a candidate,SAM, generic site or netelement, or when you change

the time schedule of a site,you only need to save thesechanges and the tree viewwill be updated automatically.


16/162



Siemens AG

2.5.2 The Network Structure View

The Network Structure View shows all objects of the network in one view, from theNetwork down to the Net Element. It displays all hierarchical levels and the relationshipbetween the different objects.

Figure 2-16: The new Network Structure View in detail

Network

On this level you see all the Networks created. If there are objects that are not assignedto a Network they will appear under < Not assigned to a Network >. To access the objectswithin the selected Network, click on the +-sign next to the name of the Network.

Cluster

On this level you can see all the Clusters assigned to the selected Network. If there areobjects, which are not assigned to a Cluster, they will appear under < Not assigned to aCluster >. To access the objects within the selected Cluster, click on the +-sign next tothe name of the Cluster.

Search Area Map (SAM)

On this level you can see all the SAMs assigned to the selected Cluster. Please refer tochapter 2.9.1 for general information about SAMs (what is a SAM?) and to 2.6.1 fordetails on the relationships of an object within a SAM. To access the objects within theselected SAM, click on the +-sign next to the SAM Number.

Nominal Net Element

For each SAM there is at least one Nominal Net Element created. It contains all the netelement specific planning data, mostly imported from Tornado.

Please refer to chapter 2.6.1 for details on the relationships of the object within a SAM.

Real Net Element

Candidate

Nominal Net Element

SAM

Cluster

Network


17/162



Siemens AG

Candidate

Candidates are attached to the SAM.

Please refer to chapter 2.6.1 for details on the relationships of the object within a SAM.

Real Net Element

The Real Net Elements contain the net element specific data that are important for theimplementation of the equipment.

Please refer to chapter 2.6.1 for details on the relationships of an object within a SAM.

2.5.3 The Site Status Indicators of the Tree view (traffic lights)

Basically the calculation of the indicators in the Views (the traffic lights) is based on theRevised Plan date of the milestone that is delayed most. Milestones, which have theactual date entered, will be ignored.

The icons in the tree have the following meanings:

The Grey Icon

Not Scheduled

A site is not scheduled when no forecast has been calculated (all milestone dates areempty).

The Green Icon

On Schedule

A site is declared on schedule when all the Revised Plan dates of the followingmilestones are lying in the future.

The Yellow Icon

Critical

A site schedule becomes critical when the next Revised Plan date is approaching. Thenumber of Critical Days before the Revised Plan Date can be defined in the RolloutSettings dialog.

The Red Icon:

Off Schedule

The indicator will become red if the Revised Plan date passes the number of CriticalDays specified in the Rollout Settings dialog.

The White Icon:

Not Controlled

If a SAM has several Candidates and one of them is ranked as "preferred" in the RP-mask, the other Candidates of this SAM will become Not Controlled. These Candidateswill not be worked on anymore, because the project has chosen the preferredCandidate. If, for any reason, the chosen Candidate cannot be built, just remove the siterank preferred and all the Candidates of this SAM will be controlled again and a newchoice can be made.

Critical Days

The timeframe, when a traffic light changes from green to yellow or from yellow to red,can be defined by the administrator in the Rollout Settings (see Administrator Manual


18/162



Siemens AG

Chapter 3.2). In the example below the traffic light changes to yellow two days before theRevised Plan Date and it will change to red two days after this date.

Figure 2-17: Critical Dates

2.5.4 Indicate Current Site in Tree

With this button you can find the currently active object (shown on the masks) in the treeview.

Example

You are currently working on site number MUC-1000A. It is shown in the Site StatusView. Now you want to see this same site in the Network Structure View. Highlight theNetwork Structure View in the Tree and click on the Indicate Current Site in Viewbutton.The Network Structure View will open and MUC-1000A will be shown in this view.

Indicate Current Site in View


19/162



Siemens AG

2.6 Network Structure

The Network Structure of CAPRI has been slightly changed to represent the real situationin your project in a more convenient way. The structure is as follows (highest level first):

1. Network

2. Cluster

3. Search Area Map (SAM)

4. Candidate/Generic Site

5. OE-ID

6. Net Element

2.6.1 Net Elements

NE-ID

The NE-ID is used as identifier in the Siemens Corporate Logistic Process. It is mostlygenerated in AOP and follows the whole Logistic Process from the Log-Milestone L* toL800. The NE-ID can be imported into CAPRI and then assigned to the respective NetElement, the CAPRI-internal Net Element ID will then be overwritten. See chapter 4.5.1for more details on the import.

Example: FI 14030101578 BTSX 001

Digit 1-2 (2 Digits) Country code FI

Digit 3-13 (10 Digits) Timestamp 14030101578

Digit 14-17 (4 Digits) Net Element Type / Model BTSX

Digit 18-20 (3 Digits) Consecutive number 001

Nominal Net Elements and Real Net Elements

The Net Element is the smallest entity (object) in a network. The Net Element is theactual equipment, which will be installed on the site (BTS; NodeB; BSC; MSC; etc.).There could be several Net Elements on one site/candidate (e.g. a BTS and a BSC).

When Net Elements are created in CAPRI, they will get a CAPRI-internal Net Element ID.It consists of the ID of the object on the next higher level and a suffix:

N(1;2;3;) Nominal Net Element (e.g. MUC1000-N1)R(1;2;3;) Real Net Element(e.g. MUC1000A-R1)

Nominal Net Element

The Nominal Net Element represents the planned Net Element. It contains informationon the planned configuration, sectors, antennas, etc. This information is coming fromRadio Planning and is mostly imported from the Radio Planning Tool (Tornado).

Real Net Element

This is the realNet Element. It contains information on the configuration, the antennas,etc. which will actually be built. The data is initially copied from the Nominal Net Element,but it is advised to modify this information according to the actual equipment that will beinstalled.

Net Element Suffix:

-N1 Nominal NE

-R1 Real NE


20/162



Siemens AG

The Network Structure is built up in the following way:

SAMs and Nominal Net Elements

The new structure defines a Nominal Net Element, which is linked to the SAM. It iscreated automatically, when you create a SAM. When you import a SAM from TornadoDMS, a Nominal Net Element is created and the Net Element related information

(Sectors, Configuration, Antenna Details, etc.) is stored there.

Figure 2-18: When you create a SAM, a Nominal Net Element is created automatically

Candidates and Real Net Elements

Every time you create a candidate for this SAM, a Real Net Element is created for everyNominal Net Element in the SAM and will be attached to the Candidate. The technicalinformation (Sectors, Antennas, etc.) is copied from the Nominal Net Element to the RealNet Element, but can be modified according to the demands of the constructiondepartment, implementation, the customer, etc.

Figure 2-19: When Candidates are created on this SAM, a Real Net Element is created

automatically.

Note:

Different to version 4.0, in version 4.1 every Candidate has its own Net Elements,independent from the Site Rank.

2.6.2 Linked and Unlinked Real Net Elements

Figure 2-20: Net Element data fields on the Site Mask

New in version 4.1 !


21/162



Siemens AG

Linked Real Net Elements

Only one of the attached Real Net Elements will be directly linkedto the Candidate.

This has the following consequences:

The linked Real Net Element will follow the same Rollout as the Candidate. Seechapter 2.7 for more details on rollouts.

The data fields of the linked Real Net Element will be filled on Candidate leveland will be copied down to the linked Real Net Element. So there is only onedata record for the Candidate and the linked Net Element.

How do Real Net Elements become linked Real Net Elements?

The first Real Net Element created under a Candidate will become the Tornado-controlledNet Element and will be the linked Net Element.

Unlinked Real Net Elements

If you have several Net Elements attached to the Candidate, only one is directly linked.

The other Net Elements are called unlinked Net Elements.How can you change the linked Net Element?

In order to change the linked Net Element, follow the steps:

Move to the unlinked Net Element, which you want to link to the Candidate andclick the tick box Link Net Element to site-specific milestones.

Save.

Figure 2-21: Link a Net Element to a Candidate

Note:

The rollout of the unlinked Net Element will be overwritten by the rollout of the Candidate.You will be prompted the warning message, asking if you also want to overwrite thetechnical information of the Net Element.

2.6.3 OE-ID

We have introduced the OE-ID as a new entity in the hierarchy of objects. It describes theOperational Entity. In some areas the OE-ID has different names (e.g. Sales UniqueName, VSTK#, Exchange ID, etc.) but they are all describing the same Entity. It is mainly

used in service related departments. The tools SAMSON and CASINO are using the OE-ID as identifier.

Example: NE 032 R G 0001

Digit 1-2 (2 Digits) Net Element NE

Digit 3-5 (3 Digits) Country code 032 (ISO 3166)

Digit 6 (1 Digits) Organisation R (for ICM CA (RLC))

Digit 7 (1 Digits) RLC (Location) G (for Getafe Madrid)

Digit 8-11 (4 Digits) Consecutive number 0001

It is important to understand the hierarchy of objects, which is the following:



22/162



Siemens AG

1. SAM

2. Candidate

3. OE-ID

4. NE-ID

5. Sector6. Antenna

From one level to the other we always have a 1-n relationship. This means for examplethat one Candidate can have several OE-IDs and one OE-ID can have several NE-IDs.

When you create a new site, a CAPRI-internal OE-ID is created automatically. It consistsof the Site ID and the suffix OE# (e.g. MUC1000A-OE1). A valid OE-ID can then beimported in the same way you already know from the NE-ID Import. The CAPRI internalOE-ID will then be overwritten. Please refer to chapter 4.5.2 for further details on theimport.

2.6.4 Field Availability on the different LevelsFor a detailed description of which data fields are available on which hierarchical leveland data fields are forwarded between the levels, please refer to the followingdocuments:

SAM to Site.doc

Site to NE.doc

Please contact the [email protected] gain these documents!


23/162



Siemens AG

2.7 Multiple Rollout Processes

A rollout process contains a set of milestones with certain durations between thesemilestones.

Since version 4.0 it is now possible to create different rollout processes (Rollouts) for

different kind of sites or Net Elements. E.g. you could have a different set of milestonesand milestone durations for greenfield sites and for rooftop sites, or for sites in region Aand in region B. It is also possible to have special rollout processes for different networkentities like Net Elements, Candidates and Search Area Maps.

In addition, it is now possible to include inchstones and user defined events into therollout. This means, they are included in the automatic forecast calculation.

These rollout processes are created by the administrator in the rollout settings window.They can be selected in a newly created field on the Site Mask, called Rollout.

For each rollout CAPRI provides you with a customisable-forecast function. The cal-culation of forecast milestone dates starts when you enter an actual date for the firstmilestone and click Save. After this is done, you have a forecast date available for everymilestone. Every milestone reached later in the project will activate the re-calculation of

all following milestones; the re-calculation is based on the date entered for the latestplanned or actual milestone. This means the further you go in your project the moreprecise the forecast of your projects end situation becomes.

Assigning an Object to a Rollout

Once the rollouts have been created, you can assign SAMs, Generic Sites, Candidates orNet Elements to the different rollouts. There is a new field on the Site Mask calledRollout.

Please refer to the Administrator Manual chapter 3 for details on RolloutAdministration.


24/162



Siemens AG

2.8 Attach File

With the Toolbar Icon Attach Fileyou can add pictures, drawings, digital images or site-specific documents to the SAM, the site or to the Net Element. Be aware that you do notsave the document in the CAPRI Database; CAPRI saves a link, which points to thedocument on a Network drive or on your local disc. We recommend to establish a folder

structure for drawings, images etc. on a network drive. If you want to see the attachment,press the View Attached Filesbutton.

Note:

A link can only be deleted by the person (login) who created it, or by the administrator.

Figure 2-22: Attach files

Figure 2-23: Files attached

Attach File

View Attached File


25/162



Siemens AG

2.9 Creating New Objects

To create a new object you can click the Newicon on the Toolbar or use the New optionfrom the Filemenu. The following dialog allows you to specify what kind of object youwant to create.

Figure 2-24: The New Site Dialog

CAPRI handles objects (Network entities) in five categories:

2.9.1 Search Area Maps (SAM)

The Search Area Maps are issued by the Radio Planning department and define the areain which the Site Acquisition team should find suitable Candidates for building up BaseStations.

Figure 2-25: Create a new SAM

New


26/162



Siemens AG

To create a new SAM,

Select Search Area Map

Click OK.

A Sam and a Nominal Net Element will be created. See chapter 2.6.1 for detailson the Nominal Net Element.

2.9.2 Generic Sites

Generic sites are sites, which are not linked to a Search Area Map. Generic Sites couldbe predefined Candidates or Friendly Sites.

Figure 2-26: Create a Generic Site

To create a new Generic Site,

Select Generic Site

Click OK.

A Generic Site and a Real Net Element will be created. See chapter 2.6.1 fordetails on the Real Net Element.

2.9.3 Candidates

After Site Acquisition has been on location, they should come back with around 3Candidates (3 possible locations to built up a NodeB/BTS). Candidates are created fromSearch Area Maps.


27/162



Siemens AG

Figure 2-27: Create a Candidate

To create a Candidate,

Select Candidate

Select the SAM, for which you want to create the Candidate, out of the list ofSAMs. Should the SAM you are looking for, not be in the list, please pressUpdate List.

Click OK.

The Candidate will be created. For every Nominal Net Element belonging to aSAM there will be one Real Net Element created and attached to the Candidate.

E.g. If the SAM has two Nominal Net Elements, every Candidate that is createdunder this SAM will get two Real Net Elements.

See chapter 2.6.1 for details on the Nominal Net Element.

2.9.4 Net Elements

Note:

A Nominal Net Element is created automatically when a SAM is created orimported from Tornado.

A Real Net Element is created automatically when a candidate is created. The

number of Real Net Elements created corresponds to the number of Nominal NetElements attached to the SAM. The technical data is copied from the NominalNet Element to the Real Net Element.

A Temporary Net Element is created automatically when a Temporary Site iscreated. The data is copied from the Temporary Site.


28/162



Siemens AG

Figure 2-28: Create a Net Element

If you require additional Net Elements you have the following possibilities:

Create a Nominal Net Elementfor the selected SAM:

This creates an additional Nominal Net Element, which is attached to the SAM, the netelement specific data is copied automatically from the SAM. The NE-ID of the NominalNet Element will consist of the SAM Number with an additional suffix (E.g. SAM =MUC1000, Nominal NE-ID = MUC1000-N1).

Select Net Element

Open the SAMtab and select the SAM to which you want to attach the NominalNet Element. Should the SAM you are looking for, not be in the list, press UpdateList.

Click OK.

Create a Real Net Elementfor the selected Generic Site:

This creates a Real Net Element, which is attached to the selected Generic Site, the netelement specific data is copied automatically from the Generic Site. The NE-ID of theReal Net Element will consist of the Site Number of the Generic Site with an additional

suffix (E.g. Generic Site Number = MUC1001A, Real NE-ID = MUC1001A-R1).

Select Net Element

Open the Genericstab and select the Generic Site to which you want to attachthe Real Net Element. Should the Generic Site you are looking for, not be in thelist, press Update List.

Click OK.

Create a Real Net Element for the selected Nominal Net Element:

This creates a Real Net Element; the net element specific data will be copied

automatically from the selected Nominal Net Element. You will have to specify whichCandidate this Real Net Element will be attached to. The NE-ID of the Real Net Element


29/162



Siemens AG

will consist of the Site Number with an additional suffix (E.g. Site = MUC1002A, Real NE-ID = MUC1002A-R1).

Select Net Element

Open the NEstab and select the Nominal Net Element from which you want tocopy the net element specific data. Should the Nominal Net Element you are

looking for, not be in the list, press Update List. Click OK.

You will be prompted the selection window shown below. It shows all the Sitesbelonging to the SAM you are working on. Select the candidate where the NetElement is going to be attached to.

Click OK.

Figure 2-29: Select Candidate

Create a Temporary Net Element for the selected Temporary Site:

This creates an additional Temporary Net Element, which is attached to the selectedTemporary Site; the net element specific data is copied automatically from the alreadyexisting Temporary Net Element (see below). The NE-ID of the Temporary Net Elementwill consist of the Site ID of the Temporary Site with an additional suffix (E.g. Temp Site =MUC1003-Temp, Temporary NE-ID = MUC1003A-Temp-R1).

Select Net Element

Open the Temptab and select the Temporary Site to which you want to attachthe Temporary Net Element. Should the Temporary Site you are looking for, notbe in the list, press Update List.

Click OK.

2.9.5 Temporary Sites

Sometimes it is necessary to build up mobile sites next to the original Candidatebecause of any delays in the progress of this site. To track this event it is possible tocreate Temporary Sites. Also have a look at chapter 5.1.


30/162



Siemens AG

Figure 2-29: Create a Temporary Site

To create a Temporary Site,

Select Temporary Site

Select the Candidate, for which you want to create the Temporary Site, out of thelist of Candidates. Should the Candidate you are looking for, not be in the list,please press Update List.

Click OK.

The Temporary Site will be created. A Temporary Net Element will be created

automatically for each Real Net Element of the Candidate. The Site-ID of theTemporary site consists of the Site ID of the original Candidate plus the suffixTemp (E.g. Site ID original = MUC 1003A, Temp Site-ID = MUC1003A-Temp).


31/162



Siemens AG

3 Reporting

3.1 The Standard Reports, Forms and Claims

The Print ReportDialog can be accessed through the two Menu Options: ToolsReportsand File Printor clicking the printer icon on the Toolbar.

In the Select Report window you will find a tree view with the following major entries:

Forms

Claims

Reports

Every one of these three entries has subentries. For a detailed description of thesereports, see chapter 3.1.1 and following.

Figure 3-1: Print Report

Preview

The Preview button will display a preview of the selected report.

PrintThe Print button on this dialog will print the selected report.

Print Reports


32/162



Siemens AG

Customer Logo

You can implement a customer (or Siemens) logo on forms and reports. The file must bea Windows bitmap (.bmp) or a jpeg-file (.jpg). Just click on the Customer Logobutton andchoose the file from the Open Dialog. To remove the logo, just click on the RemoveLogobutton.

ExportThe Export dialog will generate a CSV (Comma Separated Values) file that can be usedto import it in EXCEL. The file is actually a text file and with the appropriate interface itshould be possible to import the data in other programs as well.

The Export process Step by Step on the Example of the Weekly Status Report:

1. Select a Report

2. Press the Button

3. Save the Export file

4. If you want to open the newly created Excel File, you must first open the ExcelProgram

5. Now open the file with the command FileOpen File.

6. The Text Assistant will guide you through the conversion of the file: On the firstscreen you are asked for the type of the source file.

7. Select Separated and then click on further.

8. On the second screen, select the correct field delimiter: Semicolon. Then clickon further

9. On the third screen, Select all fields by scrolling to the end of the list, press theShift key and click in the last field (all fields are marked). Select Text as theformat for all columns.

10. Press the Finish button and you can see the report in Excel.

11. Now you also can format your Excel data sheet.

Figure 3-2: Step 3 - Save the Export file

Note:

First open the Excel program andthen open the exported file out ofExcel with the command File OpenFile.


33/162



Siemens AG

Figure 3-3: Step 7- SelectSeparated

Figure 3-4: Step 8 - SelectSemicolon

Figure 3-5: Step 9 - SelectTextas format for all columns


34/162



Siemens AG

Figure 3-6: Weekly Report in Excel format

3.1.1 Forms

The Forms in CAPRI will print the selected Form with the data of the currently active site.We use Forms as information sheets between disciplines or for the communication with

subcontractors.

The Forms are subdivided by:

MILF

Search Area Map

Site Acquisition Report

Site Evaluation

Radio Planning TSS

Transmission Planning TSS

Site Information Sheet

For Report Examples please refer to the document Report Examples.doc. Pleasecontact the [email protected] gain these documents!

MILF (Microwave Information Link Form)

This form is only available when you have selected a Microwave Link on theTransmission screen. Used by the Microwave Planning group. This form defines for theMW Implementation group the exact requirements of the MW Planners. Once this form isprovided to the MW Implementation Group, materials for each microwave link can be

ordered from the factories.


35/162



Siemens AG

Search Area Map Form

This form is used by the Radio Planning group and is only available when you haveselected a Search Area Map in CAPRI. This form is the trigger of all activity on a TurnkeyProject. The SAM defines the exact requirements of the Radio Planners for the specificSearch Area. From this point Site Acquisition will provide the SAM to the Subcontractor toidentify potential candidate sites.

If you use the new SAM Creator of the MapInfo function, the created jpeg-picture of theSearch Area Map can be attached to the Search Area Map form automatically (seechapter 4.7).

Site Acquisition Report

Used by Site Acquisition and the Radio Planning group. This form is completed by theSubcontractors and identifies all important site-specific details. Siemens should notaccept a SAR unless the Site defined in the SAR is leasable, permittable andconstructible. The report is usually done by hand and then entered into the database.Customers usually require this in the final site documentation delivery (not available forSAMs).

Site Evaluation

Used by Radio Planning and Transmission Planning to give an evaluation of each site.This form is given to the Acquisition Department. All sites must be ranked; therefore allSARs should get a Site Evaluation form. The Site, which is ranked preferred on the SiteEvaluation form, will be the focus of all future activity (not available for SAMs).

Radio Planning Technical Site Survey (TSS)

After the site is evaluated, a Technical Site Survey (TSS) is completed. The informationfrom the TSS must be formally detailed in the Tornado and CAPRI Databases, so that theinformation can be transferred to the design subcontractor and eventually incorporatedinto the drawings. This form does this for RP information (not available for SAMs).

Transmission Planning Technical Site Survey (TSS)

This form does the same as above but for TR information (not available for SAMs).

Site Information Sheet

Used by anyone - it is a general sheet for site related details (not available for SAMs).

3.1.2 Claims

The Claims are subdivided by:

1. Forms

Request Form

General Form

Material Form

Material Claim Sheet

2. Reports

Summary of Management Activity

General Tracker

Material Tracker


36/162


37/162



Siemens AG

Figure 3-7: Material Claim Sheet

2. Claim Reports

Summary of Claim Management Activity ReportThe Summary of Claim Status Report is used to track all Claims once they have beencreated. This report groups Material Claims and General Claims by Claim Descriptions. Itshows the total number claims per Claim Description and the number of open andclosed claims per Claim Description. It also groups claims by Requestor and Recipientso you can tell who is responsible for most claim activity.

General Claim Tracker Report

General Claim Form used to track all General Claims once they have been created. Thereport divides all Claims into a status of either open or closed. If a Claim has beencreated and does not have a claim complete date then the claim is considered open.Once the Claim complete date is entered the Claim is Closed. The General ClaimTracker also sorts the General Claims by their Claim Description and then sorts the ClaimDescriptions by their Claim Status.

Material Claim Tracker Report

Material Claim Form used to track all Material Claims once they have been created. Thereport divides all Claims into a status of either open or closed. If a Claim has beencreated and does not have a claim complete date then the claim is considered open.Once the Claim complete date is entered the Claim is Closed. The Material ClaimTracker also sorts the Material Claims by their Claim Description and then sorts the ClaimDescriptions by their Claim Status.


38/162



Siemens AG

3.1.3 Reports

The Reports are subdivided by:

Status Reports (overall)

Status Reports (detailed)

Weekly Reports

Other Reports

For the description of the Custom Reports please refer to chapter 3.2.

Status Reports (overall)

The following five reports give an overview of the current status of the project. Thesereports are commonly given to the higher management.

The Status reports will generate data for all sites in the system, which fulfil the criteria forthe selected status report (defined in the header of each standard report).

The following overall Status Reports are available:

SAM Status Reports

Project Status

Project Status by Phase

Project Status by Region

Controller Status

Cluster Report

Process Duration Statistics

Report: SAM Status Report

Figure 3-8 SAM Status Report

The SAM Status Report will provide you detailed information about Node B / BTSSearch Area Maps (SAMs) and Candidates focus on Milestones 1, 2 and 3.


39/162



Siemens AG

Preconditions:

SAMs must be ranked in the Radio Planning mask as Active or Inactive. Only theactive-ranked SAMs (and the assigned candidates) have influence on the total numbersshown in this specific report for milestones M1, M2 and M3. The SAMs imported byTornado interface will be ranked automatically as Active

If you change the SAM rank from Active to Inactive during the project, it is a must tore-rank (e.g. RP rejected) also each candidate which is assigned to the concerning SAM.Thats why you want to see exactly the same number of preferred candidates in the M3overview as in the All preferred Sites overview below in the Node B / BTS row. If thesetwo numbers are not equal, then a preferred candidate exists that is assigned to a notranked or inactive ranked SAM. All other Status Reports available in CAPRI do notcheck if the assigned SAM to a preferred candidate is active or inactive!

Tables:

Node B / BTS SAMs (no preferred Candidate)

How many Node B / BTS SAMs are ranked active, inactive or other (e.g. no rank). Inbrackets you see the number of SAMs, which have at least one candidate, but none ofthem is a preferred candidate. That means if you want to know how many SAMs have

no preferred candidate in total, you have to add to this figure the number of SAMs withno candidate at all (see below).

Active Node B / BTS SAMs

How many active ranked SAMs have no candidate, 1 / 2 / 3 / 4 / 5 and more can-didates?

Active Node B / BTS SAMs (Total / M1)

Totals: How many Node B / BTS SAMs are ranked active.

M1: How many of the Totals have reached Milestone 1 until today / How many wereplanned to reach until today / deviation

Node B / BTS Candidates (Act. SAMs)

Totals: How many candidates are in the system, which are assigned to an active SAM(no consideration of site rank, because at this stage, the candidates are not ranked)?

M2: How many of the Totals have reached Milestone 2 until today / How many wereplanned to reach until today / deviation?

Node B / BTS Candidates (Act. SAMs)

Totals: How many candidates are in the system which are ranked e.g. preferred ?

M3: How many of the Totals have reached Milestone 3 until today / How many wereplanned to reach until today / deviation?


40/162


41/162



Siemens AG

NE

The preferred RNC/ BSC Controller.

Totals

Number of preferred Node B / BTS sites, which where connected to this controller.

MS 2 to MS 15Reflect the status of these preferred Node B / BTS sites, in the same logic like the StatusReports above.

Totals

Sum of all preferred Node B / BTS Sites, which where connected to a preferred RNC /BSC Controller.

Report: Cluster Report

Figure 3-10: Cluster Report

This report gives you an overview on the status of the clusters in your database. It issorted by Phase, by Region and by Cluster.

The left part shows you an overview of the milestone status of the sites assigned to acertain cluster.

The right part shows you the Actual Dates of the Cluster milestones reached. The columnat the far right shows the number of Control Units requested per Cluster.


42/162



Siemens AG

Report: Process Duration Statistics

Figure 3-11: Process Duration Statistics

This report gives you statistical information on the duration of certain processes. It isdivided into Completed Processes and Ongoing Processes.

One process is defined by a starting milestone and an ending milestone. For each ofthese processes you get statistical information like:

Events started

Events completed

Percentage of completed events

Fastest and longest event

Average duration

Etc.

Status Reports (detailed)

The following overall Status Reports are available:

Pref. Sites by Phase and Number

Pref. Sites by Phase and Region

All Sites by Number

General:

Site #

The Site-number.


43/162



Siemens AG

Region

The Site-region.

MS

The Milestone Status, this site has reached.

MS 2 to MS 15Shaded if this site has an actual date in the Milestone, otherwise the Revised Plan will beshown (empty if no Revised Plan).

Totals in Region Column

Count of all sites in this group

Totals in column MS 2 to MS 15

Count of all sites in this group with an actual date.

Report: Preferred Sites by Phase and Number

Like described in General, reflects on preferred sites only.

The information is sorted by the site number.

Report: Preferred Sites by Phase and Region

Like described in General, reflects on preferred sites only.

The information is ordered by the region and then by the milestone status.

Report: All Sites by Number

Like described in General, the information is ordered by the site number.

The site rank of each site is shown additionally.

Figure 3-12: Preferred Sites by Phase and Number


44/162



Siemens AG

Weekly Reports

Report: Preferred Sites Weekly Report

Figure 3-13: Weekly Status Report

This report gives you an overview of the number of sites, which have reached a certainmilestone in a certain week.

Additionally you can see the plan value. In Milestone 1 you see all active Node B / BTSSAMs and in the Milestones 2 15 you see the preferred Node B/BTS Sites. The Valueof the dates are divide in Actual Date / Original Plan / AD OP.

Report: TSS Scheduler

A simple report that offers the possibility to get an overview of scheduled TSS in a certainweek.

You have to select a certain week and filter for a special region or TR Supervisor.

Other Reports

Report: Export Status by Region

This Report gives you a quick overview over the Status of Implementation in the differentRegions of your project. It shows the number of sites, which have reached a certainmilestone in a region. It shows the Original Plan, the Revised Plan and the Actual Date.

This report can only be exported into Excel.

Note:

Be aware that the Preview func-tion can only display one page ofthe report (12 weeks). If you needa wider time frame, please exportthe report to Excel.


45/162



Siemens AG

3.2 The Custom Report / Search Function

CAPRI provides a powerful search- and reporting function, which allows you to create anykind of customised report or to search for certain objects in a very efficient way. The filtersettings of these reports can be saved as profiles to enable quick access to customisedreports, which are needed on a regular basis.

3.2.1 Selecting Fields and Filter for Search

By clicking on the Searchbutton (binoculars) you will be prompted the Fields and Filterfor Search dialog.

This dialog is split up into three sub windows:

Mask Selection

Field Selection

Filter

Figure 3-14: Fields and Filter for Search dialog

S (Show field)

Show this field in the Report

F (Filter)

Make this field available forFiltering

Search

Note:

The header of the filter windowtells you if you are in the Searchsection or in the Custom reportsection.

Note:

The most important fields arepre-selected in the filterfunction to save your time forselecting the standard fields.


46/162



Siemens AG

Note:

The access filter the administrator has defined for the current user will be shown in thefieldAccess Filter. This user will only be able to report on objects he has access to. Seethe Administrator Manual chapter 5.3.1 for details.

Mask Selection

This is a table of all the masks and detail tables available for filtering. The mask youchoose with the tick-boxes will appear on the Field Selection window to the right,including all the available fields in this mask. You can choose as many masks as you like.

Network / Cluster

The Network and Cluster Manager can be selected for Field Selection.

Site Information

Here you find all the masks, which contain site related information. Click on the checkboxto see all the fields of this mask in the Field Selectionwindow on the right.

Only Sites with Detail Information

Beneath this row, shaded blue, you find all the Detail Tablesof the database. These aretables where there is more than one block of information per Site (e.g. usually 3 Sectorsper Site).

If the checkbox next to the words Only Sites with Detail Information is filled and youhave chosen one of the Detail Tables, CAPRI will only display the sites which have detailinformation entered in these tables.

Field Selection

Choose the field you would like to see in the report or you would like to filter on, bychecking the tick-box either in column S or F.

S (Show field)

Show this field in the result table

F (Filter)

Make this field available for filtering

Note:

The following system fields (fields that are calculated by the system) are now availablefor filtering and in the search results:

Milestone Status

Tornado Import (date of last Tornado import)

Object Type (Candidate, SAM, Net Element,...)

Indicator (traffic light: on schedule, off schedule, )

Lease fully executed (on ACQ Mask)

TR Installation Counter (on IMP Mask)

TR Commissioned Counter (on IMP Mask)

Hotkeys:

To check and uncheck thetick-boxes in the FieldSelection window, use theSpace Bar and the up ordown arrow to move up ordown.


47/162



Siemens AG

Filter Window

Filter

In the combo box menu of this field you will find all the fields, which you have selected inthe Field Selectionwindow under the column F.

Operator

The combo box allows you to select one of the following operators:

= equal

= greater or equal

not like

like wildcard (use the operator like if you want to use the * in the value field,e.g. *street)

between between two values (e.g. two dates). When you use this operator, youhave to enter values in both value fields (value 1 and value 2).

empty shows all sites where this data field is empty

not empty shows all sites where this data field is not empty

Value 1 / 2

Here you enter either dates or values that are predefined in a look up table according tothe filter criteria you have chosen, or you can enter a free value. If you have chosen theoperator between, you will use both value fields.

AND / OR

Click on one of the tick boxes if you want to link this filter criteria with the following oneeither with an AND or with an OR operator.

Show linked and Nominal Net ElementsCheck this tick-box to implement the new network structure in the reporting. When thistick-box is checked, a record for every linked Real Net Element (on every Candidate) andfor every Nominal Net Element (on every SAM) will be created. When this tick-box isunchecked, the reporting will follow the old structure and show only the Candidate andonly the SAM. For more details on the new network structure, please refer to chapter 2.6.

Expert Filter (SQL)

The Expert Filter allows users with experience in SQL to create reports based on queriesthat are not available in the normal filter functionality. Please see some examples forthese queries below.

Create a SQL query

The fields you need for the SQL query are selected in the same way as they are selectedfor a normal Custom Report / Search (see chapter 3.2.1).

Select the fields you want to show in the report by clicking in the column S.Select the fields you need for the SQL query by clicking in the column F.

Press the SQL button.

A window showing the second part of a SQL string will replace the Filter window.

Now modify this string to your needs (see some examples below).

Click on Show Resultsto execute the query.

The meaning of the abbrevia-tions in the Fields Selection:

ACQ = AcquisitionCON = ConstructionIMP = Implementation

PND = Permits and DrawingsRP = Radio PlanningSAR = Site Acquisition ReportSite = Sites

In Detail Section:

Claim: ClaimsDRA: DrawingsMOD: ModificationsPRM: PermitsPOL: PolesSector: SectorsTRA: TransmissionsAccCac: Acceptance Mask,Customer Acceptance CentreAccDcc: Acceptance Mask,Document Control Centre

Lease: LeaseCoLo: Co-LocationSite Visit: Site Visit

Change to Expert Filter



48/162



Siemens AG

Figure 3-15: Expert Filter function

If you want to go back to the normal filter view, click once again on the SQLbutton. Be aware that the modifications you did will be lost. A warning messagewill pop up asking you if you want to continue. Confirm with YES.

Figure 3-16: Warning Message

Save a SQL query as a profile

After modifying the SQL string you can save this query as a profile by clicking on OpenProfile Dialog. The procedure of saving this query is the same as saving any othercustom report (see chapter 3.2.2).

Examples for SQL queries

Here are some examples of SQL queries that can be created with the new Expert Filter:

Show all NodeB/BTS SAMs, that have a preferred Candidate

o Mask Selection:Siteand Radio Planningo Field Selection: Object Type, Common Site Rank


49/162



Siemens AG

o Filter: WHERE Sys_ObjectType = 0 AND NetelementType = 'Node B /BTS' AND CandID IN (SELECT ObjectID FROM RadioPlanning_CanWHERE SiteRank = 'Preferred')

Compare a date against todays date

o

Mask Selection:Radio Planningo Field Selection: SAM Issued ADo Filter: WHERE RadioPlanning.SAMIssuedAD > Now()

Compare a date field against another date field

o Mask Selection: Radio Planningand Acquisitiono Field Selection: SAM Issued AD, SAR Complete ADo Filter: WHERE RadioPlanning.SAMIssuedAD >

Acquisition.SARCompleteAD

Buttons

Clear all Fields

Clears all the selections you have made.

Load the Default Profile

Loads the default filter settings.

Open Profile Dialog

Gives access to the Load Fields and Filter for Search Dialog. Here you cansave your selections as profiles. This dialog is explained in the next chapter.

Change to Expert Filter

Gives access to the SQL string that can be edited.

Open Custom Layout Dialog

Gives Access to the Layout Definition for Search window.

Show Results

Leads you to the Results for Search window.

Cancel

Cancels this operation

3.2.2 Load Fields and Filter for Search

This dialog can be used for the following tasks:

Load an existing profile for Search

Save a field and filter selection as a profile Open Profile Dialog


50/162



Siemens AG

Figure 3-17: Load Fields and Filter for Search

Load existing profile

To load an existing profile, just select the profile from the Name window on the left andthen click on the green check mark (Load (use) profile ). You will be prompted the Fieldand Filter Selection window filled with the settings of the profile you have chosen. Nowyou can modify these settings and/or execute the search (see chapter 3.2.1).

Save a field and filter selection as a profile

To save the filter and field settings that you have chosen in the previous dialog, follow thesteps:

1. Go to the window Name and click into the last row with the star (*).

2. Write the name of the profile you want to save.

3. Go to Permissions and define the access rights to your custom report. You havethe choice between:

No access for other users

Read access for all users

Full access for all users

4. Write any remarks (optional) about this custom report, e.g. a short description ofthe filtering criteria.

5. Click on the diskette symbol Save current settings to . (name of profile).

6. Click on the OK button (Load (use) profile) to come back to the Field an FilterSelection window with the settings of the profile you have created.

7. From here you can execute the Search by Clicking on the show results button(green check mark).

Profile Pre-selection (optional)You can pre-select the type of profile you are looking for. This is especially useful whenthere are many reports stored in the database. You have the following possibilities:


51/162



Siemens AG

All Profiles

This button will show you all the profiles stored in the database that have access rights forall users (see below).

Select All Profilesand click on Refresh Profile Selectionto update the list of profiles.

Only Report Profiles

This button will show you all the search profiles and custom report profiles stored in thedatabase that have access rights for all users (see below).

Select Only Report Profiles and click on Refresh Profile Selection to update the list ofprofiles.

Only Power Profiles

This button will show you all the power profiles stored in the database, that have accessrights for all users. See chapter 3.3 for more details on power profiles.

Select Only Power Profiles and click on Refresh Profile Selection to update the list ofprofiles.

User Selection

In this combo box, you can choose to either only see the reports you have created, or tosee the reports of all users. The selection is done by the login name.

Select either your name or All Usersand click on Refresh Profile Selectionto update thelist of profiles.

Buttons

Delete profile

Assign Custom Report settings to profile :

Assign the setting you have made in the Set Selection and Filter Dialog to theCustom Report you have just created.

Accept current selected profile .:

Execute the search and to access the Custom Report Layout dialog.

Cancel profile selection

3.2.3 Layout Definition for Search

The Layout of the Custom Report can be edited. You can rename the labels, define theorder and the width of the columns etc.

Figure 3-18: Layout definition for Search

Open Custom LayoutDialog


52/162



Siemens AG

Layout

The row highlighted in orange shows the names of the fields, which you have selected.You can change the order of the columns by clicking into one of the orange fields andmoving this column to a different place (drag and drop).

You can also change the width of the columns by moving the cursor over the separating

line between two orange fields and clicking when the cursor changes to a symbol with twoarrows. Keep the mouse button pressed and move the separating line right or left (dragand drop).

Labels

The Labels row shows the labels of each column how they will be seen on the printout.You can change the name of these labels (e.g. into your language).

Sort

In this row you can define the sorting order of your report: click into that field of this rowwhich corresponds to the column on which you want to sort. Open the combo box, whichappears. You can choose between ascending and descending sorting. You can defineseveral sorting options but be aware that they should make sense.

Layout Type

There are three different Layout Types, they all refer to the detail tables. Additionallythere is the possibility to group the results and add some functions:

Grouped: Shows the detail information (e.g. Sector information) as a group ofrows directly underneath the row containing the Site Information.

Joined: Every detail information block has its own row containing all information.So for e.g. every sector there is a row containing Site information and sectorinformation (For 3 sectors the site information is repeated 3 times).

One Row: All the information concerning one site is shown in one row. Thismeans that the blocks of detail information are posted one after the other in one

row. Functions: By selecting this feature, you have the possibility to do the following:

o Grouping the results: Shows the results of your report grouped by thevalues of the selected column (E.g. Region). You can specify severalgrouping criteria. CAPRI will use the column most to the left as the firstgrouping criteria and then will proceed to the right. If you want to changethe grouping order, please change the order of the columns. To specify agrouping criteria, please select the column on which you want to groupand click into the row Grouping.

o Add mathematical functions: The following mathematical functions areavailable for text fields, number fields and date fields. Note that all thesefunctions always refer to the group you have specified in the rowGrouping:

Text fields and Date fields:

Count: counts the number of entries in this column (pergroup)

Min: Shows the minimum value in this column (pergroup)

Max: Shows the maximum value in this column (pergroup)

Number fields:

Avg: Shows the average value in this column (per group)

Count: see above



53/162



Siemens AG

Min: see above

Max: see above

Sum: Shows the sum of all the values in this column (pergroup)

Stdev: Shows the standard deviation on all the values inthis column (per group)

Var: Shows the variant on all the values in this column(per group)

Figure 3-19: Grouping and adding functions to the results

Figure 3-20: grouped results

Landscape

If this checkbox is filled the report will be printed in landscape format, otherwise inportrait format.


54/162



Siemens AG

Buttons

Reset Layout to Default

Open Profiles Dialog

Open Selection and Filter Dialog

Show Results: Accept the layout and move to the Selection Results window

Cancel

3.2.4 Results for Search

The results of your report will be shown in the Selection Results window, from there youcan preview the printout, print the report or export it to Excel. You can also copy aselection of cells into Excel.

Figure 3-21: Selection Results

To copy a selection of cells into Excel select the cells you want to copy by moving thecursor over the cells while keeping the mouse button pressed. The cells will behighlighted. Now you can move them to Excel with copy (ctr+c) and paste (ctr+v).

Buttons

Refresh current result (execute search once again)

Open Selection and Filter Dialog

Open Custom Layout Dialog

Export results into csv-file

Print results

Preview the Results

Locate and show site

Cancel

Note:

The whole report or only partsof it can now be exported toExcel or Access by usingcopy and paste.

Just highlight the fields youwant to copy with the cursor(for the whole report, click onthe field in the top left corner),press ctrl+C to copy. Move toExcel or Access and pressctrl+V to paste.


55/162



Siemens AG

3.2.5 Load existing Custom Reports

Once you have created and saved the filtering profiles as custom reports, you can accessthem via a shortcut:

1. Click on the Load existing Custom Reportbutton in the Toolbarand you will cometo the Load Custom Report window directly.

2. Choose the report you want to execute and proceed as described above.

Note:

It is not possible to save new custom reports or delete existing custom reports in thisdialog. To edit the Custom report, please go to the Load Set Selection and Filter dialogas described in chapter 3.2.2.

Figure 3-22: Load Custom Report

3.2.6 Create new Custom Report

The procedure to create a new custom report is exactly the same as the procedure forsaving field and filter selections as a profile (see chapter 3.2.2). The newly createdcustom report will be stored in the list of existing custom reports, which can be accessedthrough the Load existing custom report button.

Load existing Custom Report

Create new Custom Re ort


56/162



Siemens AG

3.3 Power Profiles

In version 4.0 we provide an even more convenient reporting feature called PowerProfiles. With this functionality you can attach an excel-file directly to a custom report youhave created. This gives you the possibility to export the data you need into a predefinedexcel report with a click of a button. You can create your own forms (e.g. SAM forms, Site

Acquisition Reports, TSS Reports, etc.) in Excel and can fill them with the actual data outof CAPRI within seconds. Or you can create sophisticated reports including calculations,macros or diagrams of any sort and have them filled with data automatically from CAPRIvia the power profiles. Only with the click of a button.

Figure 3-23: Load Power Profile

3.3.1 Create a new Power Profile

The procedure to create a new Power Profile report is exactly the same as the procedurefor saving field and filter selections as a profile (see chapter 3.2.2). Just follow theseadditional steps:

Before saving the power profile, click on the Profile is Power Profiletick box

Click on the Browsebutton to select the Excel target file you want to attach to thisPower Profile. The entire path of this excel file will be displayed in the windowbelow.

Check the Show Filter Dialogtick box, if you want to be prompted the filter dialogbefore the results will be exported to the excel file. This might be important if youwant to change some filter criteria before exporting (e.g. change dates for certainmilestones). If this tick box is not checked, the data will be exported directly to theExcel target file as soon as you hit the Use Profile button.

Press the Save current settings to profile button (face) to save your settings.

Note:

Excel has to be installed onthe same computer as theCapri.exe to be able to openthe target file directly.


57/162



Siemens AG

3.3.2 Load existing Power Profile

To load and execute an existing power profile follow the steps:

Click on the Load existing Custom Reportbutton in the Toolbarand you will beprompted the Load Custom Report window.

Pre-select the power profiles by clicking on Only Power Profiles and then onRefresh Profile Selection.

Select the Power profile you want to use by highlighting it.

Hit the Use Profile button to export the filtered data directly to the Excel targetfile. Excel will be started and the file will be opened automatically.

An additional table called CAPRIdatawill be created in the target file. This tablecontains all the exported data.

This table can be used as a data source for any kind of reports, calculations,forms, etc. you create on other tables of this file. Just create a link between thefields on the CAPRIdatatable to the appropriate fields on the other tables.

Every time you run the export of the power profile, the old data on the CAPRIdatatable will be overwritten with the new data.

IMPORTANT NOTE:

The CAPRIdata table must not be changed (order of columns, additional text, etc.).Otherwise the export cannot be executed the next time you run the power profile.

Figure 3-24: The Excel target file

If you have changed the settings of the Power Profile in CAPRI you may receive thebelow error message the next time you run the power profile. It appears when you haveadded fields to the power profile.

Tip:

If you have accidentallychanged the CAPRIdata table,just rename this table to

something different. The nexttime the power profile is run, anew table with the nameCAPRIdatawill be created andall the links you have installedwill be functioning again.


58/162



Siemens AG

Figure 3-25: Error message after changing the settings of the power profile

There are two possibilities to handle this problem:

1. Delete theCAPRIdata table in your Excel file. This will also delete links you havecreated between theCAPRIdata table and other tables in your Excel file.

2. In order to save the links you have created, follow the steps below:

Open your Target file with Excel and go toInsert Name define

In this dialog select the entryCAPRIdataand pressdelete, then pressOK

Now move to the tableCAPRIdata and select all fields in this table (click ontothe field in the left top corner)

Go back toInsert Name define and writeCAPRIdatainto the upper field,click onadd, then click onOK.


59/162



Siemens AG

3.4 The Charts

From the Tools Graphical Overviews menu you can access the submenu that allowsyou to generate two kinds of charts:

Site Status Chart

The Site Status Chart gives a quick overview on the overall Status of the project, it showsa bar chart with the number of preferred sites (horizontal) which have reached a certainmilestone status (vertical).

Figure 3-26: Site Status Chart

Clicking the Printbutton will print the chart.

The Trend Analysis

The Trend Analysis chart shows you a forecast on the number of sites, which will reach acertain Milestone. The Milestone can be selected from the list of milestones on the right.The timeframe and time scale can be specified in the right top corner. Only the sites thatare ranked Preferred in the Radio Planning screen and have the Net Element Type setto Node B / BTS on the Site screen will count.

Before displaying a Trend Analysis the data pool has to be analysed. Once the screenappears you can freely define the time range you want to display. Moreover you canscale in weekly, monthly, quarterly or yearly increments.

Note:

The chart shows you the pre-ferred Node B / BTS Sites.Nothing else!


60/162



Siemens AG

Figure 3-27: The Trend Analysis

Clicking the Print button will print the chart.


61/162



Siemens AG

4 Interfaces

CAPRI offers a large number of interfaces to import and export data from or to othercommonly used tools. You may supply the database with updates and new data on the

one hand; on the other hand you can make the information stored in CAPRI visible inother programs like Excel, for example. To get access to the various export and importinterfaces, click on Interfacesin the menu bar.

Figure 4-1: Interfaces

MapInfo: MapInfo is a tool to visualize sites and links on digital maps. TheMapInfo interface enables users to export site and link information from CAPRIinto MapInfo.

Database Dump: The dump interface is a separate program that exports all dataof the CAPRI database to a non-protected MS Access database.

Pathloss Interface: Pathloss is a Microwave Planning tool, where transmissionplanners can create microwave links including all technical specifications and

information. The Pathloss Interface is used to export site information from CAPRIand, in turn, import microwave link information from the Pathloss program.

Tornado DMS Import: CAPRI offers you the possibility to import Radio Planningdata from the Tornado DMS system.

Tornado-N: With the introduction of a new Radio Planning too

capri user manual v4.1 screen_optimized

Documents