Delete Unique Records
  • 24 Mar 2023
  • 5 Minutes to read
  • PDF

Delete Unique Records

  • PDF

Article Summary

Overview

Cloudingo allows users to create a unique list of records to delete in bulk. Simply specify which records to delete by choosing specific field values. For example, choose all records that do not have an email address, do not have a phone number, and do not have an address. Or records that were just imported into Salesforce incorrectly. Build criteria or use an existing Salesforce report to pull in records for deletion. Preview results for accuracy and delete those worthless records!



  1. Open the Delete Unique Records window. Choose the ‘Tools’ → ‘Delete’ option from the left-hand-side navigation window.


    2. Tabs at the top of the page separate the indexed objects. Choose 'All' to view all indexed and non-indexed object filters.
    1. Choose ‘Create New Job’ to build a new filter.
    2. Choose ‘Edit’ from a specific filter’s menu option to edit an existing filter.


Actions & View Options 

Graphical user interface

Description automatically generated with medium confidence

  1. The 'Actions' menu provides a variety of options.
    1. Recalculate Totals: Recalculates (queries) all filters at one time.
    2. Reorder Jobs: Choose this option to reorder the filters for display. 
    3. Manage Rules: Choose this option to get directly into the Manage Rules page. 
    4. Manage Owner Mapping: Choose this option to get directly into the Owner Mapping page. 
    5. Run Window & Throttle: Choose this option to get directly into the Run Window & Throttle page.
    6. Halt & Disable All Data Maintenance Automation: Choose this option to temporarily stop all currently running or future automation jobs. 
      1. Jobs currently running can take time to completely stop.
    7. Show Details: Choose this option to show additional filter details (such as the filter description, fields used, and the rule applied if applicable.
      1. Choose 'Hide Details' from the 'Actions' menu to return back to the regular filter view.
         
  2. Toggle between Tile View or List View to control how filters are displayed.


  3. Sort By: Choose from a variety of sort options to display filters.


  4. View Settings: Choose from a variety of view settings to display filters.


Step 1: The basics

  1. Maintenance Type: This will automatically default to ‘Delete Unique Records’.
  2. Object Type: Choose the object that the deletions will be applied to. The list includes any standard or custom object.
  3. Filter Name: Give the filter a descriptive name.
  4. Description Name (optional): Give a brief description of the filter.
  5. Enable: All filters are enabled by default. Disabling makes the filter inactive.
  6. Run filter with Bulk API: Choose this option for any indexed objects that should use Bulk API to query for records. Non-indexed objects use Bulk API by default.


Step 2: Which records do you want to delete?



  1. Select Criteria: Build criteria to filter out records to delete.
    1. Choose the ‘Add Field’ button to begin adding fields to the criteria.
    2. (Object) Field: Choose a field for the criteria to find records.
      1. Use the ‘Refresh Fields’ option at the top of Step 2 if a field is not showing in the list.
      2. Use caution when using formula, calculated, or related object fields. Syncs are not sent to Cloudingo when the underlying value is changed. Reindexing may be required. Consider using a Salesforce report instead of building criteria when using these field types.
    3. Condition: Choose a condition (such as ‘Equal’, ‘Contains’, ‘Has a value’, etc.).
    4. Specify a value in the far-right blank box if one appears. The condition chosen may require a value, but in some cases a value is not required.
      1. Or Has No Value: Choose this option to also allow records with a blank value for the field to pull into the results.
    5. Choose ‘Add Field’ again to add additional criteria to find records.

  2. Use an Existing (Salesforce) Report:


    1. Salesforce reports will appear in the drop box when this option is selected. Choose the desired Salesforce report to pull the list of Leads for conversion.
      1. Report must contain the Salesforce Record ID using the standard ID field in the output.
      2. Report must be accessible to the user establishing the Cloudingo connection.

Choose ‘Save’ or ‘Save & Run’ (to query for results) to save the filter configuration. 



Re-indexing

When creating or editing a filter with new fields (on indexed objects), Cloudingo initiates a re-indexing process on the object that may take time. To avoid this, users can pre-set a list of fields they will be using in their filters by going to 'Account' → 'Settings' → 'Manage Objects' from the top right toolbar.



Preview Results

Make sure to preview the filter results for accuracy before performing deletions.

  1. Choose the ‘View Results’ option on the filter after the filter has been calculated.



  2. Choose the red arrow on a group to preview the results. Check a few records for accuracy.


Delete

After checking records for accuracy, run the delete process.

Three ways to delete:

  1. Manually: Delete one record at a time from the preview page.



    1. Delete: Deletes the record and returns the view back to the record list.
    2. Delete & Load Next: Deletes the record and immediately opens the next record.
    3. Skip & Load Next: Loads the next record without updating the current record.

  2. Mass Delete: Delete records one page at a time from the preview page.



    1. Select records using the checkbox to the left to be deleted.
      1. Or choose the Select All box at the top left corner.
    2. Choose the ‘Mass Delete Unique Records’ button at the top of the record list to submit all selected records in view.
    3. Page through results using the page numbers at the bottom of the results list.
    4. Mass Deletes can only be done one page at a time.
    5. Watch the Activity Stream for the delete confirmation back from Salesforce to see if deletes were successful or a failure (or view the Activity Stream Error/Warnings report from the Reports dashboard to get a list of failures).
    6. Results within the pages will refresh in the list as records are deleted and when moving through the pages.

  3. Automation: Delete all records in the filter by starting a one-time automation job or schedule to run the job repeatedly.

    1. For a one-time job:
      1. From the filter’s menu option, choose ‘Start Automation’ or choose the ‘Automation’ menu option from within the preview page and choose ‘Start Automation’.
      2. Choose ‘Automate’ on the confirmation page.
        1. Check the Run Window & Throttle settings if the job does not start within a reasonable time.

    2. To schedule the job to run repeatedly:
      1. From the filter’s menu option, choose ‘Schedule’.
      2. Toggle the dot to the right to enable the ‘Schedule recalculation’.


      3. Specify a frequency (once, hourly, daily, or weekly. Set any additional settings related to the frequency as required. 
      4. Specify a start date and start time.
      5. The ‘Keep Schedule Running’ option must be enabled for the job to continue processing at the scheduled time.
      6. Toggle the dot to the right to enable ‘Schedule auto – delete’ to process the job and 'Save'. If disabled, the job will only perform the calculation (query) at the scheduled time.

 


Was this article helpful?