Force.com Apex Merge/Replace Class ;)

-
Hello again!

I just developed an Apex class for performing replace/merge operations on any kind of object, and yes any kind of relations as well! , so it doesn't matter if you have master-detail relationships that can't be modified, objects tied in a master-detail relationship will be cloned, deleted and inserted with the new values to simulate a merge operation!

To use the Merge class  just create an ObjectMerge instance, passing as an argument of the constructor your current record:

ObjectMerge oMerge = new ObjectMerge(SourceObject);

And to peform the merge operation just use the replaceRecord method and thats it!, you can specify if you want to delete the source record after the merge operation is done.

oMerge.replaceRecord(MergeToThisObjectID,DeleteSourceObject);

You can limit the number of records that will be processed in the merge operation for Master-Detail relations  to avoid hitting governor limits. The ObjectMerge class will let you know if there are any objects left, and if this is the case just continue performing the merge operation.

Force.com provides a merge DML operation but it's only available for some of their standard objects, this class can help you get around that. There are still some limitations with this class due to governor limits in the number of describe calls but unless you have a large amount of objects related to the replaced/merged record it should work pretty well.

For now, the Object Merge class only merges/replaces custom objects related to your record, but this can be changed  in the class , however keep in mind that no more than 10 relations can be processed due to describe calls limitations so be careful when removing the custom objects limitation because there can be many Non-Custom objects related to your record.

I'll leave a link in this post to the files but for now here's an example of how to use the ObjectMerge class in a VisualForce controller that merges contacts, if you have custom objects tied a contact A and want to merge contact A to Contact B you will see how the ObjectMerge class changes all of the objects from contact A to contact B then deletes contact A. Remember, you can try it with any custom object ;)  Enjoy!

Download the files from here --> ObjectMerge



(NOTE: There's a bug with the code viewer plug-in, please ignore the second viewer)

Comments

  1. JatinMarch 23, 2011 at 11:36 PM

    Hi,
    Can i resue this in providing mail merge fucntionality in Custom VF Page

    ReplyDelete

Post a Comment

Popular posts from this blog

Force.com commandments

-
I spent a few minutes today thinking about my experiences developing on the Force.com platform. Overall it has been great, nevertheless, there have been some bumps in the road (and there will be more to come). Here's a list of some commandments that I've come to think of as imperatives for development on Force.com. NOTE: This is just a list with no particular order of some of what I consider are the most important items. Thou shall not: Say a class or trigger is ready without having any test units Place a SOQL query inside a for loop Place a DML operation (for a single record) inside a for loop Hardcode an id, object prefix or service instance names... anywhere Create a full sandbox without being damn sure you're ready to create it Say a field is hidden by just removing it from a page layout Assume your test units will magically find data in a new org Assume a 75% coverage is good Ignore asserts in your test units Rely on good percentage coverage of oth
Read more

Force.com object and record level security

-
Image
Lately I've been involved in several discussions around how the Force.com platform handles object and record level security. I'm surprised that there's still a lot of confusion around this topic despite all of documentation available out there so I'll try to explain this topic in more detail. It usually helps to start the conversation referring to Jason Ouellete’s “Development with the Force.com Platform” book where he illustrates these layers of security as a funnel. Each request has to go through several layers starting with CRUD and FLS checks and then moving to verifying org-wide default sharing model and any exceptions to org-wide sharing model if applicable. If the request “survives” through all of these checks then access is granted. This funnel provides a great way to illustrate how data security works at a high level but it still doesn't explain all the nuts and bolts involved with sharing rules and how to enforce these levels of security w
Read more

almond

-
Image
Wow, it's been almost 2 years since my last post. It's been pretty busy for me lately but I'm still very involved with Salesforce and excited to share a project I've been working on for a while now (drumroll) : What is almond?  Almond is a Learning Management Application built on top of Salesforce1. The goal of this app is to create engaging learning experiences for your employees and reward them as they make progress through their learning activities. Learners can take quizzes, complete tasks and launch learning resources from a desktop or mobile device as well as provide feedback on the learning content. Here's a quick overview of the app: Why is it called almond? It all started with the idea of creating Learning Management ON Demand (LMOND) system and ended up adding an A in there because I think it's awesome, plus, almonds are tasty. How can I use it? The app can be used in different scenarios, here are some examples: Create
Read more