Revisions Table

Note

Only global administrators, promotion administrators and developers can see revisions information. Developers can only see their own revisions. More information is available in the Authorization section.

To open the Revisions table, click the menu Promotions > Revisions.

Open revisions table

Open Revisions table

A new tab will open, where you can check all the information about revisions and perform any available operation with each one of them, according to its current state.

Example of Revisions table

Example of Revisions table

Take into account that the information shown in the Revisions table is not automatically updated once open. Click refresh-btn to refresh the information.

The following sections explain in detail the operations that you can execute on revisions from this table.

Create a Revision

Click new-revision-table-btn to open the New Revision dialog. The process to create a new revision is explained in the section Creating Revisions.

Global administrators and promotion administrators users also have the possibilty to create a new revision uploading directly a VQL file clicking the new-revision-from-vql-btn. The process is explained in the section Load Revisions from VQL.

Edit a Revision

To edit a revision, click edit-btn. A similar dialog to the one of creating a revision will appear. You can change any value from the General pill or update the selected elements in the Revision Elements one. Remember to click the save-btn on the top of the dialog to save your changes.

Warning

When you change one of the following fields in the General pill, the candidate elements to show will change and, therefore, your selected elements will be lost:

  • Type
  • Virtual DataPort server
  • Scheduler server

Note

Take into account that no global administrator users can only edit their own revisions. Moreover, it is not allowed to edit deployed revisions.

Note

It is not possible to edit the revisions created uploading a VQL file.

See the Information of a Revision

Global administrators can edit the revisions of other users. No user can edit a revision that has already been deployed. Nevertheless, you can check its content in read-only mode. Click the search-btn button and a dialog will appear with all the information about the revision.

Revision definition in read-only mode

Revision definition in read-only mode

VQL revision in read-only mode

VQL revision in read-only mode

Remove Revisions

You can remove revisions in two different ways:

  1. Select several revisions on the table and click the remove-text-btn button.
  2. To remove only one revision, click the remove-btn button on its row.

Note

Take into account that only global administrator users can remove other users revisions. Moreover, it is not allowed to remove deployed revisions.

Filter Revisions in the Table

To apply a filter to the results in the table, click the filter-btn button and fulfill the form in the dialog below.

Filter revisions dialog

Filter revisions dialog

A new tag like filter-tag will appear above the table to represent what it is filtering. You can edit the filter clicking its name or remove it clicking its remove-filter button.

You can create more than one filter. The table will show only those revisions that verify all the filters defined.

Download the Metadata of a Revision

You can download the generated VQL or the Scheduler tasks zip that will be deployed for a revision. Click the download-btn button and select the corresponding option in the emerging menu.

Download the contents of a revision

Download the contents of a revision

Validate a Revision

The elements of a revision may depend on a set of properties, like data source URIs, user names, passwords… For a deployment to succeed, the target environment should provide a value for each one of these properties. More specifically:

  • The target environment should define a value for every Virtual DataPort property that parameterizes the VQL of the revision.
  • Every cluster of the target environment with Scheduler servers should define a value for every Scheduler property that parameterizes the tasks of the revision.

Before deploying a revision, you can validate that the target environment defines all the required properties. Click the validate-btn button for the corresponding revision and select the target environment that you want to validate. You can also add a comment to the validation.

Select the target environment for a revision validation

Select the target environment for a revision validation

When the validation process ends a new dialog will appear with the result. If there is any property missing, the validation will fail.

Dialog with the result of a validation

Dialog with the result of a validation

Note

Revisions of type DROP are not parameterized, so they do not support validation.

Check the Validation Summary of a Revision

You can check the list of environments where a revision was validated on, clicking its validated-on-btn button.

List of environments where a revision was validated on

List of environments where a revision was validated on

If you click one of the environments in the list, you will access the validation summary for that environment.

Validation summary with errors for a revision

Validation summary with errors for a revision

For those unsuccessful validations, you can check the list of missing properties clicking the details-btn button.

Missing Scheduler properties for a validation

Missing Scheduler properties for a validation

Copy Revision

Click copy-revision-btn to copy a revision. This will open the wizard create revisions with all the information copied from that revision. Then, you can edit anything on this revision and save the new revision.

Note

It is not possible to copy revisions of type VQL

Deploy Revisions

You can deploy revisions in two different ways:

  1. Select several revisions on the table and click the deploy-text-btn button.
  2. To deploy only one revision, click the deploy-btn button on its row.

A dialog will appear where you have to select in which environment you want to deploy the selected revisions. You can also enter a description about the deployment.

Select the target environment for a revision deployment

Select the target environment for a revision deployment

If the option Rollback when the deployment fails in the first server is enabled for the target environment, but there is no backup data available, you will have to confirm that the deployment should continue anyway.

Confirmation dialog to continue the deployment without a backup

Confirmation dialog to continue the deployment without a backup

To get more information about the status of the deployment, you can click on the notification that appears after deploying the revision.

Notification of successful deployment

Notification of successful deployment

Note

Remember that developer users cannot deploy their revisions. They can only validate them.

Note

In the section Deploying Revisions there is a detailed explanation on how the deployment process actually works for the different available strategies.

Check the Environments where a Revision Was Deployed

You can check the list of environments where a revision was deployed on, clicking its deployed-on-btn button.

List of environments where a revision was deployed on

List of environments where a revision was deployed on