Any completed local pack can be rolled back. Rollback will restore the versions of all the records in this local pack as they were before the start of the update collection, in other words, before starting works on this local pack. Deleted records will be restored, and created records will be deleted.
After the rollback is completed, the imported versions stay in the system as non-current VCS records. You can restore these record versions manually if needed.
Example
- A configuration pack contains a record version X.
- Before import, the target instance had version Y.
- After the local pack is imported, the record version changed to X.
- When you rollback the local pack, the Y version of the record will be restored.
Rollback a local pack
To rollback a local pack, please complete the steps below:
- Navigate to Configuration → Local Pack.
- Open the local pack you need to rollback.
- Click Rollback preview to check system's response to record restoration.
- In the Related Lists area, open the VCS Preview Log tab.
- Filter out records in the Allowed state and process possible collisions if there are any.
- Click Rollback to restore records to the previous version.
Here is the expected result of the process:
Import result | Rollback result |
|---|---|
| A new table | The table is dropped from the database, deleting any data from it. |
| A new field | The field is dropped from the database, deleting any data from it. |
| A deleted field | The field is restored to the database, but the original data is lost. |
| A record is inserted | The record is deleted. |
| A record is deleted | The record is restored with its original data. |
| A record is updated | The record is restored with its original data. |
Collision processing
General process of solving the rollback collisions is the following:
- In the configuration pack to be rollbacked, click Rollback preview.
- Scroll down to the Related Lists area and open the VCS Preview Log tab.
- Filter out records in the Allowed state using the Condition Builder.
- Open one of the records.
- Read the text in the Message field to find the error cause.
- Click Save or Save and Exit to apply changes.
- Return to the configuration pack record and click Rollback preview.
- Make sure that the VCS Preview Log record state changed to Good.
- Repeat these steps until all necessary records in the VCS Preview Log are in the Good state.
- Click Rollback.
Collision cases
Collision case 1
When rolling back a local pack, the state of the record is Collision. The Message field contains the following text:
The current version for this target entry is in a different local package. https://{your-instance.ru}/record/sys_vcs_record/123455521418546721
Collision solving:
Move the current record to the local pack, which you need to rollback, and click Rollback preview.
Collision case 2
When rolling back a local pack, the state of the record is Collision. The Message field contains the following text:
Current record does not exist!
Collision solving:
Continue the rollback. The collision record will be skipped.
Collision case 3
When rolling back a local pack, the state of the record is Collision. The Message field contains the following text:
Previous version for current is not found
Collision solving:
Continue the rollback. The collision record will be skipped.
Collision case 4
The configuration pack inserted new columns into a table. When rolling back a local pack, a record is in the Warning state. The Message field contains the following text:
undefined column SQLERROR 42703
Collision solving:
Continue the rollback. Сolumns inserted during import will be deleted.
Collision case 5
A local pack contains an Insert record: a new table was created. Rollback will cause the deletion of this table, but it contains one or more records. The state of the record is Skipped. The Message field contains the following text:
Table is not empty
Collision solving:
Open the list of records of the table and delete all records manually.
You can find other examples of possible collisions in the Collisions processing article. After that, click Rollback preview.
- No labels
