> For the complete documentation index, see [llms.txt](https://help.auxalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.auxalia.com/plant-tools/plantbatch/how-to-use/user-interface/batch-configuration-dialog.md).

# Batch Configuration Dialog

**UNDER DEVELOPMENT**

The chapter describes the Batch Configuration dialog and how to setup a Batch Configuration.

### <mark style="color:blue;">Create new Batch Configuration</mark>

To create a new Batch Configuration, click the plus button in the Batch Configuration Name control on the Main Dialog.

![](/files/ThfZWIYNCK8eJlMy8Nxa)

The Batch Configuration Dialog opens. Start by entering a unique name for the configuration.

![](/files/81wTkVnNibab8ngeMLRA)

Type in a unique name for your Batch Configuration.

![](/files/uXvmehxvdE6cRyrHWfDM)

If the configuration name already exists, the name field is highlighted and the OK button is disabled.

![](/files/700uo6LSGGOAwIjvdPz9)

For each Batch Step, define a description for the step.

![](/files/BC8aW0IxQioIpXEy7DZ5)

Next select the executable file which should be executed in this step.

![](/files/dHTgZTzUVeWtK9cgkZcO)

Optionally define additional command line arguments for the executable.

![](/files/s4OolCuID0yNMG3GsSg2)

If the executable needs to run for each drawing file separately, then enable this option.

An example is, that you want to create an Equipment list with PlantReporter for each drawing separately.

When using acad.exe or accoreconsole.exe you may not need this option. Instead the script you want to have executed, can run for each drawing separately.

![](/files/mKQC7FXlDEEyn8MLK3NU)

### <mark style="color:blue;">Add a Batch Step</mark>

To add a Batch Step, click the add button and enter a description for the new step.

![](/files/YfDGMLMFpv2BdYBVI8gm)

The step is added to the list on the right.

![](/files/qRtZejUUnumGTjpCZke9)

### <mark style="color:blue;">Update a Batch Step</mark>

Select an existing Batch Step to update its settings. Changes are applied to the selected step when you switch to another step or close the dialog.

![](/files/0a3BFgfabGpUNEi1LrM9)

### <mark style="color:blue;">Add another Batch Step</mark>

Repeat the same process to add additional Batch Steps. The order in the list defines the execution order in the generated batch file.

![](/files/JJ2GEBJczfzxdFtuusum)

Use the step list to switch between steps and review or modify their settings.

![](/files/6Ay9ijULBKUqOIW5eFQs)

If you switch to another step while there are unsaved changes, PlantBatch will prompt you to save or discard the changes.

![](/files/H6LMs92ISw04wPklHItc)

Each Batch Step description must be unique. If the description already exists, you need to enter a different description.

![](/files/zwb6hwUmkncUaIZBP6cy)

After a description is not unique, the Batch Step will not be created.

![](/files/j3MgTs7XK5u4kdtMVdmz)

After entering a unique description, the Batch Step can be created successfully.

### <mark style="color:blue;">Edit a Batch Step</mark>

To edit a Batch Step, select it in the list and modify its settings.

![](/files/DsRRbk5LT6WqtG7KIbzK)

### <mark style="color:blue;">Change order of Batch Steps</mark>

To change the order of the Batch Steps you simply Drag & Drop a line.

![](/files/wbseQ1cx75BKx630elkm)

It will end at the new location now.

![](/files/69SnBDlVvGf3v5mmiH5L)

### <mark style="color:blue;">Delete a Batch Step</mark>

To delete a Batch Step, select it and use the delete function. The step is removed from the configuration.

![](/files/xC3e6CctzWqIS9ClfotT)

### <mark style="color:blue;">Unsaved Data</mark>

If you close the dialog with Cancel or change the selection while there are unsaved changes, PlantBatch will prompt you to save or discard the changes.

![](/files/ORNeUay18cTie9RBzVE5)

### <mark style="color:blue;">Scripts</mark>

Scripts can be used to run additional actions before the main batch execution or after the batch has finished.

The scripts can not only be used for AutoCAD scripts, but for other executable as well. You can see this in the [PlantReporter Example](/plant-tools/plantbatch/how-to-use/configuration/plantreporter-example.md).

![](/files/gRJ1oThNpVSJKwNeLmBr)

### <mark style="color:blue;">Remove Batch file</mark>

The batch file will be created in the %temp% folder with the date and time in the format **%temp%\[BatchConfigName] - \[YYYYMMDD] - \[HHMMSS].bat**.

You can have the batch file removed after it will have been executed.

![](/files/U4jGkmtWqJ8LUZcrC3WK)

### <mark style="color:blue;">Edit Batch Configuration</mark>

To edit an existing Batch Configuration, open it from the Main Dialog and modify its steps and settings in the Batch Configuration Dialog by clicking on the ![](/files/PazsqA31yT7ixzUMcIUl) icon.

![](/files/GKeYoj5gE98wqCQKkVah)

You can now modify your batch steps. However, the name of the Batch Configuration cannot be edited. This has to be done thought the rename button in the Main Form.

![](/files/FrC59AoZRBxLGUj7ntBo)

After saving, the updated configuration is used when executing the batch from the Main Dialog.
