Change data import agent

The Change Data Import Agent is used to import the files exported by the Change Data Export Agent. The agent picks up the zipped XML files placed in a specified folder in the agent criteria, extracts the files, and applies the changes to the database.

Notes:

  • If an entity is directly modified in the target environment, the changes are overridden by the source database updates for the same entity, when the change data import agent is run.
  • This agent needs additional instrumentation for performance improvement. For more information, refer to the Considerations for Performance Management topic.

Attributes

Table 1. Change data import agent attributes
Attribute Value
Base Transaction ID CHANGE_DATA_IMPORT
Base Process Type General

Criteria Parameters

Table 2. Change data import agent parameters
Parameter Name Description
Action Required. This parameter triggers the transaction. The default value is "Get".
Number of Records To Buffer The number of records to retrieve and process by the agent is set in this attribute. The default value is "5000".
Import Directory The import folder where the zipped XML files are stored for the agent to process.
Collect Pending Jobs If this parameter is set to N, the agent does not collect information on the pending jobs for this monitor. This pending job information is used for monitoring the monitor in the System Management Console.
Colony Id The identification number of the colony. Required in a multi schema deployment where a table may exist in multiple schemas. Runs the agent for the colony.

Events Raised

Table 3. Events raised by change data import agent
Transaction/Event Key Data Data Published Template Support
ON_SUCCESS None
YSC_CHANGE_
DATA_
IMPORT.ON_
SUCCESS.xml*
No
ON_FAILURE None
YSC_CHANGE_
DATA_
IMPORT.ON_
FAILURE.xml*
No

Statistics Tracked

None

Pending Job Count

None