| apexProcessingTime |
long |
System field |
The number of
milliseconds taken to process triggers and other processes related
to the batch data. If there are no triggers, the value is 0. This doesn't include the time
used for processing asynchronous and batch Apex
operations. See also apiActiveProcessingTime and
totalProcessingTime. This field is available in API version
19.0 and later.
|
| apiActiveProcessingTime |
long |
System field |
The number of milliseconds taken to actively process the batch, and includes
apexProcessingTime. This doesn't
include the time the batch waited in the queue to be processed
or the time required for serialization and
deserialization. See also totalProcessingTime. This field is available in
API version 19.0 and later.
|
| createdDate |
dateTime |
System field |
The date and time in the UTC time zone when
the batch was created. This is not the time processing began, but
the time the batch was added to the job. |
| id |
string |
Required |
The ID of the batch. May be globally
unique, but does not have to be. |
| jobId |
string |
Required |
The unique, 18–character ID for the job
associated with this batch. |
| numberRecordsFailed |
int |
System field |
The number of records
that were not processed successfully in this batch. This field is available in API version 19.0 and later.
|
| numberRecordsProcessed |
int |
System field |
The number of records processed in
this batch at the time the request was sent. This number increases
as more batches are processed. |
| state |
BatchStateEnum |
System field |
The current state of processing for the
batch:
-
Queued: Processing of the batch has not started yet. If the job
associated with this batch is aborted, the batch isn’t processed and its state
is set to Not
Processed.
-
InProgress: The batch is being processed. If the job associated
with the batch is aborted, the batch is still processed to completion. You
must close the job associated with the batch so that the batch can finish
processing.
-
Completed: The batch has been
processed completely, and the result resource is available. The result
resource indicates if some records have failed. A batch can be completed even
if some or all the records have failed. If a subset of records failed, the
successful records aren’t rolled back.
-
Failed: The batch failed to process the full request due to an
unexpected error, such as the request is compressed with an unsupported
format, or an internal server error. The
stateMessage element could contain more details about any
failures. Even if the batch failed, some
records could have been completed successfully. The
numberRecordsProcessed field tells you how many records
were processed. The numberRecordsFailed field contains the
number of records that were not processed successfully.
-
Not
Processed: The batch won’t be
processed. This state is assigned when a job is aborted while the batch is
queued. For bulk queries, if the job has PK chunking enabled, this state is
assigned to the original batch that contains the query when the subsequent
batches are created. After the original batch is changed to this state, you
can monitor the subsequent batches and retrieve each batch’s results when it’s
completed. Then you can safely close the job.
|
| stateMessage |
string |
System field |
Contains details about the state. For example, if the
state value is Failed,
this field contains the reasons for failure.
If there are multiple failures, the message may be truncated.
If so, fix the known errors and re-submit the batch.
Even if the batch failed, some
records could have been completed successfully. |
| systemModstamp |
dateTime |
System field |
The date and time in the UTC time zone that
processing ended. This is only valid when the state is Completed. |
| totalProcessingTime |
long |
System field |
The number of
milliseconds taken to process the batch. This excludes the time the
batch waited in the queue to be processed. See also apexProcessingTime and
apiActiveProcessingTime. This field is available in API
version 19.0 and later.
|