[SalesForce] Efficient way to create master-detail records

I am working on creating records for a custom object type in Salesforce. There is also a line item object which has a master-detail relationship.

  • Invoice = Master
  • Invoice Line Item = Detail

I am using JAVA to create these records after parsing an input XML file.
The logic I am using to create invoice is as follows

  • Parse XML file, create Invoice object for each Invoice node.
  • Set the relevant fields.
  • Store in SObject array.
  • After all invoices have been created, use one UPSERT call to create records.

    UpsertResult[] upsertResults = connection.upsert("Invoice_ID__c", invoiceArray);

This is working fine. Now I need to create the invoice details. They are also in the XML file as child nodes of the Invoice node. I am a little confused about how to proceed. Since each Invoice detail line item will need to store the ID of its parent invoice which needs to be created first.

Is there a way of creating the master-detail records at the same time efficiently? If so where can I store the detail records at the time of calling the UPSERT call on the array storing all my Invoice records?

Thanks.

Best Answer

You're doing it right, you will need to create the Master records first before attempting to create the child records.

You have a couple of options :

Using the External Id : You can use the Invoice_Id__c to hook up to the parent. Here's an example , where you instantiate an instance of the parent, setting the External Id on it, and then just set that reference on the child record. You can then upsert the child records.

An important consideration is "When batch updating multiple records where the external ID is the same for two or more records in your batch call, those records will be marked as errors in the UpsertResult file. The records will be neither created or updated."

Using the Salesforce Id : If the upsert of the parent records has been successful, you will be able to get the Id from each element in the Upsert Result, using the getId() method.

I'm guessing Invoice_Id__c is the external id that you're using to upsert and will be available on both the parent and child records, to establish the relationship.

You could add all the child records to a Map <Invoice_Id__c, List<InvoiceLineItem>>

After successful upsert of parent, iterate through the UpsertResult, grabbing the relevant parent node and set the resulting id on all the child InvoiceLineItems in that list corresponding to that parent Id.