If you are developing an ePortal presentation project using a target framework of .NET 5.0 or .NET Core 3.1, you must update the target framework to .NET 6.0 before staging the application to the ePortal Runtime environment. Updating the target framework to .NET 6.0 is required because Microsoft no longer supports .NET 5.0 and .NET Core 3.1. We recommend using only supported components when deploying applications to the ePortal Runtime environment.
Since Microsoft does not support .NET 6.0 in Visual Studio 2019, you must have Visual Studio 2022 to perform the retargeting, building, and publishing tasks of the ePortal application. Once that is finalized, you can stage the application from ePortal Developer in Visual Studio 2019.
Prerequisite: Before upgrading the projects to .NET 6.0, ensure that Visual Studio 2022 is installed on your machine.
Note: The information in this topic applies to the following presentation projects:
ASP.NET Core Web API Application
Outbound Web Service API
Perform the following steps to change the target framework to .NET 6.0 using Visual Studio 2022 and restage the projects using Visual Studio 2019:
Make a copy of the presentation project that you are planning to upgrade to .NET 6.0.
Open the copied presentation project in Visual Studio 2022 and click OK to upgrade the project.
Right-click the presentation project and select Properties.
In the Properties page, select .NET 6.0 from the Target framework list, and save the project.
Note: If a detected package downgrade error or warning occurs, you must update the package with the supported stable version. The error details display the supported stable version. Continue with step 5 after updating the package.
Build the project.
Test the presentation project locally using Visual Studio 2022.
Right-click on the project and select Publish.
On the Publish tab, click Publish.
Close the project.
Open the presentation project using Visual Studio 2019.
Right-click the presentation project and then select Stage Published Package to ClearPath ePortal Platform.
In the Stage Published Package to ClearPath ePortal Platform dialog box, select the package that was published from the migrated presentation project in Visual Studio 2022.
Click Stage to stage the application to the ePortal Runtime. For more information on staging a project, see Staging a Presentation Project.
Note: Before verifying the application on the ePortal runtime environment, install the .NET 6.0 package.