Migration Object Group

This page is accessed via Business Process Automation > Migration Project Management > Migration Projects. Click the Add icon () in the grid header.

A migration object group is a component of a migration project. It is used to define objects of a selected type of data to be included in the migration group, such as a user menu.

Adding a Migration Object Group

1. Enter a Screen Set ID. This specifies the Finder page used to select objects of the desired type.
2. Click View Child Objects to view all the related objects which are automatically imported, when you use the screen set ID.
3. Enter a Description. This description appears on the migration project and is useful for differentiating the same screen set IDs that would otherwise appear to be the same on the migration project.
4. Select a Transaction Code. This field indicates how the objects in this group will be processed on a subsequent import.
   • Insert: Inserts a new record. If the record already exists, an error will occur.
   • Insert Ignore: Inserts a new record. No error is generated if the record already exists. The object will not be updated.
   • Insert Update: Inserts a new record or updates if the record already exists.
   • Delete: Deletes the record. An error occurs if the record does not exist.
5. When you either import or export a project, you can know the Status of an object group.

• • ACTIVE-The project content has been created or edited but not exported since the last edit.
  • SCHEDULED-The project has been scheduled for import by the Process Management UI.
  • RUNNING-This project export or import has started and the project content is currently being created.
  • EXPORTED-The project content has been exported and not edited since the last export date.
  • ERROR- An error occurred while exporting or importing the project.
  • IMPORTED-The project has been completely imported with no errors.
  • PARTIAL-The project import process has been completed but some objects had errors. Review project content and import log to determine the exact error.

6. When the Refresh Cache check box is selected, any objected created or updated by a Project Import will refresh any associated cache. For example, creating a new agent will result in the agent subscribing to its events and so will be triggered when expected.
7. If the Raise Lifetime Event check box is selected, then any object created, updated, or removed by a Project Import will trigger the "xxx - CREATED", "xxx - MODIFIED" and "xxx - REMOVED" events (where type "xxx" already supports lifetime events) and process any subscribing agent workflow. These events will be raised with the "MIGRATION" data source and so to trigger agents this data source has to be selected as one of the options (e.g. in addition to INTEGRATION, USER, INTERNAL).
8. Enter a Saved Query ID. You can enter either a Saved Query ID or list the Object IDs. If you provide a Saved Query ID, the Object ID grid is not visible. When there are large numbers of objects to be added in the object group, you must enter the Saved Query ID because only a saved query allows you to select thousands of records. For example, on the result screen, though there are 5000 objects for the REGION screen set, OTM displays only 1000 objects due to a predefined limit of 1000 records. In this case, select a saved query ID for REGION. The Saved Query ID enables you to export any number of objects in an object group. After you import the project, you can then view the number of objects which are exported using the saved query.  

The values possible for the Saved Query ID change based on the screen set you select.

6. Enter one or more Object IDs. The valid values of the object ID change based on the screen set you select.
7. Click Finished for every object ID you enter.
8. Click Finished.