You can use the Revisions tab to monitor and manage changes your team makes to an integration over time (based on the access and permissions in an account or integration). Revisions use version control logic and git-style features to help you manage changes to your integration.
Contents
integrator.io creates a revision when you perform a pull, revert or snapshot operation in an integration. Every revision is associated with a unique identifier (ID). These features work similarly to git pull, revert, and diff or commit commands.
Important: You can manage and revert your integration to any revision you've ever created, regardless of its age. All revisions are saved in integrator.io.
Revision types
There are three basic revision types for integrations: pull, snapshot, and revert.
Important: You can only perform one revision at a time (a snapshot, a pull, or a revert).
Snapshot
You can spontaneously create a snapshot as a version control backup when you’re working on changes. This backup is especially useful when you are working on an integration in your production environment. integrator.io creates a "snapshot" revision when you click the Create snapshot button.
If you run into an error or other issue, you can revert (like git restore) to a snapshot revision and return to a stable state.
Pull
You can clone an integration, make changes, and then create a pull after successfully building and testing changes. There are four statuses for a pull: In progress, failed, canceled, or completed.
integrator.io automatically saves the integration state before any change is made and after all changes are merged, and your pull is completed. You can revert to either of these integration states within a completed pull revision.
integrator.io automatically creates a snapshot of the integration before any changes are made and after changes are merged, and your pull is completed. You can use these snapshots to roll back to a previous integration.
Revert
You can roll back to the previous state of a pull, snapshot, or revert when you run into issues and want to undo changes. This is called a “revert” revision. There are four statuses for a revert: In progress, failed, canceled, or completed.
integrator.io automatically saves the integration state before and after any change is undone or reversed and when your revert is completed. You can always roll back to either of these integration states within a completed revert revision.
Revision history
The Revisions list displays the history of every revision made in an integration because of a snapshot, pull, or revert. You can view details and perform actions on a revision based on the options available when you click the Actions overflow (...) menu of a revision.
The revision list or revision history provides the following information:
| Column | What it shows… |
|---|---|
| Description | The description you provide for a revision when you create a snapshot, pull, or revert like the reason or summary of changes in a revision. |
| Date created | Time at which you create a snapshot, pull, or revert. The time is shown based on your date settings in the following format: DD-MM-YYYY hh:mm:ss |
| Type | Type of revision:
|
| Status | Revision status:
Canceled: You can cancel an In-progress pull or revert revision during the Merge step. |
| User | Name of the user who performs the revision. |
| Actions | Actions you can perform on a revision: In the case of a pull or revert:
|
Filter revisions
You can filter revisions based on user, date created, status, and type. To filter revisions:
- On the Home page, click the integration.
- On the integration page that opens, click the Revisions tab.
- Select a value in the filter fields, such as date created, type, status, or user. You can select a value in any field or all the fields to filter the integrations.
View revision details in audit logs
You can view the changes made at the resource level for a pull or revert in the audit logs. You can also filter the audit logs to view changes based on resource, user, and source. To view the audit logs:
- On the Home page, click the integration to open it.
- On the integration page, click the Audit logs tab. You can view the changes or revision details at the resource level.
Comments
2 comments
Do the revisions expire after a certain amount of time (i.e., xx days, xx months, etc.)?
Danielle Caron Nope, they stick around
Please sign in to leave a comment.