> 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/main-dialog.md).

# Main Dialog

The chapter describes the Main dialog when starting PlantBatch.

<details>

<summary>Project Selection</summary>

After starting PlantBatch you typically start with the selection of the project.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-765a9bca1e552e67eabbaec0cb78dec86815da6f%2FPB-MainDialog-0001.png?alt=media)

You can open projects from the Most Recently Used list or select normal, collaboration, or Vault project which are not in your list.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-c3070a1e436ef9c97bd8cbb3abdb3ba26e403f75%2FPB-MainDialog-0002.png?alt=media)

</details>

<details>

<summary>Categories and Drawing selection</summary>

After the project got opened you will see all folders and drawings from the selected Categories. By default P\&ID and 3D are checked.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-09eff9522782bf164be1e2606e709fc2ee318e71%2FPB-MainDialog-0004.png?alt=media)

If you check or uncheck Categories, the drawing tree will be updated.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-2a727b6a50aa5d80e6eb79d0c79928cabf46f064%2FPB-MainDialog-0005.png?alt=media)

If you switch over to the Drawings tab, you can select individual folders and drawings in case you want to execute the batch process one specific drawings and not the whole project.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-547fefe0a5568b0fa88ba1e82f62a36bc6cb6710%2FPB-MainDialog-0006.png?alt=media)

Next you can select one of your existing Batch Configurations from the list. Of course, the list is empty at the beginning.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-9b06b8aa1135872e05922325edd4043e433733f0%2FPB-MainDialog-0003.png?alt=media)

</details>

<details>

<summary>Create New Batch Configuration</summary>

If no list exists or you want to create a new Configuration, you click on the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-269d692397d5cb8a131a2ae9f088f9ef9f890942%2FPB-MainDialog-0020.png?alt=media)button.

The creation of a new Batch Configuration is covered under [Batch Configuration Dialog](/plant-tools/plantbatch/how-to-use/user-interface/batch-configuration-dialog.md).

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-bc7ee6d6d60c00739a0d5a7c86f05e7cb358494b%2FPB-MainDialog-0007.png?alt=media)

</details>

<details>

<summary>Delete Batch Configuration</summary>

If you selected an existing Batch Configuration, the other buttons can be used as well.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-f76928bcdbb7e8da07c1376c735b08e1125e6157%2FPB-MainDialog-0008.png?alt=media)

If you click the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-dc6692317eef268ed7247dd8f2bdb150de8e777c%2FPB-MainDialog-0022.png?alt=media)button you will see a text in the Status bar, that the configuration was deleted.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-b6c685f3f6ebb4bad8e6cdb67571eb256b8105cb%2FPB-MainDialog-0013.png?alt=media)

</details>

<details>

<summary>Edit Batch Configuration</summary>

If you click on the ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-5894af6f4def4b5ffa529bb95c0778d45df75f06%2FPB-MainDialog-0021.png?alt=media) button the [Batch Configuration Dialog](/plant-tools/plantbatch/how-to-use/user-interface/batch-configuration-dialog.md) will open where you can modify the Batch Configuration.

The editing a Batch Configuration is covered under [Batch Configuration Dialog](/plant-tools/plantbatch/how-to-use/user-interface/batch-configuration-dialog.md).

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-cb3132fb14a83a965ce3d68778a36861f903aa4b%2FPB-MainDialog-0009.png?alt=media)

</details>

<details>

<summary>Copy Batch Configuration</summary>

If you click on the ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-202352e9cb9a01b46d2578acb2f447cca3a7f9c1%2FPB-MainDialog-0023.png?alt=media) button you can edit the name of the Batch Configuration.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-e48fc26c2401155b232f1ed929426c71e4feeafc%2FPB-MainDialog-0010.png?alt=media)

You will notice, that the buttons will change as well.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-9b39230404d6ade1c178d3ae3ec71b890e996b87%2FPB-MainDialog-0014.png?alt=media)

If you change or type in a new Batch Configuration name, you can click on the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-23a410d2cbd5f9cf2cebeb1600f15a9f7f3be7bc%2FPB-MainDialog-0024.png?alt=media)button to save the Batch Configuration under the new name.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-6456b302b6d0577973528448c6824baac9ec6578%2FPB-MainDialog-0016.png?alt=media)

If you click the ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-dc6692317eef268ed7247dd8f2bdb150de8e777c%2FPB-MainDialog-0022.png?alt=media)button nothing will be saved and you will be back to the Batch Configuration Name selection.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-9530f2809ca2d2abbda6bde1aea313582f320b67%2FPB-MainDialog-0015.png?alt=media)

If you type in a Batch Configuration Name which already exists, the background color will change to red and the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-23a410d2cbd5f9cf2cebeb1600f15a9f7f3be7bc%2FPB-MainDialog-0024.png?alt=media)button will be disabled. You need to type in a unique name.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-decf41c85414cc15610a7865cec96c0905fb1508%2FPB-MainDialog-0017.png?alt=media)

If you have clicked the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-23a410d2cbd5f9cf2cebeb1600f15a9f7f3be7bc%2FPB-MainDialog-0024.png?alt=media)button you will see a confirmation text in the Status bar.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-f41af70a1c930caf70385ccf825b4ae391ebc933%2FPB-MainDialog-0019.png?alt=media)

</details>

<details>

<summary>Rename Batch Configuration</summary>

If you click on the ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-fb16bb71857570ae47137b5a24e1ed60da5e012a%2FPB-MainDialog-0025.png?alt=media) button you can edit the name of the Batch Configuration.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-8f20240eb22dc6a4a07359fd5f3f9706069c73e1%2FPB-MainDialog-0011.png?alt=media)

You will notice, that the buttons will change as well.

If you change or type in a new Batch Configuration name, you can click on the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-23a410d2cbd5f9cf2cebeb1600f15a9f7f3be7bc%2FPB-MainDialog-0024.png?alt=media)button to rename the Batch Configuration under the new name.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-6456b302b6d0577973528448c6824baac9ec6578%2FPB-MainDialog-0016.png?alt=media)

If you click the ![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-dc6692317eef268ed7247dd8f2bdb150de8e777c%2FPB-MainDialog-0022.png?alt=media)button nothing will be saved and you will be back to the Batch Configuration Name selection.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-9530f2809ca2d2abbda6bde1aea313582f320b67%2FPB-MainDialog-0015.png?alt=media)

If you type in a Batch Configuration Name which already exists, the background color will change to red and the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-23a410d2cbd5f9cf2cebeb1600f15a9f7f3be7bc%2FPB-MainDialog-0024.png?alt=media)button will be disabled. You need to type in a unique name.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-decf41c85414cc15610a7865cec96c0905fb1508%2FPB-MainDialog-0017.png?alt=media)

If you have clicked the![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-23a410d2cbd5f9cf2cebeb1600f15a9f7f3be7bc%2FPB-MainDialog-0024.png?alt=media)button you will see a confirmation text in the Status bar.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-03ecd98bf981d63f7cfecb7400ac1cdecab3d6d7%2FPB-MainDialog-0018.png?alt=media)

</details>

<details>

<summary>Execute and Close</summary>

If you have selected a Project and Batch Configuration Name (Category and Drawing selection may also be required depending on the selected Batch Configuration Name), you click on **Execute** to have the Batch Configuration being processed.

If everything runs smoothly, you get a final confirmation dialog.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-f15f978e8f111c7a4ec876caf4778b33d85343e9%2FPB-MainDialog-0012.png?alt=media)

After the batch has been processed PlantBatch will stay open in case you want to run another Batch.

This dialog can be suppress in the [Settings](/plant-tools/plantbatch/settings.md).

</details>

<details>

<summary>Status Messages</summary>

If a batch using acad.exe is executed you see the following message at the beginning:

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-03f00c81617c748b2942934c0344fa45c1bc3d9a%2FPB-MainDialog-0055.png?alt=media)

If you also want to see which drawings is currently processed you need to adapt your script (see [Implementing Counter](/plant-tools/plantbatch/how-to-use/configuration/implementing-counter.md)).

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-386adbc9810cc4963d394cd696b3f7e36776a954%2FPB-MainDialog-0056.png?alt=media)

When using Vault or Collaboration projects you will also see, which drawing is currently checked out.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-ae876aedd8de06b95b0470b580b6dde8623999ce%2FPB-MainDialog-0057.png?alt=media)

And when the script has been executed you will also see, which drawing is currently checked out.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-d4f12470a9b1430ec75a60efccc9677feb6ea9ac%2FPB-MainDialog-0058.png?alt=media)

</details>
