Specifying Your Change Options

The Changes sheet of the Extract dialog, shown in the following image, is displayed when you have selected the extraction of patch version changes in the current schema and you click the Changes sheet.

Use the Changes sheet to select the schema entities that have changed within specified criteria.

You can specify the extraction of patch version changes:

You can also select the entities that have changed in the patch versions that match your specified criteria. All applications added to or changed in the specified patch version are included in the schema extract.

Change options are enabled only when you extract the current schema; that is, you cannot specify these options for the extraction of multiple schemas.

Only the latest change to an entity is extracted. If a specific entity was changed in any way by any developer in an earlier patch release and it was again changed in a later patch release, only this latest change is extracted and any earlier change is lost. You should therefore consider extracting patch version changes when you set a new patch version, if appropriate. For details, see "Setting up a Patch Number" under "Patch Versioning", in Chapter 3 of the JADE Development Environment Administration Guide.

To specify your change options

  1. In the User Id(s) text box, specify the full user identifier of the developer whose changed entities you want to extract. If you do not specify a value in this text box, the patch version changes made by all developers are extracted. By default, your user id is displayed in this text box.

    You can specify one or more user identifiers in this text box, by specifying each of the required identifiers separated by a space. You must specify each user id in full (for example, wilburBloggs2), as abbreviated user ids (for example, wilbur) are not valid.

  2. In the From Version text box, specify the number of the patch version from which the changed entities are to be extracted; for example, 16.0.2.4. The last number (the .4, in this example) indicates the patch version; the preceding numbers indicate the system version and release of JADE itself (16.0.2, in this example).

    If you do not specify a value in this text box, the extraction of changed entities starts from your first JADE patch version.

  3. In the To Version text box, specify the number of the latest patch version from which the changed entities are to be extracted; for example, 16.0.2.7. The last number (the .7, in this example) indicates the patch version; the preceding numbers indicate the version and release of JADE itself (16.0.2, in this example).

    If you do not enter a value in this text box, the value defaults to that specified in the From Version text box, if present. If you specify a value in neither the From Version nor the To Version text box, the extraction is performed on all changed methods that match any specified user id or date criteria.

  4. In the From Date text box, specify the starting date from which patch version changes are to be extracted; for example, 21MAY17. (The date must be a valid date.)

    By default, the current date is displayed in this text box.

    If you do not specify a value in this text box, entities are extracted starting from the earliest timestamp; that is, the first date on which a patch version entity was changed.

  5. In the To Date text box, specify the date up to which changed entities are to be extracted; for example, 28November17. (The date must be a valid date.) By default, the current date is displayed in this text box.

    If you do not specify a value in this text box, the extraction ends with the last entity changed on the current date.

  6. If you specified a value in the From Date text box and you want to specify the time on that date from which changed entities are extracted, specify the starting time in the From Time text box; for example, 09:30:00. (The time must be a valid time.)

    If you do not specify a value, the time defaults to 00:00:00. Your specified value is ignored if you have not specified a start date.

  7. If you specified a value in the To Date text box and you want to specify the time on that date up to which changed entities are extracted, specify the end time in the To Time text box; for example, 18:59:59. (The time must be a valid time.)

    If you do not specify a value, changed entities are extracted up to the current time. Your specified value is ignored if you have not specified an end date.

  8. Click the Show Items on Selective Sheet button if you want to restrict the extraction of changed entities to specific classes or methods.

    The Selective sheet of the Extract dialog is then displayed, to enable you to select only those changed entities that you want to extract. For details, see "Specifying Selective Options", earlier in this chapter.

  9. Click the OK button to confirm your selections. Alternatively, you can click the Cancel button to abandon your selections.

For details about setting a patch version and displaying a summary of patch version changes, see "Patch Versioning", in Chapter 3 of the JADE Development Environment Administration Guide.