Asset Deletion 3 - Check constraints for deletion

Asset Deletion 3 does not delete an asset version if any constraint exists. To see all constraints for the versions of an asset, execute the report in Asset Deletion 3. This article explains the different constraints and how to work with the report.

Context

• Asset Deletion 3 deletes asset versions that are no longer needed.

• Asset version policies define which versions of an asset are kept.

• An automatic server action or an individual server action execute the deletion process.

• The deletion report is available in the censhare Client and in censhare Web.

Prerequisites

• Common knowledge about censhare, especially asset types, relations, and domains.

• Common knowledge about the technical setup and configuration of the censhare Server and the relational database.

Introduction

Asset version policies define, which versions of an asset you want to keep. The policies are customizable constraints that prevent an asset version from being deleted. The policies are defined by the administrator in the censhare Admin Client.  

Besides that, censhare must maintain data integrity when marking asset versions for deletion. This is done with fixed constraints that cannot be changed. For examples, see the section below.

Different constraints can apply to different versions of an asset. To check if your asset version policies and other constraints work as expected, the report in Asset Deletion 3 was implemented.

Constraint types

• on asset version level

• on asset level

• by asset version policies

• on asset file level

• on database level

Constraints on the asset version level relate to certain versions of an asset.

Example asset relations

For example, an image is placed in a layout. The different layout versions can relate to different image versions:

Relations between different versions of an Image asset and a Layout asset.

In the graphic above, the Image version (3) has a placement relation with the Layout version (4). The image cannot be marked/deleted if it has a placement relation to a layout. 

Constraints on the asset level relate to all versions of an asset. For example, if an asset is checked out, no asset version is marked for deletion.  

Asset version policies are defined for a domain, 2nd domain, and an asset type.

Constraints on the asset file level prevent an asset file (storage item) from being removed. For example, if an asset file is not deleted if there is any asset version that still references this file.  

Handling database constraints

For data integrity, the database executes constraint checks. For performance reasons, Asset Deletion 3 only executes the most common database constraints checks.

In some rare cases, a database error can occur later when censhare tries to mark an asset version for the deletion or tries to delete an asset version physically. In these cases, censhare rolls back the database operation and writes the information into the server log.  

Asset deletion report

The Asset Deletion 3 report shows, which versions of an individual asset are kept and why. It is available in the censhare Client and in censhare Web. The report is configured in the censhare Admin Client.

The asset deletion report

The report shows the following items:

• The asset ID.

• The total number of versions of the asset.

• The domain, 2nd domain, and asset type of the applied policy.

• The number of versions that are marked for deletion. This only occurs if versions that are marked for deletion have not yet been deleted physically.

• A list of asset versions.

• A list of constraints for each version.

The report only lists asset versions that have at least one constraint. For example, an asset has 350 versions. The asset version policy definitions keep the last three and the first three versions. The only constraint, in this case, applies to the first version. The report shows six versions. All other versions are marked for deletion:

The report lists all constraints that apply to a version. For example, an asset version has the constraints:

• Keep the last (5) version(s) policy.

• The asset version holds a content version that is still used in other asset versions (asset_fk16).

• Keep (1) days before deletion policy (it will expire in 1 day(s).

The report shows the constraints at the date/time of execution. Therefore, the result can vary when done at different times. For example, a policy defines to keep asset versions for 6 hours. If you execute the report 3 hours after the asset version was marked for deletion, the result is different than after 9 hours.

The different constraints for deletion

Constraints on asset level

Constraints on asset version level

If an asset version has a certain constraint, this does not affect other versions of the same asset. But these versions can also have the same constraint.

Asset version policies

Asset Deletion 3 only checks an asset if there is at least one matching asset version policy that matches. Constraints defined by asset version rules can be changed.

Asset files

The storage_deletion_queue table stores a list of asset files that can be deleted after the corresponding asset version has been deleted. Before deleting a file physically, censhare checks if the asset file is stilled used by another asset, is available online or is offline/archived.

Database constraints

censhare checks for the following database constraint in the asset deletion process:  

• asset_rel_fk8: Asset version has an associated variant.

• asset_fk16: Asset version stores a content version that is used in a newer version.

• asset_rel_fk3: Asset version is used in an actual placement.

• asset_feature_fk7: Asset version is referenced by an asset feature.

Steps

Configure the report

In the censhare Admin Client:

1. Go to the "Configuration/Modules/Asset Deletion 3" folder.

2. Open the Asset Deletion 3 Report server action.

3. Check the Enabled.

4. Max rows to be displayed field: Select the desired number of rows in the drop-down field.

   In the censhare Client, a maximum size of entries is set that the report can show. This prevents a large number of versions that might slow down the performance of the report.

   Note: The maximum number of entries is 1000.

5. Click OK.

6. Execute Update server configuration in the censhare Admin Client.

7. If there are remote servers: Execute Synchronize remote servers in the censhare Admin Client.

Execute and show the report

censhare Web

How to execute the report for a certain asset from an asset list:  

1. Click the asset action menu of the asset list entry.

2. Select Asset Deletion report in the sub-menu Deletion.

How to execute the report for an asset opened in an asset page:  

1. Click the asset page action menu of the top right of the asset page.

2. Select Asset Deletion report in the sub-menu Deletion.

If there is no asset version policy, there is a warning when you try to execute the report:

Missing deletion policies: This asset has no deletion policies, please configure them on the admin client.

You can also call the report directly using the following URL: https://HOST_URL:9443/censhare5/client/asset-deletion-report?assetId=ASSET_ID

HOST_URL is the server URL that you enter to access censhare Web. ASSET_ID is the ID of the asset for which you want to call the report.

When you execute the Asset Deletion report server action, censhare shows the results in the Asset deletion report asset. There are two widgets:  

• Report metadata: It shows the total number of versions of the analyzed asset and the number of asset versions that are already marked for deletion.

• Report details: It shows all asset versions that have at least one constraint not to delete it.

Here is an example report:

If there is more than one entry, censhare only shows the first one. This is done for a better overview. Click the Dropdown icon "v" left to the entry to see all constraints for this version.  

As there can be many asset versions that cannot be deleted, the report shows only a certain amount of it per page. To switch between the pages, click the ">" icon to step one page forward. Click the "<" to step one page back.  

You can configure the number of versions that the report shows per page. Click the drop-down field behind Maximum versions per page in the bottom line and select the desired number.      

censhare Client

How to execute the report for a certain asset:

1. Click the asset to want to inspect.

2. Click the Server actions in the top bar of the asset list.

3. Select Asset Deletion 3 Report.

If there is no asset version policy that applies, the report shows a warning:

Asset ID: ASSET_ID - WARNING: This asset type has no policies. Add one in the asset versions table.

ASSET_ID is the ID of the selected asset.

The report in the censhare Client is shown in a simple window. If the report cannot show all version entries in the dialog window, you can scroll down/up.

Here is a sample report:

If there are more asset versions than the report is configured to show, it displays information in the top line of the report:

Versions analyzed for this report: MAX_NUMBER".

MAX_NUMBER is the number that is defined in the configuration of server action for the report.

Result

You have configured the server action for the report. You can execute the report in the censhare Client and in censhare Web. You understand the results that the report is showing. You know the difference between constraints on the asset, asset versions, asset version policy, asset file, and database level. You understand how the different constraints prevent the deletion of asset versions and asset files.