snapshotCompareReport

Compares two snapshots and creates the Snapshot Compare Report identifying the differences in calculation rules and rulesets, and data forms included in the snapshots.

The report shows the differences in rules and forms definitions. It also identifies whether one snapshot contains a rule, ruleset, or form that is present in the other snapshot. Differences in rulesets are identified based on the rules contained in them. Note that the generated report does not report on the differences in the properties of the cubes or dimensions.

• Recent performance deterioration in an environment. You can compare the previous snapshot with the current snapshot to check on the differences that may have caused the performance deterioration.
• You see difference in behavior or performance between two environments that you expect to have identical functional behavior or performance. In this case, you can compare the snapshots of the two environments to understand the differences between them.
• You suspect that some rules, or forms have disappeared from an environment. Use this report to compare the artifacts that used to exist and the current artifacts.

Applies to

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Enterprise Profitability and Cost Management, Strategic Workforce Planning, and Sales Planning.

Required Roles

Service Administrator

Usage

epmAutomate snapshotCompareReport SOURCE_SNAPSHOT TARGET_SNAPSHOT [reportName=REPORT_NAME.html] where:

• SOURCE_SNAPSHOT is the name of the snapshot to which the comparison is to be made. The report contains data on the differences in the rules and forms in this snapshot.
• TARGET_SNAPSHOT is the name of the snapshot you want to compare.

  Note:

  • Snapshot names may be specified with or without the .ZIP extension.
  • Both snapshots must be available in the environment. Use the uploadFile, copyFromObjectStorage, or the copySnapshotFromInstance command to upload them to the environment.
• REPORT_NAME, optionally, is the name of the report file. Default report name is SnapshotCompare.html.

  Use the downloadFile command to download the report.

Examples

• epmAutomate snapshotCompareReport "Artifact Snapshot" Backup_22-09-08.zip reportName=Snapshot_Diffs.html
• epmAutomate snapshotCompareReport backup_snapshot_22-Aug-08.zip backup_Snapshot_22-Sep-08.zip reportName=Sep_22_snapshot_compare_report.html