Deployment action modes

You can define the action mode of each object that you export to specify what action is performed on the object when it is imported.

You can choose from four action modes when you export objects to define how they are imported into Product Master.

When you create an export script and specify action modes for your objects, an Action tag is stored in the corresponding XML file of your export compressed file to specify the action mode of each object.

The four action modes are:

CREATE
The CREATE action mode creates the object in the specified company of the target system. An error message is logged if you attempt to import an object that exists in the company.
Limitations:
  • Jobs of executable type, except for the Import Environment objects, cannot be created through an export or import process.
  • The following objects will always be updated or created if the object types do not exist:
    • Lookup table content
    • Hierarchy content
    • Catalog content
UPDATE
The UPDATE action mode updates an existing object in the target system. An error message is logged if you attempt to import an object that does not exist in the company. Only the attributes of objects that can be modified from the user interface or through script is modified when you use this mode.
Limitations:
  • The UPDATE action mode is not applicable with the following object types:
    • Exports
    • Feeds
    • Collaboration areas
    • Reports
  • When an alert object is exported and then imported with the UPDATE action mode, a new alert is created even if an alert with the same description exists.
  • The following object types will always be updated or created if the object types do not exist:
    • Lookup table content
    • Hierarchy content
    • Catalog content
  • The UPDATE action mode is the only action that you specify for the following object types:
    • Company attributes: You can only specify to update either all or none of the objects.
    • My Settings: You can only specify to update either all or none of the objects.
DELETE
The DELETE action mode deletes the object from the specified company of the target system. An error message is logged if you attempt to delete an object that does not exist in the company.
Limitation:
  • The DELETE mode is not applicable with the following object types:
    • Access control group (ACG)
    • Users
    • Company attributes
    • My settings
    • Alerts
  • Jobs of executable type, except for the Import Environment objects, cannot be deleted through an export or import process.
CREATE_OR_UPDATE
The CREATE_OR_UPDATE action mode creates an object if it does not exist, and update the object if it exists in the company of the target system. This action mode is the default mode and is used when you do not define the action mode.

When you import compressed files that are generated in versions before Product Master, the CREATE_OR_UPDATE action mode is used.

Limitations:
  • The UPDATE action mode is not applicable with the following object types:
    • Exports
    • Imports
    • Feeds
    • Collaboration areas
    • Reports
  • When an alert object is exported and then imported with the UPDATE action mode, a new alert is created even if an alert with the same description exists.
  • Jobs of executable type, except for the Import environment, cannot be created through an export or import process.
  • The following object types will always be updated or created if the objects do not exist:
    • Lookup table content
    • Hierarchy content
    • Catalog content

For writing scripts, ensure that you specify the action modes by using uppercase text only. An error message is logged if you specify an incorrect action mode.

When you import jobs with an environment import, historic schedules will not be imported. Historic schedules are not repeating schedules in the past. Therefore, you see the following error in the import log: ERROR:CWXIM0272E:Create not supported for job of type CTGTODB. If this error message is being thrown in context of an environment import for objects of type "Job", this means that historic job schedules are not being repeated for this job and that this job will not be imported into the target company. Job schedules that took place in the past in the source company will not be imported into a company through environment import.