Utility - exportChangeTrackingRun

Utility - exportChangeTrackingRun

Description :

This command exports the change tracking information for a particular run of a Snapshot Job. You must identify the job run by its run number.

The change tracking information includes a descriptive list of the changes that occurred between the last snapshot and this snapshot.

This command exports the change tracking information to a file. You can save the results in HTML or CSV format.

To execute this command, the BLCLI user's role must have the following authorizations:

  • SnapshotJob.Read authorization for the job producing the change tracking information.
  • JobFolder.Read authorization for the job folder containing the Snapshot Job.

Return type : java.lang.Void

Command Input :

Variable Name

Variable Type

Description

jobGroupName

String

Fully qualified job group where the Snapshot Job is stored.

jobName

String

Name of the Snapshot Job whose change tracking information you want to export.

runId

Integer

Job Run Id of the Snapshot Job run whose change tracking information you want to export.

exportFileName

String

Name of the file into which you want to export the change tracking information.

exportType

String

Format for saving exported results (CSV or HTML).

Example

The following example shows how to export the change tracking information from a particular run of a Snapshot Job. To prepare for the export, we first get the job key, and use it to get the job run key; we then convert the job run key to a job run ID, and then we are finally ready to run the export command.

Script

JOB_GROUP="/sampleJobGroup"
 
JOB_NAME="sampleJob"
 
JOB_DB_KEY=`blcli SnapshotJob getDBKeyByGroupAndName $JOB_GROUP $JOB_NAME`
 
JOB_RUN_KEY=`blcli JobRun findAllRunKeysByJobKey $JOB_DB_KEY`
 
JOB_RUN_ID=`blcli JobRun jobRunKeyToJobRunId $JOB_RUN_KEY`
 
CHANGE_TRACK_RUN_EXPORT=`blcli Utility exportChangeTrackingRun $JOB_GROUP $JOB_NAME $JOB_RUN_ID "C:/temp/sampleJobResult.csv" "CSV"`
Was this page helpful? Yes No Submitting... Thank you

Comments