Bookshelf v7.5.2: Creating a Patch File

Siebel Tools Reference > Repositories > Creating Patches >

Creating a Patch File

A wizard steps you through the process of creating a patch.

To create a patch file

Make sure that both the original source and the modified source repositories are present on the client computer.

Select File > Open Repository from the menu bar and open the modified source repository.

NOTE: You can skip this step if you are building a patch file from an archive file.

Select Tools > Utilities > Build Patch from the menu bar.

The Build Patch - Setup window appears.

In the "Select modifications from" radio button group, select either Changed objects in current repository or Archive file:

Changed objects in current repository. Allows you to generate the set of source object definitions in the patch file from all object definitions in the currently open (modified source) repository that have a value of TRUE in their Changed property. The Changed property indicates changes to property values or child object definitions for all object definitions that have changed since a specified date. This is an easy way to capture all object definitions that have changed since the start of work on the new release.

NOTE: This is useful for creating cumulative patch files—that is, if several patches are created over time, each successive patch will include all changes that went into previous patches plus the most recent changes, as long as the Changed Indicator Date has not been modified. This is the real reason that it is possible to define a patch using the Changed property. If you use the Changed indicator in this or any other way, you need to be careful that the Changed Indicator Date does not get set arbitrarily.

Archive file. Allows you to use an existing archive file to generate the same set of object definitions in the patch file. Use this option when the set of patch object definitions is identical to a recently exported archive file, or when you want to explicitly select individual top-level object definitions to be included. In this latter case, generate the archive file prior to generating the patch file. Building a patch from an archive file may also be preferable when there are too many object definitions with a Changed value of TRUE.

If you selected the Archive File option, specify a pathname and filename for the archive file in the File Name box, or click the Browse button and navigate to the archive file.

In the Repository box, select the name of the original source repository.

In the Patch File box, specify a pathname and filename for the patch file to create.

Click Next.

The Build Patch Summary window appears.

If you selected the Archive file option, the list of object definitions for the patch loads immediately.

If you selected the Changed objects option, the system requires a minute or more to generate the list, because it needs to scan through the repository and check all the Changed property values.

Click Finish.

The patch file is generated in the directory location you specified in Step 4.