Checking In an Item

Purpose

Check in an item revision when you have finished editing it and want to update Dimensions.This operation is not available for items in a stream.

PRIVILEGES Revise Item Content

To check in an item:

In an Items list, select one or more checked out item revisions.

You can select multiple items. If you do, you cannot change item attributes or status.

Select Item | Check In, or click the Check In Item button.
In the Comment field, type a description of the changes you made.
To set attributes, click the Attributes tab and type or select values.

Attributes in bold are required. Attributes in italics cannot be modified.

Click OK.

If Dimensions CM has determined that there are other revisions of the item that need to be merged with your changes, you may be presented with a Tip Conflicts dialog box. This will happen if:

Your administrator has set the option DM_DISABLE_BRANCH_CHECKINS in the dm.cfg file for the server. For details, see the System Administration Guide.

and/or

You have set the option Check for tip conflicts when checking-in or updating items in Tools | Preferences | Tip Conflict Options. See Setting the Tip Conflict Options.

Select the option you require on completing the merge:

Select Merge my changes and check-in now to invoke the Serena Merge Tool and for the merged file(s) to be saved to a temporary file, and for the temporary file to be used for the check in.

Select Update my local workfile content after merging to have the files in your work area overwritten with the resulting temporary merged file after completing the merge. If this option is not set, the files in your work area will remain as they were before the check in/update and the temporary file will be discarded once the check in is complete.

Select Merge with my workfiles, and check-in later to invoke the default merge tool and have the merged file overwrite the file in your work area, but not be checked in to the repository, enabling you to carry on working with this merged file.

If you attempt to check in or revise the file later, the local metatada will have recorded that a merge was performed. Dimensions CM will check whether there have been any subsequent changes in the repository, and if not, check in or revise the merged file (without invoking the default merge tool). If there have been changes in the repository, the Serena Merge Tool will be invoked.

Select Do not perform an interactive merge but check-in my changes as the tip to check in the version of the file in your work area as the tip revision without invoking the default merge tool.
Select Ignore the conflict and continue with the check-in to check in the version of the file in your work area as a branch revision without invoking the default merge tool.

NOTE This option does not appear if your administrator has set the symbol DM_DISABLE_BRANCH_CHECKINS in the dm.cfg file.

Select Don’t show this message again; always assume my current selection, if you do not want this dialog box to be displayed again. You can subsequently change the options in this dialog box by selecting Tools | Preferences | Tip Conflict Options, and you can also re-enable the display of this dialog box.

Click OK.

Depending on the options you have previously selected, you may be presented with the default merge tool. Follow the instructions in the online help for the Serena Merge Tool, or see Chapter , "Using the Serena Merge Tool" on page 521 in the Serena® Dimensions® CM User's Guide for more details.

On completion of the merge the action specified will be taken.

If you have selected multiple items, and Dimensions CM subsequently detects that another merge is required, the specified action will be taken again, and you will not be presented with the Tip Conflicts dialog box.