Composite Operations

[k-capehart]

Use Composite to allow users to group dependent calls into a single request

• https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/requests_composite.htm

Examples

• Create record with child records in same request
• Create record and retrieve record with ID in same request

Use Composite Batch to allow users to group independent requests together into a single request

• https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_batch.htm
• https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_composite_batch.htm#topic-title

Examples

• Perform an insert and then query in same request

Considerations

• There is still a limit of 25 subrequests (5 if they are SObject Collections)
• Use composite calls to optimize the collections functions
  • We could group batches together into composite requests
• I separated the logic between Collections and Composite functions because: with Composite you can insert a large amount of data with the AllOrNone parameter, while Batch and Collections have no limit to the number of batches but AllOrNone won't persist across the batches

Stretch

• It would also be cool to use Composite Graph https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_graph_introduction.htm

[k-capehart]

Some composite operations are already available, as they were created alongside function intended for inserting, updating, etc sobject collections

[ivanquirino]

+1 to this one. I use composite to create a set of diferent records: Order, OrdeItem etc. The current API doesn't have a call for that and I'll have to build the HTTP directly

[k-capehart]

@ivanquirino Thanks for the use case example! I probably won't be able to get to it for a while, so if you end up building anything out please share what you do.

[ivanquirino]

@k-capehart I'd like to, but I'm not using this library currently and I have a deadline for a release, it would be too expensive to change libraries now since the whole salesforce part for the project is on simpleforce (https://github.com/simpleforce/ not my choice thouth). We've been using it, but then I stumbled on it's limitations and went out to check if any library implemented what I wanted.