topic Re: Purge all versions (including controlled versions) in Vault Customization Forum

Purge all versions (including controlled versions)

jason.dupree — Fri, 26 Apr 2024 18:14:45 GMT

Is it possible to delete all versions on a file using the API including the controlled versions? With the check box available in the UI when deleting an individual version to Ignore Restrictions, is this available in the API?

Re: Purge all versions (including controlled versions)

Markus.Koechl — Mon, 29 Apr 2024 07:43:24 GMT

You can use the method DeleteFileVersionsByMasterIdsUnconditional; however, I have not implemented it yet and cannot share more code.

Re: Purge all versions (including controlled versions)

jason.dupree — Mon, 29 Apr 2024 13:39:04 GMT

Thanks, Markus. I did find the DeleteFileVersionsByMasterIdsUnconditional method and DeleteFileVersionsUnconditional. For anyone else that runs across this, here's a couple of things that are useful to know.

DeleteFileVersionsByMasterIdsUnconditional
Is run on the MasterID of a file

While is unconditional, it's still bound by any lifecycle control on that file

Can use normal purge rules for uncontrolled (by a lifecycle) files, like keep latest #, keep latest since date, etc

DeleteFileVersionsUnconditional

Is run on the FileID which is particular to a version

Will delete the version truly unconditionally
Latest version cannot be deleted (pretty sure this applies to both methods)

I hope someone else finds this useful.

Re: Purge all versions (including controlled versions)

jason.dupree — Tue, 30 Apr 2024 15:22:22 GMT

It seems as though I don't have this quite as buttoned up as I thought. Released versions are not allowing for the unconditional purge, even through the UI, the Ignore Restrictions button is greyed out. Any ideas?

Re: Purge all versions (including controlled versions)

Markus.Koechl — Thu, 02 May 2024 06:18:00 GMT

I think that matching capabilities for UI and API are intended and make absolute sense.

Re: Purge all versions (including controlled versions)

jason.dupree — Thu, 02 May 2024 13:19:24 GMT

That's definitely understandable. Do you know if it's possible at all to delete Released revisions? Or to change the property 'Latest Released Revision' from True to False? Maybe that would allow the deletion then?

Re: Purge all versions (including controlled versions)

Markus.Koechl — Tue, 07 May 2024 05:53:19 GMT

As far as I know, both questions are to be answered "no". Only an unconditional file (master) deletion can erase released versions. But that's completely different from your objective.

Re: Purge all versions (including controlled versions)

jason.dupree — Wed, 08 May 2024 14:21:12 GMT

Thanks for clarifying, Markus.