====== Change Management ======

BIPLUS has been designed to prevent one developer from over-writing a report while another developer is working with it.

Reports are either checked out to you (developer) or checked into the repository.

You can only check-out a report that is checked in to the repository. If another developer is busy with modifications to the report, then you (developer) must contact the developer to whom the report is checked out, or contact the Administrator for help.

Administrators can check reports in on behalf of other developers or can cancel a checkout. This is to prevent the situation where you are starting to make changes to a report, and then going on leave or training, leaving the report checked out for yourself, preventing other developers from working on it. If the change becomes urgent and the business requires the changes to be implemented while you are not available to check the report in, then the Administrator can perform the testing to ensure that any modifications documented and specified are now working, or can cancel the checkout to enable another developer to continue where you left off.

As you click on a report in the Report Tree, the status of the report and to whom it is checked out should appear. As you can see the screenshot below, the report has been checked out to a developer whose UserId is ‘FERENC’ on 27 November 2012.

The following image shows the checkout information and shows that this particular report is check-out by developer 'FERENC'. So this report cannot be worked on by any other user except 'FERENC', until 'FERENC' checks the report IN or the administrator cancels the checkout. When a report is checked out by a user then other users will see that report's check-out information in 'Maroon' background color.

{{:biplus:documentation:checkout_by.png?nolink&550|}}

When a report is checked in by you for yourself then you will see that report's check out information appear in a 'Green' background color. See image below.

{{:biplus:documentation:checked_out.png?nolink&550|}}

When a report is not checked out at all by any user (Or you can say that it is checked in to the repository) then it looks as follows. No check out information is written in 'Maroon' background color.

{{:biplus:documentation:checkout_by_none.png?nolink&550|}}

What if you want to see which reports are checked out to you? This is easily achieved by clicking the Version control menu and selecting **Show My Checkout Reports**.

{{:biplus:documentation:my_checkout_report_menu.png?nolink&550|}}

Clicking on **Show My Checkout Reports** button opens the dialog below. Using **My Checked Out Reports** dialog you can see all checked out reports to you and by selecting a report (or selecting multiple reports while holding down the control key) you can either check in the report/s or cancel the checkout on the relevant report/s. 

A browse button in front of Report Name (highlighted in image below) displays where that report appears in reports tree.

{{:biplus:documentation:my_checkout_reports.png?nolink&550|}}

An Admin user has the power to check in reports on behalf of you or other developers and cancel those checkout reports. Simply select the **Show All Checked out Reports** option of the **Version Control** menu. 

{{:biplus:documentation:all_checkout_report_menu.png?nolink&550|}}

This opens the **All Checked out Reports** dialog as below, which lets you (Administrator) check-in or cancel the checkout of one or more reports. 

{{:biplus:documentation:all_checkout_reports.png?nolink&550|}}

A browse button in front of Report Name (highlighted in above image) displays that where that report appears in reports tree.