This section lists known issues and limitations in the ACT 2024 R2 release.
Note:
For known issues and limitations specific to Mechanical APIs, see Mechanical API Known Issues and Limitations in the Scripting in Mechanical Guide.
On the Ansys Store, the App Developer Resources page displays a link on the Help & Support tab to the stand-alone ACT Known Issues and Limitation document. This document might contain entries that were added after publication of this guide. To quickly access this document, click here.
- Links in the help for an ACT wizard do not work
Due to a limitation in third-party packages used by ACT, the help for an ACT wizard can only link to on-disk locations (
ref="file:///..."
). Using a location other than the local disk will result in an empty help content area within the wizard.- Extension images from network locations and mapped drives do not display
Extension images residing on a network location or a mapped drive do not display on web browser-based ACT views. Affected views include all tools available from the ACT Start Page, such as the Extension Manager and Wizards Launcher. Instead of seeing the intended image for an extension, you will see a
"?"
icon. However, the extension will execute properly.- Captions for custom objects cannot end in a space followed by a number
When naming a caption for a custom object, the software automatically appends a number to the name if it is identical to existing objects. Do not end the name with a space followed by a number. While no error appears, the number will be removed and may be changed. Workaround: When renaming a caption for a custom object, always follow a space with a non-numeric character before using a number. For example, rather than renaming a caption to
my custom object 2
, rename it tomy custom object n2
.- Third-party solver fails to display in Workbench
A third-party solver exposed through the
<solver>
simdata tag may not display in the Workbench Toolbox if the XML file specified for the attributesystem_template
relies on aValidationCode
. To obtain a correctValidationCode
value compatible with recent licensing system upgrades, contact your local support channel.- ACT panels may not fill entire dialog width
Some ACT panels, such as the ACT Console and ACT Debugger, may not "spring" the entire width of the parent dialog. Panel behavior and user interaction are unaffected.
- Reloading a Workbench extension while in use
A Workbench extension can define new systems to insert in the Project Schematic. Reloading such an extension after creating new system instances will result in unexpected behavior. Before reloading, delete all extension-related systems or save and reset the project.
- In HTML components, the URL protocol must be used for image, custom JS, and CSS files
In an HTML component, an image, custom JS, or CSS file does not display unless the file URL protocol (
file:///
) is placed before the file path.Prior to 2020 R2, an absolute path could be used:
img src="c:/Users/User1/myimage.jpg"
However, the
file:///
protocol must now be placed before the file path. Some examples follow.For an image file:
img src="file:///c:/Users/User1/myimage.jpg"
For a custom JS file:
component.CustomJSFile = r'file:///' + str(ExtAPI/Extension.InstallDir)+ r'\custom_table.js'
- After installation, the ACT Start Page sometimes appears blank
If after installing Ansys products, you see that the ACT Start Page is blank, right-click inside the blank window and select .
- VPN conflicts can arise if IP information is retained
When using a VPN, IP information can be retained, even after turning off the VPN and rebooting the computer. The workaround is to release the IP configuration using the following script:
echo Releasing IP ipconfig /release > NUL echo Acquiring new IP ipconfig /renew > NUL
- Enabled FIPS security policy
When running with an enabled FIPS security policy, ACT User Interface elements are not supported.
- Workbench customization
When using ACT to create Workbench custom workflows, not all optional attributes for the tag <property> are currently supported. For example,
visibleon
is not supported.- For DesignModeler, the ACT Console, Extensions Log, and ACT wizards are supported on Windows platform only
For DesignModeler, the ACT Console, Extensions Log, and ACT wizards are supported only when DesignModeler is running on the Windows platform.
- ACT for Fluent is supported on Windows platform only
When using ACT for Fluent customization, ACT is supported only when Fluent is running on the Windows platform.
- For Fluent, the initial attempt at opening the Extensions Log from the ACT Start Page causes an unexpected shutdown
In a new Fluent installation, the initial attempt at opening the Extensions Log from the ACT Start Page does not display the log dialog box. Instead, Fluent shuts down unexpectedly. However, subsequent attempts at opening this dialog box are successful.
- ACT Debugger and App Builder are supported on Windows platform only
The ACT Debugger is supported only on the Windows platform from the Project page in Ansys Workbench and from DesignModeler and Mechanical. The ACT App Builder is supported only on the Windows platform.
- ACT App Builder is not supported in Ansys Electronics Desktop
The ACT App Builder is not supported in Ansys Electronics Desktop (AEDT). Clicking the Open App Builder icon on the ACT Start Page in AEDT will not start the App Builder.
- Limited ACT localization support
Localization of ACT is limited to the languages currently supported in Ansys Workbench. This limitation does not apply to the ability to manage various languages within the extension. For example, the property names created by an extension do not have to be in the same language as the current activated language in Workbench.
There is no mechanism to integrate localization for the property names defined by an extension. To manage different languages for your property names, you must develop localization yourself. Both regional settings based on the "." or the "," decimal symbol are available. However, the implementation of the extension should use the "." symbol for any value defined at the XML or IronPython level.
- Default location of ACT extensions for SpaceClaim
The default location in which SpaceClaim is to look for ACT extensions is %ANSYSversion_DIR%\scdm\Addins. However, SpaceClaim is not currently recognizing this location. Workarounds include either installing extensions in %APPDATA%\Ansys\v242\ACT\extensions or using the gear icon on the graphic-based Extension Manager accessed from the ACT Start Page to add the folder for the default location or the folder to which you installed the extension.
- Mechanical read-only mode
ACT does not support Mechanical read-only mode. If you launch Mechanical and see read-only mode, avoid interactions with ACT extensions and features as changes could result in unexpected application behavior.
- Captions for custom objects cannot contain a space followed by a number
When renaming a caption for a custom object, do not follow a space with a number. While no error appears, the caption is not renamed. Workaround: When renaming a caption for a custom object, always follow a space with a non-numeric character before using a number. For example, rather than renaming a caption to "my custom object 2", rename it to "my custom object n2".
- ExtAPI.Extension.Attributes does not support OrderedDict values
When
ExtAPI.Extension.Attributes
is used to store a value of typeOrderedDict
, an empty dictionary is stored instead of the supplied value.- Saving dictionaries in attributes slows the opening of Mechanical significantly
When loading a project with custom ACT objects whose attributes have been filled with dictionaries, it takes Mechanical much more time to open. In cases where these dictionaries are very large, Mechanical may be unable to recreate results as ACT results, displaying user-defined results instead.
- Accessing UserInterface on ExtAPI in Mechanical from an onInit callback or globally causes errors
Accessing
UserInterface
onExtAPI
in Mechanical from anonInit
callback or globally causes errors to be thrown in the Extensions Log, resulting in instability. Workaround: AccessUserInterface
from anonLoad
callback or any place other than theonInit
callback. Keep in mind that anonLoad
callback is invoked only when Mechanical is started. Reloading an extension using the button in the GUI will not invoke anonLoad
callback.- Electronics Desktop module CoreGlobalScriptContextFunctions is unavailable
The Electronics Desktop module
CoreGlobalScriptContextFunctions
is unavailable in ACT. The following functions are available only through the Command window in Electronics Desktop:AddErrorMessage
AddFatalMessage
AddInfoMessage
AddWarningMessage
LogDebug
LogError
As alternatives, you can use the following:
oDesktop.AddMessage
Python logging functionality (for example,
"import logging"
and use the logging module)
Limitations Unique to Linux
If you are running on Linux, you should be aware of the following limitations:
- Starting the ACT Start Page can cause an unexpected shutdown
When you start the
on Linux, an unexpected shutdown can occur. On some Linux operating system variants such as Red Hat, removing the packagetotem-mozplugin
resolves the issue:yum remove totem-mozplugin
- Some Linux versions contain a JPEG library that conflicts with the Ansys package
In some Linux versions, a JPEG library conflicts with the Ansys package. When using ACT wizards with JPEG images, this conflict can produce an SIGSEV error and an application crash. If this occurs, you can convert your images to other file formats such as GIF or PNG.
- Graphics API issues in Ansys DesignModeler and Mechanical when no extensions are loaded
When no extensions are loaded, there are some limitations on the
Graphics
API from the ACT Console in Ansys DesignModeler and Mechanical. For instance, Factory2D does not work. Therefore, you should load one or more extensions before using theGraphics
API from the ACT Console.