- Release Notes
- Getting Started
- Setup and Configuration
- Automation Projects
- About the Windows - Legacy Compatibility
- About the Project.Json File
- About Publishing Automation Projects
- Designing Automations
- Managing activity packages
- Configuring Activity Project Settings
- Signing Packages
- Governance
- Importing Entities
- Modern Design Experience
- Linking a Project to an Idea in Automation Hub
- Using the Data Manager
- Dependencies
- Types of Workflows
- File Comparison
- Automation Best Practices
- Source Control Integration
- Debugging
- The Diagnostic Tool
- Variables
- Arguments
- Imported Namespaces
- Trigger-based Attended Automation
- Recording
- UI Elements
- Control Flow
- Selectors
- Object Repository
- Data Scraping
- Image and Text Automation
- Automating Citrix Technologies
- RDP Automation
- Salesforce Automation
- SAP Automation
- VMware Horizon Automation
- Logging
- The ScreenScrapeJavaSupport Tool
- The WebDriver Protocol
- Test Suite - Studio
- Extensions
- Troubleshooting
- About troubleshooting
- Microsoft App-V support and limitations
- Internet Explorer X64 troubleshooting
- Microsoft Office issues
- Identifying UI elements in PDF with Accessibility options
- Repairing Active Accessibility support
- Automating Applications Running Under a Different Windows User
- Validation of large Windows-legacy projects takes longer than expected
About the Windows - Legacy Compatibility
Studio 2021.10 brought support for .NET-based projects and introduced the concept of project compatibility based on the target framework. In releases prior to 2021.10, all projects used .NET Framework 4.6.1, but since Studio 2021.10 you have had the option to create projects with the Windows - Legacy compatibility (.NET Framework 4.6.1) or with the Windows and cross-platform compatibilities based on .NET.
The default compatibility for new projects is now Windows. While we continue to support the Windows - Legacy compatibility, new features will only be available in projects with the Windows and cross-platform compatibilities.
For example, the following features introduced in Studio 2022.10 are not available in Windows - Legacy projects:
- Support for creating global variables and constants in the Data Manager.
- New design experience available for cross-platform projects and some activities in Windows projects.
- The ability to customize the layout of activities generated from libraries.
While creating new projects with the Windows - Legacy compatibility is supported and enabled, we recommend using the Windows compatibility to benefit from features not available in Windows - Legacy.
In future Studio releases, you will only be able to open, edit, and run Windows - Legacy projects. However, organizations will still be able to use governance policies to restore the option of creating Windows – Legacy projects by configuring the Allowed compatibility frameworks setting. To stay up to date with upcoming changes, see Deprecation Timeline.
Editing, publishing, and running Windows - Legacy projects will continue to be supported in future releases, which means you can open and edit them like other Windows and cross-platform projects. When you open an existing Windows - Legacy project, a message is displayed at the top of the window.
Studio comes with a built-in conversion tool that enables you to convert any Windows - Legacy project to Windows.
When you convert a project to Windows:
- Project dependencies are managed
based on the following rules:
- If the same version of the package exists in the configured package sources, the version used in the Windows - Legacy project is not changed.
- If the same version of the package does not exist, the version used in the Windows - Legacy project is changed to the highest patch of the nearest version.
- All the activities and properties are preserved in the converted project.
- Namespaces that are different in Windows - Legacy and Windows projects are updated.
-
Namespaces that are required in Windows projects are added and those used only in Windows - Legacy projects are removed.
Note: Convert and republish Windows - Legacy libraries before you convert the processes where they are installed as dependencies.
To convert a legacy project to the Windows compatibility:
-
Open the Windows - Legacy project in Studio and make sure you only open it in one Studio instance.
-
Right-click the project node in the Project panel and then select Convert to Windows. A new window is displayed.
-
Select how to convert:
- To create a copy of the current project using the Windows compatibility and keep the original Windows - Legacy project, select Create a new project. Enter the name, the location where to create, and optionally a description for the new project.
- To update the existing project and convert it to the Windows compatibility, clear the Create a new project checkbox. The changes made to the project if you select this option cannot be undone.
- Click Convert.
If dependency issues cause unresolved activities after the conversion, a message displayed at the top of each such activity indicates that it is missing or it could not be loaded. The following information is available for each one: display name, activity namespace, activity properties and values. Click Replace to find an alternative and replace the missing or invalid activity. For more information, see Missing or Invalid Activities.
Known limitations
- The following expressions are
incompatible with Windows projects and need to be manually changed to
successfully convert a Windows - Legacy project to Windows:
Windows - Legacy syntax Windows syntax {}
new Object() {}
{task_output.Id.ToString,task_action,now,I_comment}
new Object() {task_output.Id.ToString,task_action,now,I_comment }
- To resolve validation errors generated by other expressions that worked before the conversion, cut the expression using the CTRL + X keyboard shortcut and paste it back in the activity field using CTRL + V.