ActionAddToProjectFromEstimateAsync
Pushes an estimate's role requests and tasks onto an existing project as resource requests and project tasks, and optionally also creates matching opportunity products, in a background job. The estimate is locked and the work may not be complete when the action returns, so callers must acknowledge this and use the AddToProjectFromEstimatePlugin to chain any dependent work. Use this action instead of Add to Project from Estimate for large estimates that would otherwise time out. Returns per-request errors captured before the job was enqueued.
| Property | Value |
|---|
| Label | Add to Project from Estimate Asynchronously |
| Category | Estimates |
| Since | Spring 2024 |
| Read-only | No |
| Supports Agents | No |
| Supports Flows | Yes |
| Async Action | Yes |
| Keywords | add, create, estimate, project, resource request, project task, asynchronous |
Request Parameters
| Field | Type | Label | Description | Required |
|---|
EstimateId | Id | Estimate ID | The ID of the estimate to add records from. | Yes |
ProjectId | Id | Project ID | The ID of the project to add estimate records to. | Yes |
Acknowledgement | Boolean | Async Action Caution Acknowledged | If set to true, you confirm that you understand that this asynchronous action may not have completed before the next step in the flow is executed. Subsequent actions therefore should not depend on the completion of the Add to Project from Estimate Asynchronously action. They must also not affect the same estimate as the action because the estimate will be locked while the action is in progress. Instead, you can trigger an action using the AddToProjectFromEstimatePlugin subsequent to the completion of the Add to Project from Estimate Asynchronously action. | Yes |
EstimateProductIds | List<Id> | Estimate Product IDs | A list of IDs of the estimate product instances to be added to the project. | No |
EstimateBillingGroupIds | List<Id> | Estimate Billing Group IDs | A list of IDs of the estimate billing groups to be added to the project. | No |
IncludeRecordsIndependentOfEstimateProducts | Boolean | Include Records Independent of Estimate Products | If true, records independent of estimate products will be added to the project. The default value is true. | No |
AdditionalAggregationFields | List<String> | Additional Role Request Consolidation Fields | Additional fields to consolidate estimate role requests by when creating resource requests. | No |
AggregateBySkills | Boolean | Consolidate by Skills | If true, role requests are consolidated by skills. The default value is false. | No |
CreateOpportunityLineItems | Boolean | Create Opportunity Products | If true, opportunity products are created for each estimate product instance. The default value is true. | No |
GroupingConfiguration | String | Grouping Criteria Configuration | The grouping criteria fields configuration to use when consolidating role requests into resource requests, enter either API_INPUT_GROUPING or ESTIMATE_STORED_GROUPING. When set to ESTIMATE_STORED_GROUPING, AdditionalAggregationFieldPaths and AggregateBySkills are ignored from the grouping criteria configuration. The default is API_INPUT_GROUPING. | No |
Response Parameters
| Field | Type | Label | Description | Required |
|---|
EstimateId | Id | Estimate ID | The ID of the estimate to add records from. | Yes |
ProjectId | Id | Project ID | The ID of the project to add estimate records to. | Yes |
Errors | List<AddToProjectFromEstimateService.AddToProjectFromEstimateAsyncError> | Deprecated: Errors | Not in use. | No |
Errors2 | List<InvocableAddToProjFromEstAsyncError> | Errors | A list containing errors that occurred while processing the request. | No |
| 