You can enrich the external connection functionality by defining custom toolbar and menu entries within the Workbench user interface. At add-in load time, Workbench reads in a user-interface configuration file, independent of any defined Component Configuration files, from either an installation-specific or user-specific location. A user interface-based configuration file located in the installation area results in Workbench exposing additional custom entries for every user who accesses the installed ANSYS Workbench application. On the other hand, a file located in the user-specific area will result in additional custom entries only appearing for that specific user. In either case, the content of the user-specific custom files takes precedence over the custom installation files. If user interface configuration files exist in both locations, workbench first examines and loads the user-specific entries and then processes installation entries (ignoring duplicates).
The custom User Interface configuration file format shares the same syntax as the Component Configuration files used with External Connection components. However, only the user interface operation section and elements remain relevant. If you provide content from other sections, Workbench will ignore it (see Configuration XML File Details for element descriptions and examples).
You must place custom installation files in the ExternalConnection directory under v182/Addins (for example C:\Program Files\Ansys Inc\v182\Addins\ExternalConnection). The user-specific custom file location depends upon the operating system:
For Windows machines, create a directory named ExternalConnection under %APPDATA%\Ansys\v182.
For Linux machines, create a directory named ExternalConnection under $HOME/.config/Ansys/v182.
You must create a directory named Customization under ExternalConnection folder to use the custom user interface functionality within the External Connection add-in.
You must name your custom user interface configuration file (which contains the information about the custom user interface entries) CustomToolBarConfiguration.xml and place it under the new Customization folder.
If your custom user interface entries use images or scripts (as defined in your user interface configuration file), you require folders named Images and Scripts under the Customization directory.
The custom entries defined within the user interface configuration file invoke either in-line C# code snippets or python script files. Typically, External Connection users define python script files as they have full access to the Workbench Scripting APIs. You can use a combination of custom user interface entries and scripts to support process automation, wizard-like dialog boxes, and custom lightweight vertical applications.
Note: Toolbar buttons may not appear in Workbench by default. If your External Connection-defined user interface entry does not appear, select the corresponding Toolbar group menu entry from the View>Toolbars menu.