An Easier Way to Delete Apex Classes From Production

An Easier Way to Delete Apex Classes From Production

The purpose of this article is to:

– Highlight the problems faced when deleting Apex classes and triggers in a Salesforce production environment

– Describe in detail a lightweight and flexible solution that enables one to delete Apex classes and triggers from a Salesforce production environment quickly and easily

This article expands on the question and answers posted here.

The problem

The most common approach to deleting Apex classes and triggers in a Salesforce production environment is to leverage either the Force.com IDE or the Force.com Migration tool. These tools have a number of downsides, namely:

-The Force.com IDE is very ‘heavyweight’ and is known for being quite buggy sometimes and unpleasant to use.

-They have a number of dependencies (a compatible version of Java, different IDE version etc)

-Connectivity to Salesforce via the Force.com IDE may be an issue

-The Force.com migration tool (ANT) can take some time to learn how to use properly.

Apex classes and triggers cannot be deleted from a Salesforce production declaratively, unlike in sandbox orgs. This is because security for Apex in Salesforce production orgs is greatly increased. So how can one delete Apex classes and triggers from a production org without having to go through the inconvenience and time consuming effort of installing, testing and learning how to properly use these tools?

The answer can be to use Notepad* text editor and the super lightweight and easy to use Workbench suite. Using these tools, deleting Apex classes and triggers from Salesforce production is a breeze. Because Workbench is web based and text editors are already pre-installed and super easy to use, there’s no time spent on downloading, installing or testing the Force.com IDE or Force.com Migration tool (ANT).

What to do

Let’s say that you have a Salesforce production org that has two Apex classes that need to be deleted.

1. To achieve this via Workbench, create a folder on your desktop. I will call my folder ‘deleteClasses’.

2. Then go to Notepad (or another text editor) and copy and paste the below and save as the file with ‘package.xml’ and ‘All files (*.*)’.

<?xml version="1.0" encoding="UTF-8"?>

<Package xmlns="http://soap.sforce.com/2006/04/metadata">

<version>30.0</version>

</Package>

Apex1

3. Then create a new file in Notepad (or another text editor) and copy the below into it:

<?xml version="1.0" encoding="utf-8"?>

<Package xmlns="http://soap.sforce.com/2006/04/metadata">

<types>

<members>SomeClass</members>

<name>ApexClass</name>

</types>

<version>30.0</version>

</Package>

Replace SomeClass with the name of your class that you wish to delete. If you have two classes that need to be deleted at the same time, you can simply add another <members> row into the file with the name of the other class, for example:

<?xml version="1.0" encoding="utf-8"?>

<Package xmlns="http://soap.sforce.com/2006/04/metadata">

<types>

<members>SomeClass</members>

<members>SomeOtherClass</members>

<name>ApexClass</name>

</types>

<version>30.0</version>

</Package>

4. Save this file name as destructiveChanges.xml (note the capital ‘C’ in ‘changes’). Make sure the file is saved as ‘All files (*.*)’. More information on destructive changes can be found here.

Apex2

5. Now there are two files in your folder. Open the folder, select both the XML files, right-click and select ‘Send To > Compressed Folder’. Keeping the default name of ‘package’ for the folder is fine.

Apex3

6. You are now setup to deploy the destructiveChanges.xml file to Salesforce. To do this, go to Workbench and login with your credentials. It is recommended that you login to a Sandbox instance before you deploy the file to production.

7.  Select Migration > Deploy.

8. Click ‘Browse’ and select the .zip package file. Then check ‘Rollback on Error’, ‘Single Package’, and select Test Level with ‘RunLocalTests’. More information on the Test Level can be found here.

Apex4

9. Finally, select ‘Next’ and then you will notice that the success or error results will be displayed in Workbench once the deployment process has been completed.

This is a very easy way to delete Apex classes and can be very handy if you need a lightweight tool to do the job.

Subscribe To The Monthly Newsletter

No Spam. No Rubbish. Just great content from the Salesforce Industry.

You have Successfully Subscribed!

8 thoughts on “An Easier Way to Delete Apex Classes From Production

  1. Here is another way to do it using IDE like Force.com IDE or MavensMate:

    1. Force.com IDE should be installed.
    2. Connect to the Sandbox Instance using the IDE and find the class or trigger that you want to delete.
    3. Open the matching .xml file, and change the Status XML tag from Active to Deleted.
    4. Or to disable the trigger change it to Inactive.
    Note: Apex class Status can only be changed to “Active” or “Deleted,” not “Inactive”.
    5. Save the file.
    6. Select the two files (Code and XML) using “Ctrl-click,” and then right-click on one of them.
    7. Select Force.com | Deploy to server.
    8. Provide your credentials for the Production org and follow the steps.

    Source: https://help.salesforce.com/apex/HTViewSolution?id=000006188

    1. Hi Joey.. I have tried above steps for UAT sandbox, after changing to Active state to “deleted” sate in meta data I can save the file, then next step I don’t option to Deploy to server/save to server.
      Please help me here.

      Thanks
      Vinod

  2. I have come across very simplified tool Metaforce, it can be installed as plugin in chrome.
    User interface is very simplified for deleting metadata.

  3. Hi Joey.. I came across your points, at 7th point I’m getting only “Force.com > show in salesforce web ” this option. Pls help me out, its urgent.

    Thanks
    Vinod Kumar

Add Comment