Setting Object Names

When defining an object type, it is important to choose one field to represent the name of this object in a package line. This field is the object name. To designate a field as the object name, select that field's Parameter Column in the Object Name Column field.

For example, to designate the File Name field as the object name for a File Migration object type, select the File Name field's Parameter Column in the Object Name Column field.

In the package window, the object name for each package line is displayed in the Object Name column, on the Status tab.

The object name field drives additional functionality:

  • If the object name field is a file chooser or an auto-complete list, multi-selection is automatically enabled on this field when users add a line to a package with this object type. If multiple values are selected, a new package line for each value will be created, allowing users to add multiple lines to a package simultaneously.

  • All migrations are tracked in the database tables KENV_ENV_CONTENTS and KENV_ENV_CONTENTS_HIST. The value of a package line's object name field is stored in these tables (along with other relevant data) whenever a migration occurs.

  • You can use the Object Type Workbench to query the Object Name.

Setting Object Revisions

You can create a field on the object type to represent the revision number of the object. This field is often a numeric text field. You can then configure the deployment process to consider the object revision number during package processing.