ODC Tool v1.0.0
Purpose
We have identified an issue with certain candidate record documents that have been shared through the Connexys for Salesforce “Proposal” functionality; when adding attachments to an email in a Step and/or Email component; and when uploading images as part of generating candidate CVs. As part of these processes, Connexys creates and stores a copy of the applicable document as a new Content Document in the Service.
In versions prior to 31.27.3 (e.g. 31.27.2 and older versions), if the Content Document was candidate-related (e.g. a CV), then the Content Document was not linked to the candidate. As a result, the Content Document would not be deleted/anonymized when a customer deleted/anonymized the related candidate record. These Content Documents remain in your Service as “Orphaned Documents” as the candidate anonymisation process cannot identify them.
This tool allows you to review these potentially Orphaned Documents and delete them at your discretion.
For versions 31.27.3 and more current versions, the Content Documents created after installation are linked to candidate records and, accordingly, they are included in the anonymisation process.
Please take note: We are providing this tool to assist and streamline your review of these Content Documents. That said, due to the nature of Salesforce, and your ability to configure, customise, or add third party products to the Service, it is possible that legitimate documents could appear to be Orphaned. For this reason, any deletions you perform need to be carefully considered.
Instructions
Prerequisite
To start with, the Connexys package on your Org must be on version 31.27.3 or higher and the Lighting version of Salesforce.
Installation
- Please contact your Support Representative for installation of the ODC Tool, including the name of the Admin User that will be using it.
- Once installed, you or Support will need to assign the ODC_Tool permission set to the Admin User.
- Make sure the Admin has Query All Files permission in App Permissions - Content section
Usage
Open the Orphaned Documents Cleanup Tool tab from the App Launcher icon.
Once opened, the initial tab shows all the Sites in your Org, and you can start to find and analyse the Content Documents that are potentially Orphaned. You will want to review every Site in your Org.
Click the Process Documents button to start the analysis for a particular Site. This triggers an asynchronous batch job, and the status is shown to the right of the button.
Depending on the data in your Org, it may take minutes to complete the analysis. If you are concerned about the duration, please contact Support.
Once the batch job has completed, the results can help you decide whether the Content Documents can be deleted without needing individual review. It will show the number of potentially Orphaned Documents. It will also indicate how many of these are only linked to the Site Default Record Owner.
You should take the following considerations into account:
- Is there a large discrepancy between the two counts?
- If there is a large number of potentially Orphaned Documents with links to entities other than the Site Default Record Owner, this can indicate another process, product or action is interacting with the system. Any deletion may therefore affect the functioning of that entity.
- Who is the Site Default Record Owner?
- If this is a dedicated user that would not upload any other content, you can have more confidence in being able to delete the potentially Orphaned Documents.
- However, if they are an active user, could they own valuable Content Documents that shouldn't be deleted?
- Do you have customisations or other products that could have created Content Documents through the same Site?
- If so, any deletion may therefore affect the functioning of that entity.
For example, if the Site Default Record Owner is the Connexys Support Account, and you have no third party products installed, and don't reuse the Site for any other purpose, then you can be more confident that these are Orphaned Documents that can be deleted.
If you are satisfied that all of the potentially Orphaned Documents linked only to the Site Default Owner can be deleted, then use the Delete Documents button to start a batch job to remove them. This will not remove any Content Document with a link to any other entity, nor will it remove Content Documents that have been marked as Retain in the Orphaned Document Reference list view.
If you want to review the Content Documents before deletion, or there are some that are linked to more than just the Site Default Record Owner, then proceed to the Orphaned Document Reference list view.
This page allows you to see any Content Documents that are potentially Orphaned so that you can review them and determine whether to retain or delete them.
As you review the Content Documents, you can update the Retain field to indicate the Content Document that should not be deleted. Please note: the value of the Retain field is stored, so you can easily distribute review work and be clear on what has already been reviewed. You may choose to leverage the Retain field in a standard Salesforce filter to exclude results that have already been reviewed. Should you have a significant number of records to review, use of filters may be helpful in partitioning the review work.
When you have finalized your review and updated the Retain field for the documents you wish to retain, then select the Content Documents you wish to delete and click the Delete Content Documents button to start a batch job to remove them. Any Content Document that has been marked to be retained will not be deleted.
Note that if the Retain field on a Content Document is checked, it will be excluded from all subsequent the Delete Documents actions in both Step 1 (“Orphaned Documents Cleanup Tool”) and Step 2 (“Orphaned Documents Reference List View”) tabs. You can uncheck the Retain field on the Content Document at any point in the future should you wish to delete it.
If you have any questions about the tool, please reach out to your Support Representative and they will be happy to help you.
Comments