Exporting a tracked object’s previous state

3 minute readData analyticsAutomation

The Change History displays a list of changes in reverse chronological order (from latest to oldest) for tracked entities in objects such as applications, independent microservices , procedures, workflows, workspaces, resources, and project-owned components such as library components. Each row in the Change History or a tracked object is a record of a change made either to the tracked object or to a tracked object owned by the object (directly or indirectly). For example, the Change History of a project would show both changes to the project itself and changes to any tracked object in the project, such as its procedures, the steps for each procedure, or properties belonging to the procedure steps.

Some types of objects (mostly run-time objects such as jobs, because tracking those would be resource-intensive and seldom useful) are not tracked by the Change Tracking feature. For a few types of tracked objects, some attributes are not tracked (for example, agents are tracked, but certain attributes of agents that vary frequently in real time, such as their current status, are not).

Changes to untracked objects, or to untracked attributes of tracked objects, are not shown in the Change History and cannot be reverted. In general, objects that are normally created or changed manually are tracked, and objects that are normally created or modified during automated processing are not, However, depending on your specific usage patterns, this behavior may not be recorded in the Change History, such as when you frequently run jobs that use ectool or API commands to automate the creation of new procedures or steps.

Follow these steps to export a previous state of a tracked object and its tracked contents:

  1. Go to the Change History for the object that you want to revert using one of these methods:

    • Click the Track Changes button ( )for the object.

    • From the Automation Platform Home page (https://<cloudbees-flow-server>/commander/), click the Change History button ( ) to go to the "Change History—Search" page and search for the object.

  2. Locate the time period in which you are interested.

    A list of changes for the tracked object appears.

  3. Select a row (record) in the Change History corresponding to the earliest change after the state that you want to export.

    You will be exporting state of the object and its tracked contents directly before the selected change was made.

  4. Before clicking the Export changes button ( ), you may want to look through all the changes have been made since the state you will be exporting, so you know what will not be in your export.

    1. If so, you may need to modify the timeline and filter settings in order to display all records in the Change History.

    2. Make sure that the end of the timeline is set to Now and that the filters are set to View All Changes.

    3. Look through the entire list of changes from the most recent to the one you have selected, expanding them to see the details if needed.

  5. Click the Export changes button ( )

    If this operation is successful, the Change History of the object and its tracked entities are exported. A message appears that the Export operation was successful.

    If this operation is not successful, the Change History of the object and its tracked entities are not exported. A message appears about the failed operation.