> For the complete documentation index, see [llms.txt](https://docs.videc.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videc.de/june5-3.7/en/webanwendung/sichten/batch-objekt.md).

# Batch Object

A batch object serves for tabular and graphical representation of unit batches *from acron and HEB data sources*. The batch object comprises three main areas:

* Batches
* Reference Batches
* Comparison

In the first main areas the following additional options are available:

* Batch Search
* Visualization
* Events
* Batch Report

For each displayed unit batch or reference batch, in the "Visualization" area, process data of the measurement variables can be determined/retrieved. Furthermore, for both batches, in the Events area, events from HEB data sources can be retrieved.

### Batches

This area primarily presents a tabular representation of unit batches and, if applicable, batch steps. Furthermore, a tabular overview of already saved reference batches is presented. Just like in the Reference Batch area, a reference batch can be selected here as well.

### Reference Batches

This area presents a tabular representation of reference batches. Here the reference batches can be selected, deleted, or edited. Furthermore, the measurement variable selection can be configured for the individual reference batches. More on the topic of Reference Batches can be found in the chapter [Reference Batches](/june5-3.7/en/webanwendung/sichten/batch-objekt/referenz-batches.md).

### Comparison

In this area, a unit batch and a reference batch can be compared graphically with each other. More on this can be found in the chapter [Batch Comparison](/june5-3.7/en/webanwendung/sichten/batch-objekt/batch-vergleich.md).

## Creating a Batch Object

After clicking on the button with the *plus symbol* in the toolbar, a window appears. Here the entry Batch Object must be selected. The Batch Object starts with predefined time settings and loads all batches that occurred in this time range.

Using the filters *Namespace* and *Batch Number* the search can be narrowed down. Entries in these two fields can be combined with OR/AND as desired. Furthermore, via a dropdown list above the table, the number of displayed rows and columns can be configured. A click on the *Refresh* button in the toolbar updates the batch list.

{% hint style="info" %}

* To query unit batches, at least one data source must be selected. This can be configured in the Properties window.
* Events can only be determined for unit batches from HEB (Honeywell Experion Batch) data sources.
* Measurement variables that belong to the unit batch no longer need to be released in the object model so that their process data can be determined.
  {% endhint %}

### Selection of Batch Data Source

The selection of the batch data source can be configured in the *Properties window*, under the entry *Selection of Batch Data Source*. Here, additionally, a *SQL command* can be entered to restrict the result set to the corresponding data source.

If no data source is selected, the unit batches are determined from all data sources released to the user.

## Analyzing a Batch

If a batch is to be analyzed, the corresponding entry must be selected from the list via the circular option field (radio button). Subsequently, depending on whether events can be determined for the unit batch, two or three additional tabs are activated:

### Visualization

The Visualization tab opens and displays the process data of the measurement variables belonging to the batch in a line chart. These are displayed in the chart with the PROCESS database, over the duration of the batch operation.

{% hint style="info" %}
In batch analysis, the process parameters that are contained in the short display of the acron event are shown. An event without process parameters in the short display will not enable analysis. In this case, no chart is displayed.
{% endhint %}

### Events

The events are displayed under the tab labeled Events. To visualize these, press the tab labeled Events.

### Batch Report

Furthermore, the *Batch Report* tab is activated. Here you can view the report for the selected unit batch. The Batch Report tab is not selectable for batch steps!

Display of Detailed Batch Information

As soon as the circular option field (radio button) for a batch is selected, the view for displaying detailed batch information opens to the right of the main table

In the middle of both halves is the vertical dividing line, which allows the width of both halves to be adjusted as desired.

To analyze another batch, a new unit batch must be selected in the list on the tab labeled *Batch Search*!

## Batch Steps

The evaluation of batch steps is described in the chapter [Batch Steps](/june5-3.7/en/webanwendung/sichten/batch-objekt/batch-schritte.md).

## Properties

The following properties can be configured in the *Properties window*:

* Name
* Identification
* [Start Time](/june5-3.7/en/webanwendung/sichten/startzeit.md) *(automatically with current timestamp, absolute or relative)*
* Selection of Batch Data Source
* Pre-filter
* Widget Border Color (*only in Dashboard possible!*)
* Widget Border Width (*only in Dashboard possible!*)
* [Print](/june5-3.7/en/webanwendung/sichten/drucken.md)

## Toolbar

The toolbar provides buttons for the following settings.

* Refresh *(loads newly occurred values from the data source).*
* Set Time *(opens a modal window in which the time point/range can be adjusted).*

## Deleting a Batch Object

To delete a batch object, the auxiliary button with the three dots can be pressed in the object list to the right of the batch object. In the following dropdown menu, the delete button appears, recognizable by the *trash icon*. When this is pressed, the batch object is then irrevocably deleted.

{% hint style="info" %}

* Minimum system requirement - acron 8.4 SP8.
* The millisecond component is not taken into account when displaying the start and end time and the duration in a batch object. Therefore, a duration is only resolved up to the seconds component.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.videc.de/june5-3.7/en/webanwendung/sichten/batch-objekt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
