Troubleshoot Setup and Configuration Issues

A Data Processing Engine definition run can fail when the user who ran the definition or the writeback user of the definition don't have the required permissions. Learn how to resolve user access issues for definition runs.

Required Editions

View supported editions.

Fixes for Setup and Configuration Issues

Issue Error Code Resolution
A definition run fails because the user running the definition doesn't have a required license. USER_ERROR_REQUIRED_LICENSE_MISSING Assign the required license to the user, then run the definition again. Contact your Salesforce account executive to purchase needed licenses or add-ons.
A definition run fails because the user doesn't have access to the required CRM Analytics dataset folder. USER_ERROR_DATASET_FOLDER_ACCESS_MISSING Grant the user access to the required dataset folder, then run the definition again.
A definition run fails because the user doesn't have sufficient access to one or more required resources. USER_ERROR_ACCESS_MISSING Confirm that the required Setup objects are enabled, the specified objects are available in your org, and the user has Read and Create permissions for the objects. For example, if the definition uses the Order object, confirm from Setup in Order Settings that the object is enabled.
A definition run fails because a required permission or license isn't enabled in the org. USER_ERROR_REQUIRED_PERMISSION_OR_LICENSE_DISABLED Enable the required permission or assign the required license, then run the definition again.
A definition run fails because the user can't view or write to datasets created by using the Analytics Cloud Integration user license. USER_ERROR_REQUIRED_PERMISSION_MISSING

Assign the required permission to the user, then run the definition again.

To grant access via the Analytics Cloud Integration User license, you must have the Manage Profiles and Permission Sets permission.

  • From Setup, in the Quick Find box, enter Permission Sets, and then select it.
  • Click New and enter a permission set name. The API name is automatically populated based on the permission set name.
  • In the License dropdown, select Analytics Cloud Integration User, and save the permission set.
  • On the Permission Sets overview page, open the permission set that you created, click System Permissions > View All Data, and save the permission set changes.
  • On the Permission Sets overview page, click Manage Assignments > Add Assignments, select the user with the Analytics Cloud Integration User profile, click Assign, and then click Done.
A definition run fails because the org has exceeded the CRM Analytics API hourly user limit. USER_ERROR_CRMA_LIMIT_EXCEEDED Wait for the limit window to reset, then run the definition again. If the issue persists, contact Salesforce Support to review your limits.