You are browsing documentation for version 5.0 of OroCommerce, OroCRM, and OroPlatform, maintained until August 2024 and supported until March 2026. See version 5.1 (the latest LTS version) of the Oro documentation for information on latest features.
See our Release Process documentation for more information on the currently supported and upcoming releases.
The Batch API provides a way to create or update a list of entities of the same type via one API request.
Enable Batch API for Entity
By default, Batch API is disabled for all API resources. To enable it for an API resource,
the update_list action should be enabled for this resource.
You can do this via
actions section for an entity in Resources/config/oro/api.yml.
api: entities: Oro\Bundle\UserBundle\Entity\User: actions: update_list: true
Batch API Configuration
All configuration options related to Batch API are grouped in the
batch_api section of ApiBundle configuration:
oro_api: batch_api: # The default maximum number of entities that can be saved in a chunk. The default value is 100. chunk_size: 100 # The maximum number of entities of a specific type that can be saved in a chunk. chunk_size_per_entity: Oro\Bundle\UserBundle\Entity\User: 10 # example # The default maximum number of included entities that can be saved in a chunk. The default value is 50. included_data_chunk_size: 50 # The maximum number of included entities that can be saved in a chunk for a specific primary entity type. included_data_chunk_size_per_entity: Oro\Bundle\UserBundle\Entity\User: 20 # example
included_data_chunk_size_per_entity can be used to tuning of
an API engine to have maximum performance.
To get maximum performance in requests with included entities, you can change the value of the
parameter to the medium number of related entities that will be set to one primary entity when processing the request.
Asynchronous Batch Operations Cleanup Configuration
Obsolete asynchronous batch operations are removed once a day by a cron job.
The default configuration of this cron job is illustrated below:
oro_api: batch_api: async_operation: # The number of days async operations are stored in the system. lifetime: 30 # The maximum number of seconds that the cron job can spend in one run. cleanup_process_timeout: 3600 # 1 hour # The maximum number of seconds after which an operation will be removed regardless of status. operation_timeout: 3600 # 1 hour
The KnpGaufretteBundle is used to configure storages for source data files of Batch API requests and all files created when processing asynchronous batch operations (e.g., chunk files, error files, etc.).
Here is the default configuration of these storages:
knp_gaufrette: adapters: api: doctrine_dbal: connection_name: batch table: oro_api_async_data columns: key: name content: content mtime: updated_at checksum: checksum filesystems: # a storage for source data files api_source_data: adapter: private alias: api_source_data_filesystem # a storage for files created when processing asynchronous batch operations api: adapter: api alias: api_filesystem
To change the adapter configuration, use Resources/config/oro/app.yml in any application bundle or config/config.yml. The following example shows how to reconfigure this adapter to use a local filesystem:
knp_gaufrette: adapters: api: local: directory: '%kernel.project_dir%/var/api_files'
You can find more examples in KnpGaufretteBundle documentation.
Explore our guide to learn how digital transformation in manufacturing industry improves operations, customer experiences, and sales.